matter-all-in-one-addon 1.8.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/README.md +183 -0
  2. package/dist/camera/ai/camera-ai-detector.d.ts +44 -0
  3. package/dist/camera/ai/camera-ai-detector.js +329 -0
  4. package/dist/camera/ai/camera-ai-detector.js.map +1 -0
  5. package/dist/camera/camera-capabilities.d.ts +13 -0
  6. package/dist/camera/camera-capabilities.js +186 -0
  7. package/dist/camera/camera-capabilities.js.map +1 -0
  8. package/dist/camera/camera-source-resolver.d.ts +18 -0
  9. package/dist/camera/camera-source-resolver.js +187 -0
  10. package/dist/camera/camera-source-resolver.js.map +1 -0
  11. package/dist/camera/camera-types.d.ts +124 -0
  12. package/dist/camera/camera-types.js +8 -0
  13. package/dist/camera/camera-types.js.map +1 -0
  14. package/dist/camera/cameraui/cameraui-client.d.ts +54 -0
  15. package/dist/camera/cameraui/cameraui-client.js +698 -0
  16. package/dist/camera/cameraui/cameraui-client.js.map +1 -0
  17. package/dist/camera/cameraui/cameraui-homekit-bridge.d.ts +21 -0
  18. package/dist/camera/cameraui/cameraui-homekit-bridge.js +343 -0
  19. package/dist/camera/cameraui/cameraui-homekit-bridge.js.map +1 -0
  20. package/dist/camera/cameraui/cameraui-storage.d.ts +17 -0
  21. package/dist/camera/cameraui/cameraui-storage.js +916 -0
  22. package/dist/camera/cameraui/cameraui-storage.js.map +1 -0
  23. package/dist/camera/cameraui/cameraui-types.d.ts +89 -0
  24. package/dist/camera/cameraui/cameraui-types.js +5 -0
  25. package/dist/camera/cameraui/cameraui-types.js.map +1 -0
  26. package/dist/camera/homekit/ffmpeg-helper.d.ts +88 -0
  27. package/dist/camera/homekit/ffmpeg-helper.js +673 -0
  28. package/dist/camera/homekit/ffmpeg-helper.js.map +1 -0
  29. package/dist/camera/homekit/fmp4-parser.d.ts +48 -0
  30. package/dist/camera/homekit/fmp4-parser.js +156 -0
  31. package/dist/camera/homekit/fmp4-parser.js.map +1 -0
  32. package/dist/camera/homekit/hevc-eligibility.d.ts +16 -0
  33. package/dist/camera/homekit/hevc-eligibility.js +153 -0
  34. package/dist/camera/homekit/hevc-eligibility.js.map +1 -0
  35. package/dist/camera/homekit/homekit-camera-recording.delegate.d.ts +73 -0
  36. package/dist/camera/homekit/homekit-camera-recording.delegate.js +445 -0
  37. package/dist/camera/homekit/homekit-camera-recording.delegate.js.map +1 -0
  38. package/dist/camera/homekit/homekit-camera-stream.delegate.d.ts +47 -0
  39. package/dist/camera/homekit/homekit-camera-stream.delegate.js +833 -0
  40. package/dist/camera/homekit/homekit-camera-stream.delegate.js.map +1 -0
  41. package/dist/camera/homekit/homekit-camera.accessory.d.ts +53 -0
  42. package/dist/camera/homekit/homekit-camera.accessory.js +697 -0
  43. package/dist/camera/homekit/homekit-camera.accessory.js.map +1 -0
  44. package/dist/camera/matter/camera-endpoint.builder.d.ts +7 -0
  45. package/dist/camera/matter/camera-endpoint.builder.js +127 -0
  46. package/dist/camera/matter/camera-endpoint.builder.js.map +1 -0
  47. package/dist/camera/matter/camera-session-manager.d.ts +46 -0
  48. package/dist/camera/matter/camera-session-manager.js +120 -0
  49. package/dist/camera/matter/camera-session-manager.js.map +1 -0
  50. package/dist/camera/matter/camera-webrtc-adapter.d.ts +62 -0
  51. package/dist/camera/matter/camera-webrtc-adapter.js +298 -0
  52. package/dist/camera/matter/camera-webrtc-adapter.js.map +1 -0
  53. package/dist/camera/motion/ffmpeg-motion-detector.d.ts +46 -0
  54. package/dist/camera/motion/ffmpeg-motion-detector.js +200 -0
  55. package/dist/camera/motion/ffmpeg-motion-detector.js.map +1 -0
  56. package/dist/camera/nest/nest-camera-adapter.d.ts +38 -0
  57. package/dist/camera/nest/nest-camera-adapter.js +109 -0
  58. package/dist/camera/nest/nest-camera-adapter.js.map +1 -0
  59. package/dist/camera/scrypted/scrypted-camera-card.d.ts +39 -0
  60. package/dist/camera/scrypted/scrypted-camera-card.js +38 -0
  61. package/dist/camera/scrypted/scrypted-camera-card.js.map +1 -0
  62. package/dist/camera/scrypted/scrypted-camera-detail.d.ts +33 -0
  63. package/dist/camera/scrypted/scrypted-camera-detail.js +34 -0
  64. package/dist/camera/scrypted/scrypted-camera-detail.js.map +1 -0
  65. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.d.ts +17 -0
  66. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.js +24 -0
  67. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.js.map +1 -0
  68. package/dist/camera/scrypted/scrypted-camera-normalizer.d.ts +44 -0
  69. package/dist/camera/scrypted/scrypted-camera-normalizer.js +44 -0
  70. package/dist/camera/scrypted/scrypted-camera-normalizer.js.map +1 -0
  71. package/dist/camera/scrypted/scrypted-camera-policy.d.ts +11 -0
  72. package/dist/camera/scrypted/scrypted-camera-policy.js +13 -0
  73. package/dist/camera/scrypted/scrypted-camera-policy.js.map +1 -0
  74. package/dist/camera/scrypted/scrypted-camera-presentation.d.ts +13 -0
  75. package/dist/camera/scrypted/scrypted-camera-presentation.js +23 -0
  76. package/dist/camera/scrypted/scrypted-camera-presentation.js.map +1 -0
  77. package/dist/camera/scrypted/scrypted-client-discovery-adapter.d.ts +6 -0
  78. package/dist/camera/scrypted/scrypted-client-discovery-adapter.js +12 -0
  79. package/dist/camera/scrypted/scrypted-client-discovery-adapter.js.map +1 -0
  80. package/dist/camera/scrypted/scrypted-client.d.ts +152 -0
  81. package/dist/camera/scrypted/scrypted-client.js +1170 -0
  82. package/dist/camera/scrypted/scrypted-client.js.map +1 -0
  83. package/dist/camera/scrypted/scrypted-crypto.d.ts +21 -0
  84. package/dist/camera/scrypted/scrypted-crypto.js +90 -0
  85. package/dist/camera/scrypted/scrypted-crypto.js.map +1 -0
  86. package/dist/camera/scrypted/scrypted-discovery-provider.d.ts +9 -0
  87. package/dist/camera/scrypted/scrypted-discovery-provider.js +25 -0
  88. package/dist/camera/scrypted/scrypted-discovery-provider.js.map +1 -0
  89. package/dist/camera/scrypted/scrypted-homekit-bridge.d.ts +12 -0
  90. package/dist/camera/scrypted/scrypted-homekit-bridge.js +214 -0
  91. package/dist/camera/scrypted/scrypted-homekit-bridge.js.map +1 -0
  92. package/dist/camera/scrypted/scrypted-matter-bridge.d.ts +36 -0
  93. package/dist/camera/scrypted/scrypted-matter-bridge.js +226 -0
  94. package/dist/camera/scrypted/scrypted-matter-bridge.js.map +1 -0
  95. package/dist/camera/scrypted/scrypted-reconnect-manager.d.ts +40 -0
  96. package/dist/camera/scrypted/scrypted-reconnect-manager.js +353 -0
  97. package/dist/camera/scrypted/scrypted-reconnect-manager.js.map +1 -0
  98. package/dist/camera/scrypted/scrypted-runtime-connector.d.ts +7 -0
  99. package/dist/camera/scrypted/scrypted-runtime-connector.js +17 -0
  100. package/dist/camera/scrypted/scrypted-runtime-connector.js.map +1 -0
  101. package/dist/camera/scrypted/scrypted-runtime-facade.d.ts +13 -0
  102. package/dist/camera/scrypted/scrypted-runtime-facade.js +29 -0
  103. package/dist/camera/scrypted/scrypted-runtime-facade.js.map +1 -0
  104. package/dist/camera/scrypted/scrypted-runtime-ingest.d.ts +5 -0
  105. package/dist/camera/scrypted/scrypted-runtime-ingest.js +54 -0
  106. package/dist/camera/scrypted/scrypted-runtime-ingest.js.map +1 -0
  107. package/dist/camera/scrypted/scrypted-storage.d.ts +95 -0
  108. package/dist/camera/scrypted/scrypted-storage.js +698 -0
  109. package/dist/camera/scrypted/scrypted-storage.js.map +1 -0
  110. package/dist/camera/scrypted/scrypted-stream-validator.d.ts +46 -0
  111. package/dist/camera/scrypted/scrypted-stream-validator.js +412 -0
  112. package/dist/camera/scrypted/scrypted-stream-validator.js.map +1 -0
  113. package/dist/camera/scrypted/scrypted-types.d.ts +354 -0
  114. package/dist/camera/scrypted/scrypted-types.js +6 -0
  115. package/dist/camera/scrypted/scrypted-types.js.map +1 -0
  116. package/dist/converters/binary_sensor.converter.d.ts +18 -0
  117. package/dist/converters/binary_sensor.converter.js +21 -0
  118. package/dist/converters/binary_sensor.converter.js.map +1 -0
  119. package/dist/converters/camera.converter.d.ts +18 -0
  120. package/dist/converters/camera.converter.js +24 -0
  121. package/dist/converters/camera.converter.js.map +1 -0
  122. package/dist/converters/climate.converter.d.ts +21 -0
  123. package/dist/converters/climate.converter.js +55 -0
  124. package/dist/converters/climate.converter.js.map +1 -0
  125. package/dist/converters/cover.converter.d.ts +14 -0
  126. package/dist/converters/cover.converter.js +22 -0
  127. package/dist/converters/cover.converter.js.map +1 -0
  128. package/dist/converters/energy_tariff.converter.d.ts +10 -0
  129. package/dist/converters/energy_tariff.converter.js +12 -0
  130. package/dist/converters/energy_tariff.converter.js.map +1 -0
  131. package/dist/converters/fan.converter.d.ts +233 -0
  132. package/dist/converters/fan.converter.js +353 -0
  133. package/dist/converters/fan.converter.js.map +1 -0
  134. package/dist/converters/index.d.ts +14 -0
  135. package/dist/converters/index.js +15 -0
  136. package/dist/converters/index.js.map +1 -0
  137. package/dist/converters/light.converter.d.ts +26 -0
  138. package/dist/converters/light.converter.js +36 -0
  139. package/dist/converters/light.converter.js.map +1 -0
  140. package/dist/converters/lock.converter.d.ts +20 -0
  141. package/dist/converters/lock.converter.js +29 -0
  142. package/dist/converters/lock.converter.js.map +1 -0
  143. package/dist/converters/sensor.converter.d.ts +18 -0
  144. package/dist/converters/sensor.converter.js +33 -0
  145. package/dist/converters/sensor.converter.js.map +1 -0
  146. package/dist/converters/soil_sensor.converter.d.ts +14 -0
  147. package/dist/converters/soil_sensor.converter.js +21 -0
  148. package/dist/converters/soil_sensor.converter.js.map +1 -0
  149. package/dist/converters/vacuum.converter.d.ts +168 -0
  150. package/dist/converters/vacuum.converter.js +288 -0
  151. package/dist/converters/vacuum.converter.js.map +1 -0
  152. package/dist/device-profiles.d.ts +14 -0
  153. package/dist/device-profiles.js +245 -0
  154. package/dist/device-profiles.js.map +1 -0
  155. package/dist/device-registry.d.ts +58 -0
  156. package/dist/device-registry.js +288 -0
  157. package/dist/device-registry.js.map +1 -0
  158. package/dist/entities/base.entity.d.ts +40 -0
  159. package/dist/entities/base.entity.js +826 -0
  160. package/dist/entities/base.entity.js.map +1 -0
  161. package/dist/entities/camera.entity.d.ts +48 -0
  162. package/dist/entities/camera.entity.js +127 -0
  163. package/dist/entities/camera.entity.js.map +1 -0
  164. package/dist/entities/closure.entity.d.ts +9 -0
  165. package/dist/entities/closure.entity.js +52 -0
  166. package/dist/entities/closure.entity.js.map +1 -0
  167. package/dist/entities/composite-device.entity.d.ts +61 -0
  168. package/dist/entities/composite-device.entity.js +986 -0
  169. package/dist/entities/composite-device.entity.js.map +1 -0
  170. package/dist/entities/cooktop.entity.d.ts +20 -0
  171. package/dist/entities/cooktop.entity.js +59 -0
  172. package/dist/entities/cooktop.entity.js.map +1 -0
  173. package/dist/entities/energy_tariff.entity.d.ts +7 -0
  174. package/dist/entities/energy_tariff.entity.js +32 -0
  175. package/dist/entities/energy_tariff.entity.js.map +1 -0
  176. package/dist/entities/humidifier.entity.d.ts +27 -0
  177. package/dist/entities/humidifier.entity.js +187 -0
  178. package/dist/entities/humidifier.entity.js.map +1 -0
  179. package/dist/entities/lock.entity.d.ts +12 -0
  180. package/dist/entities/lock.entity.js +58 -0
  181. package/dist/entities/lock.entity.js.map +1 -0
  182. package/dist/entities/media-player.entity.d.ts +13 -0
  183. package/dist/entities/media-player.entity.js +52 -0
  184. package/dist/entities/media-player.entity.js.map +1 -0
  185. package/dist/entities/oven.entity.d.ts +20 -0
  186. package/dist/entities/oven.entity.js +112 -0
  187. package/dist/entities/oven.entity.js.map +1 -0
  188. package/dist/entities/pet_feeder.entity.d.ts +28 -0
  189. package/dist/entities/pet_feeder.entity.js +67 -0
  190. package/dist/entities/pet_feeder.entity.js.map +1 -0
  191. package/dist/entities/soil_sensor.entity.d.ts +7 -0
  192. package/dist/entities/soil_sensor.entity.js +40 -0
  193. package/dist/entities/soil_sensor.entity.js.map +1 -0
  194. package/dist/entities/vacuum.entity.d.ts +37 -0
  195. package/dist/entities/vacuum.entity.js +352 -0
  196. package/dist/entities/vacuum.entity.js.map +1 -0
  197. package/dist/frontend/assets/index-DPXu3al2.js +26 -0
  198. package/dist/frontend/assets/index-DalMl4eS.css +1 -0
  199. package/dist/frontend/assets/logo-B_gEBugV.png +0 -0
  200. package/dist/frontend/index.html +14 -0
  201. package/dist/frontend/logo.png +0 -0
  202. package/dist/homeAssistant.d.ts +1268 -0
  203. package/dist/homeAssistant.js +1623 -0
  204. package/dist/homeAssistant.js.map +1 -0
  205. package/dist/homekit.compat.d.ts +40 -0
  206. package/dist/homekit.compat.js +43 -0
  207. package/dist/homekit.compat.js.map +1 -0
  208. package/dist/index.d.ts +7 -0
  209. package/dist/index.js +31 -0
  210. package/dist/index.js.map +1 -0
  211. package/dist/mqtt/mqtt-client.d.ts +33 -0
  212. package/dist/mqtt/mqtt-client.js +138 -0
  213. package/dist/mqtt/mqtt-client.js.map +1 -0
  214. package/dist/mqtt/mqtt.entity.d.ts +30 -0
  215. package/dist/mqtt/mqtt.entity.js +286 -0
  216. package/dist/mqtt/mqtt.entity.js.map +1 -0
  217. package/dist/platform.d.ts +318 -0
  218. package/dist/platform.js +6144 -0
  219. package/dist/platform.js.map +1 -0
  220. package/dist/proxy.d.ts +1 -0
  221. package/dist/proxy.js +226 -0
  222. package/dist/proxy.js.map +1 -0
  223. package/dist/utils/ha-discovery.d.ts +30 -0
  224. package/dist/utils/ha-discovery.js +175 -0
  225. package/dist/utils/ha-discovery.js.map +1 -0
  226. package/dist/utils/ha-state.d.ts +48 -0
  227. package/dist/utils/ha-state.js +21 -0
  228. package/dist/utils/ha-state.js.map +1 -0
  229. package/dist/utils/light-color.d.ts +63 -0
  230. package/dist/utils/light-color.js +213 -0
  231. package/dist/utils/light-color.js.map +1 -0
  232. package/dist/utils/log-buffer.d.ts +13 -0
  233. package/dist/utils/log-buffer.js +50 -0
  234. package/dist/utils/log-buffer.js.map +1 -0
  235. package/dist/utils/matter-attributes.d.ts +13 -0
  236. package/dist/utils/matter-attributes.js +35 -0
  237. package/dist/utils/matter-attributes.js.map +1 -0
  238. package/dist/utils/matter-device-identity.d.ts +22 -0
  239. package/dist/utils/matter-device-identity.js +70 -0
  240. package/dist/utils/matter-device-identity.js.map +1 -0
  241. package/dist/utils/thread-credentials.d.ts +22 -0
  242. package/dist/utils/thread-credentials.js +29 -0
  243. package/dist/utils/thread-credentials.js.map +1 -0
  244. package/package.json +80 -0
@@ -0,0 +1,36 @@
1
+ export const lightConverter = {
2
+ /**
3
+ * Map HA state to OnOff boolean.
4
+ * State and is_on are the sole authority for OnOff; brightness is never used to infer power.
5
+ */
6
+ toOnOff(state) {
7
+ return state.state === "on";
8
+ },
9
+ /**
10
+ * Map HA brightness (1..255, with defensive fallback for 0) to Matter currentLevel (1..254).
11
+ *
12
+ * Modern Home Assistant specifies brightness in the range 1..255 (or null when off).
13
+ * Matter LevelControl cluster specifies CurrentLevel in the range 1..254.
14
+ *
15
+ * If an uncompliant integration reports brightness 0, it is defensively clamped to 1
16
+ * without affecting the OnOff state.
17
+ */
18
+ toLevel(state) {
19
+ const brightness = typeof state === "number" ? state : state?.attributes?.brightness;
20
+ if (brightness === undefined || brightness === null)
21
+ return 1;
22
+ // Defensive handling: clamp between 1 and 255 before mapping
23
+ const clampedHa = Math.max(1, Math.min(255, brightness));
24
+ const raw = Math.round((clampedHa / 255) * 254);
25
+ return Math.max(1, Math.min(254, raw));
26
+ },
27
+ /**
28
+ * Map Matter currentLevel (1..254) back to HA brightness (1..255).
29
+ */
30
+ toHaBrightness(level) {
31
+ const clampedLevel = Math.max(1, Math.min(254, level));
32
+ const raw = Math.round((clampedLevel / 254) * 255);
33
+ return Math.max(1, Math.min(255, raw));
34
+ },
35
+ };
36
+ //# sourceMappingURL=light.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"light.converter.js","sourceRoot":"","sources":["../../src/converters/light.converter.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;OAGG;IACH,OAAO,CAAC,KAAgB;QACtB,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAyB;QAC/B,MAAM,UAAU,GACd,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC;QACpE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QAC9D,6DAA6D;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAa;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;CACF,CAAC"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Converter utility for lock domain.
3
+ */
4
+ import { HassState } from "../utils/ha-state.js";
5
+ export declare enum MatterLockState {
6
+ NotFullyLocked = 0,
7
+ Locked = 1,
8
+ Unlocked = 2,
9
+ Unlatched = 3
10
+ }
11
+ export declare const lockConverter: {
12
+ /**
13
+ * Map HA state to Matter LockState.
14
+ */
15
+ toLockState(state: HassState): MatterLockState;
16
+ /**
17
+ * Map Matter LockState back to HA service call.
18
+ */
19
+ toHaService(lockState: MatterLockState): "lock" | "unlock";
20
+ };
@@ -0,0 +1,29 @@
1
+ export var MatterLockState;
2
+ (function (MatterLockState) {
3
+ MatterLockState[MatterLockState["NotFullyLocked"] = 0] = "NotFullyLocked";
4
+ MatterLockState[MatterLockState["Locked"] = 1] = "Locked";
5
+ MatterLockState[MatterLockState["Unlocked"] = 2] = "Unlocked";
6
+ MatterLockState[MatterLockState["Unlatched"] = 3] = "Unlatched";
7
+ })(MatterLockState || (MatterLockState = {}));
8
+ export const lockConverter = {
9
+ /**
10
+ * Map HA state to Matter LockState.
11
+ */
12
+ toLockState(state) {
13
+ switch (state.state) {
14
+ case "locked":
15
+ return MatterLockState.Locked;
16
+ case "unlocked":
17
+ return MatterLockState.Unlocked;
18
+ default:
19
+ return MatterLockState.NotFullyLocked;
20
+ }
21
+ },
22
+ /**
23
+ * Map Matter LockState back to HA service call.
24
+ */
25
+ toHaService(lockState) {
26
+ return lockState === MatterLockState.Locked ? "lock" : "unlock";
27
+ },
28
+ };
29
+ //# sourceMappingURL=lock.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.converter.js","sourceRoot":"","sources":["../../src/converters/lock.converter.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,yEAAkB,CAAA;IAClB,yDAAU,CAAA;IACV,6DAAY,CAAA;IACZ,+DAAa,CAAA;AACf,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,WAAW,CAAC,KAAgB;QAC1B,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACX,OAAO,eAAe,CAAC,MAAM,CAAC;YAChC,KAAK,UAAU;gBACb,OAAO,eAAe,CAAC,QAAQ,CAAC;YAClC;gBACE,OAAO,eAAe,CAAC,cAAc,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAA0B;QACpC,OAAO,SAAS,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClE,CAAC;CACF,CAAC"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Converter utility for sensor domain.
3
+ */
4
+ import { HassState } from "../utils/ha-state.js";
5
+ export declare const sensorConverter: {
6
+ /**
7
+ * Convert temperature sensor value.
8
+ */
9
+ toTemperature(state: HassState): number | null;
10
+ /**
11
+ * Convert relative humidity value.
12
+ */
13
+ toHumidity(state: HassState): number | null;
14
+ /**
15
+ * Convert light/illuminance value.
16
+ */
17
+ toIlluminance(state: HassState): number | null;
18
+ };
@@ -0,0 +1,33 @@
1
+ export const sensorConverter = {
2
+ /**
3
+ * Convert temperature sensor value.
4
+ */
5
+ toTemperature(state) {
6
+ const val = parseFloat(state.state);
7
+ if (isNaN(val))
8
+ return null;
9
+ return Math.round(val * 100); // Matter Temp is in 0.01 C
10
+ },
11
+ /**
12
+ * Convert relative humidity value.
13
+ */
14
+ toHumidity(state) {
15
+ const val = parseFloat(state.state);
16
+ if (isNaN(val))
17
+ return null;
18
+ return Math.round(val * 100); // Matter Humidity is in 0.01 %
19
+ },
20
+ /**
21
+ * Convert light/illuminance value.
22
+ */
23
+ toIlluminance(state) {
24
+ const val = parseFloat(state.state);
25
+ if (isNaN(val))
26
+ return null;
27
+ // Matter Illuminance = 10000 * log10(Lux) + 1
28
+ if (val <= 0)
29
+ return 1;
30
+ return Math.round(10000 * Math.log10(val) + 1);
31
+ },
32
+ };
33
+ //# sourceMappingURL=sensor.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sensor.converter.js","sourceRoot":"","sources":["../../src/converters/sensor.converter.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,aAAa,CAAC,KAAgB;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,2BAA2B;IAC3D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAgB;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,+BAA+B;IAC/D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAgB;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5B,8CAA8C;QAC9C,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Converter utility for soil sensors.
3
+ */
4
+ import { HassState } from "../utils/ha-state.js";
5
+ export declare const soilSensorConverter: {
6
+ /**
7
+ * Convert moisture state percentage to Matter format (0..10000).
8
+ */
9
+ toMoistureValue(state: HassState): number | null;
10
+ /**
11
+ * Convert temperature state to Matter temperature format.
12
+ */
13
+ toTemperatureValue(state: HassState): number | null;
14
+ };
@@ -0,0 +1,21 @@
1
+ export const soilSensorConverter = {
2
+ /**
3
+ * Convert moisture state percentage to Matter format (0..10000).
4
+ */
5
+ toMoistureValue(state) {
6
+ const rawVal = parseFloat(state.state);
7
+ if (isNaN(rawVal))
8
+ return null;
9
+ return Math.round(rawVal * 100);
10
+ },
11
+ /**
12
+ * Convert temperature state to Matter temperature format.
13
+ */
14
+ toTemperatureValue(state) {
15
+ const rawVal = parseFloat(state.state);
16
+ if (isNaN(rawVal))
17
+ return null;
18
+ return Math.round(rawVal * 100);
19
+ },
20
+ };
21
+ //# sourceMappingURL=soil_sensor.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"soil_sensor.converter.js","sourceRoot":"","sources":["../../src/converters/soil_sensor.converter.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC;;OAEG;IACH,eAAe,CAAC,KAAgB;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,KAAgB;QACjC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;CACF,CAAC"}
@@ -0,0 +1,168 @@
1
+ /**
2
+ * vacuum.converter.ts
3
+ *
4
+ * Converts Home Assistant `vacuum.*` entities (Tuya, Smart Life, Roborock,
5
+ * iRobot, Dreame, etc.) to the Matter 1.4 RVC (Robotic Vacuum Cleaner) device type.
6
+ *
7
+ * Apple Home recognises this as a real vacuum since iOS 18.4 / Matter 1.2+.
8
+ * The RVC device type requires the following clusters:
9
+ * - RvcRunMode (Idle / Cleaning / Mapping)
10
+ * - RvcCleanMode (Vacuum / Mop / etc.)
11
+ * - RvcOperationalState (Stop / Start / Pause / GoHome)
12
+ * - OnOff (for simple on/off bridging)
13
+ *
14
+ * HA vacuum states → Matter RVC states:
15
+ * cleaning → RvcOperationalState: Running
16
+ * paused → RvcOperationalState: Paused
17
+ * docked → RvcOperationalState: SeekingCharger + Docked
18
+ * idle → RvcOperationalState: Stopped
19
+ * returning → RvcOperationalState: SeekingCharger
20
+ * error → RvcOperationalState: Error
21
+ *
22
+ * @see https://matter-smarthome.de/en/know-how/matter-device-types/
23
+ * @see https://github.com/project-chip/connectedhomeip/blob/master/docs/clusters/RoboticVacuumCleaner.md
24
+ */
25
+ import type { HassState } from "../utils/ha-state.js";
26
+ /** RvcOperationalState operational state IDs (Matter 1.4 spec §9.10.5.1) */
27
+ export declare const RvcOperationalStateId: {
28
+ readonly Stopped: 0;
29
+ readonly Running: 1;
30
+ readonly Paused: 2;
31
+ readonly Error: 3;
32
+ readonly SeekingCharger: 64;
33
+ readonly Charging: 65;
34
+ readonly Docked: 66;
35
+ };
36
+ /** RvcRunMode mode tags (Matter 1.4 spec §7.22) */
37
+ export declare const RvcRunModeTag: {
38
+ readonly Idle: 16384;
39
+ readonly Cleaning: 16385;
40
+ readonly Mapping: 16386;
41
+ };
42
+ /** RvcCleanMode mode tags (Matter 1.4 spec §7.23) */
43
+ export declare const RvcCleanModeTag: {
44
+ readonly DeepClean: 16384;
45
+ readonly Vacuum: 16385;
46
+ readonly Mop: 16386;
47
+ };
48
+ export type RvcOperationalStateValue = (typeof RvcOperationalStateId)[keyof typeof RvcOperationalStateId];
49
+ /**
50
+ * Possible HA vacuum states.
51
+ * https://www.home-assistant.io/integrations/vacuum/
52
+ */
53
+ export type HaVacuumState = "cleaning" | "docked" | "idle" | "paused" | "returning" | "error" | "unavailable" | "unknown" | string;
54
+ /**
55
+ * Maps a HA vacuum state string to the closest Matter RvcOperationalState value.
56
+ */
57
+ export declare function haVacuumStateToMatter(haState: HaVacuumState): RvcOperationalStateValue;
58
+ /**
59
+ * Returns true when the vacuum is actively cleaning or switched on.
60
+ * Used to drive the OnOff cluster for simple on/off bridges.
61
+ */
62
+ export declare function haVacuumIsActive(haState: HaVacuumState): boolean;
63
+ /**
64
+ * Some vacuum integrations leave the HA entity state at `cleaning` while the
65
+ * physical robot is already in its base. Prefer an explicit charging/docked
66
+ * status from the integration over that stale activity state.
67
+ */
68
+ export declare function isVacuumChargingOrDocked(entity: HassState): boolean;
69
+ /**
70
+ * Maps a Matter RvcOperationalState command to the corresponding
71
+ * HA vacuum service call.
72
+ *
73
+ * Returns `{ service: string; extra?: Record<string, unknown> }` or
74
+ * `null` when there is no matching HA service.
75
+ */
76
+ export declare function matterCommandToHaVacuum(command: "start" | "stop" | "pause" | "resume" | "goHome"): {
77
+ service: string;
78
+ extra?: Record<string, unknown>;
79
+ } | null;
80
+ /**
81
+ * Some Tuya/Smart Life vacuums expose a `fan_speed` attribute.
82
+ * Maps well-known HA fan speed strings to a 0-100 Matter fan speed level.
83
+ *
84
+ * Falls back to `null` when unknown so callers can skip the attribute update.
85
+ */
86
+ export declare function haFanSpeedToMatter(fanSpeed: string | undefined): number | null;
87
+ /**
88
+ * Extracts relevant vacuum attributes from a HA entity state object.
89
+ * Normalises attribute names across Tuya, Roborock, iRobot, Dreame, etc.
90
+ */
91
+ export interface VacuumAttributes {
92
+ battery_level: number | null;
93
+ fan_speed: string | undefined;
94
+ fan_speed_list: string[];
95
+ status: string | undefined;
96
+ error_code: number | null;
97
+ }
98
+ export declare function extractVacuumAttributes(entity: HassState): VacuumAttributes;
99
+ export interface VacuumCleanModeOption {
100
+ option: string;
101
+ mode: number;
102
+ label: string;
103
+ modeTag: number;
104
+ }
105
+ /**
106
+ * Filters and maps HA clean mode selector options to valid RVC Clean Mode definitions.
107
+ * Explicitly excludes non-clean options such as 'standby', 'chargego', 'manual', 'stop'.
108
+ */
109
+ export declare function getSupportedVacuumCleanModes(options: string[]): VacuumCleanModeOption[];
110
+ /**
111
+ * Metadata used by the frontend to display the vacuum in the entity picker
112
+ * and generate its individual Matter QR code.
113
+ */
114
+ export interface VacuumMatterMeta {
115
+ /** Matter device type discriminator shown in the UI */
116
+ matterType: "RoboticVacuumCleaner";
117
+ /** Short human-readable label for the QR code selector */
118
+ displayLabel: string;
119
+ /** HomeKit-compatible: true — Apple Home supports RVC via Matter ≥1.2 */
120
+ homekitCompatible: true;
121
+ /** Vendor-specific hint parsed from the entity's integration manifest */
122
+ vendorHint: "tuya" | "smartlife" | "roborock" | "irobot" | "dreame" | "generic";
123
+ }
124
+ /**
125
+ * Builds the Matter metadata record for a vacuum entity.
126
+ * The `platform_id` attribute (set by most integrations) is used as a vendor hint.
127
+ */
128
+ export declare function buildVacuumMatterMeta(entity: HassState): VacuumMatterMeta;
129
+ /**
130
+ * Determines whether a HA entity should be handled by this converter.
131
+ * Matches `vacuum.*` domain entities or entities with roboticVacuumCleaner profile.
132
+ */
133
+ export declare function isVacuumEntity(entity: HassState, effectiveProfile?: string): boolean;
134
+ /**
135
+ * Main converter entry point.
136
+ *
137
+ * Returns the set of Matter attribute updates to apply to the Matterbridge
138
+ * endpoint representing this vacuum.
139
+ *
140
+ * Usage example (inside platform.ts device sync loop):
141
+ *
142
+ * ```ts
143
+ * import { isVacuumEntity, buildVacuumUpdate } from './converters/vacuum.converter.js';
144
+ *
145
+ * if (isVacuumEntity(entity)) {
146
+ * const update = buildVacuumUpdate(entity);
147
+ * await endpoint.setAttribute('rvcOperationalState', 'currentPhase', update.operationalState);
148
+ * if (update.batteryLevel != null) {
149
+ * await endpoint.setAttribute('powerSource', 'batPercentRemaining', update.batteryLevel * 2);
150
+ * }
151
+ * }
152
+ * ```
153
+ */
154
+ export interface VacuumMatterUpdate {
155
+ /** Maps to RvcOperationalState.operationalState */
156
+ operationalState: RvcOperationalStateValue;
157
+ /** Maps to OnOff.onOff (true while cleaning) */
158
+ onOff: boolean;
159
+ /** True when the integration reports that the robot is at its base. */
160
+ isChargingOrDocked: boolean;
161
+ /** Maps to PowerSource.batPercentRemaining (Matter uses 0-200 range) */
162
+ batteryLevel: number | null;
163
+ /** Maps to FanControl.percentSetting (0-100) */
164
+ fanSpeedPercent: number | null;
165
+ /** Full extracted attributes for custom handling */
166
+ attributes: VacuumAttributes;
167
+ }
168
+ export declare function buildVacuumUpdate(entity: HassState): VacuumMatterUpdate;
@@ -0,0 +1,288 @@
1
+ /**
2
+ * vacuum.converter.ts
3
+ *
4
+ * Converts Home Assistant `vacuum.*` entities (Tuya, Smart Life, Roborock,
5
+ * iRobot, Dreame, etc.) to the Matter 1.4 RVC (Robotic Vacuum Cleaner) device type.
6
+ *
7
+ * Apple Home recognises this as a real vacuum since iOS 18.4 / Matter 1.2+.
8
+ * The RVC device type requires the following clusters:
9
+ * - RvcRunMode (Idle / Cleaning / Mapping)
10
+ * - RvcCleanMode (Vacuum / Mop / etc.)
11
+ * - RvcOperationalState (Stop / Start / Pause / GoHome)
12
+ * - OnOff (for simple on/off bridging)
13
+ *
14
+ * HA vacuum states → Matter RVC states:
15
+ * cleaning → RvcOperationalState: Running
16
+ * paused → RvcOperationalState: Paused
17
+ * docked → RvcOperationalState: SeekingCharger + Docked
18
+ * idle → RvcOperationalState: Stopped
19
+ * returning → RvcOperationalState: SeekingCharger
20
+ * error → RvcOperationalState: Error
21
+ *
22
+ * @see https://matter-smarthome.de/en/know-how/matter-device-types/
23
+ * @see https://github.com/project-chip/connectedhomeip/blob/master/docs/clusters/RoboticVacuumCleaner.md
24
+ */
25
+ // ─── Matter RVC Cluster IDs ────────────────────────────────────────────────
26
+ /** RvcOperationalState operational state IDs (Matter 1.4 spec §9.10.5.1) */
27
+ export const RvcOperationalStateId = {
28
+ Stopped: 0x00,
29
+ Running: 0x01,
30
+ Paused: 0x02,
31
+ Error: 0x03,
32
+ SeekingCharger: 0x40,
33
+ Charging: 0x41,
34
+ Docked: 0x42,
35
+ };
36
+ /** RvcRunMode mode tags (Matter 1.4 spec §7.22) */
37
+ export const RvcRunModeTag = {
38
+ Idle: 0x4000,
39
+ Cleaning: 0x4001,
40
+ Mapping: 0x4002,
41
+ };
42
+ /** RvcCleanMode mode tags (Matter 1.4 spec §7.23) */
43
+ export const RvcCleanModeTag = {
44
+ DeepClean: 0x4000,
45
+ Vacuum: 0x4001,
46
+ Mop: 0x4002,
47
+ };
48
+ // ─── State mapping ────────────────────────────────────────────────────────
49
+ /**
50
+ * Maps a HA vacuum state string to the closest Matter RvcOperationalState value.
51
+ */
52
+ export function haVacuumStateToMatter(haState) {
53
+ switch (haState.toLowerCase()) {
54
+ case "cleaning":
55
+ case "on":
56
+ return RvcOperationalStateId.Running;
57
+ case "paused":
58
+ return RvcOperationalStateId.Paused;
59
+ case "docked":
60
+ return RvcOperationalStateId.Docked;
61
+ case "returning":
62
+ return RvcOperationalStateId.SeekingCharger;
63
+ case "error":
64
+ return RvcOperationalStateId.Error;
65
+ case "idle":
66
+ case "off":
67
+ default:
68
+ return RvcOperationalStateId.Stopped;
69
+ }
70
+ }
71
+ /**
72
+ * Returns true when the vacuum is actively cleaning or switched on.
73
+ * Used to drive the OnOff cluster for simple on/off bridges.
74
+ */
75
+ export function haVacuumIsActive(haState) {
76
+ const normalized = haState.toLowerCase();
77
+ return normalized === "cleaning" || normalized === "on";
78
+ }
79
+ /**
80
+ * Some vacuum integrations leave the HA entity state at `cleaning` while the
81
+ * physical robot is already in its base. Prefer an explicit charging/docked
82
+ * status from the integration over that stale activity state.
83
+ */
84
+ export function isVacuumChargingOrDocked(entity) {
85
+ const attributes = entity.attributes ?? {};
86
+ const rawDps = attributes.raw_dps;
87
+ const signals = [
88
+ attributes.status,
89
+ attributes.activity,
90
+ attributes.state,
91
+ ...(rawDps && typeof rawDps === "object"
92
+ ? Object.values(rawDps)
93
+ : []),
94
+ ];
95
+ return signals.some((value) => {
96
+ if (typeof value !== "string")
97
+ return false;
98
+ const normalized = value.trim().toLowerCase();
99
+ return [
100
+ "charging",
101
+ "charge",
102
+ "docked",
103
+ "on_charge",
104
+ "in_charge",
105
+ "charging_completed",
106
+ "charge_done",
107
+ ].includes(normalized);
108
+ });
109
+ }
110
+ // ─── HA command mapping ───────────────────────────────────────────────────
111
+ /**
112
+ * Maps a Matter RvcOperationalState command to the corresponding
113
+ * HA vacuum service call.
114
+ *
115
+ * Returns `{ service: string; extra?: Record<string, unknown> }` or
116
+ * `null` when there is no matching HA service.
117
+ */
118
+ export function matterCommandToHaVacuum(command) {
119
+ switch (command) {
120
+ case "start":
121
+ return { service: "vacuum.start" };
122
+ case "stop":
123
+ return { service: "vacuum.stop" };
124
+ case "pause":
125
+ return { service: "vacuum.pause" };
126
+ case "resume":
127
+ // HA doesn't have a dedicated resume — start again
128
+ return { service: "vacuum.start" };
129
+ case "goHome":
130
+ return { service: "vacuum.return_to_base" };
131
+ default:
132
+ return null;
133
+ }
134
+ }
135
+ // ─── Fan speed / suction → Matter fan speed level ─────────────────────────
136
+ /**
137
+ * Some Tuya/Smart Life vacuums expose a `fan_speed` attribute.
138
+ * Maps well-known HA fan speed strings to a 0-100 Matter fan speed level.
139
+ *
140
+ * Falls back to `null` when unknown so callers can skip the attribute update.
141
+ */
142
+ export function haFanSpeedToMatter(fanSpeed) {
143
+ if (fanSpeed == null)
144
+ return null;
145
+ switch (fanSpeed.toLowerCase()) {
146
+ case "quiet":
147
+ case "min":
148
+ case "eco":
149
+ return 25;
150
+ case "standard":
151
+ case "normal":
152
+ case "medium":
153
+ return 50;
154
+ case "strong":
155
+ case "high":
156
+ case "turbo":
157
+ case "boost":
158
+ return 75;
159
+ case "max":
160
+ case "max+":
161
+ return 100;
162
+ default: {
163
+ // Try to parse numeric strings ("50", "75", etc.)
164
+ const n = Number(fanSpeed);
165
+ return Number.isFinite(n) ? Math.min(100, Math.max(0, n)) : null;
166
+ }
167
+ }
168
+ }
169
+ export function extractVacuumAttributes(entity) {
170
+ const a = entity.attributes ?? {};
171
+ // Try to parse battery level from standard attributes
172
+ let battery = typeof a["battery_level"] === "number"
173
+ ? a["battery_level"]
174
+ : typeof a["battery"] === "number"
175
+ ? a["battery"]
176
+ : null;
177
+ // Fallback: If not found, try to extract from raw_dps (common in Tuya/Smart Life integrations)
178
+ if (battery === null && a["raw_dps"] && typeof a["raw_dps"] === "object") {
179
+ const rawDps = a["raw_dps"];
180
+ const dps6 = rawDps["6"];
181
+ if (typeof dps6 === "number") {
182
+ battery = dps6;
183
+ }
184
+ else if (typeof dps6 === "string") {
185
+ const parsed = parseInt(dps6, 10);
186
+ if (!isNaN(parsed))
187
+ battery = parsed;
188
+ }
189
+ }
190
+ return {
191
+ battery_level: battery,
192
+ fan_speed: typeof a["fan_speed"] === "string"
193
+ ? a["fan_speed"]
194
+ : typeof a["suction"] === "string"
195
+ ? a["suction"]
196
+ : undefined,
197
+ fan_speed_list: Array.isArray(a["fan_speed_list"])
198
+ ? a["fan_speed_list"]
199
+ : [],
200
+ status: typeof a["status"] === "string" ? a["status"] : undefined,
201
+ error_code: typeof a["error_code"] === "number" ? a["error_code"] : null,
202
+ };
203
+ }
204
+ const CLEAN_MODE_MAPPING = {
205
+ smart: { mode: 1, label: "Automático", modeTag: 0x0000 }, // Auto
206
+ auto: { mode: 1, label: "Automático", modeTag: 0x0000 },
207
+ random: { mode: 2, label: "Aleatorio", modeTag: 0x0001 }, // Quick
208
+ wall_follow: { mode: 3, label: "Seguimiento de pared", modeTag: 0x0002 }, // Quiet
209
+ edge: { mode: 3, label: "Seguimiento de pared", modeTag: 0x0002 },
210
+ spiral: { mode: 4, label: "Espiral", modeTag: 0x4000 },
211
+ spot: { mode: 4, label: "Espiral", modeTag: 0x4000 },
212
+ };
213
+ /**
214
+ * Filters and maps HA clean mode selector options to valid RVC Clean Mode definitions.
215
+ * Explicitly excludes non-clean options such as 'standby', 'chargego', 'manual', 'stop'.
216
+ */
217
+ export function getSupportedVacuumCleanModes(options) {
218
+ const result = [];
219
+ const seenModes = new Set();
220
+ for (const opt of options) {
221
+ const key = opt.toLowerCase().trim();
222
+ if (["standby", "chargego", "manual", "stop", "off", "idle"].includes(key))
223
+ continue;
224
+ const mapped = CLEAN_MODE_MAPPING[key];
225
+ if (mapped && !seenModes.has(mapped.mode)) {
226
+ seenModes.add(mapped.mode);
227
+ result.push({
228
+ option: opt,
229
+ mode: mapped.mode,
230
+ label: mapped.label,
231
+ modeTag: mapped.modeTag,
232
+ });
233
+ }
234
+ }
235
+ return result;
236
+ }
237
+ /**
238
+ * Builds the Matter metadata record for a vacuum entity.
239
+ * The `platform_id` attribute (set by most integrations) is used as a vendor hint.
240
+ */
241
+ export function buildVacuumMatterMeta(entity) {
242
+ const integrationId = entity.attributes?.["integration"]?.toLowerCase() ??
243
+ "";
244
+ let vendorHint = "generic";
245
+ if (integrationId.includes("tuya") || integrationId.includes("smart_life")) {
246
+ vendorHint = "tuya";
247
+ }
248
+ else if (integrationId.includes("roborock")) {
249
+ vendorHint = "roborock";
250
+ }
251
+ else if (integrationId.includes("irobot") ||
252
+ integrationId.includes("roomba")) {
253
+ vendorHint = "irobot";
254
+ }
255
+ else if (integrationId.includes("dreame")) {
256
+ vendorHint = "dreame";
257
+ }
258
+ return {
259
+ matterType: "RoboticVacuumCleaner",
260
+ displayLabel: entity.attributes?.["friendly_name"] ?? entity.entity_id,
261
+ homekitCompatible: true,
262
+ vendorHint,
263
+ };
264
+ }
265
+ // ─── Platform integration hook ────────────────────────────────────────────
266
+ /**
267
+ * Determines whether a HA entity should be handled by this converter.
268
+ * Matches `vacuum.*` domain entities or entities with roboticVacuumCleaner profile.
269
+ */
270
+ export function isVacuumEntity(entity, effectiveProfile) {
271
+ return (entity.entity_id.startsWith("vacuum.") ||
272
+ effectiveProfile === "roboticVacuumCleaner");
273
+ }
274
+ export function buildVacuumUpdate(entity) {
275
+ const attrs = extractVacuumAttributes(entity);
276
+ const isChargingOrDocked = isVacuumChargingOrDocked(entity);
277
+ return {
278
+ operationalState: isChargingOrDocked
279
+ ? RvcOperationalStateId.Charging
280
+ : haVacuumStateToMatter(entity.state),
281
+ onOff: !isChargingOrDocked && haVacuumIsActive(entity.state),
282
+ isChargingOrDocked,
283
+ batteryLevel: attrs.battery_level,
284
+ fanSpeedPercent: haFanSpeedToMatter(attrs.fan_speed),
285
+ attributes: attrs,
286
+ };
287
+ }
288
+ //# sourceMappingURL=vacuum.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vacuum.converter.js","sourceRoot":"","sources":["../../src/converters/vacuum.converter.ts"],"names":[],"mappings":"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"}