homebridge-securitysystem 9.1.2 → 10.0.0-beta.3

package/dist/constants/switch-uuid-constant.d.ts

@@ -0,0 +1,23 @@
+/** Stable subtype UUIDs for each HomeKit service. Must not change between restarts. */
+export declare const SWITCH_UUIDS: {
+    readonly TRIP: "siren-switch";
+    readonly TRIP_HOME: "siren-home";
+    readonly TRIP_AWAY: "siren-away";
+    readonly TRIP_NIGHT: "siren-night";
+    readonly TRIP_OVERRIDE: "pink-sheep";
+    readonly ARMING_LOCK: "arming-lock";
+    readonly ARMING_LOCK_HOME: "arming-lock-home";
+    readonly ARMING_LOCK_AWAY: "arming-lock-away";
+    readonly ARMING_LOCK_NIGHT: "arming-lock-night";
+    readonly MODE_HOME: "mode-home";
+    readonly MODE_AWAY: "mode-away";
+    readonly MODE_NIGHT: "mode-night";
+    readonly MODE_OFF: "mode-off";
+    readonly MODE_AWAY_EXTENDED: "mode-away-extended";
+    readonly MODE_PAUSE: "mode-pause";
+    readonly AUDIO: "kx82r64zN3txDXKFiX9JDi";
+    readonly ARMING_SENSOR: "arming-motion-sensor";
+    readonly TRIPPED_SENSOR: "siren-tripped";
+    readonly TRIGGERED_SENSOR: "siren-triggered";
+    readonly RESET_SENSOR: "reset-event";
+};

package/dist/constants/switch-uuid-constant.js

@@ -0,0 +1,24 @@
+/** Stable subtype UUIDs for each HomeKit service. Must not change between restarts. */
+export const SWITCH_UUIDS = {
+    TRIP: 'siren-switch',
+    TRIP_HOME: 'siren-home',
+    TRIP_AWAY: 'siren-away',
+    TRIP_NIGHT: 'siren-night',
+    TRIP_OVERRIDE: 'pink-sheep',
+    ARMING_LOCK: 'arming-lock',
+    ARMING_LOCK_HOME: 'arming-lock-home',
+    ARMING_LOCK_AWAY: 'arming-lock-away',
+    ARMING_LOCK_NIGHT: 'arming-lock-night',
+    MODE_HOME: 'mode-home',
+    MODE_AWAY: 'mode-away',
+    MODE_NIGHT: 'mode-night',
+    MODE_OFF: 'mode-off',
+    MODE_AWAY_EXTENDED: 'mode-away-extended',
+    MODE_PAUSE: 'mode-pause',
+    AUDIO: 'kx82r64zN3txDXKFiX9JDi',
+    ARMING_SENSOR: 'arming-motion-sensor',
+    TRIPPED_SENSOR: 'siren-tripped',
+    TRIGGERED_SENSOR: 'siren-triggered',
+    RESET_SENSOR: 'reset-event',
+};
+//# sourceMappingURL=switch-uuid-constant.js.map

package/dist/constants/switch-uuid-constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-uuid-constant.js","sourceRoot":"","sources":["../../src/constants/switch-uuid-constant.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,aAAa,EAAE,YAAY;IAC3B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,wBAAwB;IAC/B,aAAa,EAAE,sBAAsB;IACrC,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,YAAY,EAAE,aAAa;CACnB,CAAC"}

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,46 @@
+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 { SensorHandler } from './sensor-handler.js';
+import type { TimerManager } from '../timers/timer-manager.js';
+/**
+ * Manages the core security-system state machine: arming, triggering, and resetting.
+ * Cross-handler side effects are signalled via the event bus so that this class has
+ * no direct dependencies on TripHandler or SwitchHandler.
+ */
+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 readonly timers;
+    private readonly sensorHandler;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, bus: EventBusService, storageService: StorageService, audio: AudioService, timers: TimerManager, sensorHandler: SensorHandler);
+    setCurrentState(state: SecurityState, origin: OriginType): void;
+    updateTargetState(state: SecurityState, origin: OriginType, delay: number): boolean;
+    getArmingSeconds(targetState: SecurityState): number;
+    resetTimers(): void;
+    /** Returns true while the trigger delay is counting down (trip switch is active). */
+    isTripping(): boolean;
+    /** Checks whether arming is currently blocked by an arming-lock switch. */
+    isArmingLocked(targetState: SecurityState): boolean;
+    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,182 @@
+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';
+import { getArmingSeconds } from '../utils/arming-util.js';
+/**
+ * Manages the core security-system state machine: arming, triggering, and resetting.
+ * Cross-handler side effects are signalled via the event bus so that this class has
+ * no direct dependencies on TripHandler or SwitchHandler.
+ */
+export class StateHandler {
+    services;
+    state;
+    options;
+    Characteristic;
+    log;
+    bus;
+    storageService;
+    audio;
+    timers;
+    sensorHandler;
+    constructor(services, state, options, Characteristic, log, bus, storageService, audio, timers, sensorHandler) {
+        this.services = services;
+        this.state = state;
+        this.options = options;
+        this.Characteristic = Characteristic;
+        this.log = log;
+        this.bus = bus;
+        this.storageService = storageService;
+        this.audio = audio;
+        this.timers = timers;
+        this.sensorHandler = sensorHandler;
+    }
+    // ── 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.timers.setArmTimer(armSeconds * 1000, () => {
+            this.state.isArming = false;
+            this.setCurrentState(state, origin);
+        });
+        return true;
+    }
+    getArmingSeconds(targetState) {
+        return getArmingSeconds(this.state, this.options, targetState);
+    }
+    resetTimers() {
+        this.timers.clearAll();
+    }
+    /** Returns true while the trigger delay is counting down (trip switch is active). */
+    isTripping() {
+        return this.state.isTripping;
+    }
+    /** Checks whether arming is currently blocked by an arming-lock switch. */
+    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;
+    }
+    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.isArmingLocked(state)) {
+            this.log.warn('Arming lock (Not allowed)');
+            return true;
+        }
+        return false;
+    }
+    handleTargetStateChange(origin) {
+        this.resetTimers();
+        // Notify handlers to reset their displayed state (bus is synchronous).
+        this.bus.emit(EventType.RESET_TRIP_SWITCHES, {});
+        this.sensorHandler.resetTrippedMotionSensor();
+        this.bus.emit(EventType.RESET_MODE_SWITCHES, {});
+        this.bus.emit(EventType.UPDATE_MODE_SWITCHES, {});
+        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;
+            }
+        }
+        // Notify TripHandler to reset trip switches on any state change.
+        this.bus.emit(EventType.RESET_TRIP_SWITCHES, {});
+        this.bus.emit(EventType.CURRENT_CHANGED, { state: this.state.currentState, origin });
+    }
+    handleTriggeredState() {
+        this.timers.clearTrippedInterval();
+        if (this.options.triggeredMotionSensor) {
+            this.timers.setTriggeredInterval(this.options.triggeredMotionSensorSeconds * 1000, () => this.sensorHandler.pulseTriggeredMotionSensor());
+        }
+        this.timers.setResetTimer(this.options.resetMinutes * 60 * 1000, () => {
+            this.log.info('Reset (Finished)');
+            this.sensorHandler.pulseResetMotionSensor();
+            if (this.options.resetOffFlow) {
+                this.resetViaOffMode();
+            }
+            else {
+                this.setCurrentState(this.state.targetState, OriginType.EXTERNAL);
+            }
+        });
+    }
+    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,34 @@
+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';
+import type { TimerManager } from '../timers/timer-manager.js';
+import type { EventBusService } from '../services/event-bus-service.js';
+/**
+ * Handles all mode switches and the pause/extended switches.
+ * Calls StateHandler directly (one-way dependency — no cycle).
+ * Subscribes to bus events emitted by StateHandler to reset its own display state.
+ */
+export declare class SwitchHandler {
+    private readonly services;
+    private readonly state;
+    private readonly options;
+    private readonly Characteristic;
+    private readonly log;
+    private readonly timers;
+    private readonly stateHandler;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, timers: TimerManager, stateHandler: StateHandler);
+    /** Register bus listeners so StateHandler can signal display resets without importing this class. */
+    subscribeToStateEvents(bus: EventBusService): 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;
+    resetModeSwitches(): void;
+    updateModeSwitches(): void;
+    private logArmingLock;
+}

package/dist/handlers/switch-handler.js

@@ -0,0 +1,134 @@
+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';
+import { EventType } from '../types/event-type.js';
+/**
+ * Handles all mode switches and the pause/extended switches.
+ * Calls StateHandler directly (one-way dependency — no cycle).
+ * Subscribes to bus events emitted by StateHandler to reset its own display state.
+ */
+export class SwitchHandler {
+    services;
+    state;
+    options;
+    Characteristic;
+    log;
+    timers;
+    stateHandler;
+    constructor(services, state, options, Characteristic, log, timers, stateHandler) {
+        this.services = services;
+        this.state = state;
+        this.options = options;
+        this.Characteristic = Characteristic;
+        this.log = log;
+        this.timers = timers;
+        this.stateHandler = stateHandler;
+    }
+    /** Register bus listeners so StateHandler can signal display resets without importing this class. */
+    subscribeToStateEvents(bus) {
+        bus.on(EventType.RESET_MODE_SWITCHES, () => this.resetModeSwitches());
+        bus.on(EventType.UPDATE_MODE_SWITCHES, () => this.updateModeSwitches());
+    }
+    // ── 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.timers.setPauseTimer(this.options.pauseMinutes * 60 * 1000, () => {
+                    this.log.info('Mode pause (Finished)');
+                    const prev = this.state.pausedCurrentState ?? this.state.defaultState;
+                    this.stateHandler.updateTargetState(prev, OriginType.INTERNAL, this.stateHandler.getArmingSeconds(prev));
+                });
+            }
+        }
+        else {
+            this.log.info('Mode pause (Cancelled)');
+            this.timers.clearPauseTimer();
+            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;
+    }
+    // ── 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,43 @@
+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 { AudioService } from '../services/audio-service.js';
+import type { SensorHandler } from './sensor-handler.js';
+import type { TimerManager } from '../timers/timer-manager.js';
+/**
+ * Handles the trip switch and trigger-delay logic, including all blocking conditions.
+ * Communicates state transitions back to the state machine via the event bus so that
+ * no circular import is needed with StateHandler.
+ */
+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 readonly timers;
+    private readonly conditions;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, bus: EventBusService, audio: AudioService, sensorHandler: SensorHandler, timers: TimerManager);
+    /**
+     * 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;
+}