homebridge-securitysystem 0.0.1-matter

package/dist/conditions/already-triggered-condition.d.ts

@@ -0,0 +1,10 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a new trip activation when the alarm has already been triggered.
+ * Prevents stacking multiple trigger events on an active alarm.
+ */
+export declare class AlreadyTriggeredCondition extends Condition {
+    readonly name = "already-triggered";
+    evaluate({ state, value, log }: ConditionContext): boolean;
+}

package/dist/conditions/already-triggered-condition.js

@@ -0,0 +1,22 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a new trip activation when the alarm has already been triggered.
+ * Prevents stacking multiple trigger events on an active alarm.
+ */
+export class AlreadyTriggeredCondition extends Condition {
+    name = 'already-triggered';
+    evaluate({ state, value, log }) {
+        this.clearFailureReason();
+        if (!value) {
+            return false;
+        }
+        const blocked = state.currentState === SecurityState.TRIGGERED;
+        if (blocked) {
+            this._failureReason = 'Security System (Already triggered): alarm is already active';
+            log.warn(this._failureReason);
+        }
+        return blocked;
+    }
+}
+//# sourceMappingURL=already-triggered-condition.js.map

package/dist/conditions/already-triggered-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"already-triggered-condition.js","sourceRoot":"","sources":["../../src/conditions/already-triggered-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAC7C,IAAI,GAAG,mBAAmB,CAAC;IAEpC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAoB;QAC9C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,KAAK,aAAa,CAAC,SAAS,CAAC;QAC/D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,GAAG,8DAA8D,CAAC;YACrF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/conditions/arming-in-progress-condition.d.ts

@@ -0,0 +1,10 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip action while the arm delay countdown is still running.
+ * Prevents an intruder from tripping the system before it has fully armed.
+ */
+export declare class ArmingInProgressCondition extends Condition {
+    readonly name = "arming-in-progress";
+    evaluate({ state, value, log }: ConditionContext): boolean;
+}

package/dist/conditions/arming-in-progress-condition.js

@@ -0,0 +1,21 @@
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip action while the arm delay countdown is still running.
+ * Prevents an intruder from tripping the system before it has fully armed.
+ */
+export class ArmingInProgressCondition extends Condition {
+    name = 'arming-in-progress';
+    evaluate({ state, value, log }) {
+        this.clearFailureReason();
+        if (!value) {
+            return false;
+        }
+        if (state.isArming) {
+            this._failureReason = 'Trip Switch (Still arming): arm delay countdown is still in progress';
+            log.warn(this._failureReason);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=arming-in-progress-condition.js.map

package/dist/conditions/arming-in-progress-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arming-in-progress-condition.js","sourceRoot":"","sources":["../../src/conditions/arming-in-progress-condition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAC7C,IAAI,GAAG,oBAAoB,CAAC;IAErC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAoB;QAC9C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,cAAc,GAAG,sEAAsE,CAAC;YAC7F,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/conditions/arming-lock-condition.d.ts

@@ -0,0 +1,10 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks arming when an arming-lock switch (global or mode-specific) is active.
+ * Does NOT block disarming.
+ */
+export declare class ArmingLockCondition extends Condition {
+    readonly name = "arming-lock";
+    evaluate({ state, options }: ConditionContext): boolean;
+}

package/dist/conditions/arming-lock-condition.js

@@ -0,0 +1,43 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks arming when an arming-lock switch (global or mode-specific) is active.
+ * Does NOT block disarming.
+ */
+export class ArmingLockCondition extends Condition {
+    name = 'arming-lock';
+    evaluate({ state, options }) {
+        this.clearFailureReason();
+        const hasLockFeature = options.armingLockSwitch || options.armingLockSwitches;
+        if (!hasLockFeature) {
+            return false;
+        }
+        const targetState = state.targetState;
+        if (targetState === SecurityState.OFF) {
+            return false;
+        }
+        // Check global arming-lock switch.
+        if (state.armingLocks.global) {
+            this._failureReason = 'arming is blocked by the global arming lock switch';
+            return true;
+        }
+        // Check mode-specific arming-lock switch.
+        let blocked = false;
+        switch (targetState) {
+            case SecurityState.HOME:
+                blocked = state.armingLocks.home;
+                break;
+            case SecurityState.AWAY:
+                blocked = state.armingLocks.away;
+                break;
+            case SecurityState.NIGHT:
+                blocked = state.armingLocks.night;
+                break;
+        }
+        if (blocked) {
+            this._failureReason = 'arming is blocked by a mode-specific arming lock switch';
+        }
+        return blocked;
+    }
+}
+//# sourceMappingURL=arming-lock-condition.js.map

package/dist/conditions/arming-lock-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arming-lock-condition.js","sourceRoot":"","sources":["../../src/conditions/arming-lock-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACvC,IAAI,GAAG,aAAa,CAAC;IAE9B,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAoB;QAC3C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;QAC9E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACtC,IAAI,WAAW,KAAK,aAAa,CAAC,GAAG,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mCAAmC;QACnC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,cAAc,GAAG,oDAAoD,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,QAAQ,WAAW,EAAE,CAAC;YACtB,KAAK,aAAa,CAAC,IAAI;gBACrB,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;gBACjC,MAAM;YACR,KAAK,aAAa,CAAC,IAAI;gBACrB,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;gBACjC,MAAM;YACR,KAAK,aAAa,CAAC,KAAK;gBACtB,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC;gBAClC,MAAM;QACR,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,GAAG,yDAAyD,CAAC;QAClF,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/conditions/condition.d.ts

@@ -0,0 +1,22 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+/**
+ * Base class for all conditions that can block a trip/trigger action.
+ *
+ * Extend this class and implement `evaluate()` to return `true` when the
+ * condition should prevent the action from proceeding. Set `_failureReason`
+ * before returning `true` so callers can retrieve it via `failureReason`.
+ */
+export declare abstract class Condition {
+    abstract readonly name: string;
+    protected _failureReason: string | undefined;
+    /** Returns the reason the condition blocked the last evaluated action, if any. */
+    get failureReason(): string | undefined;
+    /** Must be called at the top of every evaluate() implementation to clear any stale reason. */
+    protected clearFailureReason(): void;
+    /**
+     * Returns `true` if this condition blocks the action described by `context`.
+     * When `true` is returned the caller must reject the HomeKit request.
+     * Implementations must call `this.clearFailureReason()` before any allow/deny logic.
+     */
+    abstract evaluate(context: ConditionContext): boolean;
+}

package/dist/conditions/condition.js

@@ -0,0 +1,19 @@
+/**
+ * Base class for all conditions that can block a trip/trigger action.
+ *
+ * Extend this class and implement `evaluate()` to return `true` when the
+ * condition should prevent the action from proceeding. Set `_failureReason`
+ * before returning `true` so callers can retrieve it via `failureReason`.
+ */
+export class Condition {
+    _failureReason;
+    /** Returns the reason the condition blocked the last evaluated action, if any. */
+    get failureReason() {
+        return this._failureReason;
+    }
+    /** Must be called at the top of every evaluate() implementation to clear any stale reason. */
+    clearFailureReason() {
+        this._failureReason = undefined;
+    }
+}
+//# sourceMappingURL=condition.js.map

package/dist/conditions/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/conditions/condition.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAgB,SAAS;IAGnB,cAAc,CAAqB;IAE7C,kFAAkF;IAClF,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,8FAA8F;IACpF,kBAAkB;QAC1B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;CAQF"}

package/dist/conditions/double-knock-condition.d.ts

@@ -0,0 +1,24 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Implements the double-knock pattern: the first activation within a mode that
+ * has double-knock enabled sets a "knocked" flag and rejects the trip. Only the
+ * second activation within the configured window proceeds.
+ *
+ * The caller is responsible for managing `state.isKnocked` and the timeout
+ * via the `onFirstKnock` callback injected at construction.
+ */
+export declare class DoubleKnockCondition extends Condition {
+    private readonly onFirstKnock;
+    private readonly onCancelTimer;
+    readonly name = "double-knock";
+    /**
+     * @param onFirstKnock Called when the first knock is detected.
+     *   The callback receives the window duration in seconds and a reset function
+     *   to invoke when the window expires.
+     * @param onCancelTimer Called on the second knock to cancel the running window timer.
+     */
+    constructor(onFirstKnock: (seconds: number, onExpire: () => void) => void, onCancelTimer: () => void);
+    evaluate({ state, options, value, origin, log }: ConditionContext): boolean;
+    private resolveWindow;
+}

package/dist/conditions/double-knock-condition.js

@@ -0,0 +1,73 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { modeToState } from '../utils/state-util.js';
+import { Condition } from './condition.js';
+/**
+ * Implements the double-knock pattern: the first activation within a mode that
+ * has double-knock enabled sets a "knocked" flag and rejects the trip. Only the
+ * second activation within the configured window proceeds.
+ *
+ * The caller is responsible for managing `state.isKnocked` and the timeout
+ * via the `onFirstKnock` callback injected at construction.
+ */
+export class DoubleKnockCondition extends Condition {
+    onFirstKnock;
+    onCancelTimer;
+    name = 'double-knock';
+    /**
+     * @param onFirstKnock Called when the first knock is detected.
+     *   The callback receives the window duration in seconds and a reset function
+     *   to invoke when the window expires.
+     * @param onCancelTimer Called on the second knock to cancel the running window timer.
+     */
+    constructor(onFirstKnock, onCancelTimer) {
+        super();
+        this.onFirstKnock = onFirstKnock;
+        this.onCancelTimer = onCancelTimer;
+    }
+    evaluate({ state, options, value, origin, log }) {
+        this.clearFailureReason();
+        if (!value || !options.doubleKnock) {
+            return false;
+        }
+        if (origin === OriginType.OVERRIDE_SWITCH) {
+            return false;
+        }
+        if (state.isArming) {
+            return false;
+        }
+        const knockableStates = options.doubleKnockModes.map(m => modeToState(m.toLowerCase()));
+        if (!knockableStates.includes(state.currentState)) {
+            return false;
+        }
+        if (state.isKnocked) {
+            // Second knock — clear the flag and cancel the window timer, then allow through.
+            state.isKnocked = false;
+            this.onCancelTimer();
+            return false;
+        }
+        // First knock — block and schedule expiry.
+        state.isKnocked = true;
+        const seconds = this.resolveWindow(state.currentState, options);
+        this.onFirstKnock(seconds, () => {
+            state.isKnocked = false;
+            log.info('Trip Switch (Reset): double-knock window expired without second activation');
+        });
+        this._failureReason = 'Trip Switch (Knock): double-knock is required, waiting for second activation';
+        log.warn(this._failureReason);
+        return true;
+    }
+    resolveWindow(currentState, options) {
+        if (currentState === SecurityState.HOME && options.homeDoubleKnockSeconds !== null) {
+            return options.homeDoubleKnockSeconds;
+        }
+        if (currentState === SecurityState.AWAY && options.awayDoubleKnockSeconds !== null) {
+            return options.awayDoubleKnockSeconds;
+        }
+        if (currentState === SecurityState.NIGHT && options.nightDoubleKnockSeconds !== null) {
+            return options.nightDoubleKnockSeconds;
+        }
+        return options.doubleKnockSeconds;
+    }
+}
+//# sourceMappingURL=double-knock-condition.js.map

package/dist/conditions/double-knock-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-knock-condition.js","sourceRoot":"","sources":["../../src/conditions/double-knock-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAU9B,YAAY;IACZ,aAAa;IAVvB,IAAI,GAAG,cAAc,CAAC;IAE/B;;;;;OAKG;IACH,YACmB,YAA6D,EAC7D,aAAyB;QAE1C,KAAK,EAAE,CAAC;4BAHS,YAAY;6BACZ,aAAa;IAGhC,CAAC;IAED,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAoB;QAC/D,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,iFAAiF;YACjF,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,2CAA2C;QAC3C,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE;YAC9B,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,8EAA8E,CAAC;QACrG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa,CACnB,YAA2B,EAC3B,OAAoC;QAEpC,IAAI,YAAY,KAAK,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;YACnF,OAAO,OAAO,CAAC,sBAAsB,CAAC;QACxC,CAAC;QACD,IAAI,YAAY,KAAK,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;YACnF,OAAO,OAAO,CAAC,sBAAsB,CAAC;QACxC,CAAC;QACD,IAAI,YAAY,KAAK,aAAa,CAAC,KAAK,IAAI,OAAO,CAAC,uBAAuB,KAAK,IAAI,EAAE,CAAC;YACrF,OAAO,OAAO,CAAC,uBAAuB,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC,kBAAkB,CAAC;IACpC,CAAC;CACF"}

package/dist/conditions/not-armed-condition.d.ts

@@ -0,0 +1,10 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip action when the system is disarmed and neither
+ * `override_off` nor the override switch is in use.
+ */
+export declare class NotArmedCondition extends Condition {
+    readonly name = "not-armed";
+    evaluate({ state, options, value, origin, log }: ConditionContext): boolean;
+}

package/dist/conditions/not-armed-condition.js

@@ -0,0 +1,26 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip action when the system is disarmed and neither
+ * `override_off` nor the override switch is in use.
+ */
+export class NotArmedCondition extends Condition {
+    name = 'not-armed';
+    evaluate({ state, options, value, origin, log }) {
+        this.clearFailureReason();
+        if (!value) {
+            return false;
+        }
+        const isDisarmed = state.currentState === SecurityState.OFF;
+        const isNotOverridingOff = !options.overrideOff;
+        const isNotOverrideSwitch = origin !== OriginType.OVERRIDE_SWITCH;
+        const blocked = isDisarmed && isNotOverridingOff && isNotOverrideSwitch;
+        if (blocked) {
+            this._failureReason = 'Trip Switch (Not armed): system is disarmed and override is not enabled';
+            log.warn(this._failureReason);
+        }
+        return blocked;
+    }
+}
+//# sourceMappingURL=not-armed-condition.js.map

package/dist/conditions/not-armed-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-armed-condition.js","sourceRoot":"","sources":["../../src/conditions/not-armed-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACrC,IAAI,GAAG,WAAW,CAAC;IAE5B,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAoB;QAC/D,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,KAAK,aAAa,CAAC,GAAG,CAAC;QAC5D,MAAM,kBAAkB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC;QAChD,MAAM,mBAAmB,GAAG,MAAM,KAAK,UAAU,CAAC,eAAe,CAAC;QAElE,MAAM,OAAO,GAAG,UAAU,IAAI,kBAAkB,IAAI,mBAAmB,CAAC;QACxE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,GAAG,yEAAyE,CAAC;YAChG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/conditions/trigger-already-running-condition.d.ts

@@ -0,0 +1,10 @@
+import type { ConditionContext } from '../interfaces/condition-context-interface.js';
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip activation when the trigger-delay countdown is already running.
+ * Prevents stacking multiple trigger events during the pre-alarm window.
+ */
+export declare class TriggerAlreadyRunningCondition extends Condition {
+    readonly name = "trigger-already-running";
+    evaluate({ state, value, log }: ConditionContext): boolean;
+}

package/dist/conditions/trigger-already-running-condition.js

@@ -0,0 +1,21 @@
+import { Condition } from './condition.js';
+/**
+ * Blocks a trip activation when the trigger-delay countdown is already running.
+ * Prevents stacking multiple trigger events during the pre-alarm window.
+ */
+export class TriggerAlreadyRunningCondition extends Condition {
+    name = 'trigger-already-running';
+    evaluate({ state, value, log }) {
+        this.clearFailureReason();
+        if (!value) {
+            return false;
+        }
+        if (state.isTripping) {
+            this._failureReason = 'Security System (Already tripped): trigger delay countdown is already running';
+            log.warn(this._failureReason);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=trigger-already-running-condition.js.map

package/dist/conditions/trigger-already-running-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-already-running-condition.js","sourceRoot":"","sources":["../../src/conditions/trigger-already-running-condition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,8BAA+B,SAAQ,SAAS;IAClD,IAAI,GAAG,yBAAyB,CAAC;IAE1C,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAoB;QAC9C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,cAAc,GAAG,+EAA+E,CAAC;YACtG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/constants/default-constant.d.ts

@@ -0,0 +1,24 @@
+/** Default configuration values applied when a config property is not set. */
+export declare const DEFAULTS: {
+    readonly NAME: 'Security System';
+    readonly SERIAL_NUMBER: 'S3CUR1TYSYST3M';
+    readonly DEFAULT_MODE: 'off';
+    readonly ARM_SECONDS: 0;
+    readonly TRIGGER_SECONDS: 0;
+    readonly RESET_MINUTES: 10;
+    readonly DOUBLE_KNOCK_SECONDS: 90;
+    readonly TRIPPED_SENSOR_SECONDS: 5;
+    readonly PAUSE_MINUTES: 0;
+    readonly TRIP_SWITCH_NAME: 'Trip';
+    readonly TRIP_HOME_SWITCH_NAME: 'Trip Home';
+    readonly TRIP_AWAY_SWITCH_NAME: 'Trip Away';
+    readonly TRIP_NIGHT_SWITCH_NAME: 'Trip Night';
+    readonly TRIP_OVERRIDE_SWITCH_NAME: 'Trip Override';
+    readonly MODE_HOME_SWITCH_NAME: 'Mode Home';
+    readonly MODE_AWAY_SWITCH_NAME: 'Mode Away';
+    readonly MODE_NIGHT_SWITCH_NAME: 'Mode Night';
+    readonly MODE_OFF_SWITCH_NAME: 'Mode Off';
+    readonly MODE_AWAY_EXTENDED_SWITCH_NAME: 'Mode Away Extended';
+    readonly MODE_PAUSE_SWITCH_NAME: 'Mode Pause';
+    readonly MQTT_TOPIC: 'security-system/state';
+};

package/dist/constants/default-constant.js

@@ -0,0 +1,27 @@
+/** Default configuration values applied when a config property is not set. */
+export const DEFAULTS = {
+    NAME: 'Security System',
+    SERIAL_NUMBER: 'S3CUR1TYSYST3M',
+    DEFAULT_MODE: 'off',
+    ARM_SECONDS: 0,
+    TRIGGER_SECONDS: 0,
+    RESET_MINUTES: 10,
+    DOUBLE_KNOCK_SECONDS: 90,
+    TRIPPED_SENSOR_SECONDS: 5,
+    PAUSE_MINUTES: 0,
+    // Switch display names
+    TRIP_SWITCH_NAME: 'Trip',
+    TRIP_HOME_SWITCH_NAME: 'Trip Home',
+    TRIP_AWAY_SWITCH_NAME: 'Trip Away',
+    TRIP_NIGHT_SWITCH_NAME: 'Trip Night',
+    TRIP_OVERRIDE_SWITCH_NAME: 'Trip Override',
+    MODE_HOME_SWITCH_NAME: 'Mode Home',
+    MODE_AWAY_SWITCH_NAME: 'Mode Away',
+    MODE_NIGHT_SWITCH_NAME: 'Mode Night',
+    MODE_OFF_SWITCH_NAME: 'Mode Off',
+    MODE_AWAY_EXTENDED_SWITCH_NAME: 'Mode Away Extended',
+    MODE_PAUSE_SWITCH_NAME: 'Mode Pause',
+    // MQTT
+    MQTT_TOPIC: 'security-system/state',
+};
+//# sourceMappingURL=default-constant.js.map

package/dist/constants/default-constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-constant.js","sourceRoot":"","sources":["../../src/constants/default-constant.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,iBAAiB;IACvB,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,EAAE;IACjB,oBAAoB,EAAE,EAAE;IACxB,sBAAsB,EAAE,CAAC;IACzB,aAAa,EAAE,CAAC;IAEhB,uBAAuB;IACvB,gBAAgB,EAAE,MAAM;IACxB,qBAAqB,EAAE,WAAW;IAClC,qBAAqB,EAAE,WAAW;IAClC,sBAAsB,EAAE,YAAY;IACpC,yBAAyB,EAAE,eAAe;IAC1C,qBAAqB,EAAE,WAAW;IAClC,qBAAqB,EAAE,WAAW;IAClC,sBAAsB,EAAE,YAAY;IACpC,oBAAoB,EAAE,UAAU;IAChC,8BAA8B,EAAE,oBAAoB;IACpD,sBAAsB,EAAE,YAAY;IAEpC,OAAO;IACP,UAAU,EAAE,uBAAuB;CAC3B,CAAC"}

package/dist/constants/homekit-constant.d.ts

@@ -0,0 +1,2 @@
+/** Pulse duration in ms used by motion sensors to emit a brief motion event. */
+export declare const SENSOR_PULSE_MS = 750;

package/dist/constants/homekit-constant.js

@@ -0,0 +1,3 @@
+/** Pulse duration in ms used by motion sensors to emit a brief motion event. */
+export const SENSOR_PULSE_MS = 750;
+//# sourceMappingURL=homekit-constant.js.map

package/dist/constants/homekit-constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"homekit-constant.js","sourceRoot":"","sources":["../../src/constants/homekit-constant.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC"}

package/dist/constants/matter-constant.d.ts

@@ -0,0 +1,21 @@
+import type { FixedMatterSwitchKey } from '../types/matter-accessory-key-type.js';
+import type { SensorKind } from '../types/sensor-kind-type.js';
+/**
+ * Stable device-type-indexed identity for every fixed switch, following the
+ * Matter convention of `<device-type>-<index>` (e.g. `motion-sensor-1`).
+ * The index comes from the fixed slot, so disabling an accessory never
+ * renumbers the others.
+ */
+export declare const MATTER_SWITCH_IDENTITIES: Record<FixedMatterSwitchKey, string>;
+/** The first index available for custom trip switches. */
+export declare const MATTER_CUSTOM_TRIP_START_INDEX = 16;
+/** Stable device-type-indexed identity for each motion sensor. */
+export declare const MATTER_SENSOR_IDENTITIES: Record<SensorKind, string>;
+/** All mode-switch keys, used to push their displayed state to Matter. */
+export declare const MATTER_MODE_SWITCH_KEYS: readonly ["mode-home", "mode-away", "mode-night", "mode-off", "mode-away-extended", "mode-pause"];
+/** All trip-switch keys, used to push their displayed state to Matter. */
+export declare const MATTER_TRIP_SWITCH_KEYS: readonly ["trip", "trip-home", "trip-away", "trip-night", "trip-override"];
+/** All arming-lock switch keys, used to push their displayed state to Matter. */
+export declare const MATTER_ARMING_LOCK_SWITCH_KEYS: readonly ["arming-lock", "arming-lock-home", "arming-lock-away", "arming-lock-night"];
+export declare const MATTER_MANUFACTURER = "MiguelRipoll23";
+export declare const MATTER_MODEL = "Security System (Matter)";

package/dist/constants/matter-constant.js

@@ -0,0 +1,61 @@
+/**
+ * Stable device-type-indexed identity for every fixed switch, following the
+ * Matter convention of `<device-type>-<index>` (e.g. `motion-sensor-1`).
+ * The index comes from the fixed slot, so disabling an accessory never
+ * renumbers the others.
+ */
+export const MATTER_SWITCH_IDENTITIES = {
+    // Trip switches
+    trip: 'switch-1',
+    'trip-home': 'switch-2',
+    'trip-away': 'switch-3',
+    'trip-night': 'switch-4',
+    'trip-override': 'switch-5',
+    // Mode switches
+    'mode-home': 'switch-6',
+    'mode-away': 'switch-7',
+    'mode-night': 'switch-8',
+    'mode-off': 'switch-9',
+    'mode-away-extended': 'switch-10',
+    'mode-pause': 'switch-11',
+    // Arming lock switches
+    'arming-lock': 'switch-12',
+    'arming-lock-home': 'switch-13',
+    'arming-lock-away': 'switch-14',
+    'arming-lock-night': 'switch-15',
+};
+/** The first index available for custom trip switches. */
+export const MATTER_CUSTOM_TRIP_START_INDEX = 16;
+/** Stable device-type-indexed identity for each motion sensor. */
+export const MATTER_SENSOR_IDENTITIES = {
+    arming: 'motion-sensor-1',
+    tripped: 'motion-sensor-2',
+    reset: 'motion-sensor-3',
+};
+/** All mode-switch keys, used to push their displayed state to Matter. */
+export const MATTER_MODE_SWITCH_KEYS = [
+    'mode-home',
+    'mode-away',
+    'mode-night',
+    'mode-off',
+    'mode-away-extended',
+    'mode-pause',
+];
+/** All trip-switch keys, used to push their displayed state to Matter. */
+export const MATTER_TRIP_SWITCH_KEYS = [
+    'trip',
+    'trip-home',
+    'trip-away',
+    'trip-night',
+    'trip-override',
+];
+/** All arming-lock switch keys, used to push their displayed state to Matter. */
+export const MATTER_ARMING_LOCK_SWITCH_KEYS = [
+    'arming-lock',
+    'arming-lock-home',
+    'arming-lock-away',
+    'arming-lock-night',
+];
+export const MATTER_MANUFACTURER = 'MiguelRipoll23';
+export const MATTER_MODEL = 'Security System (Matter)';
+//# sourceMappingURL=matter-constant.js.map

package/dist/constants/matter-constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matter-constant.js","sourceRoot":"","sources":["../../src/constants/matter-constant.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAyC;IAC5E,gBAAgB;IAChB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,eAAe,EAAE,UAAU;IAC3B,gBAAgB;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,UAAU;IACtB,oBAAoB,EAAE,WAAW;IACjC,YAAY,EAAE,WAAW;IACzB,uBAAuB;IACvB,aAAa,EAAE,WAAW;IAC1B,kBAAkB,EAAE,WAAW;IAC/B,kBAAkB,EAAE,WAAW;IAC/B,mBAAmB,EAAE,WAAW;CACjC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,kEAAkE;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAA+B;IAClE,MAAM,EAAE,iBAAiB;IACzB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,iBAAiB;CACzB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW;IACX,WAAW;IACX,YAAY;IACZ,UAAU;IACV,oBAAoB;IACpB,YAAY;CACoC,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,WAAW;IACX,WAAW;IACX,YAAY;IACZ,eAAe;CACiC,CAAC;AAEnD,iFAAiF;AACjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;CAC6B,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { Logging } from 'homebridge';
+import type { EventBusService } from '../services/event-bus-service.js';
+import type { SensorKind } from '../types/sensor-kind-type.js';
+/**
+ * Owns the current state of every motion sensor and publishes changes over the
+ * bus (SENSOR_STATE_CHANGED), which MatterService pushes to Matter. Sensors are
+ * Matter-only, so no HomeKit characteristics are touched here.
+ */
+export declare class SensorHandler {
+    private readonly log;
+    private readonly bus;
+    private readonly currentValueByKind;
+    constructor(log: Logging, bus: EventBusService);
+    updateArmingMotionSensor(value: boolean): void;
+    resetArmingMotionSensor(): void;
+    pulseTrippedMotionSensor(): void;
+    setTrippedMotionSensor(value: boolean): void;
+    resetTrippedMotionSensor(): void;
+    pulseResetMotionSensor(): void;
+    /** Returns the current value of the given sensor, for Matter startup sync. */
+    getMotionState(kind: SensorKind): boolean;
+    private setSensorValue;
+    private scheduleReset;
+}

package/dist/handlers/sensor-handler.js

@@ -0,0 +1,63 @@
+import { SENSOR_PULSE_MS } from '../constants/homekit-constant.js';
+import { EventType } from '../types/event-type.js';
+/**
+ * Owns the current state of every motion sensor and publishes changes over the
+ * bus (SENSOR_STATE_CHANGED), which MatterService pushes to Matter. Sensors are
+ * Matter-only, so no HomeKit characteristics are touched here.
+ */
+export class SensorHandler {
+    log;
+    bus;
+    currentValueByKind = {
+        arming: false,
+        tripped: false,
+        reset: false,
+    };
+    constructor(log, bus) {
+        this.log = log;
+        this.bus = bus;
+    }
+    // ── Arming sensor ──────────────────────────────────────────────────────────
+    updateArmingMotionSensor(value) {
+        this.setSensorValue('arming', value);
+    }
+    resetArmingMotionSensor() {
+        if (this.currentValueByKind.arming) {
+            this.setSensorValue('arming', false);
+        }
+    }
+    // ── Tripped sensor ─────────────────────────────────────────────────────────
+    pulseTrippedMotionSensor() {
+        this.setTrippedMotionSensor(true);
+        this.scheduleReset('tripped');
+    }
+    setTrippedMotionSensor(value) {
+        this.setSensorValue('tripped', value);
+    }
+    resetTrippedMotionSensor() {
+        if (this.currentValueByKind.tripped) {
+            this.setSensorValue('tripped', false);
+        }
+    }
+    // ── Reset sensor ───────────────────────────────────────────────────────────
+    pulseResetMotionSensor() {
+        this.setSensorValue('reset', true);
+        this.scheduleReset('reset');
+        this.log.debug('Reset sensor (Triggered)');
+    }
+    /** Returns the current value of the given sensor, for Matter startup sync. */
+    getMotionState(kind) {
+        return this.currentValueByKind[kind];
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    setSensorValue(kind, value) {
+        this.currentValueByKind[kind] = value;
+        this.bus.emit(EventType.SENSOR_STATE_CHANGED, { sensor: kind, value });
+    }
+    scheduleReset(kind) {
+        setTimeout(() => {
+            this.setSensorValue(kind, 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;AAEnE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAQL,GAAG;IACH,GAAG;IARL,kBAAkB,GAAgC;QACjE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK;KACb,CAAC;IAEF,YACmB,GAAY,EACZ,GAAoB;mBADpB,GAAG;mBACH,GAAG;IACnB,CAAC;IAEJ,8EAA8E;IAE9E,wBAAwB,CAAC,KAAc;QACrC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,uBAAuB;QACrB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,wBAAwB;QACtB,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,sBAAsB,CAAC,KAAc;QACnC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;QACtB,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,sBAAsB;QACpB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IAED,8EAA8E;IAC9E,cAAc,CAAC,IAAgB;QAC7B,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,8EAA8E;IAEtE,cAAc,CAAC,IAAgB,EAAE,KAAc;QACrD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IAEO,aAAa,CAAC,IAAgB;QACpC,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC,EAAE,eAAe,CAAC,CAAC;IACtB,CAAC;CACF"}