homebridge-securitysystem 0.0.1-matter

package/dist/services/server-service.js

@@ -0,0 +1,275 @@
+import { OpenAPIHono, createRoute } from '@hono/zod-openapi';
+import { serve } from '@hono/node-server';
+import { Scalar } from '@scalar/hono-api-reference';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { stateToMode } from '../utils/state-util.js';
+import { ErrorSchema } from '../schemas/error-schema.js';
+import { StatusResponseSchema } from '../schemas/status-response-schema.js';
+import { ModeRequestSchema } from '../schemas/mode-request-schema.js';
+import { TripModeRequestSchema } from '../schemas/trip-mode-request-schema.js';
+import { ArmingLockRequestSchema } from '../schemas/arming-lock-schema.js';
+const MODE_TO_STATE = {
+    home: SecurityState.HOME,
+    away: SecurityState.AWAY,
+    night: SecurityState.NIGHT,
+    off: SecurityState.OFF,
+};
+const AUTH_RESPONSES = {
+    401: {
+        content: { 'application/json': { schema: ErrorSchema } },
+        description: 'API key required',
+    },
+    403: {
+        content: { 'application/json': { schema: ErrorSchema } },
+        description: 'API key invalid or blocked',
+    },
+};
+const statusRoute = createRoute({
+    method: 'get',
+    path: '/state',
+    summary: 'Get state',
+    description: 'Returns the current arming state, active mode, target mode, and trip status.',
+    security: [{ BearerAuth: [] }],
+    responses: {
+        200: {
+            content: { 'application/json': { schema: StatusResponseSchema } },
+            description: 'Current system state',
+        },
+        ...AUTH_RESPONSES,
+    },
+});
+const modeRoute = createRoute({
+    method: 'put',
+    path: '/mode/update',
+    summary: 'Change mode',
+    description: 'Sets the target security mode. Supported modes: home, away, night, off. ' +
+        'An optional delay (seconds) defers the transition. ' +
+        'To trigger the alarm use the POST /mode/trip endpoint instead.',
+    security: [{ BearerAuth: [] }],
+    request: {
+        body: {
+            content: {
+                'application/json': {
+                    schema: ModeRequestSchema,
+                    example: { mode: 'home', delay: 5 },
+                },
+            },
+            required: true,
+        },
+    },
+    responses: {
+        204: { description: 'Mode change accepted' },
+        ...AUTH_RESPONSES,
+        409: {
+            content: { 'application/json': { schema: ErrorSchema } },
+            description: 'Mode change rejected by the system',
+        },
+    },
+});
+const tripModeRoute = createRoute({
+    method: 'post',
+    path: '/mode/trip',
+    summary: 'Trip mode',
+    description: 'Activates the alarm ("triggered" state). ' +
+        'If mode is specified the alarm only fires when the system is currently in that mode. ' +
+        'An optional delay (seconds) defers the activation.',
+    security: [{ BearerAuth: [] }],
+    request: {
+        body: {
+            content: {
+                'application/json': {
+                    schema: TripModeRequestSchema,
+                    example: { mode: 'home', delay: 30 },
+                },
+            },
+            required: true,
+        },
+    },
+    responses: {
+        204: { description: 'Trip accepted' },
+        ...AUTH_RESPONSES,
+        409: {
+            content: { 'application/json': { schema: ErrorSchema } },
+            description: 'Trip rejected by the system',
+        },
+    },
+});
+const armingLockRoute = createRoute({
+    method: 'put',
+    path: '/switches/arming-lock',
+    summary: 'Update arming lock',
+    description: 'Enables or disables the arming lock for a specific mode or globally.',
+    security: [{ BearerAuth: [] }],
+    request: {
+        body: {
+            content: {
+                'application/json': {
+                    schema: ArmingLockRequestSchema,
+                    example: { mode: 'home', value: true },
+                },
+            },
+            required: true,
+        },
+    },
+    responses: {
+        204: { description: 'Arming lock updated' },
+        ...AUTH_RESPONSES,
+        409: {
+            content: { 'application/json': { schema: ErrorSchema } },
+            description: 'Arming lock update rejected by the system',
+        },
+    },
+});
+/** Hono HTTP server providing remote control of the security system. */
+export class ServerService {
+    log;
+    options;
+    state;
+    stateHandler;
+    tripHandler;
+    switchHandler;
+    application = new OpenAPIHono();
+    constructor(log, options, state, stateHandler, tripHandler, switchHandler) {
+        this.log = log;
+        this.options = options;
+        this.state = state;
+        this.stateHandler = stateHandler;
+        this.tripHandler = tripHandler;
+        this.switchHandler = switchHandler;
+        this.registerRoutes();
+    }
+    /** Exposed for testing — returns the underlying Hono app. */
+    get app() {
+        return this.application;
+    }
+    start() {
+        const server = serve({ fetch: this.application.fetch, port: this.options.serverPort }, () => this.log.info(`Server (${this.options.serverPort})`));
+        server.on('error', (error) => {
+            this.log.error('Server error.');
+            this.log.error(String(error));
+        });
+    }
+    createAuthMiddleware() {
+        return async (c, next) => {
+            const authError = this.authenticate(c);
+            if (authError !== null) {
+                return authError;
+            }
+            await next();
+        };
+    }
+    registerRoutes() {
+        const auth = this.createAuthMiddleware();
+        // Scalar UI
+        this.application.get('/', Scalar({
+            url: '/openapi.json',
+            pageTitle: 'Homebridge Security System API',
+            defaultOpenAllTags: true,
+        }));
+        // Register Bearer auth security scheme for OpenAPI documentation
+        this.application.openAPIRegistry.registerComponent('securitySchemes', 'BearerAuth', {
+            type: 'http',
+            scheme: 'bearer',
+            description: 'API key configured via the server_api_key plugin option.',
+        });
+        // OpenAPI spec
+        this.application.doc('/openapi.json', {
+            openapi: '3.1.0',
+            info: {
+                title: 'Homebridge Security System API',
+                version: '1.0.0',
+                description: 'Remote control API for the Homebridge Security System plugin.',
+            },
+        });
+        // GET /state
+        this.application.use('/state', auth);
+        this.application.openapi(statusRoute, (c) => {
+            return c.json({
+                arming: this.state.isArming,
+                current_mode: stateToMode(this.state.currentState),
+                target_mode: stateToMode(this.state.targetState),
+                tripped: this.stateHandler.isTripping(),
+            });
+        });
+        // PUT /mode/update
+        this.application.use('/mode/update', auth);
+        this.application.openapi(modeRoute, (c) => {
+            const { mode, delay = 0 } = c.req.valid('json');
+            const result = this.stateHandler.updateTargetState(MODE_TO_STATE[mode], OriginType.EXTERNAL, delay);
+            if (!result.success) {
+                return c.json({ reason: result.reason ?? 'Mode change rejected by the system' }, 409);
+            }
+            return c.body(null, 204);
+        });
+        // POST /mode/trip
+        this.application.use('/mode/trip', auth);
+        this.application.openapi(tripModeRoute, (c) => {
+            const { mode, delay } = c.req.valid('json');
+            const effectiveDelay = delay ?? 0;
+            if (effectiveDelay > 0) {
+                const precheck = this.tripHandler.checkTripConditions(true, OriginType.EXTERNAL);
+                if (!precheck.success) {
+                    return c.json({ reason: precheck.reason ?? 'Trip rejected by the system' }, 409);
+                }
+                setTimeout(() => {
+                    if (mode != null) {
+                        this.tripHandler.triggerIfModeSet(MODE_TO_STATE[mode], true);
+                    }
+                    else {
+                        this.tripHandler.updateTripSwitch(true, OriginType.EXTERNAL, false);
+                    }
+                }, effectiveDelay * 1000);
+                return c.body(null, 204);
+            }
+            let result;
+            if (mode != null) {
+                result = this.tripHandler.triggerIfModeSet(MODE_TO_STATE[mode], true);
+            }
+            else {
+                result = this.tripHandler.updateTripSwitch(true, OriginType.EXTERNAL, false);
+            }
+            if (!result.success) {
+                return c.json({ reason: result.reason ?? 'Trip rejected by the system' }, 409);
+            }
+            return c.body(null, 204);
+        });
+        // PUT /switches/arming-lock
+        this.application.use('/switches/arming-lock', auth);
+        this.application.openapi(armingLockRoute, (c) => {
+            const { mode, value } = c.req.valid('json');
+            const result = this.switchHandler.updateArmingLock(mode, value);
+            if (!result.success) {
+                return c.json({ reason: result.reason ?? 'Arming lock update rejected by the system' }, 409);
+            }
+            return c.body(null, 204);
+        });
+    }
+    /**
+     * Validates the Authorization: Bearer <key> header when serverApiKey is configured.
+     * Returns an error Response on failure, or null to allow the request through.
+     */
+    authenticate(context) {
+        if (this.options.serverApiKey === null) {
+            return null;
+        }
+        const authHeader = context.req.header('Authorization');
+        if (authHeader === undefined || !authHeader.startsWith('Bearer ')) {
+            this.log.info('API key required - Authorization header missing (Server)');
+            return context.json({ reason: 'API key required. Use the Authorization: Bearer <key> header.' }, 401);
+        }
+        if (this.state.serverAuthenticationAttempts >= 5) {
+            this.log.warn('API key blocked - too many invalid attempts (Server)');
+            return context.json({ reason: 'API key blocked due to too many invalid attempts' }, 403);
+        }
+        const apiKey = authHeader.slice('Bearer '.length).trim();
+        if (apiKey !== this.options.serverApiKey) {
+            this.state.serverAuthenticationAttempts++;
+            this.log.warn(`API key invalid - attempt ${this.state.serverAuthenticationAttempts}/5 (Server)`);
+            return context.json({ reason: 'API key invalid' }, 403);
+        }
+        this.state.serverAuthenticationAttempts = 0;
+        return null;
+    }
+}
+//# sourceMappingURL=server-service.js.map

package/dist/services/server-service.js.map

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

package/dist/services/storage-service.d.ts

@@ -0,0 +1,14 @@
+import type { Logging } from 'homebridge';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+/** Persists and restores security system state across Homebridge restarts. */
+export declare class StorageService {
+    private readonly log;
+    private readonly options;
+    private readonly storagePath;
+    private initialised;
+    constructor(log: Logging, options: SecuritySystemOptions, storagePath: string);
+    init(): Promise<void>;
+    load(state: SystemState): Promise<void>;
+    save(state: SystemState): Promise<void>;
+}

package/dist/services/storage-service.js

@@ -0,0 +1,70 @@
+import path from 'path';
+import storage from 'node-persist';
+import { SecurityState } from '../types/security-state-type.js';
+/** Persists and restores security system state across Homebridge restarts. */
+export class StorageService {
+    log;
+    options;
+    storagePath;
+    initialised = false;
+    constructor(log, options, storagePath) {
+        this.log = log;
+        this.options = options;
+        this.storagePath = storagePath;
+    }
+    async init() {
+        const dir = path.join(this.storagePath, `homebridge-securitysystem-${this.options.serialNumber}`);
+        try {
+            await storage.init({ dir });
+            this.initialised = true;
+        }
+        catch (err) {
+            this.log.error('Unable to initialise storage.');
+            this.log.error(String(err));
+        }
+    }
+    async load(state) {
+        if (!this.initialised) {
+            return;
+        }
+        if (this.options.testMode) {
+            await storage.clear();
+            this.log.debug('Saved state cleared (test mode).');
+            return;
+        }
+        try {
+            const saved = await storage.getItem('state');
+            if (!saved) {
+                return;
+            }
+            this.log.info('Saved state (Found)');
+            this.log.debug('State (Loaded)', String(JSON.stringify(saved)));
+            const current = saved.currentState ?? state.defaultState;
+            const target = saved.targetState ?? state.defaultState;
+            state.currentState = current;
+            state.targetState = current === SecurityState.TRIGGERED ? target : current;
+        }
+        catch (err) {
+            this.log.error('Saved state (Error)');
+            this.log.error(String(err));
+        }
+    }
+    async save(state) {
+        if (!this.options.saveState || !this.initialised) {
+            return;
+        }
+        const data = {
+            currentState: state.currentState,
+            targetState: state.targetState,
+        };
+        try {
+            await storage.setItem('state', data);
+            this.log.debug('State (Saved)', String(JSON.stringify(data)));
+        }
+        catch (err) {
+            this.log.error('Unable to save state.');
+            this.log.error(String(err));
+        }
+    }
+}
+//# sourceMappingURL=storage-service.js.map

package/dist/services/storage-service.js.map

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

package/dist/services/webhook-service.d.ts

@@ -0,0 +1,16 @@
+import type { Logging } from 'homebridge';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+import type { SystemState } from '../interfaces/system-state-interface.js';
+import type { EventBusService } from './event-bus-service.js';
+/** Sends HTTP GET webhook requests in response to state-machine events. */
+export declare class WebhookService {
+    private readonly log;
+    private readonly options;
+    private readonly state;
+    constructor(log: Logging, options: SecuritySystemOptions, state: SystemState);
+    attachToBus(bus: EventBusService): void;
+    send(type: string, stateOrMode: SecurityState | string, origin: OriginType): void;
+    private resolveUrl;
+}

package/dist/services/webhook-service.js

@@ -0,0 +1,68 @@
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-type.js';
+import { stateToMode } from '../utils/state-util.js';
+import { EventType } from '../types/event-type.js';
+/** Sends HTTP GET webhook requests in response to state-machine events. */
+export class WebhookService {
+    log;
+    options;
+    state;
+    constructor(log, options, state) {
+        this.log = log;
+        this.options = options;
+        this.state = state;
+    }
+    attachToBus(bus) {
+        bus.on(EventType.TARGET_CHANGED, ({ state, origin }) => {
+            this.send('target', state, origin);
+        });
+        bus.on(EventType.CURRENT_CHANGED, ({ state, origin }) => {
+            this.send('current', state, origin);
+        });
+        bus.on(EventType.WARNING, ({ origin }) => {
+            this.send('current', 'warning', origin);
+        });
+    }
+    send(type, stateOrMode, origin) {
+        if (this.options.proxyMode && origin === OriginType.EXTERNAL) {
+            this.log.debug('Webhook bypassed (proxy mode).');
+            return;
+        }
+        const urlTemplate = this.resolveUrl(type, stateOrMode);
+        if (!urlTemplate) {
+            this.log.debug(`Webhook URL for ${type}/${stateOrMode} not set.`);
+            return;
+        }
+        const currentMode = stateToMode(this.state.currentState);
+        const url = urlTemplate.replace('${currentMode}', currentMode);
+        fetch(url)
+            .then(res => {
+            if (!res.ok) {
+                throw new Error(`Status ${res.status}`);
+            }
+            this.log.info('Webhook event (Sent)');
+        })
+            .catch(err => {
+            this.log.error(`Webhook request failed (${url})`);
+            this.log.error(String(err));
+        });
+    }
+    resolveUrl(type, stateOrMode) {
+        const s = stateOrMode;
+        const o = this.options;
+        if (s === 'warning') {
+            return o.webhookCurrentWarning;
+        }
+        switch (s) {
+            case SecurityState.TRIGGERED: return o.webhookCurrentTriggered;
+            case SecurityState.HOME: return type === 'current' ? o.webhookCurrentHome : o.webhookTargetHome;
+            case SecurityState.AWAY: return type === 'current' ? o.webhookCurrentAway : o.webhookTargetAway;
+            case SecurityState.NIGHT: return type === 'current' ? o.webhookCurrentNight : o.webhookTargetNight;
+            case SecurityState.OFF: return type === 'current' ? o.webhookCurrentOff : o.webhookTargetOff;
+            default:
+                this.log.error(`Unknown webhook state (${s})`);
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=webhook-service.js.map

package/dist/services/webhook-service.js.map

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

package/dist/tests/conditions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/conditions.test.js

@@ -0,0 +1,175 @@
+import { describe, it, expect, vi } from 'vitest';
+import { SecurityState } from '../types/security-state-type.js';
+import { OriginType } from '../types/origin-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 { ArmingLockCondition } from '../conditions/arming-lock-condition.js';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function makeState(overrides = {}) {
+    return {
+        currentState: SecurityState.HOME,
+        targetState: SecurityState.HOME,
+        defaultState: SecurityState.OFF,
+        availableTargetStates: [SecurityState.HOME, SecurityState.AWAY, SecurityState.NIGHT, SecurityState.OFF],
+        isArming: false,
+        isTripping: false,
+        isKnocked: false,
+        serverAuthenticationAttempts: 0,
+        pausedCurrentState: null,
+        armingLocks: { global: false, home: false, away: false, night: false },
+        modeAwayExtended: false,
+        ...overrides,
+    };
+}
+function makeOptions(overrides = {}) {
+    return {
+        overrideOff: false,
+        doubleKnock: false,
+        doubleKnockSeconds: 90,
+        doubleKnockModes: [],
+        homeDoubleKnockSeconds: null,
+        awayDoubleKnockSeconds: null,
+        nightDoubleKnockSeconds: null,
+        armingLockSwitch: false,
+        armingLockSwitches: false,
+        ...overrides,
+    };
+}
+function makeLog() {
+    return { info: vi.fn(), warn: vi.fn(), debug: vi.fn(), error: vi.fn(), success: vi.fn() };
+}
+function makeCtx(state, options, value, origin = OriginType.REGULAR_SWITCH) {
+    return { state, options, value, origin, log: makeLog() };
+}
+// ── ArmingLockCondition ───────────────────────────────────────────────────────
+describe('ArmingLockCondition', () => {
+    const cond = new ArmingLockCondition();
+    it('blocks when the global lock is active and arming to an armed mode', () => {
+        const state = makeState({ armingLocks: { global: true, home: false, away: false, night: false } });
+        expect(cond.evaluate(makeCtx(state, makeOptions({ armingLockSwitch: true }), true))).toBe(true);
+        expect(cond.failureReason).toBe('arming is blocked by the global arming lock switch');
+    });
+    it('blocks when the matching mode lock is active', () => {
+        const state = makeState({ targetState: SecurityState.AWAY, armingLocks: { global: false, home: false, away: true, night: false } });
+        expect(cond.evaluate(makeCtx(state, makeOptions({ armingLockSwitches: true }), true))).toBe(true);
+    });
+    it('does not block when the lock feature is disabled', () => {
+        const state = makeState({ armingLocks: { global: true, home: false, away: false, night: false } });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), true))).toBe(false);
+    });
+    it('does not block disarming', () => {
+        const state = makeState({ targetState: SecurityState.OFF, armingLocks: { global: true, home: false, away: false, night: false } });
+        expect(cond.evaluate(makeCtx(state, makeOptions({ armingLockSwitch: true }), true))).toBe(false);
+    });
+    it('allows when no lock is active', () => {
+        const state = makeState();
+        expect(cond.evaluate(makeCtx(state, makeOptions({ armingLockSwitch: true }), true))).toBe(false);
+    });
+});
+// ── NotArmedCondition ─────────────────────────────────────────────────────────
+describe('NotArmedCondition', () => {
+    const cond = new NotArmedCondition();
+    it('blocks when disarmed and override_off is false', () => {
+        const state = makeState({ currentState: SecurityState.OFF });
+        const opts = makeOptions({ overrideOff: false });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(true);
+    });
+    it('allows when disarmed but override_off is true', () => {
+        const state = makeState({ currentState: SecurityState.OFF });
+        const opts = makeOptions({ overrideOff: true });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(false);
+    });
+    it('allows when disarmed but origin is OVERRIDE_SWITCH', () => {
+        const state = makeState({ currentState: SecurityState.OFF });
+        const opts = makeOptions({ overrideOff: false });
+        expect(cond.evaluate(makeCtx(state, opts, true, OriginType.OVERRIDE_SWITCH))).toBe(false);
+    });
+    it('allows when system is armed', () => {
+        const state = makeState({ currentState: SecurityState.HOME });
+        const opts = makeOptions({ overrideOff: false });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(false);
+    });
+    it('does not block on value=false', () => {
+        const state = makeState({ currentState: SecurityState.OFF });
+        const opts = makeOptions({ overrideOff: false });
+        expect(cond.evaluate(makeCtx(state, opts, false))).toBe(false);
+    });
+});
+// ── ArmingInProgressCondition ─────────────────────────────────────────────────
+describe('ArmingInProgressCondition', () => {
+    const cond = new ArmingInProgressCondition();
+    it('blocks when isArming is true and value is true', () => {
+        const state = makeState({ isArming: true });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), true))).toBe(true);
+    });
+    it('allows when not arming', () => {
+        const state = makeState({ isArming: false });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), true))).toBe(false);
+    });
+    it('does not block on value=false', () => {
+        const state = makeState({ isArming: true });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), false))).toBe(false);
+    });
+});
+// ── AlreadyTriggeredCondition ─────────────────────────────────────────────────
+describe('AlreadyTriggeredCondition', () => {
+    const cond = new AlreadyTriggeredCondition();
+    it('blocks when currently triggered and value is true', () => {
+        const state = makeState({ currentState: SecurityState.TRIGGERED });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), true))).toBe(true);
+    });
+    it('allows when not triggered', () => {
+        const state = makeState({ currentState: SecurityState.HOME });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), true))).toBe(false);
+    });
+    it('does not block on value=false (cancel)', () => {
+        const state = makeState({ currentState: SecurityState.TRIGGERED });
+        expect(cond.evaluate(makeCtx(state, makeOptions(), false))).toBe(false);
+    });
+});
+// ── DoubleKnockCondition ──────────────────────────────────────────────────────
+describe('DoubleKnockCondition', () => {
+    it('allows through when doubleKnock option is disabled', () => {
+        const onFirstKnock = vi.fn();
+        const cond = new DoubleKnockCondition(onFirstKnock, vi.fn());
+        const state = makeState({ isKnocked: false });
+        const opts = makeOptions({ doubleKnock: false, doubleKnockModes: ['home'] });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(false);
+        expect(onFirstKnock).not.toHaveBeenCalled();
+    });
+    it('allows override switch to bypass double-knock', () => {
+        const onFirstKnock = vi.fn();
+        const cond = new DoubleKnockCondition(onFirstKnock, vi.fn());
+        const state = makeState({ isKnocked: false, currentState: SecurityState.HOME });
+        const opts = makeOptions({ doubleKnock: true, doubleKnockModes: ['home'], doubleKnockSeconds: 90 });
+        expect(cond.evaluate(makeCtx(state, opts, true, OriginType.OVERRIDE_SWITCH))).toBe(false);
+        expect(onFirstKnock).not.toHaveBeenCalled();
+    });
+    it('blocks first knock and calls onFirstKnock', () => {
+        const onFirstKnock = vi.fn();
+        const cond = new DoubleKnockCondition(onFirstKnock, vi.fn());
+        const state = makeState({ isKnocked: false, currentState: SecurityState.HOME });
+        const opts = makeOptions({ doubleKnock: true, doubleKnockModes: ['home'], doubleKnockSeconds: 90 });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(true);
+        expect(state.isKnocked).toBe(true);
+        expect(onFirstKnock).toHaveBeenCalledWith(90, expect.any(Function));
+    });
+    it('allows second knock through and clears isKnocked', () => {
+        const cond = new DoubleKnockCondition(vi.fn(), vi.fn());
+        const state = makeState({ isKnocked: true, currentState: SecurityState.HOME });
+        const opts = makeOptions({ doubleKnock: true, doubleKnockModes: ['home'], doubleKnockSeconds: 90 });
+        expect(cond.evaluate(makeCtx(state, opts, true))).toBe(false);
+        expect(state.isKnocked).toBe(false);
+    });
+    it('uses mode-specific knock window when configured', () => {
+        const onFirstKnock = vi.fn();
+        const cond = new DoubleKnockCondition(onFirstKnock, vi.fn());
+        const state = makeState({ isKnocked: false, currentState: SecurityState.AWAY });
+        const opts = makeOptions({ doubleKnock: true, doubleKnockModes: ['away'], doubleKnockSeconds: 90, awayDoubleKnockSeconds: 30 });
+        cond.evaluate(makeCtx(state, opts, true));
+        expect(onFirstKnock).toHaveBeenCalledWith(30, expect.any(Function));
+    });
+});
+//# sourceMappingURL=conditions.test.js.map