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,233 @@
1
+ /**
2
+ * Converter utilities for the HA `fan` domain.
3
+ *
4
+ * Design principles (enforced here and in all callers):
5
+ *
6
+ * 1. ON/OFF state comes ONLY from `state` / `is_on` — NEVER from `percentage > 0`.
7
+ * A fan can be OFF with a remembered `percentage` of 32, 88 or 100.
8
+ *
9
+ * 2. `last_*` attributes (last_is_on, last_percentage, last_direction, …) are
10
+ * memory, not current state. They MUST NOT overwrite current attributes.
11
+ *
12
+ * 3. The three physical fans have 6 discrete speeds (step ≈ 16.667 %).
13
+ * HA may return non-round values (e.g. 32, 88). We normalise to the
14
+ * nearest physical level for commands to HA; we accept any value from HA
15
+ * for Matter updates (round to nearest integer).
16
+ *
17
+ * 4. Hysteresis: do not re-send a speed command if the delta from the last
18
+ * acknowledged value is within ±SPEED_HYSTERESIS_PCT (avoids oscillation
19
+ * between adjacent levels on successive HomeKit slider drags).
20
+ *
21
+ * 5. AirflowDirection: `forward` → Forward (0), `reverse` → Reverse (1).
22
+ * Only use `last_direction` for restoration, never as the current direction.
23
+ */
24
+ import { FanControl } from "matterbridge/matter/clusters";
25
+ import type { HassState } from "../utils/ha-state.js";
26
+ export declare const FanEntityFeature: {
27
+ readonly SET_SPEED: 1;
28
+ readonly OSCILLATE: 2;
29
+ readonly DIRECTION: 4;
30
+ readonly PRESET_MODE: 8;
31
+ readonly TURN_OFF: 16;
32
+ readonly TURN_ON: 32;
33
+ };
34
+ /**
35
+ * The three physical fans have 6 discrete speeds (step ≈ 16.667 %).
36
+ * Representative percentages: 16.67, 33.33, 50, 66.67, 83.33, 100.
37
+ * Using the midpoints between steps as thresholds.
38
+ */
39
+ export declare const FAN_SPEED_LEVELS: readonly [{
40
+ readonly speed: 1;
41
+ readonly pct: 16.67;
42
+ readonly threshold_lo: 0;
43
+ readonly threshold_hi: 25;
44
+ }, {
45
+ readonly speed: 2;
46
+ readonly pct: 33.33;
47
+ readonly threshold_lo: 25;
48
+ readonly threshold_hi: 41.7;
49
+ }, {
50
+ readonly speed: 3;
51
+ readonly pct: 50;
52
+ readonly threshold_lo: 41.7;
53
+ readonly threshold_hi: 58.3;
54
+ }, {
55
+ readonly speed: 4;
56
+ readonly pct: 66.67;
57
+ readonly threshold_lo: 58.3;
58
+ readonly threshold_hi: 75;
59
+ }, {
60
+ readonly speed: 5;
61
+ readonly pct: 83.33;
62
+ readonly threshold_lo: 75;
63
+ readonly threshold_hi: 91.7;
64
+ }, {
65
+ readonly speed: 6;
66
+ readonly pct: 100;
67
+ readonly threshold_lo: 91.7;
68
+ readonly threshold_hi: 100;
69
+ }];
70
+ /** Max discrete speed level supported by the physical fans. */
71
+ export declare const FAN_SPEED_MAX = 6;
72
+ /**
73
+ * Hysteresis band in percentage points.
74
+ * A new command is suppressed if |requested - current| < this value.
75
+ */
76
+ export declare const SPEED_HYSTERESIS_PCT = 4;
77
+ /**
78
+ * Determine ON/OFF from HA fan state.
79
+ *
80
+ * Uses `state` and `is_on` exclusively.
81
+ * `percentage > 0` MUST NOT be used as an on indicator.
82
+ */
83
+ export declare function isFanOn(state: HassState): boolean;
84
+ /**
85
+ * Resolve the current percentage from HA state.
86
+ *
87
+ * Returns the `percentage` attribute value (may be from memory when off).
88
+ * NEVER uses `last_percentage` as current state.
89
+ * Returns 0 when the value is absent or invalid.
90
+ */
91
+ export declare function fanPercentage(state: HassState): number;
92
+ /**
93
+ * Derive speedMax dynamically from HA state attributes.
94
+ * Uses speed_count, speed_list length, or 100 / percentage_step.
95
+ */
96
+ export declare function getFanSpeedCount(state: HassState): number;
97
+ /**
98
+ * Normalise an arbitrary percentage to the nearest physical speed level
99
+ * percentage (using the 6-speed lookup table when speedMax=6, or dynamic calculation).
100
+ *
101
+ * Examples:
102
+ * 32 → 33.33 (level 2)
103
+ * 88 → 83.33 (level 5)
104
+ * 100 → 100 (level 6)
105
+ * 0 → 0 (off, returned as-is)
106
+ */
107
+ export declare function normaliseToPhysicalSpeed(pct: number, speedMax?: number): number;
108
+ /**
109
+ * Given a requested percentage (0-100), snap it to the nearest physical level
110
+ * percentage. Returns 0 when pct === 0 (represents off/minimum in some UIs).
111
+ */
112
+ export declare function snapToPhysicalLevel(pct: number, speedMax?: number): number;
113
+ /**
114
+ * Return true if the requested percentage is within the hysteresis band of the
115
+ * current percentage, meaning we should skip re-sending the command to HA.
116
+ */
117
+ export declare function withinHysteresis(requestedPct: number, currentPct: number): boolean;
118
+ /**
119
+ * Map a HA direction string to a Matter AirflowDirection value.
120
+ *
121
+ * HA reports `forward` or `reverse`; anything else defaults to Forward.
122
+ * NEVER use `last_direction` as the current direction.
123
+ */
124
+ export declare function haDirectionToMatter(direction: string | undefined): FanControl.AirflowDirection;
125
+ /**
126
+ * Map a Matter AirflowDirection to the HA direction string.
127
+ */
128
+ export declare function matterDirectionToHa(direction: FanControl.AirflowDirection): "forward" | "reverse";
129
+ /**
130
+ * Resolve the current direction from HA state.
131
+ * Only uses `attributes.direction`, NEVER `last_direction`.
132
+ */
133
+ export declare function fanDirection(state: HassState): string | undefined;
134
+ /**
135
+ * Check if the Home Assistant fan entity exposes direction control capability.
136
+ * Uses FanEntityFeature.DIRECTION (4) as the authoritative capability flag.
137
+ */
138
+ export declare function hasFanDirection(state: HassState): boolean;
139
+ /**
140
+ * Check if the Home Assistant fan entity exposes a true Auto capability/preset.
141
+ * Sleep/breeze presets are NOT equivalent to Matter Auto.
142
+ */
143
+ export declare function hasFanAuto(state: HassState): boolean;
144
+ /**
145
+ * Select the conformant FanModeSequence according to the exact enabled features.
146
+ * When Auto is enabled, OffLowMedHighAuto is required.
147
+ */
148
+ export declare function getFanModeSequence(_state?: HassState): FanControl.FanModeSequence;
149
+ /**
150
+ * Resolve dynamic Matter FanControl features supported by the fan.
151
+ * Includes MultiSpeed, Auto and Step for full Apple Home manual/auto and slider support.
152
+ * AirflowDirection (DIR) is included when HA fan supports direction (bit 4).
153
+ */
154
+ export declare function getFanControlFeatures(state: HassState): any[];
155
+ /**
156
+ * Determine the appropriate Matter FanMode from HA fan state.
157
+ *
158
+ * - Off when state is off.
159
+ * - On (speed-based) when on and percentage is non-zero.
160
+ * - On (mode 4 = "On") as fallback for on without percentage.
161
+ *
162
+ * Auto mode requires HA to expose a real auto capability; we do NOT invent it.
163
+ */
164
+ export declare function haStateToFanMode(state: HassState): FanControl.FanMode;
165
+ /** Default sequence for fans without Auto. */
166
+ export declare const FAN_MODE_SEQUENCE = FanControl.FanModeSequence.OffLowMedHigh;
167
+ /**
168
+ * Supported HA preset modes for the bedroom fan.
169
+ * Matter 1.6 / FanControl has `WindSetting` (sleepWind, naturalWind) which maps to
170
+ * `sleep` and `breeze` respectively.
171
+ *
172
+ * Presets are tracked only in HA; we do NOT advertise them as Auto.
173
+ */
174
+ export declare const FAN_PRESET_TO_WIND: Record<string, string>;
175
+ /**
176
+ * Determine if HA fan exposes speed/percentage control (bit 0 = SET_SPEED in supported_features).
177
+ * Returns true if supported_features has SET_SPEED (1) or if percentage is present.
178
+ */
179
+ export declare function hasFanSpeed(state: HassState): boolean;
180
+ /**
181
+ * Return the physical speed level (1..speedMax) or 0 (Off) based on the percentage.
182
+ */
183
+ export declare function fanSpeed(pct: number, speedMax?: number): number;
184
+ export declare const fanConverter: {
185
+ /**
186
+ * Convert HA fan state percentage to a Matter percentage (0-100).
187
+ * DOES NOT use last_percentage or percentage>0 as on indicator.
188
+ */
189
+ toPercentage(state: HassState): number;
190
+ /**
191
+ * Map Matter speed percentage back to the nearest physical HA percentage.
192
+ */
193
+ toHaPercentage(percent: number, speedMax?: number): number;
194
+ /** True only when state/is_on says on. */
195
+ isOn: typeof isFanOn;
196
+ /** Snap arbitrary percent to closest speed level. */
197
+ snapToPhysicalLevel: typeof snapToPhysicalLevel;
198
+ /** Normalise raw HA percent to nearest level name. */
199
+ normaliseToPhysicalSpeed: typeof normaliseToPhysicalSpeed;
200
+ /** Hysteresis check. */
201
+ withinHysteresis: typeof withinHysteresis;
202
+ /** HA direction → Matter AirflowDirection. */
203
+ haDirectionToMatter: typeof haDirectionToMatter;
204
+ /** Matter AirflowDirection → HA direction string. */
205
+ matterDirectionToHa: typeof matterDirectionToHa;
206
+ /** Current direction from state (not last_direction). */
207
+ fanDirection: typeof fanDirection;
208
+ /** Determine if HA fan exposes speed control. */
209
+ hasFanSpeed: typeof hasFanSpeed;
210
+ /** Determine if HA fan exposes direction control (bit 4 in supported_features). */
211
+ hasFanDirection: typeof hasFanDirection;
212
+ /** Determine if HA fan exposes Auto preset. */
213
+ hasFanAuto: typeof hasFanAuto;
214
+ /** Dynamic speed count. */
215
+ getFanSpeedCount: typeof getFanSpeedCount;
216
+ /** Dynamic FanModeSequence. */
217
+ getFanModeSequence: typeof getFanModeSequence;
218
+ /** Dynamic FanControl features. */
219
+ getFanControlFeatures: typeof getFanControlFeatures;
220
+ /** Return the physical speed level (1..speedMax) or 0 (Off) based on the percentage. */
221
+ fanSpeed: typeof fanSpeed;
222
+ /** Derive FanMode from HA state. */
223
+ haStateToFanMode: typeof haStateToFanMode;
224
+ /** HA Fan Entity Feature Constants */
225
+ FanEntityFeature: {
226
+ readonly SET_SPEED: 1;
227
+ readonly OSCILLATE: 2;
228
+ readonly DIRECTION: 4;
229
+ readonly PRESET_MODE: 8;
230
+ readonly TURN_OFF: 16;
231
+ readonly TURN_ON: 32;
232
+ };
233
+ };
@@ -0,0 +1,353 @@
1
+ /**
2
+ * Converter utilities for the HA `fan` domain.
3
+ *
4
+ * Design principles (enforced here and in all callers):
5
+ *
6
+ * 1. ON/OFF state comes ONLY from `state` / `is_on` — NEVER from `percentage > 0`.
7
+ * A fan can be OFF with a remembered `percentage` of 32, 88 or 100.
8
+ *
9
+ * 2. `last_*` attributes (last_is_on, last_percentage, last_direction, …) are
10
+ * memory, not current state. They MUST NOT overwrite current attributes.
11
+ *
12
+ * 3. The three physical fans have 6 discrete speeds (step ≈ 16.667 %).
13
+ * HA may return non-round values (e.g. 32, 88). We normalise to the
14
+ * nearest physical level for commands to HA; we accept any value from HA
15
+ * for Matter updates (round to nearest integer).
16
+ *
17
+ * 4. Hysteresis: do not re-send a speed command if the delta from the last
18
+ * acknowledged value is within ±SPEED_HYSTERESIS_PCT (avoids oscillation
19
+ * between adjacent levels on successive HomeKit slider drags).
20
+ *
21
+ * 5. AirflowDirection: `forward` → Forward (0), `reverse` → Reverse (1).
22
+ * Only use `last_direction` for restoration, never as the current direction.
23
+ */
24
+ import { FanControl } from "matterbridge/matter/clusters";
25
+ // ── HA Fan Entity Features (Authoritative bitmask from Home Assistant) ─────────
26
+ export const FanEntityFeature = {
27
+ SET_SPEED: 1, // 1 << 0
28
+ OSCILLATE: 2, // 1 << 1
29
+ DIRECTION: 4, // 1 << 2 (Bit 4)
30
+ PRESET_MODE: 8, // 1 << 3 (Bit 8)
31
+ TURN_OFF: 16, // 1 << 4
32
+ TURN_ON: 32, // 1 << 5
33
+ };
34
+ // ── Constants ─────────────────────────────────────────────────────────────────
35
+ /**
36
+ * The three physical fans have 6 discrete speeds (step ≈ 16.667 %).
37
+ * Representative percentages: 16.67, 33.33, 50, 66.67, 83.33, 100.
38
+ * Using the midpoints between steps as thresholds.
39
+ */
40
+ export const FAN_SPEED_LEVELS = [
41
+ { speed: 1, pct: 16.67, threshold_lo: 0, threshold_hi: 25 },
42
+ { speed: 2, pct: 33.33, threshold_lo: 25, threshold_hi: 41.7 },
43
+ { speed: 3, pct: 50, threshold_lo: 41.7, threshold_hi: 58.3 },
44
+ { speed: 4, pct: 66.67, threshold_lo: 58.3, threshold_hi: 75 },
45
+ { speed: 5, pct: 83.33, threshold_lo: 75, threshold_hi: 91.7 },
46
+ { speed: 6, pct: 100, threshold_lo: 91.7, threshold_hi: 100 },
47
+ ];
48
+ /** Max discrete speed level supported by the physical fans. */
49
+ export const FAN_SPEED_MAX = 6;
50
+ /**
51
+ * Hysteresis band in percentage points.
52
+ * A new command is suppressed if |requested - current| < this value.
53
+ */
54
+ export const SPEED_HYSTERESIS_PCT = 4;
55
+ // ── Helpers ───────────────────────────────────────────────────────────────────
56
+ /**
57
+ * Determine ON/OFF from HA fan state.
58
+ *
59
+ * Uses `state` and `is_on` exclusively.
60
+ * `percentage > 0` MUST NOT be used as an on indicator.
61
+ */
62
+ export function isFanOn(state) {
63
+ if (state.state === "on")
64
+ return true;
65
+ if (state.state === "off")
66
+ return false;
67
+ // Some integrations use boolean `is_on` inside attributes
68
+ if (typeof state.attributes.is_on === "boolean")
69
+ return state.attributes.is_on;
70
+ // Unavailable / unknown → treat as off for safety
71
+ return false;
72
+ }
73
+ /**
74
+ * Resolve the current percentage from HA state.
75
+ *
76
+ * Returns the `percentage` attribute value (may be from memory when off).
77
+ * NEVER uses `last_percentage` as current state.
78
+ * Returns 0 when the value is absent or invalid.
79
+ */
80
+ export function fanPercentage(state) {
81
+ const raw = state.attributes.percentage;
82
+ if (typeof raw === "number" && raw >= 0 && raw <= 100)
83
+ return raw;
84
+ return 0;
85
+ }
86
+ /**
87
+ * Derive speedMax dynamically from HA state attributes.
88
+ * Uses speed_count, speed_list length, or 100 / percentage_step.
89
+ */
90
+ export function getFanSpeedCount(state) {
91
+ if (typeof state.attributes.speed_count === "number" &&
92
+ state.attributes.speed_count > 0) {
93
+ return Math.min(100, Math.max(1, Math.round(state.attributes.speed_count)));
94
+ }
95
+ if (Array.isArray(state.attributes.speed_list) &&
96
+ state.attributes.speed_list.length > 0) {
97
+ return Math.min(100, Math.max(1, state.attributes.speed_list.length));
98
+ }
99
+ const step = state.attributes.percentage_step;
100
+ if (typeof step === "number" && step > 0 && step <= 100) {
101
+ return Math.min(100, Math.max(1, Math.round(100 / step)));
102
+ }
103
+ return FAN_SPEED_MAX;
104
+ }
105
+ /**
106
+ * Normalise an arbitrary percentage to the nearest physical speed level
107
+ * percentage (using the 6-speed lookup table when speedMax=6, or dynamic calculation).
108
+ *
109
+ * Examples:
110
+ * 32 → 33.33 (level 2)
111
+ * 88 → 83.33 (level 5)
112
+ * 100 → 100 (level 6)
113
+ * 0 → 0 (off, returned as-is)
114
+ */
115
+ export function normaliseToPhysicalSpeed(pct, speedMax = FAN_SPEED_MAX) {
116
+ if (pct <= 0)
117
+ return 0;
118
+ if (pct >= 100)
119
+ return 100;
120
+ if (speedMax === 6) {
121
+ for (const level of FAN_SPEED_LEVELS) {
122
+ if (pct >= level.threshold_lo && pct <= level.threshold_hi) {
123
+ return level.pct;
124
+ }
125
+ }
126
+ }
127
+ const step = 100 / speedMax;
128
+ const level = Math.round(pct / step);
129
+ return Number((Math.max(1, Math.min(speedMax, level)) * step).toFixed(2));
130
+ }
131
+ /**
132
+ * Given a requested percentage (0-100), snap it to the nearest physical level
133
+ * percentage. Returns 0 when pct === 0 (represents off/minimum in some UIs).
134
+ */
135
+ export function snapToPhysicalLevel(pct, speedMax = FAN_SPEED_MAX) {
136
+ if (pct <= 0)
137
+ return 0;
138
+ if (pct >= 100)
139
+ return 100;
140
+ if (speedMax === 6) {
141
+ let closest = FAN_SPEED_LEVELS[0];
142
+ let minDelta = Math.abs(pct - closest.pct);
143
+ for (const level of FAN_SPEED_LEVELS) {
144
+ const delta = Math.abs(pct - level.pct);
145
+ if (delta < minDelta) {
146
+ minDelta = delta;
147
+ closest = level;
148
+ }
149
+ }
150
+ return closest.pct;
151
+ }
152
+ const step = 100 / speedMax;
153
+ const level = Math.round(pct / step);
154
+ return Number((Math.max(1, Math.min(speedMax, level)) * step).toFixed(2));
155
+ }
156
+ /**
157
+ * Return true if the requested percentage is within the hysteresis band of the
158
+ * current percentage, meaning we should skip re-sending the command to HA.
159
+ */
160
+ export function withinHysteresis(requestedPct, currentPct) {
161
+ return Math.abs(requestedPct - currentPct) < SPEED_HYSTERESIS_PCT;
162
+ }
163
+ /**
164
+ * Map a HA direction string to a Matter AirflowDirection value.
165
+ *
166
+ * HA reports `forward` or `reverse`; anything else defaults to Forward.
167
+ * NEVER use `last_direction` as the current direction.
168
+ */
169
+ export function haDirectionToMatter(direction) {
170
+ if (direction === "reverse")
171
+ return FanControl.AirflowDirection.Reverse;
172
+ return FanControl.AirflowDirection.Forward;
173
+ }
174
+ /**
175
+ * Map a Matter AirflowDirection to the HA direction string.
176
+ */
177
+ export function matterDirectionToHa(direction) {
178
+ return direction === FanControl.AirflowDirection.Reverse
179
+ ? "reverse"
180
+ : "forward";
181
+ }
182
+ /**
183
+ * Resolve the current direction from HA state.
184
+ * Only uses `attributes.direction`, NEVER `last_direction`.
185
+ */
186
+ export function fanDirection(state) {
187
+ const dir = state.attributes.direction;
188
+ return typeof dir === "string" ? dir : undefined;
189
+ }
190
+ /**
191
+ * Check if the Home Assistant fan entity exposes direction control capability.
192
+ * Uses FanEntityFeature.DIRECTION (4) as the authoritative capability flag.
193
+ */
194
+ export function hasFanDirection(state) {
195
+ const supported = state.attributes.supported_features;
196
+ if (typeof supported === "number") {
197
+ return (supported & FanEntityFeature.DIRECTION) !== 0;
198
+ }
199
+ return false;
200
+ }
201
+ /**
202
+ * Check if the Home Assistant fan entity exposes a true Auto capability/preset.
203
+ * Sleep/breeze presets are NOT equivalent to Matter Auto.
204
+ */
205
+ export function hasFanAuto(state) {
206
+ const supported = state.attributes.supported_features;
207
+ if (typeof supported === "number" &&
208
+ !(supported & FanEntityFeature.PRESET_MODE)) {
209
+ return false;
210
+ }
211
+ const presets = state.attributes.preset_modes;
212
+ if (Array.isArray(presets)) {
213
+ return presets.some((mode) => typeof mode === "string" && mode.toLowerCase().trim() === "auto");
214
+ }
215
+ return false;
216
+ }
217
+ /**
218
+ * Select the conformant FanModeSequence according to the exact enabled features.
219
+ * When Auto is enabled, OffLowMedHighAuto is required.
220
+ */
221
+ export function getFanModeSequence(_state) {
222
+ return FanControl.FanModeSequence.OffLowMedHighAuto;
223
+ }
224
+ /**
225
+ * Resolve dynamic Matter FanControl features supported by the fan.
226
+ * Includes MultiSpeed, Auto and Step for full Apple Home manual/auto and slider support.
227
+ * AirflowDirection (DIR) is included when HA fan supports direction (bit 4).
228
+ */
229
+ export function getFanControlFeatures(state) {
230
+ const features = [
231
+ FanControl.Feature.MultiSpeed,
232
+ FanControl.Feature.Auto,
233
+ FanControl.Feature.Step,
234
+ ];
235
+ if (hasFanDirection(state)) {
236
+ features.push(FanControl.Feature.AirflowDirection);
237
+ }
238
+ return features;
239
+ }
240
+ /**
241
+ * Determine the appropriate Matter FanMode from HA fan state.
242
+ *
243
+ * - Off when state is off.
244
+ * - On (speed-based) when on and percentage is non-zero.
245
+ * - On (mode 4 = "On") as fallback for on without percentage.
246
+ *
247
+ * Auto mode requires HA to expose a real auto capability; we do NOT invent it.
248
+ */
249
+ export function haStateToFanMode(state) {
250
+ if (!isFanOn(state))
251
+ return FanControl.FanMode.Off;
252
+ const pct = fanPercentage(state);
253
+ if (pct <= 0)
254
+ return FanControl.FanMode.On; // on, no discrete level known
255
+ // Map to Low/Medium/High where possible
256
+ const normalised = normaliseToPhysicalSpeed(pct);
257
+ if (normalised <= 33.34)
258
+ return FanControl.FanMode.Low;
259
+ if (normalised <= 66.68)
260
+ return FanControl.FanMode.Medium;
261
+ return FanControl.FanMode.High;
262
+ }
263
+ /** Default sequence for fans without Auto. */
264
+ export const FAN_MODE_SEQUENCE = FanControl.FanModeSequence.OffLowMedHigh;
265
+ // ── Support for presets ───────────────────────────────────────────────────────
266
+ /**
267
+ * Supported HA preset modes for the bedroom fan.
268
+ * Matter 1.6 / FanControl has `WindSetting` (sleepWind, naturalWind) which maps to
269
+ * `sleep` and `breeze` respectively.
270
+ *
271
+ * Presets are tracked only in HA; we do NOT advertise them as Auto.
272
+ */
273
+ export const FAN_PRESET_TO_WIND = {
274
+ sleep: "sleepWind",
275
+ breeze: "naturalWind",
276
+ };
277
+ /**
278
+ * Determine if HA fan exposes speed/percentage control (bit 0 = SET_SPEED in supported_features).
279
+ * Returns true if supported_features has SET_SPEED (1) or if percentage is present.
280
+ */
281
+ export function hasFanSpeed(state) {
282
+ if (typeof state.attributes.supported_features === "number") {
283
+ return (state.attributes.supported_features & 1) !== 0;
284
+ }
285
+ return (typeof state.attributes.percentage === "number" ||
286
+ Array.isArray(state.attributes.speed_list));
287
+ }
288
+ /**
289
+ * Return the physical speed level (1..speedMax) or 0 (Off) based on the percentage.
290
+ */
291
+ export function fanSpeed(pct, speedMax = FAN_SPEED_MAX) {
292
+ if (pct <= 0)
293
+ return 0;
294
+ if (pct >= 100)
295
+ return speedMax;
296
+ if (speedMax === 6) {
297
+ for (const level of FAN_SPEED_LEVELS) {
298
+ if (pct >= level.threshold_lo && pct <= level.threshold_hi) {
299
+ return level.speed;
300
+ }
301
+ }
302
+ }
303
+ const speed = Math.round((pct / 100) * speedMax);
304
+ return Math.max(1, Math.min(speedMax, speed));
305
+ }
306
+ export const fanConverter = {
307
+ /**
308
+ * Convert HA fan state percentage to a Matter percentage (0-100).
309
+ * DOES NOT use last_percentage or percentage>0 as on indicator.
310
+ */
311
+ toPercentage(state) {
312
+ return fanPercentage(state);
313
+ },
314
+ /**
315
+ * Map Matter speed percentage back to the nearest physical HA percentage.
316
+ */
317
+ toHaPercentage(percent, speedMax = FAN_SPEED_MAX) {
318
+ return snapToPhysicalLevel(percent, speedMax);
319
+ },
320
+ /** True only when state/is_on says on. */
321
+ isOn: isFanOn,
322
+ /** Snap arbitrary percent to closest speed level. */
323
+ snapToPhysicalLevel,
324
+ /** Normalise raw HA percent to nearest level name. */
325
+ normaliseToPhysicalSpeed,
326
+ /** Hysteresis check. */
327
+ withinHysteresis,
328
+ /** HA direction → Matter AirflowDirection. */
329
+ haDirectionToMatter,
330
+ /** Matter AirflowDirection → HA direction string. */
331
+ matterDirectionToHa,
332
+ /** Current direction from state (not last_direction). */
333
+ fanDirection,
334
+ /** Determine if HA fan exposes speed control. */
335
+ hasFanSpeed,
336
+ /** Determine if HA fan exposes direction control (bit 4 in supported_features). */
337
+ hasFanDirection,
338
+ /** Determine if HA fan exposes Auto preset. */
339
+ hasFanAuto,
340
+ /** Dynamic speed count. */
341
+ getFanSpeedCount,
342
+ /** Dynamic FanModeSequence. */
343
+ getFanModeSequence,
344
+ /** Dynamic FanControl features. */
345
+ getFanControlFeatures,
346
+ /** Return the physical speed level (1..speedMax) or 0 (Off) based on the percentage. */
347
+ fanSpeed,
348
+ /** Derive FanMode from HA state. */
349
+ haStateToFanMode,
350
+ /** HA Fan Entity Feature Constants */
351
+ FanEntityFeature,
352
+ };
353
+ //# sourceMappingURL=fan.converter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fan.converter.js","sourceRoot":"","sources":["../../src/converters/fan.converter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Barrel export for converters.
3
+ */
4
+ export * from "./light.converter.js";
5
+ export * from "./cover.converter.js";
6
+ export * from "./climate.converter.js";
7
+ export * from "./sensor.converter.js";
8
+ export * from "./binary_sensor.converter.js";
9
+ export * from "./lock.converter.js";
10
+ export * from "./fan.converter.js";
11
+ export * from "./camera.converter.js";
12
+ export * from "./soil_sensor.converter.js";
13
+ export * from "./energy_tariff.converter.js";
14
+ export * from "./vacuum.converter.js";
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Barrel export for converters.
3
+ */
4
+ export * from "./light.converter.js";
5
+ export * from "./cover.converter.js";
6
+ export * from "./climate.converter.js";
7
+ export * from "./sensor.converter.js";
8
+ export * from "./binary_sensor.converter.js";
9
+ export * from "./lock.converter.js";
10
+ export * from "./fan.converter.js";
11
+ export * from "./camera.converter.js";
12
+ export * from "./soil_sensor.converter.js";
13
+ export * from "./energy_tariff.converter.js";
14
+ export * from "./vacuum.converter.js";
15
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/converters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Converter utility for light and switch domains.
3
+ * Home Assistant is the authoritative state source for Matter All-in-One Creator.
4
+ */
5
+ import { HassState } from "../utils/ha-state.js";
6
+ export declare const lightConverter: {
7
+ /**
8
+ * Map HA state to OnOff boolean.
9
+ * State and is_on are the sole authority for OnOff; brightness is never used to infer power.
10
+ */
11
+ toOnOff(state: HassState): boolean;
12
+ /**
13
+ * Map HA brightness (1..255, with defensive fallback for 0) to Matter currentLevel (1..254).
14
+ *
15
+ * Modern Home Assistant specifies brightness in the range 1..255 (or null when off).
16
+ * Matter LevelControl cluster specifies CurrentLevel in the range 1..254.
17
+ *
18
+ * If an uncompliant integration reports brightness 0, it is defensively clamped to 1
19
+ * without affecting the OnOff state.
20
+ */
21
+ toLevel(state: HassState | number): number;
22
+ /**
23
+ * Map Matter currentLevel (1..254) back to HA brightness (1..255).
24
+ */
25
+ toHaBrightness(level: number): number;
26
+ };