homebridge-securitysystem 0.0.1-matter

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

@@ -0,0 +1,49 @@
+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 { SensorHandler } from './sensor-handler.js';
+import type { TimerManager } from '../timers/timer-manager.js';
+import type { ServiceResult } from '../types/service-result-type.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 timers;
+    private readonly sensorHandler;
+    constructor(services: ServiceRegistry, state: SystemState, options: SecuritySystemOptions, Characteristic: CharacteristicConstructor, log: Logging, bus: EventBusService, storageService: StorageService, timers: TimerManager, sensorHandler: SensorHandler);
+    setCurrentState(state: SecurityState, origin: OriginType): void;
+    updateTargetState(state: SecurityState, origin: OriginType, delay: number): ServiceResult;
+    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;
+    /**
+     * Returns a human-readable reason string if `state` is an invalid target,
+     * or `null` if the transition is permitted.
+     */
+    private getBadTargetStateReason;
+    private handleTargetStateChange;
+    private handleCurrentStateChange;
+    private handleTriggeredState;
+    private handleArmingState;
+    private resetViaOffMode;
+}

package/dist/handlers/state-handler.js

@@ -0,0 +1,204 @@
+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;
+    timers;
+    sensorHandler;
+    constructor(services, state, options, Characteristic, log, bus, storageService, timers, sensorHandler) {
+        this.services = services;
+        this.state = state;
+        this.options = options;
+        this.Characteristic = Characteristic;
+        this.log = log;
+        this.bus = bus;
+        this.storageService = storageService;
+        this.timers = timers;
+        this.sensorHandler = sensorHandler;
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    setCurrentState(state, origin) {
+        this.sensorHandler.resetArmingMotionSensor();
+        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) {
+        // Same-target re-call: "confirm this mode externally; apply it now"
+        if (state === this.state.targetState && this.state.currentState !== SecurityState.TRIGGERED) {
+            if (state === this.state.currentState) {
+                return { success: true };
+            }
+            if (this.state.isArming) {
+                this.timers.clearArmTimer();
+                this.state.isArming = false;
+            }
+            this.setCurrentState(state, origin);
+            return { success: true };
+        }
+        const reason = this.getBadTargetStateReason(state);
+        if (reason !== null) {
+            return { success: false, reason };
+        }
+        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 { success: true };
+        }
+        const armSeconds = delay > 0 ? delay : 0;
+        if (armSeconds === 0) {
+            this.setCurrentState(state, origin);
+            return { success: true };
+        }
+        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 { success: 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) {
+        // Locks never block disarming.
+        if (targetState === SecurityState.OFF) {
+            return false;
+        }
+        if (this.state.armingLocks.global) {
+            return true;
+        }
+        const modeMap = {
+            [SecurityState.HOME]: 'home',
+            [SecurityState.AWAY]: 'away',
+            [SecurityState.NIGHT]: 'night',
+        };
+        const lock = modeMap[targetState];
+        return lock ? this.state.armingLocks[lock] : 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 ────────────────────────────────────────────────────────
+    /**
+     * Returns a human-readable reason string if `state` is an invalid target,
+     * or `null` if the transition is permitted.
+     */
+    getBadTargetStateReason(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 'target mode is already set';
+        }
+        if (!this.state.availableTargetStates.includes(state)) {
+            this.log.warn('Target mode (Disabled)');
+            return 'target mode is disabled';
+        }
+        const hasLock = this.options.armingLockSwitch || this.options.armingLockSwitches;
+        if (state !== SecurityState.OFF && hasLock && this.isArmingLocked(state)) {
+            this.log.warn('Arming lock (Not allowed)');
+            return 'arming is blocked by an arming lock switch';
+        }
+        return null;
+    }
+    handleTargetStateChange(origin) {
+        this.resetTimers();
+        // The away-extended flag only applies to the arm cycle it started; any
+        // subsequent target change clears it (mirrors the HAP mode-switch reset).
+        this.state.modeAwayExtended = false;
+        // 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.isTripping = false;
+        this.state.isKnocked = false;
+    }
+    handleCurrentStateChange(origin) {
+        if (this.state.currentState === SecurityState.TRIGGERED) {
+            this.handleTriggeredState();
+            if (this.options.testMode) {
+                return;
+            }
+        }
+        else {
+            // Notify TripHandler to reset trip switches on any non-triggered state change.
+            // (Do not reset when entering TRIGGERED — the trip switch should remain ON
+            // to reflect the active sensor / cause of the alarm.)
+            this.bus.emit(EventType.RESET_TRIP_SWITCHES, {});
+        }
+        this.bus.emit(EventType.CURRENT_CHANGED, { state: this.state.currentState, origin });
+    }
+    handleTriggeredState() {
+        this.timers.clearTrippedInterval();
+        this.sensorHandler.resetTrippedMotionSensor();
+        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,28 @@
+import type { Logging } from 'homebridge';
+import { SecurityState } from '../types/security-state-type.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 { ServiceResult } from '../types/service-result-type.js';
+/**
+ * Handles all mode switches and the pause/extended switches.
+ * Switches are published over Matter only; the HAP layer no longer carries them,
+ * so every method reports outcomes as ServiceResult which MatterService maps to
+ * Matter status errors. The switch display state is pushed to Matter via bus
+ * events handled by MatterService.
+ */
+export declare class SwitchHandler {
+    private readonly state;
+    private readonly options;
+    private readonly log;
+    private readonly timers;
+    private readonly stateHandler;
+    constructor(state: SystemState, options: SecuritySystemOptions, log: Logging, timers: TimerManager, stateHandler: StateHandler);
+    setModeSwitch(mode: SecurityState, value: boolean): ServiceResult;
+    setModeOffSwitch(value: boolean): ServiceResult;
+    setModeAwayExtendedSwitch(value: boolean): ServiceResult;
+    setModePauseSwitch(value: boolean): ServiceResult;
+    updateArmingLock(mode: string, value: boolean): ServiceResult;
+    private logArmingLock;
+}

package/dist/handlers/switch-handler.js

@@ -0,0 +1,95 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { capitalise } from '../utils/state-util.js';
+/**
+ * Handles all mode switches and the pause/extended switches.
+ * Switches are published over Matter only; the HAP layer no longer carries them,
+ * so every method reports outcomes as ServiceResult which MatterService maps to
+ * Matter status errors. The switch display state is pushed to Matter via bus
+ * events handled by MatterService.
+ */
+export class SwitchHandler {
+    state;
+    options;
+    log;
+    timers;
+    stateHandler;
+    constructor(state, options, log, timers, stateHandler) {
+        this.state = state;
+        this.options = options;
+        this.log = log;
+        this.timers = timers;
+        this.stateHandler = stateHandler;
+    }
+    // ── Mode switches ──────────────────────────────────────────────────────────
+    setModeSwitch(mode, value) {
+        if (!value) {
+            return { success: false, reason: 'a mode switch can only be turned on' };
+        }
+        const delay = this.stateHandler.getArmingSeconds(mode);
+        return this.stateHandler.updateTargetState(mode, OriginType.INTERNAL, delay);
+    }
+    setModeOffSwitch(value) {
+        if (!value) {
+            return { success: false, reason: 'a mode switch can only be turned on' };
+        }
+        return this.stateHandler.updateTargetState(SecurityState.OFF, OriginType.INTERNAL, 0);
+    }
+    setModeAwayExtendedSwitch(value) {
+        if (!value) {
+            return { success: false, reason: 'the away-extended switch can only be turned on' };
+        }
+        const delay = this.stateHandler.getArmingSeconds(SecurityState.AWAY);
+        const result = this.stateHandler.updateTargetState(SecurityState.AWAY, OriginType.INTERNAL, delay);
+        if (result.success) {
+            this.state.modeAwayExtended = true;
+        }
+        return result;
+    }
+    setModePauseSwitch(value) {
+        if (this.state.currentState === SecurityState.TRIGGERED) {
+            this.log.warn('Mode pause (Alarm is triggered)');
+            return { success: false, reason: 'mode pause is not allowed while the alarm is triggered' };
+        }
+        if (value) {
+            if (this.state.currentState === SecurityState.OFF) {
+                this.log.warn('Mode pause (Not armed)');
+                return { success: false, reason: 'mode pause is not allowed while disarmed' };
+            }
+            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 { success: true };
+    }
+    // ── Arming lock switches ───────────────────────────────────────────────────
+    updateArmingLock(mode, value) {
+        this.logArmingLock(mode, value);
+        const locks = this.state.armingLocks;
+        const key = ['global', 'home', 'away', 'night']
+            .find(candidate => candidate === mode);
+        if (!key) {
+            this.log.debug(`Unknown arming lock mode (${mode})`);
+            return { success: false, reason: `unknown arming lock mode: ${mode}` };
+        }
+        locks[key] = value;
+        return { success: true };
+    }
+    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,44 @@
+import type { Logging } from 'homebridge';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.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 { SensorHandler } from './sensor-handler.js';
+import type { TimerManager } from '../timers/timer-manager.js';
+import type { ServiceResult } from '../types/service-result-type.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 state;
+    private readonly options;
+    private readonly log;
+    private readonly bus;
+    private readonly sensorHandler;
+    private readonly timers;
+    private readonly conditions;
+    constructor(state: SystemState, options: SecuritySystemOptions, log: Logging, bus: EventBusService, sensorHandler: SensorHandler, timers: TimerManager);
+    /**
+     * Evaluates all blocking conditions for a trip action without side effects.
+     * Returns a failed result with the condition's reason if any condition blocks the action.
+     */
+    checkTripConditions(value: boolean, origin: OriginType): ServiceResult;
+    /**
+     * Core trip-switch logic shared by all trip/trigger paths.
+     * Returns a result object indicating success or the reason for failure.
+     */
+    updateTripSwitch(value: boolean, origin: OriginType, stateChanged: boolean): ServiceResult;
+    /**
+     * 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): ServiceResult;
+    private makeContext;
+    private activateTrip;
+    private startTrippedMotionSensor;
+    private cancelTrip;
+    private resolveTriggerSeconds;
+}

package/dist/handlers/trip-handler.js

@@ -0,0 +1,156 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { EventType } from '../types/event-type.js';
+import { NotArmedCondition } from '../conditions/not-armed-condition.js';
+import { ArmingInProgressCondition } from '../conditions/arming-in-progress-condition.js';
+import { AlreadyTriggeredCondition } from '../conditions/already-triggered-condition.js';
+import { DoubleKnockCondition } from '../conditions/double-knock-condition.js';
+import { TriggerAlreadyRunningCondition } from '../conditions/trigger-already-running-condition.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 class TripHandler {
+    state;
+    options;
+    log;
+    bus;
+    sensorHandler;
+    timers;
+    conditions;
+    constructor(state, options, log, bus, sensorHandler, timers) {
+        this.state = state;
+        this.options = options;
+        this.log = log;
+        this.bus = bus;
+        this.sensorHandler = sensorHandler;
+        this.timers = timers;
+        const doubleKnock = new DoubleKnockCondition((seconds, onExpire) => {
+            this.timers.setDoubleKnockTimer(seconds * 1000, onExpire);
+        }, () => {
+            this.timers.clearDoubleKnockTimer();
+        });
+        this.conditions = [
+            new NotArmedCondition(),
+            new ArmingInProgressCondition(),
+            doubleKnock,
+            new AlreadyTriggeredCondition(),
+            new TriggerAlreadyRunningCondition(),
+        ];
+    }
+    /**
+     * Evaluates all blocking conditions for a trip action without side effects.
+     * Returns a failed result with the condition's reason if any condition blocks the action.
+     */
+    checkTripConditions(value, origin) {
+        if (!value) {
+            return { success: true };
+        }
+        const ctx = this.makeContext(value, origin);
+        for (const condition of this.conditions) {
+            if (condition.evaluate(ctx)) {
+                return { success: false, reason: condition.failureReason };
+            }
+        }
+        return { success: true };
+    }
+    /**
+     * Core trip-switch logic shared by all trip/trigger paths.
+     * Returns a result object indicating success or the reason for failure.
+     */
+    updateTripSwitch(value, origin, stateChanged) {
+        if (value) {
+            const conditionResult = this.checkTripConditions(value, origin);
+            if (!conditionResult.success) {
+                return conditionResult;
+            }
+            this.activateTrip(origin);
+        }
+        else {
+            this.cancelTrip(origin, stateChanged);
+        }
+        // Sync trip switch characteristic when origin is not a direct switch press.
+        return { success: true };
+    }
+    /**
+     * 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, value) {
+        const isTriggered = this.state.currentState === SecurityState.TRIGGERED;
+        if (value) {
+            const modeMatches = this.state.currentState === requiredState
+                || (isTriggered && this.state.targetState === requiredState);
+            if (!modeMatches) {
+                this.log.debug('Security System (Trip mode not set)');
+                return { success: false, reason: 'mode not set' };
+            }
+        }
+        return this.updateTripSwitch(value, OriginType.REGULAR_SWITCH, false);
+    }
+    makeContext(value, origin) {
+        return {
+            state: this.state,
+            options: this.options,
+            value,
+            origin,
+            log: this.log,
+        };
+    }
+    activateTrip(origin) {
+        this.log.info('Security System (Tripped)');
+        if (this.options.trippedMotionSensor) {
+            this.startTrippedMotionSensor();
+        }
+        const triggerSeconds = this.resolveTriggerSeconds();
+        this.log.debug(`Trigger delay (${triggerSeconds}s)`);
+        this.state.isTripping = true;
+        this.timers.setTriggerTimer(triggerSeconds * 1000, () => {
+            this.state.isTripping = false;
+            this.bus.emit(EventType.TRIGGER_FIRED, { origin });
+        });
+        if (triggerSeconds > 0) {
+            this.bus.emit(EventType.WARNING, { origin, triggerSeconds });
+        }
+    }
+    startTrippedMotionSensor() {
+        const seconds = this.options.trippedMotionSensorSeconds;
+        if (seconds === 0) {
+            this.sensorHandler.setTrippedMotionSensor(true);
+        }
+        else {
+            this.sensorHandler.pulseTrippedMotionSensor();
+            this.timers.setTrippedInterval(seconds * 1000, () => this.sensorHandler.pulseTrippedMotionSensor());
+        }
+    }
+    cancelTrip(origin, stateChanged) {
+        this.log.info('Security System (Cancelled)');
+        this.state.isTripping = false;
+        this.bus.emit(EventType.TRIP_CANCELLED, { origin, stateChanged });
+        if (this.options.trippedMotionSensor) {
+            this.sensorHandler.resetTrippedMotionSensor();
+        }
+        this.state.isKnocked = false;
+    }
+    resolveTriggerSeconds() {
+        const seconds = this.options.triggerSeconds;
+        const cur = this.state.currentState;
+        if (cur === SecurityState.HOME && this.options.homeTriggerSeconds !== null) {
+            return this.options.homeTriggerSeconds;
+        }
+        if (cur === SecurityState.AWAY) {
+            if (this.options.modeAwayExtendedSwitchTriggerSeconds !== null && this.state.modeAwayExtended) {
+                return this.options.modeAwayExtendedSwitchTriggerSeconds;
+            }
+            if (this.options.awayTriggerSeconds !== null) {
+                return this.options.awayTriggerSeconds;
+            }
+        }
+        if (cur === SecurityState.NIGHT && this.options.nightTriggerSeconds !== null) {
+            return this.options.nightTriggerSeconds;
+        }
+        return seconds;
+    }
+}
+//# sourceMappingURL=trip-handler.js.map

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

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

package/dist/homekit/homekit-registrar.d.ts

@@ -0,0 +1,12 @@
+import type { CharacteristicConstructor } from '../interfaces/hap-types-interface.js';
+import type { ServiceRegistry } from '../interfaces/service-registry-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+import type { StateHandler } from '../handlers/state-handler.js';
+/** Attaches the HomeKit characteristic handlers (onGet / onSet) to the security system service. */
+export declare class HomeKitRegistrar {
+    private readonly svcs;
+    private readonly state;
+    private readonly stateHandler;
+    constructor(svcs: ServiceRegistry, state: SystemState, stateHandler: StateHandler);
+    register(Char: CharacteristicConstructor): void;
+}

package/dist/homekit/homekit-registrar.js

@@ -0,0 +1,23 @@
+import { OriginType } from '../types/origin-type.js';
+/** Attaches the HomeKit characteristic handlers (onGet / onSet) to the security system service. */
+export class HomeKitRegistrar {
+    svcs;
+    state;
+    stateHandler;
+    constructor(svcs, state, stateHandler) {
+        this.svcs = svcs;
+        this.state = state;
+        this.stateHandler = stateHandler;
+    }
+    register(Char) {
+        const s = this.svcs;
+        s.mainService.getCharacteristic(Char.SecuritySystemCurrentState)
+            .onGet(async () => this.state.currentState);
+        s.mainService.getCharacteristic(Char.SecuritySystemTargetState)
+            .onGet(async () => this.state.targetState)
+            .onSet(async (v) => {
+            this.stateHandler.updateTargetState(v, OriginType.REGULAR_SWITCH, this.stateHandler.getArmingSeconds(v));
+        });
+    }
+}
+//# sourceMappingURL=homekit-registrar.js.map

package/dist/homekit/homekit-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"homekit-registrar.js","sourceRoot":"","sources":["../../src/homekit/homekit-registrar.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,mGAAmG;AACnG,MAAM,OAAO,gBAAgB;IAER,IAAI;IACJ,KAAK;IACL,YAAY;IAH/B,YACmB,IAAqB,EACrB,KAAkB,EAClB,YAA0B;oBAF1B,IAAI;qBACJ,KAAK;4BACL,YAAY;IAC5B,CAAC;IAEJ,QAAQ,CAAC,IAA+B;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAEpB,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,0BAA0B,CAAC;aAC7D,KAAK,CAAC,KAAK,IAAkC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5E,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,yBAAyB,CAAC;aAC5D,KAAK,CAAC,KAAK,IAAkC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;aACvE,KAAK,CAAC,KAAK,EAAE,CAAsB,EAAE,EAAE;YACtC,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAkB,EAAE,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAkB,CAAC,CAAC,CAAC;QAC7I,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}