homebridge-securitysystem 9.1.2 → 10.0.0-beta.2

package/dist/handlers/sensor-handler.d.ts

@@ -0,0 +1,17 @@
+import type { Logging } from 'homebridge';
+import type { ServiceRegistry } from '../interfaces/service-registry-interface.js';
+import type { CharacteristicConstructor } from '../interfaces/hap-types-interface.js';
+/** Manages all motion sensor characteristic updates. */
+export declare class SensorHandler {
+    private readonly services;
+    private readonly Characteristic;
+    private readonly log;
+    constructor(services: ServiceRegistry, Characteristic: CharacteristicConstructor, log: Logging);
+    updateArmingMotionSensor(value: boolean): void;
+    resetArmingMotionSensor(): void;
+    pulseTrippedMotionSensor(): void;
+    resetTrippedMotionSensor(): void;
+    pulseTriggeredMotionSensor(): void;
+    pulseResetMotionSensor(): void;
+    private scheduleReset;
+}

package/dist/handlers/sensor-handler.js

@@ -0,0 +1,53 @@
+import { SENSOR_PULSE_MS } from '../constants/homekit-constant.js';
+/** Manages all motion sensor characteristic updates. */
+export class SensorHandler {
+    services;
+    Characteristic;
+    log;
+    constructor(services, Characteristic, log) {
+        this.services = services;
+        this.Characteristic = Characteristic;
+        this.log = log;
+    }
+    // ── Arming sensor ──────────────────────────────────────────────────────────
+    updateArmingMotionSensor(value) {
+        this.services.armingMotionSensorService.updateCharacteristic(this.Characteristic.MotionDetected, value);
+    }
+    resetArmingMotionSensor() {
+        const current = this.services.armingMotionSensorService
+            .getCharacteristic(this.Characteristic.MotionDetected).value;
+        if (current) {
+            this.services.armingMotionSensorService.updateCharacteristic(this.Characteristic.MotionDetected, false);
+        }
+    }
+    // ── Tripped sensor ─────────────────────────────────────────────────────────
+    pulseTrippedMotionSensor() {
+        this.services.trippedMotionSensorService.updateCharacteristic(this.Characteristic.MotionDetected, true);
+        this.scheduleReset(this.services.trippedMotionSensorService);
+    }
+    resetTrippedMotionSensor() {
+        const char = this.services.trippedMotionSensorService
+            .getCharacteristic(this.Characteristic.MotionDetected);
+        if (char.value) {
+            char.updateValue(false);
+        }
+    }
+    // ── Triggered sensor ───────────────────────────────────────────────────────
+    pulseTriggeredMotionSensor() {
+        this.services.triggeredMotionSensorService.updateCharacteristic(this.Characteristic.MotionDetected, true);
+        this.scheduleReset(this.services.triggeredMotionSensorService);
+    }
+    // ── Reset sensor ───────────────────────────────────────────────────────────
+    pulseResetMotionSensor() {
+        this.services.triggeredResetMotionSensorService.updateCharacteristic(this.Characteristic.MotionDetected, true);
+        this.scheduleReset(this.services.triggeredResetMotionSensorService);
+        this.log.debug('Reset sensor (Triggered)');
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    scheduleReset(service) {
+        setTimeout(() => {
+            service.updateCharacteristic(this.Characteristic.MotionDetected, false);
+        }, SENSOR_PULSE_MS);
+    }
+}
+//# sourceMappingURL=sensor-handler.js.map

package/dist/handlers/sensor-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor-handler.js","sourceRoot":"","sources":["../../src/handlers/sensor-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAInE,wDAAwD;AACxD,MAAM,OAAO,aAAa;IAEL;IACA;IACA;IAHnB,YACmB,QAAyB,EACzB,cAAyC,EACzC,GAAY;QAFZ,aAAQ,GAAR,QAAQ,CAAiB;QACzB,mBAAc,GAAd,cAAc,CAA2B;QACzC,QAAG,GAAH,GAAG,CAAS;IAC5B,CAAC;IAEJ,8EAA8E;IAE9E,wBAAwB,CAAC,KAAc;QACrC,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,oBAAoB,CAC1D,IAAI,CAAC,cAAc,CAAC,cAAc,EAClC,KAAK,CACN,CAAC;IACJ,CAAC;IAED,uBAAuB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,yBAAyB;aACpD,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC;QAE/D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,oBAAoB,CAC1D,IAAI,CAAC,cAAc,CAAC,cAAc,EAClC,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,wBAAwB;QACtB,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,oBAAoB,CAC3D,IAAI,CAAC,cAAc,CAAC,cAAc,EAClC,IAAI,CACL,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAC/D,CAAC;IAED,wBAAwB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,0BAA0B;aAClD,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,0BAA0B;QACxB,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,oBAAoB,CAC7D,IAAI,CAAC,cAAc,CAAC,cAAc,EAClC,IAAI,CACL,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;IACjE,CAAC;IAED,8EAA8E;IAE9E,sBAAsB;QACpB,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC,oBAAoB,CAClE,IAAI,CAAC,cAAc,CAAC,cAAc,EAClC,IAAI,CACL,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IAED,8EAA8E;IAEtE,aAAa,CAAC,OAA+C;QACnE,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC,EAAE,eAAe,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/handlers/state-handler.d.ts

@@ -0,0 +1,41 @@
+import type { Logging } from 'homebridge';
+import type { CharacteristicConstructor } from '../interfaces/hap-types-interface.js';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import type { ServiceRegistry } from '../interfaces/service-registry-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+import type { EventBusService } from '../services/event-bus-service.js';
+import type { StorageService } from '../services/storage-service.js';
+import type { AudioService } from '../services/audio-service.js';
+import type { TripHandler } from './trip-handler.js';
+import type { SwitchHandler } from './switch-handler.js';
+import type { SensorHandler } from './sensor-handler.js';
+/** Manages the core security-system state machine: arming, triggering, and resetting. */
+export declare class StateHandler {
+    private readonly services;
+    private readonly state;
+    private readonly options;
+    private readonly Characteristic;
+    private readonly log;
+    private readonly bus;
+    private readonly storageService;
+    private readonly audio;
+    private tripHandler;
+    private switchHandler;
+    private sensorHandler;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, bus: EventBusService, storageService: StorageService, audio: AudioService);
+    setHandlers(trip: TripHandler, sw: SwitchHandler, sensor: SensorHandler): void;
+    setCurrentState(state: SecurityState, origin: OriginType): void;
+    updateTargetState(state: SecurityState, origin: OriginType, delay: number): boolean;
+    getArmingSeconds(state: SecurityState): number;
+    resetTimers(): void;
+    getAvailableTargetStates(): SecurityState[];
+    logMode(type: string, state: SecurityState | string): void;
+    private isBadTargetState;
+    private handleTargetStateChange;
+    private handleCurrentStateChange;
+    private handleTriggeredState;
+    private handleArmingState;
+    private resetViaOffMode;
+}

package/dist/handlers/state-handler.js

@@ -0,0 +1,213 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { stateToMode, capitalise } from '../utils/state-util.js';
+import { modeToState } from '../utils/state-util.js';
+import { EventType } from '../types/event-type.js';
+/** Manages the core security-system state machine: arming, triggering, and resetting. */
+export class StateHandler {
+    services;
+    state;
+    options;
+    Characteristic;
+    log;
+    bus;
+    storageService;
+    audio;
+    tripHandler;
+    switchHandler;
+    sensorHandler;
+    constructor(services, state, options, Characteristic, log, bus, storageService, audio) {
+        this.services = services;
+        this.state = state;
+        this.options = options;
+        this.Characteristic = Characteristic;
+        this.log = log;
+        this.bus = bus;
+        this.storageService = storageService;
+        this.audio = audio;
+    }
+    setHandlers(trip, sw, sensor) {
+        this.tripHandler = trip;
+        this.switchHandler = sw;
+        this.sensorHandler = sensor;
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    setCurrentState(state, origin) {
+        this.sensorHandler.resetArmingMotionSensor();
+        this.audio.play('current', state);
+        if (this.state.currentState === state) {
+            this.log.warn('Current mode (Already set)');
+            return;
+        }
+        this.state.currentState = state;
+        this.services.mainService.setCharacteristic(this.Characteristic.SecuritySystemCurrentState, state);
+        this.logMode('Current', state);
+        this.handleCurrentStateChange(origin);
+        this.storageService.save(this.state);
+    }
+    updateTargetState(state, origin, delay) {
+        if (this.isBadTargetState(state)) {
+            return false;
+        }
+        this.state.targetState = state;
+        this.logMode('Target', state);
+        if (origin === OriginType.INTERNAL || origin === OriginType.EXTERNAL) {
+            this.services.mainService.updateCharacteristic(this.Characteristic.SecuritySystemTargetState, state);
+        }
+        this.handleTargetStateChange(origin);
+        if (state === this.state.currentState) {
+            this.setCurrentState(state, origin);
+            return false;
+        }
+        const armSeconds = delay > 0 ? delay : 0;
+        if (armSeconds === 0) {
+            this.setCurrentState(state, origin);
+            return false;
+        }
+        this.state.isArming = true;
+        this.handleArmingState();
+        this.log.info(`Arm delay (${armSeconds}s)`);
+        this.state.armTimeout = setTimeout(() => {
+            this.state.armTimeout = null;
+            this.state.isArming = false;
+            this.setCurrentState(state, origin);
+        }, armSeconds * 1000);
+        return true;
+    }
+    getArmingSeconds(state) {
+        const isTriggered = this.state.currentState === SecurityState.TRIGGERED;
+        const isOff = state === SecurityState.OFF;
+        if (isTriggered || isOff) {
+            return 0;
+        }
+        if (state === SecurityState.HOME && this.options.homeArmSeconds !== null) {
+            return this.options.homeArmSeconds;
+        }
+        if (state === SecurityState.AWAY && this.options.awayArmSeconds !== null) {
+            return this.options.awayArmSeconds;
+        }
+        if (state === SecurityState.NIGHT && this.options.nightArmSeconds !== null) {
+            return this.options.nightArmSeconds;
+        }
+        return this.options.armSeconds;
+    }
+    resetTimers() {
+        if (this.state.triggerTimeout) {
+            clearTimeout(this.state.triggerTimeout);
+            this.state.triggerTimeout = null;
+            this.log.debug('Trigger timeout (Cleared)');
+        }
+        if (this.state.armTimeout) {
+            clearTimeout(this.state.armTimeout);
+            this.state.armTimeout = null;
+            this.log.debug('Arming timeout (Cleared)');
+        }
+        if (this.state.triggeredMotionSensorInterval) {
+            clearInterval(this.state.triggeredMotionSensorInterval);
+            this.state.triggeredMotionSensorInterval = null;
+            this.log.debug('Triggered interval (Cleared)');
+        }
+        if (this.state.trippedMotionSensorInterval) {
+            clearInterval(this.state.trippedMotionSensorInterval);
+            this.state.trippedMotionSensorInterval = null;
+            this.log.debug('Tripped interval (Cleared)');
+        }
+        if (this.state.doubleKnockTimeout) {
+            clearTimeout(this.state.doubleKnockTimeout);
+            this.state.doubleKnockTimeout = null;
+            this.log.debug('Double-knock timeout (Cleared)');
+        }
+        if (this.state.pauseTimeout) {
+            clearTimeout(this.state.pauseTimeout);
+            this.state.pauseTimeout = null;
+            this.log.debug('Pause timeout (Cleared)');
+        }
+        if (this.state.resetTimeout) {
+            clearTimeout(this.state.resetTimeout);
+            this.state.resetTimeout = null;
+            this.log.debug('Reset timeout (Cleared)');
+        }
+    }
+    getAvailableTargetStates() {
+        const all = [SecurityState.HOME, SecurityState.AWAY, SecurityState.NIGHT, SecurityState.OFF];
+        const disabled = this.options.disabledModes.map(m => modeToState(m.toLowerCase()));
+        return all.filter(s => !disabled.includes(s));
+    }
+    logMode(type, state) {
+        const mode = capitalise(stateToMode(state));
+        this.log.info(`${type} mode (${mode})`);
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    isBadTargetState(state) {
+        const isTriggered = this.state.currentState === SecurityState.TRIGGERED;
+        const alreadySet = this.state.targetState === state;
+        if (alreadySet && !isTriggered) {
+            this.log.warn('Target mode (Already set)');
+            return true;
+        }
+        if (!this.state.availableTargetStates.includes(state)) {
+            this.log.warn('Target mode (Disabled)');
+            return true;
+        }
+        const hasLock = this.options.armingLockSwitch || this.options.armingLockSwitches;
+        if (state !== SecurityState.OFF && hasLock && this.switchHandler.isArmingLocked(state)) {
+            this.log.warn('Arming lock (Not allowed)');
+            return true;
+        }
+        return false;
+    }
+    handleTargetStateChange(origin) {
+        this.resetTimers();
+        this.tripHandler.resetTripSwitches();
+        this.sensorHandler.resetTrippedMotionSensor();
+        this.switchHandler.resetModeSwitches();
+        this.switchHandler.updateModeSwitches();
+        this.bus.emit(EventType.TARGET_CHANGED, { state: this.state.targetState, origin });
+        if (this.state.currentState === SecurityState.TRIGGERED) {
+            this.sensorHandler.pulseResetMotionSensor();
+        }
+        this.state.isKnocked = false;
+    }
+    handleCurrentStateChange(origin) {
+        if (this.state.currentState === SecurityState.TRIGGERED) {
+            this.handleTriggeredState();
+            if (this.options.testMode) {
+                return;
+            }
+        }
+        this.tripHandler.resetTripSwitches();
+        this.bus.emit(EventType.CURRENT_CHANGED, { state: this.state.currentState, origin });
+    }
+    handleTriggeredState() {
+        if (this.state.trippedMotionSensorInterval) {
+            clearInterval(this.state.trippedMotionSensorInterval);
+            this.state.trippedMotionSensorInterval = null;
+        }
+        if (this.options.triggeredMotionSensor) {
+            this.state.triggeredMotionSensorInterval = setInterval(() => this.sensorHandler.pulseTriggeredMotionSensor(), this.options.triggeredMotionSensorSeconds * 1000);
+        }
+        this.state.resetTimeout = setTimeout(() => {
+            this.state.resetTimeout = null;
+            this.log.info('Reset (Finished)');
+            this.sensorHandler.pulseResetMotionSensor();
+            if (this.options.resetOffFlow) {
+                this.resetViaOffMode();
+            }
+            else {
+                this.setCurrentState(this.state.targetState, OriginType.EXTERNAL);
+            }
+        }, this.options.resetMinutes * 60 * 1000);
+    }
+    handleArmingState() {
+        this.sensorHandler.updateArmingMotionSensor(true);
+        this.bus.emit(EventType.ARMING, { state: this.state.targetState });
+    }
+    resetViaOffMode() {
+        const original = this.state.targetState;
+        this.updateTargetState(SecurityState.OFF, OriginType.INTERNAL, 0);
+        setTimeout(() => {
+            this.updateTargetState(original, OriginType.INTERNAL, this.getArmingSeconds(original));
+        }, 100);
+    }
+}
+//# sourceMappingURL=state-handler.js.map

package/dist/handlers/state-handler.js.map

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

package/dist/handlers/switch-handler.d.ts

@@ -0,0 +1,27 @@
+import type { Logging } from 'homebridge';
+import type { CharacteristicConstructor } from '../interfaces/hap-types-interface.js';
+import { SecurityState } from '../types/security-state-type.js';
+import type { ServiceRegistry } from '../interfaces/service-registry-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+import type { StateHandler } from './state-handler.js';
+/** Handles all mode switches, arming-lock switches, and the pause/extended switches. */
+export declare class SwitchHandler {
+    private readonly services;
+    private readonly state;
+    private readonly options;
+    private readonly Characteristic;
+    private readonly log;
+    private stateHandler;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging);
+    setStateHandler(handler: StateHandler): void;
+    setModeSwitch(mode: SecurityState, value: boolean): number | null;
+    setModeOffSwitch(value: boolean): number | null;
+    setModeAwayExtendedSwitch(value: boolean): number | null;
+    setModePauseSwitch(value: boolean): number | null;
+    updateArmingLock(mode: string, value: boolean): boolean;
+    isArmingLocked(targetState: SecurityState): boolean;
+    resetModeSwitches(): void;
+    updateModeSwitches(): void;
+    private logArmingLock;
+}

package/dist/handlers/switch-handler.js

@@ -0,0 +1,139 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { HK_NOT_ALLOWED_IN_CURRENT_STATE } from '../constants/homekit-constant.js';
+import { OriginType } from '../types/origin-type.js';
+import { capitalise } from '../utils/state-util.js';
+/** Handles all mode switches, arming-lock switches, and the pause/extended switches. */
+export class SwitchHandler {
+    services;
+    state;
+    options;
+    Characteristic;
+    log;
+    stateHandler;
+    constructor(services, state, options, Characteristic, log) {
+        this.services = services;
+        this.state = state;
+        this.options = options;
+        this.Characteristic = Characteristic;
+        this.log = log;
+    }
+    setStateHandler(handler) {
+        this.stateHandler = handler;
+    }
+    // ── Mode switches ──────────────────────────────────────────────────────────
+    setModeSwitch(mode, value) {
+        if (!value) {
+            return HK_NOT_ALLOWED_IN_CURRENT_STATE;
+        }
+        const delay = this.stateHandler.getArmingSeconds(mode);
+        this.stateHandler.updateTargetState(mode, OriginType.INTERNAL, delay);
+        return null;
+    }
+    setModeOffSwitch(value) {
+        if (!value) {
+            return HK_NOT_ALLOWED_IN_CURRENT_STATE;
+        }
+        this.stateHandler.updateTargetState(SecurityState.OFF, OriginType.INTERNAL, 0);
+        return null;
+    }
+    setModeAwayExtendedSwitch(value) {
+        if (!value) {
+            return HK_NOT_ALLOWED_IN_CURRENT_STATE;
+        }
+        const delay = this.stateHandler.getArmingSeconds(SecurityState.AWAY);
+        this.stateHandler.updateTargetState(SecurityState.AWAY, OriginType.INTERNAL, delay);
+        return null;
+    }
+    setModePauseSwitch(value) {
+        if (this.state.currentState === SecurityState.TRIGGERED) {
+            this.log.warn('Mode pause (Alarm is triggered)');
+            return HK_NOT_ALLOWED_IN_CURRENT_STATE;
+        }
+        if (value) {
+            if (this.state.currentState === SecurityState.OFF) {
+                this.log.warn('Mode pause (Not armed)');
+                return HK_NOT_ALLOWED_IN_CURRENT_STATE;
+            }
+            this.log.info('Mode pause (Started)');
+            this.state.pausedCurrentState = this.state.currentState;
+            this.stateHandler.updateTargetState(SecurityState.OFF, OriginType.INTERNAL, 0);
+            if (this.options.pauseMinutes !== 0) {
+                this.state.pauseTimeout = setTimeout(() => {
+                    this.log.info('Mode pause (Finished)');
+                    const prev = this.state.pausedCurrentState ?? this.state.defaultState;
+                    this.stateHandler.updateTargetState(prev, OriginType.INTERNAL, this.stateHandler.getArmingSeconds(prev));
+                }, this.options.pauseMinutes * 60 * 1000);
+            }
+        }
+        else {
+            this.log.info('Mode pause (Cancelled)');
+            if (this.state.pauseTimeout !== null) {
+                clearTimeout(this.state.pauseTimeout);
+                this.state.pauseTimeout = null;
+            }
+            const prev = this.state.pausedCurrentState ?? this.state.defaultState;
+            this.stateHandler.updateTargetState(prev, OriginType.INTERNAL, this.stateHandler.getArmingSeconds(prev));
+        }
+        return null;
+    }
+    // ── Arming lock switches ───────────────────────────────────────────────────
+    updateArmingLock(mode, value) {
+        this.logArmingLock(mode, value);
+        const map = {
+            global: 'armingLockSwitchService',
+            home: 'armingLockHomeSwitchService',
+            away: 'armingLockAwaySwitchService',
+            night: 'armingLockNightSwitchService',
+        };
+        const key = map[mode];
+        if (!key) {
+            this.log.debug(`Unknown arming lock mode (${mode})`);
+            return false;
+        }
+        this.services[key].getCharacteristic(this.Characteristic.On).updateValue(value);
+        return true;
+    }
+    isArmingLocked(targetState) {
+        if (this.services.armingLockSwitchService.getCharacteristic(this.Characteristic.On).value) {
+            return true;
+        }
+        const modeMap = {
+            [SecurityState.HOME]: 'armingLockHomeSwitchService',
+            [SecurityState.AWAY]: 'armingLockAwaySwitchService',
+            [SecurityState.NIGHT]: 'armingLockNightSwitchService',
+        };
+        const svcKey = modeMap[targetState];
+        return svcKey ? Boolean(this.services[svcKey].getCharacteristic(this.Characteristic.On).value) : false;
+    }
+    // ── Mode switch display ────────────────────────────────────────────────────
+    resetModeSwitches() {
+        const switches = [
+            'modeHomeSwitchService', 'modeAwaySwitchService', 'modeNightSwitchService',
+            'modeOffSwitchService', 'modeAwayExtendedSwitchService', 'modePauseSwitchService',
+        ];
+        for (const key of switches) {
+            const char = this.services[key].getCharacteristic(this.Characteristic.On);
+            if (char.value) {
+                char.updateValue(false);
+                this.log.debug(`${key} (Off)`);
+            }
+        }
+    }
+    updateModeSwitches() {
+        const modeMap = {
+            [SecurityState.HOME]: 'modeHomeSwitchService',
+            [SecurityState.AWAY]: 'modeAwaySwitchService',
+            [SecurityState.NIGHT]: 'modeNightSwitchService',
+            [SecurityState.OFF]: 'modeOffSwitchService',
+        };
+        const key = modeMap[this.state.targetState];
+        if (key) {
+            this.services[key].updateCharacteristic(this.Characteristic.On, true);
+            this.log.debug(`${key} (On)`);
+        }
+    }
+    logArmingLock(mode, value) {
+        this.log.info(`Arming lock [${capitalise(mode)}] (${value ? 'On' : 'Off'})`);
+    }
+}
+//# sourceMappingURL=switch-handler.js.map

package/dist/handlers/switch-handler.js.map

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

package/dist/handlers/trip-handler.d.ts

@@ -0,0 +1,45 @@
+import type { Logging } from 'homebridge';
+import type { CharacteristicConstructor } from '../interfaces/hap-types-interface.js';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { HK_NOT_ALLOWED_IN_CURRENT_STATE } from '../constants/homekit-constant.js';
+import type { ServiceRegistry } from '../interfaces/service-registry-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+import type { EventBusService } from '../services/event-bus-service.js';
+import type { AudioService } from '../services/audio-service.js';
+import type { SensorHandler } from './sensor-handler.js';
+import type { StateHandler } from './state-handler.js';
+/** Handles the trip switch and trigger-delay logic, including all blocking conditions. */
+export declare class TripHandler {
+    private readonly services;
+    private readonly state;
+    private readonly options;
+    private readonly Characteristic;
+    private readonly log;
+    private readonly bus;
+    private readonly audio;
+    private readonly sensorHandler;
+    private stateHandler;
+    private readonly notArmed;
+    private readonly armingInProgress;
+    private readonly alreadyTriggered;
+    private readonly doubleKnock;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, bus: EventBusService, audio: AudioService, sensorHandler: SensorHandler);
+    setStateHandler(handler: StateHandler): void;
+    /**
+     * Core trip-switch logic shared by all trip/trigger paths.
+     * Returns `true` on success, `false` if blocked.
+     */
+    updateTripSwitch(value: boolean, origin: OriginType, stateChanged: boolean): boolean;
+    /**
+     * Trip a mode-specific switch. Only triggers if the system is currently in
+     * the required mode (or the alarm is triggered and target matches).
+     */
+    triggerIfModeSet(requiredState: SecurityState, value: boolean): boolean;
+    resetTripSwitches(): void;
+    private activateTrip;
+    private cancelTrip;
+    private resolveTriggerSeconds;
+}
+export { HK_NOT_ALLOWED_IN_CURRENT_STATE };