iobroker.proscenic 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C@ptain Ch@os
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# ioBroker.proscenic
+
+Development-stage ioBroker adapter for supported Proscenic vacuum robots,
+initially the Proscenic M7 Pro (`M7_PRO`, model `811_LDS`) through the legacy
+Proscenic cloud/gateway path.
+
+Manufacturer/product information: [Proscenic robot vacuums](https://www.proscenic.com/collections/robot-vacuums).
+
+## Project status
+
+This repository contains a TypeScript ioBroker adapter that can authenticate
+against the verified legacy European Proscenic cloud, enumerate one real M7 Pro,
+connect to the cloud gateway, project normalized runtime states, and expose the
+first real-device-validated control and maintenance objects.
+
+Verified on one owner-local Proscenic M7 Pro so far:
+
+- cloud login, token acquisition, device discovery, gateway discovery, framed
+  socket reception, decryption, bounded reconnect, and adapter unload cleanup;
+- status projection for battery, cleaning mode, fan, mop/water candidates,
+  features, safe map metadata, and redacted maintenance diagnostics;
+- writable command buttons for start, pause, continue, return to station, fan
+  modes, deep cleaning, and dust collection;
+- consumable counters for filter, side brush, main brush, and sensors;
+- recent maintenance/message history, including dust-bag messages;
+- experimental local-development live-map rendering for VIS debugging, including
+  app-oriented map colors, no-go areas, room-zone candidates, charger marker,
+  and an interpolated pose trail.
+
+The adapter is not a public release yet. The supported hardware claim is limited
+to the tested M7 Pro (`M7_PRO` / `811_LDS`) and the legacy cloud backend. Other
+models, accounts, regions, firmware versions, Tuya-local control, room-cleaning
+commands, final map storage/retention policy, and production release readiness
+still require separate evidence.
+
+Raw payloads, serial numbers, gateway endpoints, device addresses, credentials,
+packet captures, private maps, and home-layout data are not committed or exposed
+as public fixtures. The current live-map object is explicitly experimental and
+intended for local VIS/debug use.
+
+## Project identity
+
+- GitHub repository: `ioBroker.proscenic`
+- npm package: `iobroker.proscenic`
+- adapter ID: `proscenic`
+- namespace: `proscenic.<instance>`
+- license: MIT
+
+## Security and privacy
+
+Never publish Proscenic credentials, session tokens, serial numbers, device or
+gateway addresses, private network data, maps, packet captures, or logs.
+Security policy and contribution requirements are documented in
+[SECURITY.md](SECURITY.md) and [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Documentation
+
+- [Project definition](docs/PROJECT_DEFINITION.md)
+- [Architecture](docs/ARCHITECTURE.md)
+- [Upstream research and provenance](docs/UPSTREAM_RESEARCH.md)
+- [Publication checklist](docs/PUBLICATION_CHECKLIST.md)
+- [Architecture decisions](docs/decisions/README.md)
+
+## Changelog
+
+### 0.1.0 (2026-09-14)
+
+- Added the first real-device-validated command object tree for the M7 Pro:
+  start, pause, continue, return, fan modes, deep cleaning, and dust collection.
+- Added status projection for the verified legacy Proscenic cloud/gateway path.
+- Added consumable runtime objects with derived remaining percentage and overdue
+  hours.
+- Added bounded maintenance/message history objects for recent device messages.
+- Added experimental local live-map rendering for VIS debugging with app-oriented
+  colors, no-go overlays, room-zone candidates, charger marker, and pose trail.
+- Added the M7 Pro product image and a display-prefixed device code.
+- Improved command value normalization for visualization tools.
+
+### 0.0.1 (2026-09-10)
+
+- Initial adapter skeleton and project foundation.
+
+## Independence
+
+This is an independent interoperability project and is not affiliated with,
+endorsed by, or sponsored by Proscenic. Product and company names belong to
+their respective owners.
+
+## License
+
+MIT License. See [LICENSE](LICENSE).
+
+Copyright (c) 2026 C@ptain Ch@os

package/admin/i18n/de.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic Adaptereinstellungen",
+	"region": "Region",
+	"appVendor": "App-Anbieter",
+	"cloudEmail": "Cloud-E-Mail-Adresse",
+	"cloudPassword": "Cloud-Passwort",
+	"preferredDeviceCode": "Bevorzugter Gerätecode",
+	"preferredDeviceCodeHelp": "Optionaler Filter für das erste unterstützte Zielgerät. Für den verifizierten Proscenic M7 Pro M7_PRO beibehalten."
+}

package/admin/i18n/en.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Optional filter for the first supported target. Keep M7_PRO for the verified Proscenic M7 Pro."
+}

package/admin/i18n/es.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Filtro opcional para el primer dispositivo compatible. Mantén M7_PRO para el Proscenic M7 Pro verificado."
+}

package/admin/i18n/fr.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Filtre optionnel pour le premier appareil pris en charge. Conservez M7_PRO pour le Proscenic M7 Pro vérifié."
+}

package/admin/i18n/it.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Filtro opzionale per il primo dispositivo supportato. Mantieni M7_PRO per il Proscenic M7 Pro verificato."
+}

package/admin/i18n/nl.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Optioneel filter voor het eerste ondersteunde apparaat. Laat M7_PRO staan voor de geverifieerde Proscenic M7 Pro."
+}

package/admin/i18n/pl.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Opcjonalny filtr dla pierwszego obsługiwanego urządzenia. Pozostaw M7_PRO dla zweryfikowanego Proscenic M7 Pro."
+}

package/admin/i18n/pt.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Filtro opcional para o primeiro dispositivo compatível. Mantenha M7_PRO para o Proscenic M7 Pro verificado."
+}

package/admin/i18n/ru.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Необязательный фильтр для первого поддерживаемого устройства. Оставьте M7_PRO для проверенного Proscenic M7 Pro."
+}

package/admin/i18n/uk.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "Необов’язковий фільтр для першого підтримуваного пристрою. Залиште M7_PRO для перевіреного Proscenic M7 Pro."
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,9 @@
+{
+	"proscenic adapter settings": "Proscenic adapter settings",
+	"region": "Region",
+	"appVendor": "App vendor",
+	"cloudEmail": "Cloud email address",
+	"cloudPassword": "Cloud password",
+	"preferredDeviceCode": "Preferred device code",
+	"preferredDeviceCodeHelp": "第一个受支持设备的可选筛选条件。已验证的 Proscenic M7 Pro 请保留 M7_PRO。"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,85 @@
+{
+	"i18n": true,
+	"type": "panel",
+	"items": {
+		"adapterLogo": {
+			"type": "staticImage",
+			"src": "proscenic.png",
+			"newLine": true,
+			"xs": 12,
+			"sm": 12,
+			"md": 12,
+			"lg": 12,
+			"xl": 12,
+			"style": {
+				"width": 140,
+				"height": 140,
+				"objectFit": "contain",
+				"margin": "8px 0 16px 0"
+			}
+		},
+		"region": {
+			"type": "select",
+			"label": "region",
+			"options": [
+				{
+					"label": "Europe",
+					"value": "eu"
+				}
+			],
+			"newLine": true,
+			"xs": 12,
+			"sm": 12,
+			"md": 6,
+			"lg": 4,
+			"xl": 4
+		},
+		"vendor": {
+			"type": "select",
+			"label": "appVendor",
+			"options": [
+				{
+					"label": "Proscenic",
+					"value": "proscenic"
+				}
+			],
+			"newLine": false,
+			"xs": 12,
+			"sm": 12,
+			"md": 6,
+			"lg": 4,
+			"xl": 4
+		},
+		"username": {
+			"type": "text",
+			"label": "cloudEmail",
+			"newLine": true,
+			"xs": 12,
+			"sm": 12,
+			"md": 12,
+			"lg": 6,
+			"xl": 6
+		},
+		"password": {
+			"type": "password",
+			"label": "cloudPassword",
+			"newLine": false,
+			"xs": 12,
+			"sm": 12,
+			"md": 12,
+			"lg": 6,
+			"xl": 6
+		},
+		"deviceCode": {
+			"type": "text",
+			"label": "preferredDeviceCode",
+			"help": "preferredDeviceCodeHelp",
+			"newLine": true,
+			"xs": 12,
+			"sm": 12,
+			"md": 12,
+			"lg": 6,
+			"xl": 6
+		}
+	}
+}

package/build/domain/commands.js

@@ -0,0 +1,129 @@
+"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 commands_exports = {};
+__export(commands_exports, {
+  COMMAND_DEFINITIONS: () => COMMAND_DEFINITIONS,
+  buildCommandRequest: () => buildCommandRequest,
+  commandForStateId: () => commandForStateId,
+  normalizeCommandButtonValue: () => normalizeCommandButtonValue
+});
+module.exports = __toCommonJS(commands_exports);
+const COMMAND_DEFINITIONS = [
+  { id: "commands.start", command: "start" },
+  { id: "commands.pause", command: "pause" },
+  { id: "commands.continue", command: "continue" },
+  { id: "commands.return", command: "return" },
+  { id: "commands.fan.quiet", command: "fanQuiet" },
+  { id: "commands.fan.standard", command: "fanStandard" },
+  { id: "commands.fan.strong", command: "fanStrong" },
+  { id: "commands.deepCleaning", command: "deepCleaning" },
+  { id: "commands.collectDust", command: "collectDust" }
+];
+function commandForStateId(id) {
+  var _a;
+  return (_a = COMMAND_DEFINITIONS.find((definition) => definition.id === id)) == null ? void 0 : _a.command;
+}
+function normalizeCommandButtonValue(value) {
+  if (value === true || value === 1) {
+    return true;
+  }
+  if (value === false || value === 0 || value === null) {
+    return false;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "on") {
+      return true;
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "off" || normalized === "") {
+      return false;
+    }
+  }
+  return void 0;
+}
+function buildCommandRequest(command, serial, username, now = /* @__PURE__ */ new Date()) {
+  const encodedSerial = encodeURIComponent(serial);
+  const encodedUsername = encodeURIComponent(username);
+  switch (command) {
+    case "start":
+      return {
+        path: `/instructions/cmd21005/${encodedSerial}?username=${encodedUsername}`,
+        body: "cleanMode=sweepOnly"
+      };
+    case "pause":
+      return {
+        path: `/instructions/${encodedSerial}/21017?username=${encodedUsername}`,
+        body: "mode=pause"
+      };
+    case "continue":
+      return {
+        path: `/instructions/${encodedSerial}/21017?username=${encodedUsername}`,
+        body: "pauseOrContinue=continue"
+      };
+    case "return":
+      return {
+        path: `/instructions/${encodedSerial}/21012?username=${encodedUsername}`,
+        body: "charge=start"
+      };
+    case "fanQuiet":
+      return {
+        path: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,
+        body: "setMode=quiet"
+      };
+    case "fanStandard":
+      return {
+        path: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,
+        body: "setMode=auto"
+      };
+    case "fanStrong":
+      return {
+        path: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,
+        body: "setMode=strong"
+      };
+    case "deepCleaning":
+      return {
+        path: `/instructions/cmd21005_2/${encodedSerial}?username=${encodedUsername}`,
+        body: "mode=depthTotalClean"
+      };
+    case "collectDust":
+      return {
+        path: `/instructions/cmd/${encodedSerial}?username=${encodedUsername}`,
+        contentType: "application/json;charset=UTF-8",
+        body: JSON.stringify({
+          dInfo: {
+            ts: now.getTime().toString(),
+            userId: username
+          },
+          data: {
+            cmd: "startDustCenter",
+            value: 0
+          },
+          infoType: 21024
+        })
+      };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COMMAND_DEFINITIONS,
+  buildCommandRequest,
+  commandForStateId,
+  normalizeCommandButtonValue
+});
+//# sourceMappingURL=commands.js.map

package/build/domain/commands.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/commands.ts"],
+  "sourcesContent": ["export type RobotCommand =\n\t| \"start\"\n\t| \"pause\"\n\t| \"continue\"\n\t| \"return\"\n\t| \"fanQuiet\"\n\t| \"fanStandard\"\n\t| \"fanStrong\"\n\t| \"deepCleaning\"\n\t| \"collectDust\";\n\nexport interface CommandRequest {\n\tpath: string;\n\tbody: string;\n\tcontentType?: string;\n}\n\nexport interface CommandDefinition {\n\tid: string;\n\tcommand: RobotCommand;\n}\n\nexport const COMMAND_DEFINITIONS: readonly CommandDefinition[] = [\n\t{ id: \"commands.start\", command: \"start\" },\n\t{ id: \"commands.pause\", command: \"pause\" },\n\t{ id: \"commands.continue\", command: \"continue\" },\n\t{ id: \"commands.return\", command: \"return\" },\n\t{ id: \"commands.fan.quiet\", command: \"fanQuiet\" },\n\t{ id: \"commands.fan.standard\", command: \"fanStandard\" },\n\t{ id: \"commands.fan.strong\", command: \"fanStrong\" },\n\t{ id: \"commands.deepCleaning\", command: \"deepCleaning\" },\n\t{ id: \"commands.collectDust\", command: \"collectDust\" },\n];\n\nexport function commandForStateId(id: string): RobotCommand | undefined {\n\treturn COMMAND_DEFINITIONS.find(definition => definition.id === id)?.command;\n}\n\nexport function normalizeCommandButtonValue(value: ioBroker.StateValue | undefined): boolean | undefined {\n\tif (value === true || value === 1) {\n\t\treturn true;\n\t}\n\n\tif (value === false || value === 0 || value === null) {\n\t\treturn false;\n\t}\n\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif (normalized === \"true\" || normalized === \"1\" || normalized === \"on\") {\n\t\t\treturn true;\n\t\t}\n\t\tif (normalized === \"false\" || normalized === \"0\" || normalized === \"off\" || normalized === \"\") {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn undefined;\n}\n\nexport function buildCommandRequest(\n\tcommand: RobotCommand,\n\tserial: string,\n\tusername: string,\n\tnow = new Date(),\n): CommandRequest {\n\tconst encodedSerial = encodeURIComponent(serial);\n\tconst encodedUsername = encodeURIComponent(username);\n\n\tswitch (command) {\n\t\tcase \"start\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/cmd21005/${encodedSerial}?username=${encodedUsername}`,\n\t\t\t\tbody: \"cleanMode=sweepOnly\",\n\t\t\t};\n\t\tcase \"pause\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21017?username=${encodedUsername}`,\n\t\t\t\tbody: \"mode=pause\",\n\t\t\t};\n\t\tcase \"continue\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21017?username=${encodedUsername}`,\n\t\t\t\tbody: \"pauseOrContinue=continue\",\n\t\t\t};\n\t\tcase \"return\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21012?username=${encodedUsername}`,\n\t\t\t\tbody: \"charge=start\",\n\t\t\t};\n\t\tcase \"fanQuiet\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,\n\t\t\t\tbody: \"setMode=quiet\",\n\t\t\t};\n\t\tcase \"fanStandard\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,\n\t\t\t\tbody: \"setMode=auto\",\n\t\t\t};\n\t\tcase \"fanStrong\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/${encodedSerial}/21022?username=${encodedUsername}`,\n\t\t\t\tbody: \"setMode=strong\",\n\t\t\t};\n\t\tcase \"deepCleaning\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/cmd21005_2/${encodedSerial}?username=${encodedUsername}`,\n\t\t\t\tbody: \"mode=depthTotalClean\",\n\t\t\t};\n\t\tcase \"collectDust\":\n\t\t\treturn {\n\t\t\t\tpath: `/instructions/cmd/${encodedSerial}?username=${encodedUsername}`,\n\t\t\t\tcontentType: \"application/json;charset=UTF-8\",\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tdInfo: {\n\t\t\t\t\t\tts: now.getTime().toString(),\n\t\t\t\t\t\tuserId: username,\n\t\t\t\t\t},\n\t\t\t\t\tdata: {\n\t\t\t\t\t\tcmd: \"startDustCenter\",\n\t\t\t\t\t\tvalue: 0,\n\t\t\t\t\t},\n\t\t\t\t\tinfoType: 21024,\n\t\t\t\t}),\n\t\t\t};\n\t}\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/domain/consumables.js

@@ -0,0 +1,63 @@
+"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 consumables_exports = {};
+__export(consumables_exports, {
+  normalizeConsumables21015: () => normalizeConsumables21015
+});
+module.exports = __toCommonJS(consumables_exports);
+const CONSUMABLE_INTERVAL_HOURS = {
+  filter: 150,
+  sideBrush: 200,
+  mainBrush: 300,
+  sensors: 30
+};
+function normalizeConsumables21015(data) {
+  if (data === null || typeof data !== "object" || Array.isArray(data)) {
+    return void 0;
+  }
+  const record = data;
+  const consumables = Object.fromEntries(
+    Object.keys(CONSUMABLE_INTERVAL_HOURS).map((component) => [component, normalizeConsumable(component, record[component])]).filter((entry) => entry[1] !== void 0)
+  );
+  return Object.keys(consumables).length > 0 ? consumables : void 0;
+}
+function normalizeConsumable(component, value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    return void 0;
+  }
+  const usedSeconds = Math.trunc(value);
+  const intervalHours = CONSUMABLE_INTERVAL_HOURS[component];
+  const intervalSeconds = intervalHours * 3600;
+  const remainingPercent = roundToTwoDecimals((1 - usedSeconds / intervalSeconds) * 100);
+  const overdueHours = roundToTwoDecimals(Math.max(0, (usedSeconds - intervalSeconds) / 3600));
+  return {
+    usedSeconds,
+    intervalHours,
+    remainingPercent,
+    overdueHours
+  };
+}
+function roundToTwoDecimals(value) {
+  return Math.round(value * 100) / 100;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  normalizeConsumables21015
+});
+//# sourceMappingURL=consumables.js.map

package/build/domain/consumables.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/consumables.ts"],
+  "sourcesContent": ["export type ConsumableComponent = \"filter\" | \"sideBrush\" | \"mainBrush\" | \"sensors\";\n\nexport interface ConsumableState {\n\tusedSeconds: number;\n\tintervalHours: number;\n\tremainingPercent: number;\n\toverdueHours: number;\n}\n\nexport type ConsumableStates = Partial<Record<ConsumableComponent, ConsumableState>>;\n\nconst CONSUMABLE_INTERVAL_HOURS: Record<ConsumableComponent, number> = {\n\tfilter: 150,\n\tsideBrush: 200,\n\tmainBrush: 300,\n\tsensors: 30,\n};\n\nexport function normalizeConsumables21015(data: unknown): ConsumableStates | undefined {\n\tif (data === null || typeof data !== \"object\" || Array.isArray(data)) {\n\t\treturn undefined;\n\t}\n\n\tconst record = data as Record<string, unknown>;\n\tconst consumables = Object.fromEntries(\n\t\t(Object.keys(CONSUMABLE_INTERVAL_HOURS) as ConsumableComponent[])\n\t\t\t.map(component => [component, normalizeConsumable(component, record[component])] as const)\n\t\t\t.filter((entry): entry is readonly [ConsumableComponent, ConsumableState] => entry[1] !== undefined),\n\t) as ConsumableStates;\n\n\treturn Object.keys(consumables).length > 0 ? consumables : undefined;\n}\n\nfunction normalizeConsumable(component: ConsumableComponent, value: unknown): ConsumableState | undefined {\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n\t\treturn undefined;\n\t}\n\n\tconst usedSeconds = Math.trunc(value);\n\tconst intervalHours = CONSUMABLE_INTERVAL_HOURS[component];\n\tconst intervalSeconds = intervalHours * 3_600;\n\tconst remainingPercent = roundToTwoDecimals((1 - usedSeconds / intervalSeconds) * 100);\n\tconst overdueHours = roundToTwoDecimals(Math.max(0, (usedSeconds - intervalSeconds) / 3_600));\n\n\treturn {\n\t\tusedSeconds,\n\t\tintervalHours,\n\t\tremainingPercent,\n\t\toverdueHours,\n\t};\n}\n\nfunction roundToTwoDecimals(value: number): number {\n\treturn Math.round(value * 100) / 100;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,MAAM,4BAAiE;AAAA,EACtE,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AACV;AAEO,SAAS,0BAA0B,MAA6C;AACtF,MAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,GAAG;AACrE,WAAO;AAAA,EACR;AAEA,QAAM,SAAS;AACf,QAAM,cAAc,OAAO;AAAA,IACzB,OAAO,KAAK,yBAAyB,EACpC,IAAI,eAAa,CAAC,WAAW,oBAAoB,WAAW,OAAO,SAAS,CAAC,CAAC,CAAU,EACxF,OAAO,CAAC,UAAoE,MAAM,CAAC,MAAM,MAAS;AAAA,EACrG;AAEA,SAAO,OAAO,KAAK,WAAW,EAAE,SAAS,IAAI,cAAc;AAC5D;AAEA,SAAS,oBAAoB,WAAgC,OAA6C;AACzG,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,GAAG;AACtE,WAAO;AAAA,EACR;AAEA,QAAM,cAAc,KAAK,MAAM,KAAK;AACpC,QAAM,gBAAgB,0BAA0B,SAAS;AACzD,QAAM,kBAAkB,gBAAgB;AACxC,QAAM,mBAAmB,oBAAoB,IAAI,cAAc,mBAAmB,GAAG;AACrF,QAAM,eAAe,mBAAmB,KAAK,IAAI,IAAI,cAAc,mBAAmB,IAAK,CAAC;AAE5F,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;AAEA,SAAS,mBAAmB,OAAuB;AAClD,SAAO,KAAK,MAAM,QAAQ,GAAG,IAAI;AAClC;",
+  "names": []
+}