iobroker.homewizard 0.6.1 → 0.6.3

package/README.md

@@ -45,8 +45,6 @@ Real-time energy monitoring from [HomeWizard](https://www.homewizard.com) Energy
 | kWh Meter 3-Phase | HWE-KWH3 / SDM630 | Yes | Yes (as controller) |
 | Plug-In Battery | HWE-BAT | Yes | Controlled via P1/kWh |
 
-> **Note:** Energy Socket (HWE-SKT) and Watermeter (HWE-WTR) only support API v1 and are not yet supported. Support will be added when HomeWizard releases API v2 for these devices.
-
 ---
 
 ## Configuration
@@ -100,7 +98,9 @@ homewizard.0.
     ├── measurement/             — Measurement data
     │   ├── power_w              — Total power (number, W)
     │   ├── power_l1_w .. l3_w   — Power per phase (number, W)
+    │   ├── voltage_v            — Voltage single-phase (number, V)
     │   ├── voltage_l1_v .. l3_v — Voltage per phase (number, V)
+    │   ├── current_a            — Current single-phase (number, A)
     │   ├── current_l1_a .. l3_a — Current per phase (number, A)
     │   ├── frequency_hz         — Grid frequency (number, Hz)
     │   ├── energy_import_kwh    — Total import (number, kWh)
@@ -108,6 +108,13 @@ homewizard.0.
     │   ├── energy_export_kwh    — Total export (number, kWh)
     │   ├── energy_export_t1..t4_kwh — Export per tariff (number, kWh)
     │   ├── tariff               — Active tariff (number)
+    │   ├── state_of_charge_pct  — Battery charge level (number, %)
+    │   ├── cycles               — Battery charge cycles (number)
+    │   ├── average_power_15m_w  — 15-min average power (number, W, Belgium)
+    │   ├── monthly_power_peak_w — Monthly power peak (number, W, Belgium)
+    │   ├── monthly_power_peak_timestamp — Monthly peak timestamp (string)
+    │   ├── meter_model          — Meter model identifier (string)
+    │   ├── timestamp            — Measurement timestamp (string)
     │   ├── quality/             — Power quality counters
     │   │   ├── voltage_sag_l1..l3_count
     │   │   ├── voltage_swell_l1..l3_count
@@ -135,7 +142,7 @@ homewizard.0.
         └── identify             — Blink LED (button)
 ```
 
-> States are created dynamically based on what the device reports. Not all devices have all states.
+> States are created dynamically based on what the device reports. Not all devices have all states. kWh meters additionally provide apparent/reactive current, apparent/reactive power, and power factor states.
 
 ---
 
@@ -158,6 +165,17 @@ homewizard.0.
 
 ## Changelog
 
+### 0.6.3 (2026-04-18)
+- Harden WebSocket and REST input handling against unexpected API responses
+- Stop endless reconnect when the device token is invalid (fires once after 3 failed auth attempts)
+- Avoid creating an empty `external/` channel when a device reports no external meters
+
+### 0.6.2 (2026-04-13)
+- Fix hanging promise when response stream errors mid-transfer (`res.on("error")`)
+- Fix onUnload: wrap in try/finally so callback always fires (prevents adapter hang on shutdown)
+- Optimize state creation hot path: use `setObjectNotExistsAsync` instead of `extendObjectAsync` (~50 fewer object writes per second per device)
+- Remove unnecessary `removeDeviceFromObject` wrapper (DRY)
+
 ### 0.6.1 (2026-04-12)
 - Code cleanup: extract testable connection-utils module (classifyError, createDeviceConnection)
 - Add 20 unit tests for error classification, connection factory, and unstable threshold
@@ -180,12 +198,6 @@ homewizard.0.
 ### 0.4.2 (2026-04-05)
 - Consistent donation labels and about text across all adapters
 
-### 0.4.1 (2026-04-05)
-- Move measurement data into `measurement/` channel for cleaner object tree
-
-### 0.4.0 (2026-04-05)
-- Add online/offline status icon for devices (`statusStates`)
-
 Older entries have been moved to [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
 ---

package/build/lib/coerce.js

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var coerce_exports = {};
+__export(coerce_exports, {
+  coerceBoolean: () => coerceBoolean,
+  coerceFiniteNumber: () => coerceFiniteNumber,
+  coerceString: () => coerceString,
+  isPlainObject: () => isPlainObject
+});
+module.exports = __toCommonJS(coerce_exports);
+function coerceFiniteNumber(value) {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : null;
+  }
+  if (typeof value === "string" && value.length > 0) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+  }
+  return null;
+}
+function coerceString(value) {
+  if (typeof value === "string" && value.length > 0) {
+    return value;
+  }
+  return null;
+}
+function coerceBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  return null;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  coerceBoolean,
+  coerceFiniteNumber,
+  coerceString,
+  isPlainObject
+});
+//# sourceMappingURL=coerce.js.map

package/build/lib/coerce.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/coerce.ts"],
+  "sourcesContent": ["/**\n * Boundary coercion helpers for external API data (REST + WebSocket).\n * HomeWizard API v2 is well-documented but field types still drift in practice\n * (firmware bugs, future additions, null values). These helpers guard against\n * NaN/Infinity/non-string values reaching ioBroker states.\n */\n\n/**\n * Coerce to a finite number or null.\n * Accepts numbers directly; parses numeric strings; rejects NaN/Infinity/other.\n *\n * @param value Unknown external value\n */\nexport function coerceFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : null;\n  }\n  if (typeof value === \"string\" && value.length > 0) {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/**\n * Coerce to a non-empty string, or null.\n *\n * @param value Unknown external value\n */\nexport function coerceString(value: unknown): string | null {\n  if (typeof value === \"string\" && value.length > 0) {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Coerce to a boolean (only `true`/`false` accepted \u2014 no truthy/falsy JS rules).\n *\n * @param value Unknown external value\n */\nexport function coerceBoolean(value: unknown): boolean | null {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Guard for plain objects (not arrays, not null).\n *\n * @param value Unknown external value\n */\nexport function isPlainObject(\n  value: unknown,\n): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,mBAAmB,OAA+B;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAG;AACjD,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAOO,SAAS,aAAa,OAA+B;AAC1D,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAG;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cAAc,OAAgC;AAC5D,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cACd,OACkC;AAClC,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;",
+  "names": []
+}

package/build/lib/homewizard-client.js

@@ -121,6 +121,7 @@ class HomeWizardClient {
         },
         (res) => {
           const chunks = [];
+          res.on("error", reject);
           res.on("data", (chunk) => chunks.push(chunk));
           res.on("end", () => {
             var _a;

package/build/lib/homewizard-client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/homewizard-client.ts"],
-  "sourcesContent": ["import * as https from \"node:https\";\nimport { HW_AGENT } from \"./cacert\";\nimport type {\n  BatteryControl,\n  DeviceInfo,\n  Measurement,\n  PairingResponse,\n  SystemInfo,\n} from \"./types\";\n\n/** HTTPS client for HomeWizard API v2 */\nexport class HomeWizardClient {\n  private readonly ip: string;\n  private readonly token: string;\n\n  /**\n   * @param ip Device IP address\n   * @param token Bearer token (empty string for pairing requests)\n   */\n  constructor(ip: string, token: string = \"\") {\n    this.ip = ip;\n    this.token = token;\n  }\n\n  /** Get device info (GET /api) */\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    return this.request<DeviceInfo>(\"GET\", \"/api\");\n  }\n\n  /** Request pairing token (POST /api/user) \u2014 403 until button pressed */\n  async requestPairing(): Promise<PairingResponse> {\n    return this.request<PairingResponse>(\"POST\", \"/api/user\", {\n      name: \"local/iobroker\",\n    });\n  }\n\n  /** Get current measurement (REST fallback) */\n  async getMeasurement(): Promise<Measurement> {\n    return this.request<Measurement>(\"GET\", \"/api/measurement\");\n  }\n\n  /** Get system info */\n  async getSystem(): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"GET\", \"/api/system\");\n  }\n\n  /**\n   * Update system settings\n   *\n   * @param settings System settings to update\n   */\n  async setSystem(settings: Partial<SystemInfo>): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"PUT\", \"/api/system\", settings);\n  }\n\n  /** Reboot device */\n  async reboot(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/reboot\");\n  }\n\n  /** Identify device (blink LED) */\n  async identify(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/identify\");\n  }\n\n  /** Get battery control status */\n  async getBatteries(): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"GET\", \"/api/batteries\");\n  }\n\n  /**\n   * Set battery control\n   *\n   * @param settings Battery control settings to update\n   */\n  async setBatteries(\n    settings: Partial<BatteryControl>,\n  ): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"PUT\", \"/api/batteries\", settings);\n  }\n\n  /**\n   * @param method HTTP method\n   * @param path API path\n   * @param body Optional request body\n   */\n  private request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const bodyStr = body ? JSON.stringify(body) : undefined;\n      const headers: Record<string, string> = {\n        \"X-Api-Version\": \"2\",\n      };\n\n      if (this.token) {\n        headers.Authorization = `Bearer ${this.token}`;\n      }\n      if (bodyStr) {\n        headers[\"Content-Type\"] = \"application/json\";\n        headers[\"Content-Length\"] = Buffer.byteLength(bodyStr).toString();\n      }\n\n      const req = https.request(\n        {\n          hostname: this.ip,\n          port: 443,\n          path,\n          method,\n          headers,\n          agent: HW_AGENT,\n          timeout: 10_000,\n        },\n        (res) => {\n          const chunks: Buffer[] = [];\n          res.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n          res.on(\"end\", () => {\n            const data = Buffer.concat(chunks).toString();\n            if (!res.statusCode || res.statusCode >= 400) {\n              const error = new HomeWizardApiError(\n                res.statusCode ?? 0,\n                data,\n                `${method} ${path}`,\n              );\n              reject(error);\n              return;\n            }\n            if (!data) {\n              resolve(undefined as T);\n              return;\n            }\n            try {\n              resolve(JSON.parse(data) as T);\n            } catch {\n              reject(\n                new Error(\n                  `Invalid JSON from ${method} ${path}: ${data.substring(0, 200)}`,\n                ),\n              );\n            }\n          });\n        },\n      );\n\n      req.on(\"error\", reject);\n      req.on(\"timeout\", () => {\n        req.destroy(new Error(`Timeout: ${method} ${path}`));\n      });\n\n      if (bodyStr) {\n        req.write(bodyStr);\n      }\n      req.end();\n    });\n  }\n}\n\n/** API error with status code and parsed error body */\nexport class HomeWizardApiError extends Error {\n  readonly statusCode: number;\n  readonly errorCode: string;\n\n  /**\n   * @param statusCode HTTP status code\n   * @param body Response body\n   * @param context Request context for error message\n   */\n  constructor(statusCode: number, body: string, context: string) {\n    let errorCode = \"unknown\";\n    let description = body;\n    try {\n      const parsed = JSON.parse(body);\n      errorCode = parsed.error?.code ?? parsed.error ?? \"unknown\";\n      description = parsed.error?.description ?? parsed.error?.code ?? body;\n    } catch {\n      // body is not JSON\n    }\n    super(`${context}: HTTP ${statusCode} \u2014 ${description}`);\n    this.name = \"HomeWizardApiError\";\n    this.statusCode = statusCode;\n    this.errorCode = errorCode;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as https from \"node:https\";\nimport { HW_AGENT } from \"./cacert\";\nimport type {\n  BatteryControl,\n  DeviceInfo,\n  Measurement,\n  PairingResponse,\n  SystemInfo,\n} from \"./types\";\n\n/** HTTPS client for HomeWizard API v2 */\nexport class HomeWizardClient {\n  private readonly ip: string;\n  private readonly token: string;\n\n  /**\n   * @param ip Device IP address\n   * @param token Bearer token (empty string for pairing requests)\n   */\n  constructor(ip: string, token: string = \"\") {\n    this.ip = ip;\n    this.token = token;\n  }\n\n  /** Get device info (GET /api) */\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    return this.request<DeviceInfo>(\"GET\", \"/api\");\n  }\n\n  /** Request pairing token (POST /api/user) \u2014 403 until button pressed */\n  async requestPairing(): Promise<PairingResponse> {\n    return this.request<PairingResponse>(\"POST\", \"/api/user\", {\n      name: \"local/iobroker\",\n    });\n  }\n\n  /** Get current measurement (REST fallback) */\n  async getMeasurement(): Promise<Measurement> {\n    return this.request<Measurement>(\"GET\", \"/api/measurement\");\n  }\n\n  /** Get system info */\n  async getSystem(): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"GET\", \"/api/system\");\n  }\n\n  /**\n   * Update system settings\n   *\n   * @param settings System settings to update\n   */\n  async setSystem(settings: Partial<SystemInfo>): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"PUT\", \"/api/system\", settings);\n  }\n\n  /** Reboot device */\n  async reboot(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/reboot\");\n  }\n\n  /** Identify device (blink LED) */\n  async identify(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/identify\");\n  }\n\n  /** Get battery control status */\n  async getBatteries(): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"GET\", \"/api/batteries\");\n  }\n\n  /**\n   * Set battery control\n   *\n   * @param settings Battery control settings to update\n   */\n  async setBatteries(\n    settings: Partial<BatteryControl>,\n  ): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"PUT\", \"/api/batteries\", settings);\n  }\n\n  /**\n   * @param method HTTP method\n   * @param path API path\n   * @param body Optional request body\n   */\n  private request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const bodyStr = body ? JSON.stringify(body) : undefined;\n      const headers: Record<string, string> = {\n        \"X-Api-Version\": \"2\",\n      };\n\n      if (this.token) {\n        headers.Authorization = `Bearer ${this.token}`;\n      }\n      if (bodyStr) {\n        headers[\"Content-Type\"] = \"application/json\";\n        headers[\"Content-Length\"] = Buffer.byteLength(bodyStr).toString();\n      }\n\n      const req = https.request(\n        {\n          hostname: this.ip,\n          port: 443,\n          path,\n          method,\n          headers,\n          agent: HW_AGENT,\n          timeout: 10_000,\n        },\n        (res) => {\n          const chunks: Buffer[] = [];\n          res.on(\"error\", reject);\n          res.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n          res.on(\"end\", () => {\n            const data = Buffer.concat(chunks).toString();\n            if (!res.statusCode || res.statusCode >= 400) {\n              const error = new HomeWizardApiError(\n                res.statusCode ?? 0,\n                data,\n                `${method} ${path}`,\n              );\n              reject(error);\n              return;\n            }\n            if (!data) {\n              resolve(undefined as T);\n              return;\n            }\n            try {\n              resolve(JSON.parse(data) as T);\n            } catch {\n              reject(\n                new Error(\n                  `Invalid JSON from ${method} ${path}: ${data.substring(0, 200)}`,\n                ),\n              );\n            }\n          });\n        },\n      );\n\n      req.on(\"error\", reject);\n      req.on(\"timeout\", () => {\n        req.destroy(new Error(`Timeout: ${method} ${path}`));\n      });\n\n      if (bodyStr) {\n        req.write(bodyStr);\n      }\n      req.end();\n    });\n  }\n}\n\n/** API error with status code and parsed error body */\nexport class HomeWizardApiError extends Error {\n  readonly statusCode: number;\n  readonly errorCode: string;\n\n  /**\n   * @param statusCode HTTP status code\n   * @param body Response body\n   * @param context Request context for error message\n   */\n  constructor(statusCode: number, body: string, context: string) {\n    let errorCode = \"unknown\";\n    let description = body;\n    try {\n      const parsed = JSON.parse(body);\n      errorCode = parsed.error?.code ?? parsed.error ?? \"unknown\";\n      description = parsed.error?.description ?? parsed.error?.code ?? body;\n    } catch {\n      // body is not JSON\n    }\n    super(`${context}: HTTP ${statusCode} \u2014 ${description}`);\n    this.name = \"HomeWizardApiError\";\n    this.statusCode = statusCode;\n    this.errorCode = errorCode;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAAuB;AACvB,oBAAyB;AAUlB,MAAM,iBAAiB;AAAA,EACX;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjB,YAAY,IAAY,QAAgB,IAAI;AAC1C,SAAK,KAAK;AACV,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,MAAM,gBAAqC;AACzC,WAAO,KAAK,QAAoB,OAAO,MAAM;AAAA,EAC/C;AAAA;AAAA,EAGA,MAAM,iBAA2C;AAC/C,WAAO,KAAK,QAAyB,QAAQ,aAAa;AAAA,MACxD,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,iBAAuC;AAC3C,WAAO,KAAK,QAAqB,OAAO,kBAAkB;AAAA,EAC5D;AAAA;AAAA,EAGA,MAAM,YAAiC;AACrC,WAAO,KAAK,QAAoB,OAAO,aAAa;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,UAAoD;AAClE,WAAO,KAAK,QAAoB,OAAO,eAAe,QAAQ;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,SAAwB;AAC5B,UAAM,KAAK,QAAQ,OAAO,oBAAoB;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,WAA0B;AAC9B,UAAM,KAAK,QAAQ,OAAO,sBAAsB;AAAA,EAClD;AAAA;AAAA,EAGA,MAAM,eAAwC;AAC5C,WAAO,KAAK,QAAwB,OAAO,gBAAgB;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aACJ,UACyB;AACzB,WAAO,KAAK,QAAwB,OAAO,kBAAkB,QAAQ;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,QAAW,QAAgB,MAAc,MAA4B;AAC3E,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,UAAU,OAAO,KAAK,UAAU,IAAI,IAAI;AAC9C,YAAM,UAAkC;AAAA,QACtC,iBAAiB;AAAA,MACnB;AAEA,UAAI,KAAK,OAAO;AACd,gBAAQ,gBAAgB,UAAU,KAAK,KAAK;AAAA,MAC9C;AACA,UAAI,SAAS;AACX,gBAAQ,cAAc,IAAI;AAC1B,gBAAQ,gBAAgB,IAAI,OAAO,WAAW,OAAO,EAAE,SAAS;AAAA,MAClE;AAEA,YAAM,MAAM,MAAM;AAAA,QAChB;AAAA,UACE,UAAU,KAAK;AAAA,UACf,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,UACA,OAAO;AAAA,UACP,SAAS;AAAA,QACX;AAAA,QACA,CAAC,QAAQ;AACP,gBAAM,SAAmB,CAAC;AAC1B,cAAI,GAAG,SAAS,MAAM;AACtB,cAAI,GAAG,QAAQ,CAAC,UAAkB,OAAO,KAAK,KAAK,CAAC;AACpD,cAAI,GAAG,OAAO,MAAM;AAnH9B;AAoHY,kBAAM,OAAO,OAAO,OAAO,MAAM,EAAE,SAAS;AAC5C,gBAAI,CAAC,IAAI,cAAc,IAAI,cAAc,KAAK;AAC5C,oBAAM,QAAQ,IAAI;AAAA,iBAChB,SAAI,eAAJ,YAAkB;AAAA,gBAClB;AAAA,gBACA,GAAG,MAAM,IAAI,IAAI;AAAA,cACnB;AACA,qBAAO,KAAK;AACZ;AAAA,YACF;AACA,gBAAI,CAAC,MAAM;AACT,sBAAQ,MAAc;AACtB;AAAA,YACF;AACA,gBAAI;AACF,sBAAQ,KAAK,MAAM,IAAI,CAAM;AAAA,YAC/B,QAAQ;AACN;AAAA,gBACE,IAAI;AAAA,kBACF,qBAAqB,MAAM,IAAI,IAAI,KAAK,KAAK,UAAU,GAAG,GAAG,CAAC;AAAA,gBAChE;AAAA,cACF;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAEA,UAAI,GAAG,SAAS,MAAM;AACtB,UAAI,GAAG,WAAW,MAAM;AACtB,YAAI,QAAQ,IAAI,MAAM,YAAY,MAAM,IAAI,IAAI,EAAE,CAAC;AAAA,MACrD,CAAC;AAED,UAAI,SAAS;AACX,YAAI,MAAM,OAAO;AAAA,MACnB;AACA,UAAI,IAAI;AAAA,IACV,CAAC;AAAA,EACH;AACF;AAGO,MAAM,2BAA2B,MAAM;AAAA,EACnC;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YAAY,YAAoB,MAAc,SAAiB;AAtKjE;AAuKI,QAAI,YAAY;AAChB,QAAI,cAAc;AAClB,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,mBAAY,wBAAO,UAAP,mBAAc,SAAd,YAAsB,OAAO,UAA7B,YAAsC;AAClD,qBAAc,wBAAO,UAAP,mBAAc,gBAAd,aAA6B,YAAO,UAAP,mBAAc,SAA3C,YAAmD;AAAA,IACnE,QAAQ;AAAA,IAER;AACA,UAAM,GAAG,OAAO,UAAU,UAAU,WAAM,WAAW,EAAE;AACvD,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,YAAY;AAAA,EACnB;AACF;",
   "names": []
 }

package/build/lib/state-manager.js

@@ -21,6 +21,7 @@ __export(state_manager_exports, {
   StateManager: () => StateManager
 });
 module.exports = __toCommonJS(state_manager_exports);
+var import_coerce = require("./coerce");
 function sanitize(str) {
   return str.replace(/[^a-zA-Z0-9_-]/g, "_").toLowerCase();
 }
@@ -582,63 +583,93 @@ class StateManager {
    * @param data Measurement data
    */
   async updateMeasurement(config, data) {
-    var _a;
+    if (!(0, import_coerce.isPlainObject)(data)) {
+      return;
+    }
     const prefix = this.devicePrefix(config);
     const mPrefix = `${prefix}.measurement`;
-    await this.adapter.extendObjectAsync(mPrefix, {
+    await this.adapter.setObjectNotExistsAsync(mPrefix, {
       type: "channel",
       common: { name: "Measurement" },
       native: {}
     });
-    const fields = MEASUREMENT_STATE_DEFS;
-    for (const def of fields) {
-      const rawValue = data[def.key];
-      if (rawValue !== void 0 && rawValue !== null && !Array.isArray(rawValue)) {
+    const record = data;
+    for (const def of MEASUREMENT_STATE_DEFS) {
+      const raw = record[def.key];
+      let coerced = null;
+      if (def.type === "number") {
+        coerced = (0, import_coerce.coerceFiniteNumber)(raw);
+      } else if (def.type === "string") {
+        coerced = (0, import_coerce.coerceString)(raw);
+      }
+      if (coerced !== null) {
         await this.ensureAndSet(
           `${mPrefix}.${def.id}`,
           def.name,
           def.type,
           def.role,
-          rawValue,
+          coerced,
           def.unit
         );
       }
     }
-    if ((_a = data.external) == null ? void 0 : _a.length) {
-      await this.adapter.extendObjectAsync(`${mPrefix}.external`, {
-        type: "channel",
-        common: { name: "External Meters" },
-        native: {}
-      });
-      for (const ext of data.external) {
-        const extId = `${mPrefix}.external.${sanitize(ext.type)}_${sanitize(ext.unique_id)}`;
-        await this.adapter.extendObjectAsync(extId, {
+    const external = record.external;
+    if (Array.isArray(external) && external.length > 0) {
+      let extChannelEnsured = false;
+      for (const rawExt of external) {
+        if (!(0, import_coerce.isPlainObject)(rawExt)) {
+          continue;
+        }
+        const type = (0, import_coerce.coerceString)(rawExt.type);
+        const uniqueId = (0, import_coerce.coerceString)(rawExt.unique_id);
+        if (!type || !uniqueId) {
+          continue;
+        }
+        const value = (0, import_coerce.coerceFiniteNumber)(rawExt.value);
+        const unit = (0, import_coerce.coerceString)(rawExt.unit);
+        const timestamp = (0, import_coerce.coerceString)(rawExt.timestamp);
+        if (!extChannelEnsured) {
+          await this.adapter.setObjectNotExistsAsync(`${mPrefix}.external`, {
+            type: "channel",
+            common: { name: "External Meters" },
+            native: {}
+          });
+          extChannelEnsured = true;
+        }
+        const extId = `${mPrefix}.external.${sanitize(type)}_${sanitize(uniqueId)}`;
+        await this.adapter.setObjectNotExistsAsync(extId, {
           type: "channel",
-          common: { name: ext.type },
+          common: { name: type },
           native: {}
         });
-        await this.ensureAndSet(
-          `${extId}.value`,
-          "Value",
-          "number",
-          "value",
-          ext.value,
-          ext.unit
-        );
-        await this.ensureAndSet(
-          `${extId}.unit`,
-          "Unit",
-          "string",
-          "text",
-          ext.unit
-        );
-        await this.ensureAndSet(
-          `${extId}.timestamp`,
-          "Timestamp",
-          "string",
-          "date",
-          ext.timestamp
-        );
+        if (value !== null) {
+          await this.ensureAndSet(
+            `${extId}.value`,
+            "Value",
+            "number",
+            "value",
+            value,
+            unit != null ? unit : void 0
+          );
+        }
+        if (unit) {
+          await this.ensureAndSet(
+            `${extId}.unit`,
+            "Unit",
+            "string",
+            "text",
+            unit
+          );
+        }
+        if (timestamp) {
+          await this.ensureAndSet(
+            `${extId}.timestamp`,
+            "Timestamp",
+            "string",
+            "date",
+            timestamp
+          );
+        }
       }
     }
   }
@@ -649,53 +680,70 @@ class StateManager {
    * @param system System info data
    */
   async updateSystem(config, system) {
+    if (!(0, import_coerce.isPlainObject)(system)) {
+      return;
+    }
     const prefix = this.devicePrefix(config);
-    await this.ensureAndSet(
-      `${prefix}.info.wifi_rssi_db`,
-      "WiFi signal strength",
-      "number",
-      "value",
-      system.wifi_rssi_db,
-      "dB"
-    );
-    await this.ensureAndSet(
-      `${prefix}.info.uptime_s`,
-      "Uptime",
-      "number",
-      "value",
-      system.uptime_s,
-      "s"
-    );
-    await this.adapter.extendObjectAsync(`${prefix}.system`, {
+    const record = system;
+    const rssi = (0, import_coerce.coerceFiniteNumber)(record.wifi_rssi_db);
+    if (rssi !== null) {
+      await this.ensureAndSet(
+        `${prefix}.info.wifi_rssi_db`,
+        "WiFi signal strength",
+        "number",
+        "value",
+        rssi,
+        "dB"
+      );
+    }
+    const uptime = (0, import_coerce.coerceFiniteNumber)(record.uptime_s);
+    if (uptime !== null) {
+      await this.ensureAndSet(
+        `${prefix}.info.uptime_s`,
+        "Uptime",
+        "number",
+        "value",
+        uptime,
+        "s"
+      );
+    }
+    await this.adapter.setObjectNotExistsAsync(`${prefix}.system`, {
       type: "channel",
       common: { name: "System Settings" },
       native: {}
     });
-    await this.ensureAndSet(
-      `${prefix}.system.cloud_enabled`,
-      "Cloud enabled",
-      "boolean",
-      "switch",
-      system.cloud_enabled,
-      void 0,
-      true
-    );
-    await this.ensureAndSet(
-      `${prefix}.system.status_led_brightness_pct`,
-      "LED brightness",
-      "number",
-      "level",
-      system.status_led_brightness_pct,
-      "%",
-      true
-    );
-    if (system.api_v1_enabled !== void 0) {
+    const cloudEnabled = (0, import_coerce.coerceBoolean)(record.cloud_enabled);
+    if (cloudEnabled !== null) {
+      await this.ensureAndSet(
+        `${prefix}.system.cloud_enabled`,
+        "Cloud enabled",
+        "boolean",
+        "switch",
+        cloudEnabled,
+        void 0,
+        true
+      );
+    }
+    const ledPct = (0, import_coerce.coerceFiniteNumber)(record.status_led_brightness_pct);
+    if (ledPct !== null) {
+      await this.ensureAndSet(
+        `${prefix}.system.status_led_brightness_pct`,
+        "LED brightness",
+        "number",
+        "level",
+        ledPct,
+        "%",
+        true
+      );
+    }
+    const apiV1 = (0, import_coerce.coerceBoolean)(record.api_v1_enabled);
+    if (apiV1 !== null) {
       await this.ensureAndSet(
         `${prefix}.system.api_v1_enabled`,
         "API v1 enabled",
         "boolean",
         "switch",
-        system.api_v1_enabled,
+        apiV1,
         void 0,
         true
       );
@@ -713,80 +761,87 @@ class StateManager {
    * @param battery Battery control data
    */
   async updateBattery(config, battery) {
+    if (!(0, import_coerce.isPlainObject)(battery)) {
+      return;
+    }
     const prefix = this.devicePrefix(config);
-    await this.adapter.extendObjectAsync(`${prefix}.battery`, {
+    const record = battery;
+    await this.adapter.setObjectNotExistsAsync(`${prefix}.battery`, {
       type: "channel",
       common: { name: "Battery Control" },
       native: {}
     });
-    await this.ensureAndSet(
-      `${prefix}.battery.mode`,
-      "Battery mode",
-      "string",
-      "text",
-      battery.mode,
-      void 0,
-      true
-    );
-    if (battery.permissions !== void 0) {
+    const mode = (0, import_coerce.coerceString)(record.mode);
+    if (mode) {
       await this.ensureAndSet(
-        `${prefix}.battery.permissions`,
-        "Battery permissions",
+        `${prefix}.battery.mode`,
+        "Battery mode",
         "string",
-        "json",
-        JSON.stringify(battery.permissions),
+        "text",
+        mode,
         void 0,
         true
       );
     }
-    if (battery.battery_count !== void 0) {
-      await this.ensureAndSet(
-        `${prefix}.battery.battery_count`,
-        "Connected batteries",
-        "number",
-        "value",
-        battery.battery_count
-      );
-    }
-    if (battery.power_w !== void 0) {
-      await this.ensureAndSet(
-        `${prefix}.battery.power_w`,
-        "Battery power",
-        "number",
-        "value.power",
-        battery.power_w,
-        "W"
-      );
-    }
-    if (battery.target_power_w !== void 0) {
+    if (Array.isArray(record.permissions)) {
       await this.ensureAndSet(
-        `${prefix}.battery.target_power_w`,
-        "Target power",
-        "number",
-        "value.power",
-        battery.target_power_w,
-        "W"
-      );
-    }
-    if (battery.max_consumption_w !== void 0) {
-      await this.ensureAndSet(
-        `${prefix}.battery.max_consumption_w`,
-        "Max consumption",
-        "number",
-        "value.power",
-        battery.max_consumption_w,
-        "W"
+        `${prefix}.battery.permissions`,
+        "Battery permissions",
+        "string",
+        "json",
+        JSON.stringify(record.permissions),
+        void 0,
+        true
       );
     }
-    if (battery.max_production_w !== void 0) {
-      await this.ensureAndSet(
-        `${prefix}.battery.max_production_w`,
-        "Max production",
-        "number",
-        "value.power",
-        battery.max_production_w,
-        "W"
-      );
+    const numberFields = [
+      {
+        key: "battery_count",
+        id: "battery_count",
+        name: "Connected batteries",
+        role: "value"
+      },
+      {
+        key: "power_w",
+        id: "power_w",
+        name: "Battery power",
+        role: "value.power",
+        unit: "W"
+      },
+      {
+        key: "target_power_w",
+        id: "target_power_w",
+        name: "Target power",
+        role: "value.power",
+        unit: "W"
+      },
+      {
+        key: "max_consumption_w",
+        id: "max_consumption_w",
+        name: "Max consumption",
+        role: "value.power",
+        unit: "W"
+      },
+      {
+        key: "max_production_w",
+        id: "max_production_w",
+        name: "Max production",
+        role: "value.power",
+        unit: "W"
+      }
+    ];
+    for (const field of numberFields) {
+      const coerced = (0, import_coerce.coerceFiniteNumber)(record[field.key]);
+      if (coerced !== null) {
+        await this.ensureAndSet(
+          `${prefix}.battery.${field.id}`,
+          field.name,
+          "number",
+          field.role,
+          coerced,
+          field.unit
+        );
+      }
     }
   }
   /**
@@ -859,7 +914,7 @@ class StateManager {
     if (unit) {
       common.unit = unit;
     }
-    await this.adapter.extendObjectAsync(id, {
+    await this.adapter.setObjectNotExistsAsync(id, {
       type: "state",
       common,
       native: {}
@@ -872,7 +927,7 @@ class StateManager {
    * @param name State name
    */
   async createButton(id, name) {
-    await this.adapter.extendObjectAsync(id, {
+    await this.adapter.setObjectNotExistsAsync(id, {
       type: "state",
       common: {
         name,