homebridge-securitysystem 0.0.1-matter

package/dist/security-system.js

@@ -0,0 +1,169 @@
+import { SecurityState } from './types/security-state-type.js';
+import { OriginType } from './types/origin-type.js';
+import { ConfigurationService } from './services/configuration-service.js';
+import { stateToMode, modeToState } from './utils/state-util.js';
+import { EventBusService } from './services/event-bus-service.js';
+import { EventType } from './types/event-type.js';
+import { StorageService } from './services/storage-service.js';
+import { WebhookService } from './services/webhook-service.js';
+import { CommandService } from './services/command-service.js';
+import { MqttService } from './services/mqtt-service.js';
+import { MatterService } from './services/matter-service.js';
+import { ServerService } from './services/server-service.js';
+import { StateHandler } from './handlers/state-handler.js';
+import { TripHandler } from './handlers/trip-handler.js';
+import { SwitchHandler } from './handlers/switch-handler.js';
+import { SensorHandler } from './handlers/sensor-handler.js';
+import { buildServiceRegistry, buildServiceList } from './homekit/service-factory.js';
+import { HomeKitRegistrar } from './homekit/homekit-registrar.js';
+import { TimerManager } from './timers/timer-manager.js';
+export class SecuritySystem {
+    log;
+    api;
+    accessory;
+    options;
+    state;
+    svcs;
+    serviceList;
+    bus;
+    stateHandler;
+    tripHandler;
+    switchHandler;
+    sensorHandler;
+    storageService;
+    matterService;
+    constructor(log, config, api, accessory) {
+        this.log = log;
+        this.api = api;
+        this.accessory = accessory;
+        const Char = api.hap.Characteristic;
+        const Svc = api.hap.Service;
+        this.options = new ConfigurationService(log, config).options;
+        const defaultState = modeToState(this.options.defaultMode);
+        this.state = this.buildState(defaultState === -1 ? SecurityState.OFF : defaultState);
+        this.svcs = buildServiceRegistry(Svc, Char, this.options);
+        this.state.availableTargetStates = this.calcAvailableTargetStates();
+        // Sync main service initial values.
+        this.svcs.mainService.getCharacteristic(Char.SecuritySystemTargetState).value = this.state.targetState;
+        this.svcs.mainService.getCharacteristic(Char.SecuritySystemCurrentState).value = this.state.currentState;
+        this.svcs.mainService
+            .setCharacteristic(Char.ConfiguredName, this.options.name)
+            .getCharacteristic(Char.SecuritySystemTargetState)
+            .setProps({ validValues: this.state.availableTargetStates });
+        // Services.
+        this.bus = new EventBusService();
+        this.storageService = new StorageService(log, this.options, api.user.storagePath());
+        const timerManager = new TimerManager(log);
+        // Handlers — construction order matters: sensorHandler first (leaf), then stateHandler,
+        // then switchHandler (depends on stateHandler), then tripHandler.
+        this.sensorHandler = new SensorHandler(log, this.bus);
+        this.stateHandler = new StateHandler(this.svcs, this.state, this.options, Char, log, this.bus, this.storageService, timerManager, this.sensorHandler);
+        this.switchHandler = new SwitchHandler(this.state, this.options, log, timerManager, this.stateHandler);
+        this.tripHandler = new TripHandler(this.state, this.options, log, this.bus, this.sensorHandler, timerManager);
+        // Wire bus listeners for cross-handler coordination (no more circular constructor deps).
+        this.bus.on(EventType.TRIGGER_FIRED, ({ origin }) => {
+            this.stateHandler.setCurrentState(SecurityState.TRIGGERED, origin);
+        });
+        this.bus.on(EventType.TRIP_CANCELLED, ({ stateChanged }) => {
+            if (this.state.currentState === SecurityState.TRIGGERED && !stateChanged) {
+                this.stateHandler.updateTargetState(SecurityState.OFF, OriginType.INTERNAL, 0);
+            }
+            else {
+                this.stateHandler.resetTimers();
+            }
+        });
+        // Attach side-effect listeners.
+        const webhookSvc = new WebhookService(log, this.options, this.state);
+        const commandSvc = new CommandService(log, this.options, this.state);
+        webhookSvc.attachToBus(this.bus);
+        commandSvc.attachToBus(this.bus);
+        const mqttSvc = new MqttService(log, this.options, this.state);
+        mqttSvc.attachToBus(this.bus);
+        this.api.on('shutdown', () => mqttSvc.disconnect());
+        // Publish the optional switch/sensor accessories over Matter (HAP keeps the
+        // main SecuritySystem service and the motion sensors). Registration happens
+        // on the platform after didFinishLaunching, via setupMatterAccessories().
+        this.matterService = new MatterService(log, this.options, api, this.state, this.switchHandler, this.tripHandler, this.sensorHandler);
+        this.matterService.attachToBus(this.bus);
+        // Register HomeKit characteristic handlers.
+        new HomeKitRegistrar(this.svcs, this.state, this.stateHandler)
+            .register(Char);
+        // Build the exposed service list and host it on the platform accessory.
+        this.serviceList = buildServiceList(this.svcs);
+        this.populateAccessory(Svc);
+        this.accessory.on('identify', () => this.log.info('Identify'));
+        // Startup tasks.
+        this.logStartup();
+        const syncModeSwitches = () => {
+            this.bus.emit(EventType.RESET_MODE_SWITCHES, {});
+            this.bus.emit(EventType.UPDATE_MODE_SWITCHES, {});
+        };
+        if (this.options.saveState) {
+            this.storageService.init().then(() => this.storageService.load(this.state).then(() => {
+                this.svcs.mainService.updateCharacteristic(Char.SecuritySystemTargetState, this.state.targetState);
+                this.svcs.mainService.updateCharacteristic(Char.SecuritySystemCurrentState, this.state.currentState);
+                this.stateHandler.logMode('Current', this.state.currentState);
+                syncModeSwitches();
+            }));
+        }
+        else {
+            syncModeSwitches();
+        }
+        if (this.options.serverPort !== null) {
+            new ServerService(log, this.options, this.state, this.stateHandler, this.tripHandler, this.switchHandler).start();
+        }
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Registers all configured switch/sensor accessories over Matter.
+     * No-op when Matter is disabled on the bridge.
+     */
+    setupMatterAccessories(cachedAccessories) {
+        return this.matterService.registerAccessories(cachedAccessories);
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    /** Replaces the accessory's auto-created information service and adds all exposed services. */
+    populateAccessory(Svc) {
+        const existingInfoService = this.accessory.getService(Svc.AccessoryInformation);
+        if (existingInfoService) {
+            this.accessory.removeService(existingInfoService);
+        }
+        this.accessory.updateDisplayName(this.options.name);
+        for (const service of this.serviceList) {
+            this.accessory.addService(service);
+        }
+    }
+    buildState(defaultState) {
+        return {
+            currentState: defaultState,
+            targetState: defaultState,
+            defaultState,
+            availableTargetStates: [],
+            isArming: false,
+            isTripping: false,
+            isKnocked: false,
+            serverAuthenticationAttempts: 0,
+            pausedCurrentState: null,
+            armingLocks: { global: false, home: false, away: false, night: false },
+            modeAwayExtended: false,
+        };
+    }
+    calcAvailableTargetStates() {
+        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));
+    }
+    logStartup() {
+        if (this.options.testMode) {
+            this.log.warn('Test Mode');
+        }
+        stateToMode(this.state.defaultState);
+        this.stateHandler.logMode('Default', this.state.defaultState);
+        this.log.info(`Arm delay (${this.options.armSeconds}s)`);
+        this.log.info(`Trigger delay (${this.options.triggerSeconds}s)`);
+        if (this.options.proxyMode) {
+            this.log.info('Proxy mode (Enabled)');
+        }
+    }
+}
+//# sourceMappingURL=security-system.js.map

package/dist/security-system.js.map

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

package/dist/services/command-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';
+/** Spawns shell commands in response to state-machine events. */
+export declare class CommandService {
+    private readonly log;
+    private readonly options;
+    private readonly state;
+    constructor(log: Logging, options: SecuritySystemOptions, state: SystemState);
+    attachToBus(bus: EventBusService): void;
+    execute(type: string, stateOrMode: SecurityState | string, origin: OriginType): void;
+    private resolveCommand;
+}

package/dist/services/command-service.js

@@ -0,0 +1,65 @@
+import { spawn } from 'child_process';
+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';
+/** Spawns shell commands in response to state-machine events. */
+export class CommandService {
+    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.execute('target', state, origin);
+        });
+        bus.on(EventType.CURRENT_CHANGED, ({ state, origin }) => {
+            this.execute('current', state, origin);
+        });
+        bus.on(EventType.WARNING, ({ origin }) => {
+            this.execute('current', 'warning', origin);
+        });
+    }
+    execute(type, stateOrMode, origin) {
+        if (this.options.proxyMode && origin === OriginType.EXTERNAL) {
+            this.log.debug('Command bypassed (proxy mode).');
+            return;
+        }
+        let command = this.resolveCommand(type, stateOrMode);
+        if (!command) {
+            this.log.debug(`Command for ${type}/${stateOrMode} not set.`);
+            return;
+        }
+        const currentMode = stateToMode(this.state.currentState);
+        command = command.replace('${currentMode}', currentMode);
+        const proc = spawn(command, { shell: true });
+        proc.stdout.on('data', (data) => {
+            this.log.info(`Command output: ${data.toString().trim()}`);
+        });
+        proc.stderr.on('data', (data) => {
+            this.log.error(`Command failed (${command})\n${data.toString().trim()}`);
+        });
+    }
+    resolveCommand(type, stateOrMode) {
+        const s = stateOrMode;
+        const o = this.options;
+        if (s === 'warning') {
+            return o.commandCurrentWarning;
+        }
+        switch (s) {
+            case SecurityState.TRIGGERED: return o.commandCurrentTriggered;
+            case SecurityState.HOME: return type === 'current' ? o.commandCurrentHome : o.commandTargetHome;
+            case SecurityState.AWAY: return type === 'current' ? o.commandCurrentAway : o.commandTargetAway;
+            case SecurityState.NIGHT: return type === 'current' ? o.commandCurrentNight : o.commandTargetNight;
+            case SecurityState.OFF: return type === 'current' ? o.commandCurrentOff : o.commandTargetOff;
+            default:
+                this.log.error(`Unknown command state (${s})`);
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=command-service.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { Logging } from 'homebridge';
+import type { SecuritySystemOptions } from '../interfaces/options-interface.js';
+type RawConfig = Record<string, unknown>;
+/**
+ * Centralises all configuration parsing, validation, and normalisation.
+ * Construct with the raw Homebridge config object; access the fully-typed
+ * result via the `options` property.
+ */
+export declare class ConfigurationService {
+    private readonly log;
+    readonly options: SecuritySystemOptions;
+    constructor(log: Logging, raw: RawConfig);
+    private isSet;
+    private str;
+    private num;
+    private bool;
+    private strArr;
+    /** Rewrites deprecated config keys to their current equivalents in-place. */
+    private applyDeprecations;
+    private parse;
+    private validate;
+    private normalize;
+}
+export {};

package/dist/services/configuration-service.js

@@ -0,0 +1,189 @@
+import { DEFAULTS } from '../constants/default-constant.js';
+/**
+ * Centralises all configuration parsing, validation, and normalisation.
+ * Construct with the raw Homebridge config object; access the fully-typed
+ * result via the `options` property.
+ */
+export class ConfigurationService {
+    log;
+    options;
+    constructor(log, raw) {
+        this.log = log;
+        log.info('Config', JSON.stringify(raw));
+        this.applyDeprecations(raw);
+        this.options = this.parse(raw);
+        this.validate(this.options);
+        this.normalize(this.options);
+        log.info('Options', JSON.stringify(this.options));
+    }
+    // ── Private parsing helpers ─────────────────────────────────────────────────
+    isSet(value) {
+        if (value === undefined || value === null) {
+            return false;
+        }
+        if (typeof value === 'string' && (value.trim() === '' || value === 'null')) {
+            return false;
+        }
+        return true;
+    }
+    str(raw, key) {
+        return this.isSet(raw[key]) ? String(raw[key]) : null;
+    }
+    num(raw, key) {
+        const v = raw[key];
+        if (!this.isSet(v)) {
+            return null;
+        }
+        const n = Number(v);
+        return isNaN(n) ? null : n;
+    }
+    bool(raw, key, def) {
+        return this.isSet(raw[key]) ? Boolean(raw[key]) : def;
+    }
+    strArr(raw, key) {
+        return Array.isArray(raw[key]) ? raw[key].map(String) : [];
+    }
+    // ── Deprecation migration ───────────────────────────────────────────────────
+    /** Rewrites deprecated config keys to their current equivalents in-place. */
+    applyDeprecations(raw) {
+        const renames = {
+            siren_switch: 'trip_switch',
+            siren_override_switch: 'trip_override_switch',
+            siren_mode_switches: 'trip_mode_switches',
+        };
+        for (const [oldKey, newKey] of Object.entries(renames)) {
+            if (this.isSet(raw[oldKey]) && !this.isSet(raw[newKey])) {
+                this.log.warn(`Config: '${oldKey}' is deprecated, use '${newKey}' instead.`);
+                raw[newKey] = raw[oldKey];
+            }
+        }
+    }
+    // ── Core parsing ────────────────────────────────────────────────────────────
+    parse(raw) {
+        return {
+            name: this.str(raw, 'name') ?? DEFAULTS.NAME,
+            serialNumber: this.str(raw, 'serial_number') ?? DEFAULTS.SERIAL_NUMBER,
+            defaultMode: this.str(raw, 'default_mode') ?? DEFAULTS.DEFAULT_MODE,
+            armSeconds: this.num(raw, 'arm_seconds') ?? DEFAULTS.ARM_SECONDS,
+            triggerSeconds: this.num(raw, 'trigger_seconds') ?? DEFAULTS.TRIGGER_SECONDS,
+            resetMinutes: this.num(raw, 'reset_minutes') ?? DEFAULTS.RESET_MINUTES,
+            saveState: this.bool(raw, 'save_state', false),
+            proxyMode: this.bool(raw, 'proxy_mode', false),
+            testMode: this.bool(raw, 'test_mode', false),
+            // Switch display names
+            tripSwitchName: this.str(raw, 'trip_switch_name') ?? DEFAULTS.TRIP_SWITCH_NAME,
+            tripHomeSwitchName: this.str(raw, 'trip_home_switch_name') ?? DEFAULTS.TRIP_HOME_SWITCH_NAME,
+            tripAwaySwitchName: this.str(raw, 'trip_away_switch_name') ?? DEFAULTS.TRIP_AWAY_SWITCH_NAME,
+            tripNightSwitchName: this.str(raw, 'trip_night_switch_name') ?? DEFAULTS.TRIP_NIGHT_SWITCH_NAME,
+            tripOverrideSwitchName: this.str(raw, 'trip_override_switch_name') ?? DEFAULTS.TRIP_OVERRIDE_SWITCH_NAME,
+            modeHomeSwitchName: this.str(raw, 'mode_home_switch_name') ?? DEFAULTS.MODE_HOME_SWITCH_NAME,
+            modeAwaySwitchName: this.str(raw, 'mode_away_switch_name') ?? DEFAULTS.MODE_AWAY_SWITCH_NAME,
+            modeNightSwitchName: this.str(raw, 'mode_night_switch_name') ?? DEFAULTS.MODE_NIGHT_SWITCH_NAME,
+            modeOffSwitchName: this.str(raw, 'mode_off_switch_name') ?? DEFAULTS.MODE_OFF_SWITCH_NAME,
+            modeAwayExtendedSwitchName: this.str(raw, 'mode_away_extended_switch_name') ?? DEFAULTS.MODE_AWAY_EXTENDED_SWITCH_NAME,
+            modePauseSwitchName: this.str(raw, 'mode_pause_switch_name') ?? DEFAULTS.MODE_PAUSE_SWITCH_NAME,
+            // Behaviour toggles
+            overrideOff: this.bool(raw, 'override_off', false),
+            resetOffFlow: this.bool(raw, 'reset_off_flow', false),
+            disabledModes: this.strArr(raw, 'disabled_modes'),
+            // Per-mode arm delays
+            homeArmSeconds: this.num(raw, 'home_arm_seconds'),
+            awayArmSeconds: this.num(raw, 'away_arm_seconds'),
+            nightArmSeconds: this.num(raw, 'night_arm_seconds'),
+            // Per-mode trigger delays
+            homeTriggerSeconds: this.num(raw, 'home_trigger_seconds'),
+            awayTriggerSeconds: this.num(raw, 'away_trigger_seconds'),
+            nightTriggerSeconds: this.num(raw, 'night_trigger_seconds'),
+            // Trip switches
+            tripSwitch: this.bool(raw, 'trip_switch', false),
+            tripOverrideSwitch: this.bool(raw, 'trip_override_switch', false),
+            tripModeSwitches: this.bool(raw, 'trip_mode_switches', true),
+            // Arming lock
+            armingLockSwitch: this.bool(raw, 'arming_lock_switch', false),
+            armingLockSwitches: this.bool(raw, 'arming_lock_switches', false),
+            // Motion sensors
+            armingMotionSensor: this.bool(raw, 'arming_sensor', false),
+            trippedMotionSensor: this.bool(raw, 'tripped_sensor', false),
+            trippedMotionSensorSeconds: this.num(raw, 'tripped_sensor_seconds') ?? DEFAULTS.TRIPPED_SENSOR_SECONDS,
+            resetSensor: this.bool(raw, 'reset_sensor', false),
+            // Mode switches
+            modeSwitches: this.bool(raw, 'mode_switches', false),
+            modeOffSwitch: this.bool(raw, 'mode_off_switch', false),
+            modePauseSwitch: this.bool(raw, 'mode_pause_switch', false),
+            pauseMinutes: this.num(raw, 'pause_minutes') ?? DEFAULTS.PAUSE_MINUTES,
+            modeAwayExtendedSwitch: this.bool(raw, 'mode_away_extended_switch', false),
+            modeAwayExtendedSwitchTriggerSeconds: this.num(raw, 'mode_away_extended_switch_trigger_seconds'),
+            // Double-knock
+            doubleKnock: this.bool(raw, 'double_knock', false),
+            doubleKnockSeconds: this.num(raw, 'double_knock_seconds') ?? DEFAULTS.DOUBLE_KNOCK_SECONDS,
+            doubleKnockModes: this.strArr(raw, 'double_knock_modes'),
+            homeDoubleKnockSeconds: this.num(raw, 'home_double_knock_seconds'),
+            awayDoubleKnockSeconds: this.num(raw, 'away_double_knock_seconds'),
+            nightDoubleKnockSeconds: this.num(raw, 'night_double_knock_seconds'),
+            // Custom trip mode switches
+            tripHomeSwitches: Array.isArray(raw.trip_home_switches)
+                ? raw.trip_home_switches
+                : [],
+            tripAwaySwitches: Array.isArray(raw.trip_away_switches)
+                ? raw.trip_away_switches
+                : [],
+            tripNightSwitches: Array.isArray(raw.trip_night_switches)
+                ? raw.trip_night_switches
+                : [],
+            // Server
+            serverPort: this.num(raw, 'server_port'),
+            // TODO: Remove serverCode fallback in future major version
+            serverApiKey: this.str(raw, 'server_api_key') ?? (this.num(raw, 'server_code') !== null ? String(this.num(raw, 'server_code')) : null),
+            // Shell commands
+            commandTargetHome: this.str(raw, 'command_target_home'),
+            commandTargetAway: this.str(raw, 'command_target_away'),
+            commandTargetNight: this.str(raw, 'command_target_night'),
+            commandTargetOff: this.str(raw, 'command_target_off'),
+            commandCurrentHome: this.str(raw, 'command_current_home'),
+            commandCurrentAway: this.str(raw, 'command_current_away'),
+            commandCurrentNight: this.str(raw, 'command_current_night'),
+            commandCurrentOff: this.str(raw, 'command_current_off'),
+            commandCurrentWarning: this.str(raw, 'command_current_warning'),
+            commandCurrentTriggered: this.str(raw, 'command_current_triggered'),
+            // Webhooks
+            webhookTargetHome: this.str(raw, 'webhook_target_home'),
+            webhookTargetAway: this.str(raw, 'webhook_target_away'),
+            webhookTargetNight: this.str(raw, 'webhook_target_night'),
+            webhookTargetOff: this.str(raw, 'webhook_target_off'),
+            webhookCurrentHome: this.str(raw, 'webhook_current_home'),
+            webhookCurrentAway: this.str(raw, 'webhook_current_away'),
+            webhookCurrentNight: this.str(raw, 'webhook_current_night'),
+            webhookCurrentOff: this.str(raw, 'webhook_current_off'),
+            webhookCurrentWarning: this.str(raw, 'webhook_current_warning'),
+            webhookCurrentTriggered: this.str(raw, 'webhook_current_triggered'),
+            // MQTT
+            mqttBroker: this.str(raw, 'mqtt_broker'),
+            mqttUsername: this.str(raw, 'mqtt_username'),
+            mqttPassword: this.str(raw, 'mqtt_password'),
+            mqttTopic: this.str(raw, 'mqtt_topic') ?? DEFAULTS.MQTT_TOPIC,
+            mqttClientId: this.str(raw, 'mqtt_client_id'),
+        };
+    }
+    // ── Post-parse validation ───────────────────────────────────────────────────
+    validate(opts) {
+        if (opts.resetMinutes === 0) {
+            this.log.error('\'reset_minutes\' must be at least 1. Defaulting to 1.');
+            opts.resetMinutes = 1;
+        }
+        if (opts.serverPort !== null && (opts.serverPort < 0 || opts.serverPort > 65535)) {
+            this.log.error('\'server_port\' must be between 0 and 65535.');
+        }
+        if (opts.mqttBroker !== null && !/^mqtts?:\/\//.test(opts.mqttBroker)) {
+            this.log.warn('\'mqtt_broker\' should start with mqtt:// or mqtts://');
+        }
+    }
+    // ── Post-parse normalisation ────────────────────────────────────────────────
+    normalize(opts) {
+        opts.defaultMode = opts.defaultMode.toLowerCase();
+        if (opts.testMode) {
+            opts.webhookCurrentTriggered = null;
+            opts.commandCurrentTriggered = null;
+        }
+    }
+}
+//# sourceMappingURL=configuration-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-service.js","sourceRoot":"","sources":["../../src/services/configuration-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAI5D;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAGF,GAAG;IAFvB,OAAO,CAAwB;IAExC,YAA6B,GAAY,EAAE,GAAc;mBAA5B,GAAG;QAC9B,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,+EAA+E;IAEvE,KAAK,CAAC,KAAc;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,GAAG,CAAC,GAAc,EAAE,GAAW;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAEO,GAAG,CAAC,GAAc,EAAE,GAAW;QACrC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAEO,IAAI,CAAC,GAAc,EAAE,GAAW,EAAE,GAAY;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IAEO,MAAM,CAAC,GAAc,EAAE,GAAW;QACxC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,+EAA+E;IAE/E,6EAA6E;IACrE,iBAAiB,CAAC,GAAc;QACtC,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,aAAa;YAC3B,qBAAqB,EAAE,sBAAsB;YAC7C,mBAAmB,EAAE,oBAAoB;SAC1C,CAAC;QAEF,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,MAAM,yBAAyB,MAAM,YAAY,CAAC,CAAC;gBAC7E,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IAEvE,KAAK,CAAC,GAAc;QAC1B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI;YAC5C,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,QAAQ,CAAC,aAAa;YACtE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,QAAQ,CAAC,YAAY;YACnE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,QAAQ,CAAC,WAAW;YAChE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,QAAQ,CAAC,eAAe;YAC5E,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,QAAQ,CAAC,aAAa;YACtE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC;YAC9C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC;YAC9C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC;YAE5C,uBAAuB;YACvB,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,QAAQ,CAAC,gBAAgB;YAC9E,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC,IAAI,QAAQ,CAAC,qBAAqB;YAC5F,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC,IAAI,QAAQ,CAAC,qBAAqB;YAC5F,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,wBAAwB,CAAC,IAAI,QAAQ,CAAC,sBAAsB;YAC/F,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,CAAC,IAAI,QAAQ,CAAC,yBAAyB;YACxG,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC,IAAI,QAAQ,CAAC,qBAAqB;YAC5F,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC,IAAI,QAAQ,CAAC,qBAAqB;YAC5F,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,wBAAwB,CAAC,IAAI,QAAQ,CAAC,sBAAsB;YAC/F,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC,IAAI,QAAQ,CAAC,oBAAoB;YACzF,0BAA0B,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gCAAgC,CAAC,IAAI,QAAQ,CAAC,8BAA8B;YACtH,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,wBAAwB,CAAC,IAAI,QAAQ,CAAC,sBAAsB;YAE/F,oBAAoB;YACpB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC;YAClD,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC;YACrD,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC;YAEjD,sBAAsB;YACtB,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC;YACjD,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC;YACjD,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,mBAAmB,CAAC;YAEnD,0BAA0B;YAC1B,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC;YAE3D,gBAAgB;YAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC;YAChD,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,EAAE,KAAK,CAAC;YACjE,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,CAAC;YAE5D,cAAc;YACd,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE,KAAK,CAAC;YAC7D,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,EAAE,KAAK,CAAC;YAEjE,iBAAiB;YACjB,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,CAAC;YAC1D,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC;YAC5D,0BAA0B,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,wBAAwB,CAAC,IAAI,QAAQ,CAAC,sBAAsB;YACtG,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC;YAElD,gBAAgB;YAChB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,CAAC;YACpD,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,CAAC;YACvD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,CAAC;YAC3D,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,QAAQ,CAAC,aAAa;YACtE,sBAAsB,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,2BAA2B,EAAE,KAAK,CAAC;YAC1E,oCAAoC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2CAA2C,CAAC;YAEhG,eAAe;YACf,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC;YAClD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC,IAAI,QAAQ,CAAC,oBAAoB;YAC1F,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,oBAAoB,CAAC;YACxD,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,CAAC;YAClE,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,CAAC;YAClE,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,4BAA4B,CAAC;YAEpE,4BAA4B;YAC5B,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBACrD,CAAC,CAAE,GAAG,CAAC,kBAA0C;gBACjD,CAAC,CAAC,EAAE;YACN,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBACrD,CAAC,CAAE,GAAG,CAAC,kBAA0C;gBACjD,CAAC,CAAC,EAAE;YACN,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;gBACvD,CAAC,CAAE,GAAG,CAAC,mBAA2C;gBAClD,CAAC,CAAC,EAAE;YAEN,SAAS;YACT,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC;YACxC,2DAA2D;YAC3D,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEvI,iBAAiB;YACjB,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC;YACrD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC;YAC3D,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC;YAC/D,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,CAAC;YAEnE,WAAW;YACX,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC;YACrD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC;YACzD,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,uBAAuB,CAAC;YAC3D,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC;YACvD,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC;YAC/D,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,CAAC;YAEnE,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC;YACxC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC;YAC5C,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC;YAC5C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,QAAQ,CAAC,UAAU;YAC7D,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED,+EAA+E;IAEvE,QAAQ,CAAC,IAA2B;QAC1C,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACzE,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;YACjF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,+EAA+E;IAEvE,SAAS,CAAC,IAA2B;QAC3C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAElD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;YACpC,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/services/event-bus-service.d.ts

@@ -0,0 +1,12 @@
+import { EventEmitter } from 'events';
+import { EventType } from '../types/event-type.js';
+import type { EventPayloadMap } from '../types/event-payload-map-type.js';
+/**
+ * Typed event bus used to decouple side-effect services (commands,
+ * webhooks, storage) from the core state-machine handlers.
+ */
+export declare class EventBusService extends EventEmitter {
+    emit<K extends EventType>(event: K, payload: EventPayloadMap[K]): boolean;
+    on<K extends EventType>(event: K, listener: (payload: EventPayloadMap[K]) => void): this;
+    off<K extends EventType>(event: K, listener: (payload: EventPayloadMap[K]) => void): this;
+}

package/dist/services/event-bus-service.js

@@ -0,0 +1,17 @@
+import { EventEmitter } from 'events';
+/**
+ * Typed event bus used to decouple side-effect services (commands,
+ * webhooks, storage) from the core state-machine handlers.
+ */
+export class EventBusService extends EventEmitter {
+    emit(event, payload) {
+        return super.emit(event, payload);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+//# sourceMappingURL=event-bus-service.js.map

package/dist/services/event-bus-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-service.js","sourceRoot":"","sources":["../../src/services/event-bus-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,IAAI,CAAsB,KAAQ,EAAE,OAA2B;QAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAAsB,KAAQ,EAAE,QAA+C;QAC/E,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAsB,KAAQ,EAAE,QAA+C;QAChF,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,69 @@
+import type { API, Logging, MatterAccessory } from 'homebridge';
+import type { SensorHandler } from '../handlers/sensor-handler.js';
+import type { SwitchHandler } from '../handlers/switch-handler.js';
+import type { TripHandler } from '../handlers/trip-handler.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';
+/**
+ * Publishes the optional switch and sensor accessories over Matter (HAP keeps
+ * the main SecuritySystem service and the motion sensors). Switches are
+ * Matter-only. The security system has no Matter device type, so every control
+ * is exposed as an OnOffSwitch and every sensor as a MotionSensor.
+ *
+ * Identities follow the `<device-type>-<index>` convention (`switch-1`,
+ * `motion-sensor-2`, …) and are fed through `api.matter.uuid.generate()` to
+ * produce stable UUIDs. Commands from the Matter controller call straight into
+ * the existing handlers; state changes reach it through bus events and
+ * `updateAccessoryState()`, mirroring the HAP characteristic updates.
+ */
+export declare class MatterService {
+    private readonly log;
+    private readonly options;
+    private readonly api;
+    private readonly state;
+    private readonly switchHandler;
+    private readonly tripHandler;
+    private readonly sensorHandler;
+    private readonly accessoryUuidByKey;
+    private readonly sensorUuidByKind;
+    private readonly pushedSwitchStateByKey;
+    private readonly pushedSensorStateByKind;
+    private matter;
+    constructor(log: Logging, options: SecuritySystemOptions, api: API, state: SystemState, switchHandler: SwitchHandler, tripHandler: TripHandler, sensorHandler: SensorHandler);
+    attachToBus(bus: EventBusService): void;
+    /**
+     * Registers every configured Matter accessory and removes cached ones that are
+     * no longer configured. Accessories restored from Homebridge's cache are
+     * matched by UUID and adopted by the Matter server, so they are not
+     * re-registered. No-op when Matter is disabled on the bridge.
+     */
+    registerAccessories(cachedAccessories: Map<string, MatterAccessory>): Promise<void>;
+    private addModeSwitches;
+    private addTripSwitches;
+    private addArmingLockSwitches;
+    private addMotionSensors;
+    private addOnOffSwitch;
+    /** Sensors declare no handlers — they only push readings with updateAccessoryState. */
+    private addMotionSensor;
+    /**
+     * Runs a controller command, translating failures into Matter status errors:
+     * a blocked action throws a specific status class, and any unexpected error
+     * from the underlying handler becomes a generic Failure instead of escaping
+     * as an untyped error (matter-errors best practice).
+     */
+    private runCommand;
+    private throwIfBlocked;
+    private rethrowAsMatterError;
+    private pushModeSwitchesOff;
+    private pushModeSwitchForTargetState;
+    private modeSwitchKeyForTarget;
+    private pushTripSwitchesOff;
+    private pushLockSwitches;
+    private pushSwitch;
+    private pushSensorState;
+    /** Syncs every registered switch/sensor to its real state after registration. */
+    private syncInitialState;
+    private pushAccessoryState;
+    private uuidFor;
+}