homebridge-blueair-plugin 1.1.0

package/dist/constants.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Constants for BlueAir accessory control
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEBOUNCE_DELAY_MS = exports.AQI_THRESHOLDS = exports.NL_HOMEKIT_STEP = exports.NL_LEVELS = exports.FAN_SPEED_HOMEKIT_VALUES = exports.FAN_SPEED_HOMEKIT_STEP = exports.FAN_SPEED_LEVELS = exports.HUMIDITY_MAX = exports.HUMIDITY_MIN = exports.AQI = void 0;
+exports.fanSpeedHomeKitToDevice = fanSpeedHomeKitToDevice;
+exports.fanSpeedDeviceToHomeKit = fanSpeedDeviceToHomeKit;
+exports.mapToDeviceSpeed = mapToDeviceSpeed;
+exports.nlDeviceToHomeKit = nlDeviceToHomeKit;
+exports.nlHomeKitToDevice = nlHomeKitToDevice;
+exports.nlDeviceToName = nlDeviceToName;
+exports.AQI = {
+    PM2_5: {
+        AQI_LO: [0, 51, 101, 151, 201, 301],
+        AQI_HI: [50, 100, 150, 200, 300, 500],
+        CONC_LO: [0.0, 9.1, 35.5, 55.5, 125.5, 225.5],
+        CONC_HI: [9.0, 35.4, 55.4, 125.4, 225.4, 325.4],
+    },
+    PM10: {
+        AQI_LO: [0, 51, 101, 151, 201, 301],
+        AQI_HI: [50, 100, 150, 200, 300, 500],
+        CONC_LO: [0, 55, 155, 255, 355, 425],
+        CONC_HI: [54, 154, 254, 354, 424, 604],
+    },
+    VOC: {
+        AQI_LO: [0, 51, 101, 151, 201, 301],
+        AQI_HI: [50, 100, 150, 200, 300, 500],
+        CONC_LO: [0, 221, 661, 1431, 2201, 3301],
+        CONC_HI: [220, 660, 1430, 2200, 3300, 5500],
+    },
+};
+// Humidity control range
+exports.HUMIDITY_MIN = 30;
+exports.HUMIDITY_MAX = 80;
+// Fan speed levels: 0 (sleep/night), 11 (low), 37 (medium), 64 (high)
+exports.FAN_SPEED_LEVELS = [0, 11, 37, 64];
+// HomeKit fan speed mapping - use 5 discrete positions (0, 25, 50, 75, 100)
+// 0% = Off/Standby, 25% = Sleep/Night, 50% = Low, 75% = Medium, 100% = High
+exports.FAN_SPEED_HOMEKIT_STEP = 25;
+exports.FAN_SPEED_HOMEKIT_VALUES = [0, 25, 50, 75, 100];
+// Map HomeKit percentage to device speed
+// Returns { speed: number, isNightMode: boolean, isStandby: boolean }
+function fanSpeedHomeKitToDevice(hkSpeed) {
+    if (hkSpeed <= 12) {
+        // 0% = Standby (device off)
+        return { speed: 0, isNightMode: false, isStandby: true };
+    }
+    if (hkSpeed <= 37) {
+        // 25% = Sleep/Night mode (device on, night mode enabled)
+        return { speed: 0, isNightMode: true, isStandby: false };
+    }
+    if (hkSpeed <= 62) {
+        // 50% = Low
+        return { speed: 11, isNightMode: false, isStandby: false };
+    }
+    if (hkSpeed <= 87) {
+        // 75% = Medium
+        return { speed: 37, isNightMode: false, isStandby: false };
+    }
+    // 100% = High
+    return { speed: 64, isNightMode: false, isStandby: false };
+}
+// Map device state to HomeKit percentage
+function fanSpeedDeviceToHomeKit(deviceSpeed, isNightMode, isStandby) {
+    if (isStandby) {
+        return 0;
+    } // Off → 0%
+    if (isNightMode) {
+        return 25;
+    } // Night mode → 25%
+    if (deviceSpeed <= 5) {
+        return 25;
+    } // Speed 0 without night mode → treat as sleep
+    if (deviceSpeed <= 24) {
+        return 50;
+    } // Low → 50%
+    if (deviceSpeed <= 50) {
+        return 75;
+    } // Medium → 75%
+    return 100; // High → 100%
+}
+// Legacy function for backward compatibility
+function mapToDeviceSpeed(hkSpeed) {
+    return fanSpeedHomeKitToDevice(hkSpeed).speed;
+}
+// Night light levels: device uses 0-3, HomeKit uses discrete 0/33/66/100%
+exports.NL_LEVELS = {
+    OFF: 0,
+    WARM: 1,
+    NORMAL: 2,
+    BRIGHT: 3,
+};
+// HomeKit night light step - 3 brightness levels + off
+exports.NL_HOMEKIT_STEP = 33;
+// Convert device night light value (0-3) to HomeKit percentage (0, 33, 66, 100)
+function nlDeviceToHomeKit(deviceValue) {
+    switch (deviceValue) {
+        case 0:
+            return 0;
+        case 1:
+            return 33; // warm
+        case 2:
+            return 66; // normal
+        case 3:
+            return 100; // bright
+        default:
+            return 0;
+    }
+}
+// Convert HomeKit percentage to device night light value (0-3)
+function nlHomeKitToDevice(hkValue) {
+    if (hkValue <= 16) {
+        return exports.NL_LEVELS.OFF;
+    }
+    if (hkValue <= 49) {
+        return exports.NL_LEVELS.WARM;
+    }
+    if (hkValue <= 83) {
+        return exports.NL_LEVELS.NORMAL;
+    }
+    return exports.NL_LEVELS.BRIGHT;
+}
+// Get human-readable name for night light level
+function nlDeviceToName(deviceValue) {
+    switch (deviceValue) {
+        case 1:
+            return "Warm";
+        case 2:
+            return "Normal";
+        case 3:
+            return "Bright";
+        default:
+            return "Off";
+    }
+}
+// AQI thresholds for HomeKit AirQuality characteristic
+exports.AQI_THRESHOLDS = {
+    EXCELLENT: 50,
+    GOOD: 100,
+    FAIR: 150,
+    INFERIOR: 200,
+};
+// Default debounce delay for HomeKit slider interactions (ms)
+exports.DEBOUNCE_DELAY_MS = 500;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/device.d.ts

@@ -0,0 +1,49 @@
+/**
+ * BlueAirDevice - State management model for BlueAir devices
+ *
+ * This class acts as a bridge between the platform (API) and accessories (HomeKit).
+ * It holds device state, calculates AQI, and emits events for state changes.
+ */
+import EventEmitter from "events";
+import { BlueAirDeviceSensorData, BlueAirDeviceState, BlueAirDeviceStatus, FullBlueAirDeviceState } from "./api/BlueAirAwsApi";
+export type BlueAirSensorDataWithAqi = BlueAirDeviceSensorData & {
+    aqi?: number;
+};
+interface BlueAirDeviceEvents {
+    stateUpdated: (changedStates: Partial<FullBlueAirDeviceState>) => void;
+    update: (newState: BlueAirDeviceStatus) => void;
+    setState: (data: {
+        id: string;
+        name: string;
+        attribute: string;
+        value: number | boolean;
+    }) => void;
+    setStateDone: (success: boolean) => void;
+}
+export interface BlueAirDevice {
+    on<K extends keyof BlueAirDeviceEvents>(event: K, listener: BlueAirDeviceEvents[K]): this;
+    emit<K extends keyof BlueAirDeviceEvents>(event: K, ...args: Parameters<BlueAirDeviceEvents[K]>): boolean;
+    once<K extends keyof BlueAirDeviceEvents>(event: K, listener: BlueAirDeviceEvents[K]): this;
+}
+export declare class BlueAirDevice extends EventEmitter {
+    state: BlueAirDeviceState;
+    sensorData: BlueAirSensorDataWithAqi;
+    readonly id: string;
+    readonly name: string;
+    private mutex;
+    private currentChanges;
+    constructor(device: BlueAirDeviceStatus);
+    private hasChanges;
+    private notifyStateUpdate;
+    /**
+     * Request a state change on the device.
+     * Emits "setState" event for the platform to handle the API call.
+     * Waits for "setStateDone" before updating local state.
+     */
+    setState(attribute: string, value: number | boolean): Promise<void>;
+    private updateState;
+    private calculateAqi;
+    private calculateAqiForSensor;
+}
+export {};
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,UAAU,mBAAmB;IAC3B,YAAY,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;IACvE,MAAM,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;KACzB,KAAK,IAAI,CAAC;IACX,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAGD,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAAC;IACR,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACtC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC;IACX,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAAC;CACT;AAGD,qBAAa,aAAc,SAAQ,YAAY;IACtC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,wBAAwB,CAAC;IAE5C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,MAAM,EAAE,mBAAmB;IAqBvC,OAAO,CAAC,UAAU;YAOJ,iBAAiB;IAgC/B;;;;OAIG;IACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;YA0BlD,WAAW;IAoBzB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,qBAAqB;CAc9B"}

package/dist/device.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * BlueAirDevice - State management model for BlueAir devices
+ *
+ * This class acts as a bridge between the platform (API) and accessories (HomeKit).
+ * It holds device state, calculates AQI, and emits events for state changes.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlueAirDevice = void 0;
+const events_1 = __importDefault(require("events"));
+const async_mutex_1 = require("async-mutex");
+const constants_1 = require("./constants");
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+class BlueAirDevice extends events_1.default {
+    constructor(device) {
+        super();
+        this.id = device.id;
+        this.name = device.name;
+        this.state = device.state;
+        this.sensorData = {
+            ...device.sensorData,
+            aqi: undefined,
+        };
+        this.sensorData.aqi = this.calculateAqi();
+        this.mutex = new async_mutex_1.Mutex();
+        this.currentChanges = {
+            state: {},
+            sensorData: {},
+        };
+        this.on("update", this.updateState.bind(this));
+    }
+    hasChanges(changes) {
+        return (Object.keys(changes.state).length > 0 ||
+            Object.keys(changes.sensorData).length > 0);
+    }
+    async notifyStateUpdate(newState, newSensorData) {
+        this.currentChanges = {
+            state: {
+                ...this.currentChanges.state,
+                ...newState,
+            },
+            sensorData: {
+                ...this.currentChanges.sensorData,
+                ...newSensorData,
+            },
+        };
+        const release = await this.mutex.acquire();
+        const changesToApply = this.currentChanges;
+        this.currentChanges = { state: {}, sensorData: {} };
+        if (this.hasChanges(changesToApply)) {
+            this.state = { ...this.state, ...changesToApply.state };
+            this.sensorData = { ...this.sensorData, ...changesToApply.sensorData };
+            this.emit("stateUpdated", {
+                ...changesToApply.state,
+                ...changesToApply.sensorData,
+            });
+        }
+        release();
+    }
+    /**
+     * Request a state change on the device.
+     * Emits "setState" event for the platform to handle the API call.
+     * Waits for "setStateDone" before updating local state.
+     */
+    async setState(attribute, value) {
+        // Skip if value is unchanged
+        if (attribute in this.state && this.state[attribute] === value) {
+            return;
+        }
+        this.emit("setState", { id: this.id, name: this.name, attribute, value });
+        const release = await this.mutex.acquire();
+        return new Promise((resolve) => {
+            this.once("setStateDone", async (success) => {
+                release();
+                if (success) {
+                    const newState = { [attribute]: value };
+                    // Night mode turns off display brightness
+                    if (attribute === "nightmode" && value === true) {
+                        newState["brightness"] = 0;
+                    }
+                    await this.notifyStateUpdate(newState);
+                }
+                resolve();
+            });
+        });
+    }
+    async updateState(newState) {
+        const changedState = {};
+        const changedSensorData = {};
+        for (const [k, v] of Object.entries(newState.state)) {
+            if (this.state[k] !== v) {
+                changedState[k] = v;
+            }
+        }
+        for (const [k, v] of Object.entries(newState.sensorData)) {
+            if (this.sensorData[k] !== v) {
+                changedSensorData[k] = v;
+                if (k === "pm25" || k === "pm10" || k === "voc") {
+                    changedSensorData.aqi = this.calculateAqi();
+                }
+            }
+        }
+        await this.notifyStateUpdate(changedState, changedSensorData);
+    }
+    calculateAqi() {
+        if (this.sensorData.pm2_5 === undefined &&
+            this.sensorData.pm10 === undefined &&
+            this.sensorData.voc === undefined) {
+            return undefined;
+        }
+        const pm2_5 = Math.round((this.sensorData.pm2_5 || 0) * 10) / 10;
+        const pm10 = this.sensorData.pm10 || 0;
+        const voc = this.sensorData.voc || 0;
+        const aqi_pm2_5 = this.calculateAqiForSensor(pm2_5, "PM2_5");
+        const aqi_pm10 = this.calculateAqiForSensor(pm10, "PM10");
+        const aqi_voc = this.calculateAqiForSensor(voc, "VOC");
+        return Math.max(aqi_pm2_5, aqi_pm10, aqi_voc);
+    }
+    calculateAqiForSensor(value, sensor) {
+        const levels = constants_1.AQI[sensor];
+        for (let i = 0; i < levels.AQI_LO.length; i++) {
+            if (value >= levels.CONC_LO[i] && value <= levels.CONC_HI[i]) {
+                return Math.round(((levels.AQI_HI[i] - levels.AQI_LO[i]) /
+                    (levels.CONC_HI[i] - levels.CONC_LO[i])) *
+                    (value - levels.CONC_LO[i]) +
+                    levels.AQI_LO[i]);
+            }
+        }
+        return 0;
+    }
+}
+exports.BlueAirDevice = BlueAirDevice;
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,oDAAkC;AAOlC,6CAAoC;AACpC,2CAAkC;AAuClC,4EAA4E;AAC5E,MAAa,aAAc,SAAQ,gBAAY;IAU7C,YAAY,MAA2B;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAExB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG;YAChB,GAAG,MAAM,CAAC,UAAU;YACpB,GAAG,EAAE,SAAS;SACf,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1C,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAK,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG;YACpB,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE;SACf,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAEO,UAAU,CAAC,OAAuB;QACxC,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAC3C,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,QAAsC,EACtC,aAAgD;QAEhD,IAAI,CAAC,cAAc,GAAG;YACpB,KAAK,EAAE;gBACL,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK;gBAC5B,GAAG,QAAQ;aACZ;YACD,UAAU,EAAE;gBACV,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU;gBACjC,GAAG,aAAa;aACjB;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAE3C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAEpD,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;YACxD,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,cAAc,CAAC,UAAU,EAAE,CAAC;YACvE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;gBACxB,GAAG,cAAc,CAAC,KAAK;gBACvB,GAAG,cAAc,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,KAAuB;QAC9D,6BAA6B;QAC7B,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAE1E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAE3C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC1C,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,QAAQ,GAAgC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;oBACrE,0CAA0C;oBAC1C,IAAI,SAAS,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;wBAChD,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;oBAC7B,CAAC;oBACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,QAA6B;QACrD,MAAM,YAAY,GAAgC,EAAE,CAAC;QACrD,MAAM,iBAAiB,GAAsC,EAAE,CAAC;QAEhE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;oBAChD,iBAAiB,CAAC,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC9C,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;IAEO,YAAY;QAClB,IACE,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS;YACnC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,SAAS,EACjC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAErC,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEvD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAEO,qBAAqB,CAAC,KAAa,EAAE,MAAc;QACzD,MAAM,MAAM,GAAG,eAAG,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,IAAI,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACpC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBACxC,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CACnB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AA3JD,sCA2JC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("./utils");
+const platform_1 = require("./platform");
+/**
+ * This method registers the platform with Homebridge
+ */
+module.exports = (api) => {
+    api.registerPlatform(utils_1.PLATFORM_NAME, platform_1.BlueAirPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA,mCAAwC;AACxC,yCAA6C;AAE7C;;GAEG;AACH,MAAM,CAAC,OAAO,GAAG,CAAC,GAAQ,EAAE,EAAE;IAC5B,GAAG,CAAC,gBAAgB,CAAC,qBAAa,EAAE,0BAAe,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,35 @@
+import { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig, Service, Characteristic } from "homebridge";
+import { BlueAirDeviceStatus } from "./api/BlueAirAwsApi";
+import EventEmitter from "events";
+export declare class BlueAirPlatform extends EventEmitter implements DynamicPlatformPlugin {
+    readonly log: Logger;
+    readonly config: PlatformConfig;
+    readonly api: API;
+    readonly Service: typeof Service;
+    readonly Characteristic: typeof Characteristic;
+    readonly accessories: PlatformAccessory[];
+    private readonly platformConfig;
+    private readonly blueAirApi;
+    private existingUuids;
+    private devices;
+    private polling;
+    constructor(log: Logger, config: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private retryCount;
+    private readonly MAX_RETRY_COUNT;
+    getValidDevicesStatus(): Promise<void>;
+    getInitialDeviceStates(retryCount?: number, maxRetries?: number): Promise<void>;
+    addDevice(device: BlueAirDeviceStatus): Promise<void>;
+    /**
+     * Get available devices from API for auto-discovery
+     * Used by the configuration UI to populate available devices
+     */
+    getAvailableDevices(): Promise<Array<{
+        uuid: string;
+        name: string;
+        type: string;
+        mac: string;
+    }>>;
+    private isHumidifierDevice;
+}
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,qBAAqB,EACrB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,OAAO,EACP,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB,OAAsB,EACpB,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,YAAY,MAAM,QAAQ,CAAC;AAElC,qBAAa,eACX,SAAQ,YACR,YAAW,qBAAqB;aAiBd,GAAG,EAAE,MAAM;aACX,MAAM,EAAE,cAAc;aACtB,GAAG,EAAE,GAAG;IAjB1B,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxC,SAAgB,cAAc,EAAE,OAAO,cAAc,CAAC;IAGtD,SAAgB,WAAW,EAAE,iBAAiB,EAAE,CAAM;IAEtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAA+B;gBAG5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,GAAG;IAqC1B,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAK/C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IAE/B,qBAAqB;IAyErB,sBAAsB,CAAC,UAAU,SAAI,EAAE,UAAU,SAAI;IAmFrD,SAAS,CAAC,MAAM,EAAE,mBAAmB;IA4E3C;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAClC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CACjE;IAgBD,OAAO,CAAC,kBAAkB;CA6B3B"}