@mp-consulting/homebridge-daikin-cloud 1.5.1 → 1.6.0

package/dist/src/types/daikin-enums.js

@@ -4,7 +4,7 @@
  * These enums represent the values used by the Daikin Cloud API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DaikinTemperatureControlSetpoints = exports.DaikinSetpointModes = exports.DaikinControlModes = exports.DaikinOutdoorSilentModes = exports.DaikinStreamerModes = exports.DaikinEconoModes = exports.DaikinPowerfulModes = exports.DaikinFanDirectionVerticalModes = exports.DaikinFanDirectionHorizontalModes = exports.DaikinFanSpeedModes = exports.DaikinOperationModes = exports.DaikinOnOffModes = void 0;
+exports.DaikinTemperatureControlSetpoints = exports.DaikinSetpointModes = exports.DaikinControlModes = exports.DaikinOutdoorSilentModes = exports.DaikinStreamerModes = exports.DaikinEconoModes = exports.DaikinPowerfulModes = exports.DaikinFanDirectionHorizontalModes = exports.DaikinFanSpeedModes = exports.DaikinOperationModes = exports.DaikinOnOffModes = void 0;
 var DaikinOnOffModes;
 (function (DaikinOnOffModes) {
     DaikinOnOffModes["ON"] = "on";
@@ -29,12 +29,6 @@ var DaikinFanDirectionHorizontalModes;
     DaikinFanDirectionHorizontalModes["STOP"] = "stop";
     DaikinFanDirectionHorizontalModes["SWING"] = "swing";
 })(DaikinFanDirectionHorizontalModes || (exports.DaikinFanDirectionHorizontalModes = DaikinFanDirectionHorizontalModes = {}));
-var DaikinFanDirectionVerticalModes;
-(function (DaikinFanDirectionVerticalModes) {
-    DaikinFanDirectionVerticalModes["STOP"] = "stop";
-    DaikinFanDirectionVerticalModes["SWING"] = "swing";
-    DaikinFanDirectionVerticalModes["WIND_NICE"] = "windNice";
-})(DaikinFanDirectionVerticalModes || (exports.DaikinFanDirectionVerticalModes = DaikinFanDirectionVerticalModes = {}));
 var DaikinPowerfulModes;
 (function (DaikinPowerfulModes) {
     DaikinPowerfulModes["ON"] = "on";

package/dist/src/types/daikin-enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"daikin-enums.js","sourceRoot":"","sources":["../../../src/types/daikin-enums.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,6BAAS,CAAA;IACT,+BAAW,CAAA;AACf,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,4CAAoB,CAAA;IACpB,2CAAmB,CAAA;IACnB,2CAAmB,CAAA;IACnB,qCAAa,CAAA;IACb,mCAAW,CAAA;AACf,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,sCAAe,CAAA;IACf,sCAAe,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAED,IAAY,iCAGX;AAHD,WAAY,iCAAiC;IACzC,kDAAa,CAAA;IACb,oDAAe,CAAA;AACnB,CAAC,EAHW,iCAAiC,iDAAjC,iCAAiC,QAG5C;AAED,IAAY,+BAIX;AAJD,WAAY,+BAA+B;IACvC,gDAAa,CAAA;IACb,kDAAe,CAAA;IACf,yDAAsB,CAAA;AAC1B,CAAC,EAJW,+BAA+B,+CAA/B,+BAA+B,QAI1C;AAED,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gCAAS,CAAA;IACT,kCAAW,CAAA;AACf,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,6BAAS,CAAA;IACT,+BAAW,CAAA;AACf,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gCAAS,CAAA;IACT,kCAAW,CAAA;AACf,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,qCAAS,CAAA;IACT,uCAAW,CAAA;AACf,CAAC,EAHW,wBAAwB,wCAAxB,wBAAwB,QAGnC;AAED,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,0DAAoC,CAAA;IACpC,2EAAqD,CAAA;IACrD,2EAAqD,CAAA;AACzD,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC3B,sCAAe,CAAA;IACf,sGAA+E,CAAA;IAC/E,6DAAsC,CAAA;AAC1C,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAED,IAAY,iCAIX;AAJD,WAAY,iCAAiC;IACzC,yEAAoC,CAAA;IACpC,gFAA2C,CAAA;IAC3C,0FAAqD,CAAA;AACzD,CAAC,EAJW,iCAAiC,iDAAjC,iCAAiC,QAI5C"}
+{"version":3,"file":"daikin-enums.js","sourceRoot":"","sources":["../../../src/types/daikin-enums.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,6BAAS,CAAA;IACT,+BAAW,CAAA;AACf,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,4CAAoB,CAAA;IACpB,2CAAmB,CAAA;IACnB,2CAAmB,CAAA;IACnB,qCAAa,CAAA;IACb,mCAAW,CAAA;AACf,CAAC,EANW,oBAAoB,oCAApB,oBAAoB,QAM/B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,sCAAe,CAAA;IACf,sCAAe,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAED,IAAY,iCAGX;AAHD,WAAY,iCAAiC;IACzC,kDAAa,CAAA;IACb,oDAAe,CAAA;AACnB,CAAC,EAHW,iCAAiC,iDAAjC,iCAAiC,QAG5C;AAED,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gCAAS,CAAA;IACT,kCAAW,CAAA;AACf,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,6BAAS,CAAA;IACT,+BAAW,CAAA;AACf,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gCAAS,CAAA;IACT,kCAAW,CAAA;AACf,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,qCAAS,CAAA;IACT,uCAAW,CAAA;AACf,CAAC,EAHW,wBAAwB,wCAAxB,wBAAwB,QAGnC;AAED,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,0DAAoC,CAAA;IACpC,2EAAqD,CAAA;IACrD,2EAAqD,CAAA;AACzD,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC3B,sCAAe,CAAA;IACf,sGAA+E,CAAA;IAC/E,6DAAsC,CAAA;AAC1C,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAED,IAAY,iCAIX;AAJD,WAAY,iCAAiC;IACzC,yEAAoC,CAAA;IACpC,gFAA2C,CAAA;IAC3C,0FAAqD,CAAA;AACzD,CAAC,EAJW,iCAAiC,iDAAjC,iCAAiC,QAI5C"}

package/dist/src/types/device-capabilities.d.ts

@@ -19,6 +19,7 @@ export interface DeviceCapabilities {
     hasSwingModeVertical: boolean;
     hasSwingModeHorizontal: boolean;
     hasFanControl: boolean;
+    hasHolidayMode: boolean;
     supportedOperationModes: DaikinOperationModes[];
     hasDryOperationMode: boolean;
     hasFanOnlyOperationMode: boolean;

package/dist/src/types/device-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-capabilities.d.ts","sourceRoot":"","sources":["../../../src/types/device-capabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAE/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB,EAAE,OAAO,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IAGpB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IAGvB,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;IAChD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IAGjC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IAGrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC7C"}
+{"version":3,"file":"device-capabilities.d.ts","sourceRoot":"","sources":["../../../src/types/device-capabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAE/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB,EAAE,OAAO,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IAGpB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IAGxB,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;IAChD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IAGjC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IAGrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC7C"}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Error helpers
+ */
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ * `JSON.stringify(new Error('x'))` yields `{}`, so always go through this.
+ */
+export declare function toMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYhD"}

package/dist/src/utils/errors.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Error helpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMessage = toMessage;
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ * `JSON.stringify(new Error('x'))` yields `{}`, so always go through this.
+ */
+function toMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,8BAYC;AAhBD;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/utils/hap-write.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HAP write helper
+ *
+ * Every HomeKit setter that talks to the Daikin cloud follows the same shape:
+ * run the write, schedule a (debounced) device refresh so the cache catches up
+ * with the cloud, and on failure log a warning and throw
+ * HapStatusError(SERVICE_COMMUNICATION_FAILURE) so HomeKit shows "No Response"
+ * instead of Homebridge logging "plugin threw an error".
+ */
+import type { DaikinCloudPlatform } from '../platform';
+export type HapWritePlatform = Pick<DaikinCloudPlatform, 'log' | 'api' | 'forceUpdateDevices'>;
+export interface HapWriteOptions {
+    /** Schedule a device refresh after a successful write (default: true). */
+    refresh?: boolean;
+}
+/**
+ * Run `op` as a HomeKit-initiated device write.
+ *
+ * @param label - Prefix for the failure log line, e.g. `[Living room] CoolingThresholdTemperature`.
+ */
+export declare function withHapWrite<T>(platform: HapWritePlatform, label: string, op: () => Promise<T>, options?: HapWriteOptions): Promise<T>;
+//# sourceMappingURL=hap-write.d.ts.map

package/dist/src/utils/hap-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hap-write.d.ts","sourceRoot":"","sources":["../../../src/utils/hap-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,KAAK,GAAG,oBAAoB,CAAC,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/src/utils/hap-write.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * HAP write helper
+ *
+ * Every HomeKit setter that talks to the Daikin cloud follows the same shape:
+ * run the write, schedule a (debounced) device refresh so the cache catches up
+ * with the cloud, and on failure log a warning and throw
+ * HapStatusError(SERVICE_COMMUNICATION_FAILURE) so HomeKit shows "No Response"
+ * instead of Homebridge logging "plugin threw an error".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withHapWrite = withHapWrite;
+const errors_1 = require("./errors");
+/**
+ * Run `op` as a HomeKit-initiated device write.
+ *
+ * @param label - Prefix for the failure log line, e.g. `[Living room] CoolingThresholdTemperature`.
+ */
+async function withHapWrite(platform, label, op, options = {}) {
+    let result;
+    try {
+        result = await op();
+    }
+    catch (e) {
+        platform.log.warn(`${label}: write failed: ${(0, errors_1.toMessage)(e)}`);
+        throw new platform.api.hap.HapStatusError(-70402 /* platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE */);
+    }
+    if (options.refresh !== false) {
+        platform.forceUpdateDevices();
+    }
+    return result;
+}
+//# sourceMappingURL=hap-write.js.map

package/dist/src/utils/hap-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hap-write.js","sourceRoot":"","sources":["../../../src/utils/hap-write.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAiBH,oCAiBC;AA/BD,qCAAqC;AASrC;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAChC,QAA0B,EAC1B,KAAa,EACb,EAAoB,EACpB,UAA2B,EAAE;IAE7B,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,mBAAmB,IAAA,kBAAS,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,uEAA0D,CAAC;IACtG,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC9B,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/utils/sleep.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolve after `ms` milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/src/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/src/utils/sleep.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+/**
+ * Resolve after `ms` milliseconds.
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/src/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":";;AAGA,sBAEC;AALD;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/homebridge-ui/README.md

@@ -14,6 +14,7 @@ Custom UI for the Daikin Cloud plugin, providing an integrated authentication ex
 
 - `server.js` - Server-side handlers for OAuth flow and API communication
 - `public/index.html` - Custom UI with authentication wizard
+- `public/script.js` - Client-side logic for the custom UI
 
 ## How It Works
 
@@ -28,8 +29,30 @@ Custom UI for the Daikin Cloud plugin, providing an integrated authentication ex
 | Endpoint | Description |
 |----------|-------------|
 | `/auth/status` | Get current authentication status |
-| `/auth/start` | Start OAuth authorization flow |
-| `/auth/callback` | Handle OAuth callback with auth code |
+| `/auth/start` | Start the OAuth authorization flow and the HTTPS callback server |
+| `/auth/` | Complete the flow manually from a pasted callback URL (code and `state` required) |
+| `/auth/poll` | Poll for the result captured by the callback server |
+| `/auth/stop-server` | Cancel the flow and stop the callback server |
+| `/auth/mobile-test` | Test and store Mobile App (Onecta) credentials |
 | `/auth/revoke` | Revoke current authentication |
 | `/auth/test` | Test API connection |
 | `/config/validate` | Validate configuration |
+| `/devices/list` | List devices (cached for 5 minutes per auth mode; pass `refresh: true` to bypass) |
+| `/api/rate-limit` | Last rate limit status recorded by the running plugin (no API call) |
+| `/server/info` | Host IP addresses, used to prefill the callback address |
+
+## Security Notes
+
+- The callback server binds to `oidcCallbackServerBindAddr` (an IPv4/IPv6 literal, default `0.0.0.0`).
+  A loopback bind address is refused when the callback address is not loopback, because the
+  browser redirect could never reach it.
+- The callback server stops automatically when the 10-minute authorization window expires.
+- Callback requests are only honoured when their `state` matches the pending authorization; the
+  callback page is served with a restrictive Content-Security-Policy and escaped content.
+
+## API Quota
+
+The Daikin API has a daily quota (200 requests for the Developer Portal). The UI shares one
+`/devices/list` request between the Devices and Settings tabs, the server caches that result for
+5 minutes (cleared on any authentication change), and the rate limit check reads the status file
+the plugin writes (`.daikin-rate-limit.json` in the Homebridge storage path) instead of calling the API.

package/homebridge-ui/public/index.html

@@ -24,7 +24,7 @@
                 <div class="mp-header-title">Daikin Cloud</div>
                 <div class="mp-header-subtitle">Onecta integration for HomeKit</div>
             </div>
-            <div class="ms-auto d-flex align-items-center gap-2">
+            <div class="header-status ms-auto d-flex align-items-center gap-2">
                 <span class="text-muted small" id="header-info">
                     <span id="token-expires-label" class="d-none">Expires in: </span>
                     <span id="token-expires" class="fw-medium"></span>
@@ -37,7 +37,7 @@
         </div>
 
         <!-- Tab Navigation -->
-        <ul class="nav nav-pills mb-3" role="tablist">
+        <ul class="nav nav-pills app-tabs mb-3" role="tablist">
             <li class="nav-item" role="presentation">
                 <button class="nav-link active" data-tab="devices" onclick="switchTab('devices')">
                     Devices
@@ -91,7 +91,7 @@
                 </div>
 
                 <!-- Settings Sub-tabs -->
-                <ul class="nav nav-tabs nav-fill mb-3">
+                <ul class="nav nav-tabs nav-fill app-tabs mb-3">
                     <li class="nav-item">
                         <button class="nav-link active" data-subtab="features" onclick="switchSettingsSubtab('features')">Features</button>
                     </li>
@@ -113,7 +113,7 @@
                         <div class="card-body">
                             <p class="text-muted small mb-3">Enable switches for additional modes in HomeKit</p>
                             <div class="list-group list-group-flush">
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Powerful Mode</div>
                                         <small class="text-muted">Boost heating/cooling performance</small>
@@ -122,7 +122,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showPowerfulMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Econo Mode</div>
                                         <small class="text-muted">Energy-saving operation</small>
@@ -131,7 +131,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showEconoMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Streamer Mode</div>
                                         <small class="text-muted">Air purification</small>
@@ -140,7 +140,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showStreamerMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Outdoor Silent Mode</div>
                                         <small class="text-muted">Reduce outdoor unit noise</small>
@@ -149,7 +149,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showOutdoorSilentMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Indoor Silent Mode</div>
                                         <small class="text-muted">Quiet fan operation</small>
@@ -158,7 +158,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showIndoorSilentMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Auto Fan Mode</div>
                                         <small class="text-muted">Automatic fan speed (switch)</small>
@@ -167,7 +167,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showAutoFanMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Oscillation Switch</div>
                                         <small class="text-muted">Swing as a separate switch (stays visible when grouped into a single tile)</small>
@@ -176,7 +176,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showOscillationSwitch">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Separate Fan Tile</div>
                                         <small class="text-muted">Fan speed + oscillation as a standalone Fan tile (stays visible when grouped into a single tile)</small>
@@ -185,7 +185,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showSeparateFanControl">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Dry Mode</div>
                                         <small class="text-muted">Dehumidification</small>
@@ -194,7 +194,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showDryMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Fan Only Mode</div>
                                         <small class="text-muted">Fan without heating/cooling</small>
@@ -203,7 +203,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showFanOnlyMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Holiday Mode</div>
                                         <small class="text-muted">Holiday / away mode as a switch</small>
@@ -212,7 +212,7 @@
                                         <input class="form-check-input" type="checkbox" role="switch" id="showHolidayMode">
                                     </div>
                                 </div>
-                                <div class="list-group-item d-flex justify-content-between align-items-center">
+                                <div class="list-group-item d-flex justify-content-between align-items-center gap-3">
                                     <div>
                                         <div class="fw-medium">Firmware Update</div>
                                         <small class="text-muted">Install staged gateway firmware updates from HomeKit. Never enabled implicitly &mdash; the unit is unavailable while it updates</small>
@@ -265,7 +265,7 @@
                                 <label class="form-label" for="oidcCallbackServerBindAddr">OIDC Callback Bind Address</label>
                                 <input type="text" class="form-control" id="oidcCallbackServerBindAddr" placeholder="0.0.0.0" value="0.0.0.0"
                                        pattern="^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)\.?\b){4}$">
-                                <div class="form-text">IPv4 address for OAuth callback server (use 0.0.0.0 for all interfaces)</div>
+                                <div class="form-text">IPv4 address for OAuth callback server (use 0.0.0.0 for all interfaces). 127.0.0.1 only accepts connections from this host, so the login redirect cannot reach it.</div>
                             </div>
                             <div class="mt-3 mb-0">
                                 <label class="form-label" for="httpTransport">HTTP Transport</label>
@@ -317,7 +317,7 @@
                 <!-- Auth Status -->
                 <div class="card mb-3" id="auth-status-card">
                     <div class="card-body">
-                        <div class="row mb-3">
+                        <div class="row g-3 mb-3">
                             <div class="col-auto">
                                 <div class="text-muted small text-uppercase">Status</div>
                                 <div class="fw-semibold" id="auth-status">Loading...</div>
@@ -534,6 +534,8 @@
                     <div class="card-body">
                         <div id="rate-limit-display" class="fw-semibold mb-1">200 requests/day</div>
                         <div class="text-muted small" id="rate-limit-info">The Daikin API limits you to 200 requests per day.</div>
+                        <div class="text-muted small d-none" id="rate-limit-updated"></div>
+                        <div class="text-muted small mt-1">Check shows the quota reported on the plugin's most recent API call; it does not use an API request itself.</div>
                     </div>
                 </div>
 

package/homebridge-ui/public/lib/kit.css

@@ -1,4 +1,4 @@
-/* @mp-consulting/homebridge-ui-kit v1.0.0 */
+/* @mp-consulting/homebridge-ui-kit v1.0.1 */
 
 /* ── Design tokens ──────────────────────────────────────────────────────────
    CSS custom properties used throughout the design system.