homebridge-verisure 2.0.1 → 3.0.0

package/README.md

@@ -6,7 +6,7 @@
 
 [![GitHub Actions badge](https://github.com/ptz0n/homebridge-verisure/workflows/Test/badge.svg)](https://github.com/ptz0n/homebridge-verisure/actions?query=workflow%3ATest)
 
-This is a plugin for [Homebridge](https://github.com/nfarina/homebridge). It's
+This is a plugin for [Homebridge](https://homebridge.io). It's
 an implementation for your Verisure installation and exposes the following devices:
 
 - Security alarm
@@ -19,6 +19,11 @@ an implementation for your Verisure installation and exposes the following devic
 - Smoke detector
 - Vibration detector
 
+## Requirements
+
+* Node.js 22 or later
+* Homebridge 2.0 or later
+
 ## Protect linked devices & accounts
 
 If configured, this plugin will expose your security system and door lock.
@@ -74,6 +79,18 @@ your array (list) of enabled platform plugins. Example config:
 * `showAudioSwitch` Optional boolean for exposing door audio volume switch. Defaults to `true`.
 * `audioOffValue` Optional string for door audio volume, `SILENCE` or `LOW`. Defaults to `SILENCE`.
 * `audioOnValue` Optional string for door audio volume, `LOW` or `HIGH`. Defaults to `LOW`.
+* `forceArm` Optional boolean. Bypasses Verisure's "a door/window is open" guard when arming. Defaults to `true` - without it, arming can silently fail depending on sensor state.
+* `excludedAccessoryTypes` Optional array to hide entire accessory types: `alarm`, `climateSensor`, `contactSensor`, `doorLock`, `smartPlug`.
+* `excludedDevices` Optional array of device labels or area names (e.g. `"Kitchen"`) to hide regardless of type.
+
+### Rate limits
+
+Verisure limits how many API calls an account can make per day; exceeding it
+gets your account temporarily blocked. This plugin makes one request per
+installation per `pollInterval` tick, shared by every accessory on it, plus a
+short-lived cache that collapses bursts of near-simultaneous HomeKit reads.
+If Verisure does rate-limit the account anyway, polling for that installation
+pauses automatically for 15 minutes.
 
 ### Multi-factor authentication
 
@@ -82,7 +99,7 @@ your array (list) of enabled platform plugins. Example config:
 In 2021 Verisure started enrolling MFA which requires you to obtain cookies. These cookies are used instead of a `password` in your config and will need to be renewed yearly. After installing the plugin, run `npx homebridge-verisure` in your terminal and copy the output values into your config.
 
 ```bash
-$ npx homebridge-verisure
+$ npx homebridge-verisure@latest
 ✔ What is your login email? · foo@bar.com
 ✔ What is your password? · ********************
 
@@ -113,3 +130,17 @@ For convenience, the following environment variables can be used instead of plac
 * `VERISURE_DOOR_CODE`
 * `VERISURE_EMAIL`
 * `VERISURE_PASSWORD`
+
+## Known limitations
+
+* Verisure's alarm system has no equivalent of HomeKit's "Night" state; a client that lets you pick it anyway (e.g. Eve) will have the request rejected.
+* Climate sensor readings update roughly every 6 hours on Verisure's side; HomeKit will show that same stale-looking value in between.
+
+## Development
+
+```bash
+npm install
+npm run build   # compile TypeScript to dist/
+npm test        # lint, build, and run the test suite
+npm start       # build and launch a local Homebridge instance for manual testing
+```

package/config.schema.json

@@ -81,6 +81,36 @@
         ],
         "required": true,
         "functionBody": "return model.showAudioSwitch === true;"
+      },
+      "forceArm": {
+        "title": "Force arm",
+        "description": "Arm even if a door/window sensor is open. Turning this off can cause arming to silently fail if a sensor isn't in its expected state.",
+        "type": "boolean",
+        "default": true
+      },
+      "excludedAccessoryTypes": {
+        "title": "Excluded accessory types",
+        "type": "array",
+        "items": {
+          "type": "string",
+          "oneOf": [
+            { "title": "Alarm", "enum": ["alarm"] },
+            { "title": "Climate sensor", "enum": ["climateSensor"] },
+            { "title": "Contact sensor", "enum": ["contactSensor"] },
+            { "title": "Door lock", "enum": ["doorLock"] },
+            { "title": "Smart plug", "enum": ["smartPlug"] }
+          ]
+        },
+        "required": false
+      },
+      "excludedDevices": {
+        "title": "Excluded devices",
+        "description": "Device labels or area names to never expose, regardless of type.",
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "required": false
       }
     }
   },

package/dist/accessories/alarm.d.ts

@@ -0,0 +1,28 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { VerisureInstallation } from 'verisure';
+import type { VerisurePlatform } from '../platform';
+import type { Overview } from '../types';
+import { VerisureAccessoryHandler } from './base';
+import type { AccessoryContext } from './base';
+export declare class Alarm extends VerisureAccessoryHandler {
+    private readonly service;
+    private readonly alarmCode;
+    private readonly forceArm;
+    /** Verisure reports transitional statuses (e.g. `CHANGE_IN_PROGRESS`
+     * while an arm/disarm is mid-flight) that have no HomeKit equivalent.
+     * Falling back to the last resolved state avoids surfacing a read error
+     * for what is a normal, brief condition, and is more robust than
+     * enumerating every transitional status Verisure might ever send. */
+    private lastKnownState?;
+    constructor(platform: VerisurePlatform, accessory: PlatformAccessory<AccessoryContext>, installation: VerisureInstallation);
+    private armStateMap;
+    private toHomeKitState;
+    /** Resolves the current HomeKit state for a Verisure status, remembering
+     * it for next time. Falls back to the last known state - rather than
+     * erroring - for a transitional or otherwise unrecognized status. */
+    private resolveCurrentState;
+    private toVerisureState;
+    private getCurrentAlarmState;
+    private setTargetAlarmState;
+    protected onOverview(overview: Overview): void;
+}

package/dist/accessories/alarm.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Alarm = void 0;
+const operations_1 = require("../operations");
+const base_1 = require("./base");
+class Alarm extends base_1.VerisureAccessoryHandler {
+    service;
+    alarmCode;
+    forceArm;
+    /** Verisure reports transitional statuses (e.g. `CHANGE_IN_PROGRESS`
+     * while an arm/disarm is mid-flight) that have no HomeKit equivalent.
+     * Falling back to the last resolved state avoids surfacing a read error
+     * for what is a normal, brief condition, and is more robust than
+     * enumerating every transitional status Verisure might ever send. */
+    lastKnownState;
+    constructor(platform, accessory, installation) {
+        super(platform, accessory, installation);
+        this.alarmCode = String(this.platformConfig.alarmCode);
+        this.forceArm = this.platformConfig.forceArm !== false;
+        const { Service, Characteristic } = this.hap;
+        this.accessoryInformation.setCharacteristic(Characteristic.Model, 'ALARM');
+        this.service = this.accessory.getService(Service.SecuritySystem)
+            ?? this.accessory.addService(Service.SecuritySystem, accessory.displayName);
+        this.service.getCharacteristic(Characteristic.SecuritySystemCurrentState)
+            .onGet(() => this.getCurrentAlarmState());
+        const targetState = this.service.getCharacteristic(Characteristic.SecuritySystemTargetState)
+            .onGet(() => this.getCurrentAlarmState())
+            .onSet((value) => this.setTargetAlarmState(value));
+        // There is no "Night" mode in this alarm system; some HomeKit clients
+        // (e.g. Eve) let a user pick it anyway despite it being filtered out of
+        // validValues here, which used to crash the plugin outright (#85) -
+        // setTargetAlarmState() below now rejects it with a proper HAP error
+        // instead of throwing synchronously.
+        const { NIGHT_ARM } = Characteristic.SecuritySystemTargetState;
+        targetState.setProps({
+            validValues: targetState.props.validValues?.filter((state) => state !== NIGHT_ARM),
+        });
+    }
+    armStateMap() {
+        const { SecuritySystemCurrentState } = this.hap.Characteristic;
+        return {
+            ARMED_AWAY: SecuritySystemCurrentState.AWAY_ARM,
+            ARMED_HOME: SecuritySystemCurrentState.STAY_ARM,
+            DISARMED: SecuritySystemCurrentState.DISARMED,
+        };
+    }
+    toHomeKitState(statusType) {
+        const value = this.armStateMap()[statusType];
+        if (value === undefined) {
+            throw new Error(`Cannot resolve arm state from unknown Verisure status: ${statusType}`);
+        }
+        return value;
+    }
+    /** Resolves the current HomeKit state for a Verisure status, remembering
+     * it for next time. Falls back to the last known state - rather than
+     * erroring - for a transitional or otherwise unrecognized status. */
+    resolveCurrentState(statusType) {
+        try {
+            this.lastKnownState = this.toHomeKitState(statusType);
+        }
+        catch (error) {
+            if (this.lastKnownState === undefined) {
+                throw error;
+            }
+            this.logPrefixed(`${error.message} - reporting the last known state instead.`, 'debug');
+        }
+        return this.lastKnownState;
+    }
+    toVerisureState(value) {
+        const map = this.armStateMap();
+        const match = Object.keys(map).find((key) => map[key] === value);
+        if (!match) {
+            throw new this.hap.HapStatusError(-70410 /* this.hap.HAPStatus.INVALID_VALUE_IN_REQUEST */);
+        }
+        return match;
+    }
+    async getCurrentAlarmState() {
+        this.logPrefixed('Getting current alarm state.', 'debug');
+        const overview = await this.platform.poller(this.installation).getOverview();
+        if (!overview.armState) {
+            this.logPrefixed(`No armState in overview; last known state: ${this.lastKnownState}`, 'debug');
+            if (this.lastKnownState !== undefined) {
+                return this.lastKnownState;
+            }
+            throw new this.hap.HapStatusError(-70402 /* this.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE */);
+        }
+        try {
+            const value = this.resolveCurrentState(overview.armState.statusType);
+            this.logPrefixed(`Resolved current alarm state: ${value} (raw Verisure status: ${overview.armState.statusType})`, 'debug');
+            return value;
+        }
+        catch {
+            throw new this.hap.HapStatusError(-70402 /* this.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE */);
+        }
+    }
+    async setTargetAlarmState(value) {
+        this.logPrefixed(`Setting target alarm state to: ${value}`);
+        const targetArmState = this.toVerisureState(value);
+        const operation = {
+            ARMED_AWAY: () => (0, operations_1.armAwayOperation)(this.alarmCode, this.forceArm),
+            ARMED_HOME: () => (0, operations_1.armHomeOperation)(this.alarmCode, this.forceArm),
+            DISARMED: () => (0, operations_1.disarmOperation)(this.alarmCode),
+        }[targetArmState]();
+        const { transactionId } = await this.installation.client(operation);
+        await this.resolveChangeResult((0, operations_1.pollArmStateOperation)(transactionId, targetArmState));
+        this.lastKnownState = value;
+        // A stale cached overview from just before this change must not answer
+        // the read HomeKit does right after to confirm it (see OverviewPoller#invalidate).
+        this.platform.poller(this.installation).invalidate();
+        setImmediate(() => {
+            this.service.updateCharacteristic(this.hap.Characteristic.SecuritySystemCurrentState, value);
+        });
+    }
+    onOverview(overview) {
+        const { armState } = overview;
+        if (!armState) {
+            return;
+        }
+        try {
+            const value = this.resolveCurrentState(armState.statusType);
+            this.service.updateCharacteristic(this.hap.Characteristic.SecuritySystemCurrentState, value);
+        }
+        catch (error) {
+            this.logPrefixed(error.message, 'debug');
+        }
+    }
+}
+exports.Alarm = Alarm;
+//# sourceMappingURL=alarm.js.map

package/dist/accessories/alarm.js.map

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

package/dist/accessories/base.d.ts

@@ -0,0 +1,39 @@
+import type { Logger, PlatformAccessory, Service } from 'homebridge';
+import type { GraphqlOperation, VerisureInstallation } from 'verisure';
+import type { AccessoryType, Overview, VerisurePlatformConfig } from '../types';
+import type { VerisurePlatform } from '../platform';
+export interface AccessoryContext {
+    deviceType: AccessoryType;
+    deviceLabel?: string;
+    installationGiid: string;
+}
+/**
+ * Common plumbing shared by every accessory type: logging, the
+ * AccessoryInformation service, and the arm/lock change-result poller.
+ */
+export declare abstract class VerisureAccessoryHandler {
+    protected readonly platform: VerisurePlatform;
+    protected readonly accessory: PlatformAccessory<AccessoryContext>;
+    protected readonly installation: VerisureInstallation;
+    protected readonly log: Logger;
+    protected readonly hap: VerisurePlatform['api']['hap'];
+    protected readonly platformConfig: VerisurePlatformConfig;
+    protected readonly serialNumber?: string;
+    protected readonly accessoryInformation: Service;
+    constructor(platform: VerisurePlatform, accessory: PlatformAccessory<AccessoryContext>, installation: VerisureInstallation);
+    /** Paints the accessory's current characteristics from an overview that
+     * was already fetched for discovery, so it doesn't sit at HAP's default
+     * value until the next poll tick fires. */
+    paint(overview: Overview): void;
+    protected logPrefixed(message: string, level?: 'info' | 'debug' | 'warn' | 'error'): void;
+    /** Called on every poll tick with a fresh overview. Implementations should
+     * push any new values to their characteristics via `updateValue()` and
+     * must not throw - a missing/malformed slice for this one device shouldn't
+     * take down anything else. */
+    protected abstract onOverview(overview: Overview): void;
+    /** Polls a change-result query until Verisure resolves the transaction
+     * (non-null result) or `CHANGE_RESULT_TIMEOUT_MS` elapses. The original
+     * implementation had no timeout, so a transaction Verisure never resolved
+     * would retry forever every 200ms. */
+    protected resolveChangeResult(operation: GraphqlOperation, deadline?: number): Promise<string>;
+}

package/dist/accessories/base.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerisureAccessoryHandler = void 0;
+const settings_1 = require("../settings");
+/**
+ * Common plumbing shared by every accessory type: logging, the
+ * AccessoryInformation service, and the arm/lock change-result poller.
+ */
+class VerisureAccessoryHandler {
+    platform;
+    accessory;
+    installation;
+    log;
+    hap;
+    platformConfig;
+    serialNumber;
+    accessoryInformation;
+    constructor(platform, accessory, installation) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.installation = installation;
+        this.log = platform.log;
+        this.hap = platform.api.hap;
+        this.platformConfig = platform.config;
+        this.serialNumber = accessory.context.deviceLabel;
+        const { Characteristic, Service } = this.hap;
+        this.accessoryInformation = this.accessory.getService(Service.AccessoryInformation)
+            ?? this.accessory.addService(Service.AccessoryInformation);
+        this.accessoryInformation
+            .setCharacteristic(Characteristic.Manufacturer, 'Verisure')
+            .setCharacteristic(Characteristic.SerialNumber, this.serialNumber ?? this.installation.giid);
+        this.platform.poller(this.installation).subscribe((overview) => this.onOverview(overview));
+    }
+    /** Paints the accessory's current characteristics from an overview that
+     * was already fetched for discovery, so it doesn't sit at HAP's default
+     * value until the next poll tick fires. */
+    paint(overview) {
+        this.onOverview(overview);
+    }
+    logPrefixed(message, level = 'info') {
+        this.log[level](`${this.installation.config.alias} ${this.accessory.displayName}: ${message}`);
+    }
+    /** Polls a change-result query until Verisure resolves the transaction
+     * (non-null result) or `CHANGE_RESULT_TIMEOUT_MS` elapses. The original
+     * implementation had no timeout, so a transaction Verisure never resolved
+     * would retry forever every 200ms. */
+    async resolveChangeResult(operation, deadline = Date.now() + settings_1.CHANGE_RESULT_TIMEOUT_MS) {
+        this.logPrefixed(`Resolving: ${operation.operationName}`, 'debug');
+        const { installation: { pollResult: { result } } } = await this.installation
+            .client(operation);
+        this.logPrefixed(`Got "${result}" back from: ${operation.operationName}`, 'debug');
+        if (result !== null) {
+            return result;
+        }
+        if (Date.now() >= deadline) {
+            throw new Error(`Timed out waiting for ${operation.operationName} to resolve.`);
+        }
+        await new Promise((resolve) => { setTimeout(resolve, settings_1.CHANGE_RESULT_POLL_INTERVAL_MS); });
+        return this.resolveChangeResult(operation, deadline);
+    }
+}
+exports.VerisureAccessoryHandler = VerisureAccessoryHandler;
+//# sourceMappingURL=base.js.map

package/dist/accessories/base.js.map

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

package/dist/accessories/climateSensor.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { VerisureInstallation } from 'verisure';
+import type { VerisurePlatform } from '../platform';
+import type { Climate, Overview } from '../types';
+import { VerisureAccessoryHandler } from './base';
+import type { AccessoryContext } from './base';
+export declare class ClimateSensor extends VerisureAccessoryHandler {
+    private temperatureService?;
+    private humidityService?;
+    constructor(platform: VerisurePlatform, accessory: PlatformAccessory<AccessoryContext>, installation: VerisureInstallation, initial: Climate);
+    private findDevice;
+    private getCurrentValue;
+    protected onOverview(overview: Overview): void;
+}

package/dist/accessories/climateSensor.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClimateSensor = void 0;
+const base_1 = require("./base");
+const isNumber = (value) => typeof value === 'number';
+class ClimateSensor extends base_1.VerisureAccessoryHandler {
+    temperatureService;
+    humidityService;
+    constructor(platform, accessory, installation, initial) {
+        super(platform, accessory, installation);
+        const label = initial.device.gui?.label ?? 'UNKNOWN';
+        const { Characteristic, Service } = this.hap;
+        this.accessoryInformation.setCharacteristic(Characteristic.Model, label);
+        // Verisure reports an unsupported reading as an explicit `null`, not a
+        // missing field - e.g. VoiceBox devices have a `humidityValue: null`.
+        // Checking only `!== undefined` let `null` through, which HomeKit
+        // rejects outright for these characteristics.
+        if (isNumber(initial.temperatureValue)) {
+            this.temperatureService = this.accessory.getService(Service.TemperatureSensor)
+                ?? this.accessory.addService(Service.TemperatureSensor, accessory.displayName);
+            this.temperatureService.getCharacteristic(Characteristic.CurrentTemperature)
+                .setProps({ minValue: -40.0, maxValue: 60.0 })
+                .onGet(() => this.getCurrentValue('temperatureValue'));
+        }
+        if (isNumber(initial.humidityValue)) {
+            this.humidityService = this.accessory.getService(Service.HumiditySensor)
+                ?? this.accessory.addService(Service.HumiditySensor, accessory.displayName);
+            this.humidityService.getCharacteristic(Characteristic.CurrentRelativeHumidity)
+                .onGet(() => this.getCurrentValue('humidityValue'));
+        }
+    }
+    findDevice(overview) {
+        return overview.climates?.find((climate) => climate.device.deviceLabel === this.serialNumber);
+    }
+    async getCurrentValue(property) {
+        this.logPrefixed(`Getting current ${property} value.`, 'debug');
+        const overview = await this.platform.poller(this.installation).getOverview();
+        const device = this.findDevice(overview);
+        const value = device?.[property];
+        if (!isNumber(value)) {
+            throw new this.hap.HapStatusError(-70402 /* this.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE */);
+        }
+        return value;
+    }
+    onOverview(overview) {
+        const device = this.findDevice(overview);
+        if (!device) {
+            return;
+        }
+        const { Characteristic } = this.hap;
+        if (this.temperatureService && isNumber(device.temperatureValue)) {
+            this.temperatureService.updateCharacteristic(Characteristic.CurrentTemperature, device.temperatureValue);
+        }
+        if (this.humidityService && isNumber(device.humidityValue)) {
+            this.humidityService.updateCharacteristic(Characteristic.CurrentRelativeHumidity, device.humidityValue);
+        }
+    }
+}
+exports.ClimateSensor = ClimateSensor;
+//# sourceMappingURL=climateSensor.js.map

package/dist/accessories/climateSensor.js.map

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

package/dist/accessories/contactSensor.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { VerisureInstallation } from 'verisure';
+import type { VerisurePlatform } from '../platform';
+import type { Overview } from '../types';
+import { VerisureAccessoryHandler } from './base';
+import type { AccessoryContext } from './base';
+export declare class ContactSensor extends VerisureAccessoryHandler {
+    private readonly service;
+    constructor(platform: VerisurePlatform, accessory: PlatformAccessory<AccessoryContext>, installation: VerisureInstallation);
+    private static resolveSensorState;
+    private findDevice;
+    private getCurrentSensorState;
+    protected onOverview(overview: Overview): void;
+}

package/dist/accessories/contactSensor.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactSensor = void 0;
+const base_1 = require("./base");
+class ContactSensor extends base_1.VerisureAccessoryHandler {
+    service;
+    constructor(platform, accessory, installation) {
+        super(platform, accessory, installation);
+        const { Service, Characteristic } = this.hap;
+        this.service = this.accessory.getService(Service.ContactSensor)
+            ?? this.accessory.addService(Service.ContactSensor, accessory.displayName);
+        this.service.getCharacteristic(Characteristic.ContactSensorState)
+            .onGet(() => this.getCurrentSensorState());
+    }
+    static resolveSensorState(input) {
+        return input !== 'CLOSE';
+    }
+    findDevice(overview) {
+        return overview.doorWindows?.find((doorWindow) => doorWindow.device.deviceLabel === this.serialNumber);
+    }
+    async getCurrentSensorState() {
+        this.logPrefixed('Getting current sensor state.', 'debug');
+        const overview = await this.platform.poller(this.installation).getOverview();
+        const doorWindow = this.findDevice(overview);
+        if (!doorWindow) {
+            throw new this.hap.HapStatusError(-70402 /* this.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE */);
+        }
+        return ContactSensor.resolveSensorState(doorWindow.state);
+    }
+    onOverview(overview) {
+        const doorWindow = this.findDevice(overview);
+        if (!doorWindow) {
+            return;
+        }
+        this.service.updateCharacteristic(this.hap.Characteristic.ContactSensorState, ContactSensor.resolveSensorState(doorWindow.state));
+    }
+}
+exports.ContactSensor = ContactSensor;
+//# sourceMappingURL=contactSensor.js.map

package/dist/accessories/contactSensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactSensor.js","sourceRoot":"","sources":["../../src/accessories/contactSensor.ts"],"names":[],"mappings":";;;AAKA,iCAAkD;AAGlD,MAAa,aAAc,SAAQ,+BAAwB;IACxC,OAAO,CAAU;IAElC,YACE,QAA0B,EAC1B,SAA8C,EAC9C,YAAkC;QAElC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QAEzC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;eAC1D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;QAE7E,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,kBAAkB,CAAC;aAC9D,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,KAAa;QAC7C,OAAO,KAAK,KAAK,OAAO,CAAC;IAC3B,CAAC;IAEO,UAAU,CAAC,QAAkB;QACnC,OAAO,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC;IACzG,CAAC;IAEO,KAAK,CAAC,qBAAqB;QACjC,IAAI,CAAC,WAAW,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,+DAAkD,CAAC;QACtF,CAAC;QACD,OAAO,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAES,UAAU,CAAC,QAAkB;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAC/B,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,kBAAkB,EAC1C,aAAa,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CACnD,CAAC;IACJ,CAAC;CACF;AA9CD,sCA8CC"}

package/dist/accessories/doorLock.d.ts

@@ -0,0 +1,32 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { VerisureInstallation } from 'verisure';
+import type { VerisurePlatform } from '../platform';
+import type { Overview } from '../types';
+import { VerisureAccessoryHandler } from './base';
+import type { AccessoryContext } from './base';
+export declare class DoorLock extends VerisureAccessoryHandler {
+    private readonly lockService;
+    private readonly autoLockService?;
+    private readonly audioService?;
+    private readonly doorCode;
+    /** The lock state we're actively trying to reach, if any. Cleared as soon
+     * as the change settles (success or failure) so getTargetLockState() falls
+     * straight back to the device's actual state - keeping it "stuck" here
+     * indefinitely was the cause of the Yale-lock report/reconcile loop that
+     * burned through the daily API quota in issues #159, #173, #181, #168. */
+    private pendingTargetState?;
+    private readonly getLockConfig;
+    constructor(platform: VerisurePlatform, accessory: PlatformAccessory<AccessoryContext>, installation: VerisureInstallation);
+    private resolveCurrentLockState;
+    private findDevice;
+    private getDoorLock;
+    private getCurrentLockState;
+    private getTargetLockState;
+    private setTargetLockState;
+    private resolveAutoLockState;
+    private getAutoLockState;
+    private setAutoLockState;
+    private getAudioState;
+    private setAudioState;
+    protected onOverview(overview: Overview): void;
+}