mqtt2matter 0.0.0-stage → 0.2.0

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 (279) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +23 -0
  4. package/README.md +172 -2
  5. package/dist/app.d.ts +34 -0
  6. package/dist/app.js +157 -0
  7. package/dist/app.js.map +1 -0
  8. package/dist/commands/import-z2m.d.ts +20 -0
  9. package/dist/commands/import-z2m.js +173 -0
  10. package/dist/commands/import-z2m.js.map +1 -0
  11. package/dist/commands/install.d.ts +41 -0
  12. package/dist/commands/install.js +250 -0
  13. package/dist/commands/install.js.map +1 -0
  14. package/dist/commands/update.d.ts +14 -0
  15. package/dist/commands/update.js +109 -0
  16. package/dist/commands/update.js.map +1 -0
  17. package/dist/config/index.d.ts +2 -0
  18. package/dist/config/index.js +3 -0
  19. package/dist/config/index.js.map +1 -0
  20. package/dist/config/load.d.ts +57 -0
  21. package/dist/config/load.js +137 -0
  22. package/dist/config/load.js.map +1 -0
  23. package/dist/config/schema.d.ts +496 -0
  24. package/dist/config/schema.js +115 -0
  25. package/dist/config/schema.js.map +1 -0
  26. package/dist/engine/payload.d.ts +94 -0
  27. package/dist/engine/payload.js +515 -0
  28. package/dist/engine/payload.js.map +1 -0
  29. package/dist/engine/runtime.d.ts +79 -0
  30. package/dist/engine/runtime.js +438 -0
  31. package/dist/engine/runtime.js.map +1 -0
  32. package/dist/engine/template.d.ts +20 -0
  33. package/dist/engine/template.js +264 -0
  34. package/dist/engine/template.js.map +1 -0
  35. package/dist/engine/units.d.ts +9 -0
  36. package/dist/engine/units.js +42 -0
  37. package/dist/engine/units.js.map +1 -0
  38. package/dist/families/climate.d.ts +11 -0
  39. package/dist/families/climate.js +68 -0
  40. package/dist/families/climate.js.map +1 -0
  41. package/dist/families/color.d.ts +30 -0
  42. package/dist/families/color.js +152 -0
  43. package/dist/families/color.js.map +1 -0
  44. package/dist/families/cover.d.ts +17 -0
  45. package/dist/families/cover.js +308 -0
  46. package/dist/families/cover.js.map +1 -0
  47. package/dist/families/fan.d.ts +16 -0
  48. package/dist/families/fan.js +154 -0
  49. package/dist/families/fan.js.map +1 -0
  50. package/dist/families/index.d.ts +32 -0
  51. package/dist/families/index.js +162 -0
  52. package/dist/families/index.js.map +1 -0
  53. package/dist/families/light.d.ts +36 -0
  54. package/dist/families/light.js +258 -0
  55. package/dist/families/light.js.map +1 -0
  56. package/dist/families/lock.d.ts +10 -0
  57. package/dist/families/lock.js +31 -0
  58. package/dist/families/lock.js.map +1 -0
  59. package/dist/families/on-off.d.ts +7 -0
  60. package/dist/families/on-off.js +56 -0
  61. package/dist/families/on-off.js.map +1 -0
  62. package/dist/families/power-source.d.ts +12 -0
  63. package/dist/families/power-source.js +60 -0
  64. package/dist/families/power-source.js.map +1 -0
  65. package/dist/families/registry.d.ts +40 -0
  66. package/dist/families/registry.js +72 -0
  67. package/dist/families/registry.js.map +1 -0
  68. package/dist/families/rvc.d.ts +40 -0
  69. package/dist/families/rvc.js +83 -0
  70. package/dist/families/rvc.js.map +1 -0
  71. package/dist/families/switch.d.ts +19 -0
  72. package/dist/families/switch.js +94 -0
  73. package/dist/families/switch.js.map +1 -0
  74. package/dist/importers/actions.d.ts +19 -0
  75. package/dist/importers/actions.js +98 -0
  76. package/dist/importers/actions.js.map +1 -0
  77. package/dist/importers/ha/areas.d.ts +6 -0
  78. package/dist/importers/ha/areas.js +279 -0
  79. package/dist/importers/ha/areas.js.map +1 -0
  80. package/dist/importers/ha/generate.d.ts +51 -0
  81. package/dist/importers/ha/generate.js +1376 -0
  82. package/dist/importers/ha/generate.js.map +1 -0
  83. package/dist/importers/ha/index.d.ts +6 -0
  84. package/dist/importers/ha/index.js +7 -0
  85. package/dist/importers/ha/index.js.map +1 -0
  86. package/dist/importers/ha/source.d.ts +36 -0
  87. package/dist/importers/ha/source.js +95 -0
  88. package/dist/importers/ha/source.js.map +1 -0
  89. package/dist/importers/ha/sync.d.ts +29 -0
  90. package/dist/importers/ha/sync.js +132 -0
  91. package/dist/importers/ha/sync.js.map +1 -0
  92. package/dist/importers/ha/templates.d.ts +18 -0
  93. package/dist/importers/ha/templates.js +285 -0
  94. package/dist/importers/ha/templates.js.map +1 -0
  95. package/dist/importers/ha/types.d.ts +78 -0
  96. package/dist/importers/ha/types.js +479 -0
  97. package/dist/importers/ha/types.js.map +1 -0
  98. package/dist/importers/index.d.ts +5 -0
  99. package/dist/importers/index.js +8 -0
  100. package/dist/importers/index.js.map +1 -0
  101. package/dist/importers/patch.d.ts +50 -0
  102. package/dist/importers/patch.js +224 -0
  103. package/dist/importers/patch.js.map +1 -0
  104. package/dist/importers/sync.d.ts +112 -0
  105. package/dist/importers/sync.js +220 -0
  106. package/dist/importers/sync.js.map +1 -0
  107. package/dist/importers/twins.d.ts +10 -0
  108. package/dist/importers/twins.js +34 -0
  109. package/dist/importers/twins.js.map +1 -0
  110. package/dist/importers/z2m/generate.d.ts +81 -0
  111. package/dist/importers/z2m/generate.js +1171 -0
  112. package/dist/importers/z2m/generate.js.map +1 -0
  113. package/dist/importers/z2m/index.d.ts +5 -0
  114. package/dist/importers/z2m/index.js +6 -0
  115. package/dist/importers/z2m/index.js.map +1 -0
  116. package/dist/importers/z2m/source.d.ts +18 -0
  117. package/dist/importers/z2m/source.js +46 -0
  118. package/dist/importers/z2m/source.js.map +1 -0
  119. package/dist/importers/z2m/sync.d.ts +29 -0
  120. package/dist/importers/z2m/sync.js +92 -0
  121. package/dist/importers/z2m/sync.js.map +1 -0
  122. package/dist/importers/z2m/types.d.ts +72 -0
  123. package/dist/importers/z2m/types.js +46 -0
  124. package/dist/importers/z2m/types.js.map +1 -0
  125. package/dist/index.d.ts +5 -0
  126. package/dist/index.js +7 -0
  127. package/dist/index.js.map +1 -0
  128. package/dist/log.d.ts +17 -0
  129. package/dist/log.js +54 -0
  130. package/dist/log.js.map +1 -0
  131. package/dist/main.d.ts +2 -0
  132. package/dist/main.js +202 -0
  133. package/dist/main.js.map +1 -0
  134. package/dist/matter/bridge.d.ts +113 -0
  135. package/dist/matter/bridge.js +467 -0
  136. package/dist/matter/bridge.js.map +1 -0
  137. package/dist/matter/check.d.ts +11 -0
  138. package/dist/matter/check.js +116 -0
  139. package/dist/matter/check.js.map +1 -0
  140. package/dist/matter/cluster-defaults.d.ts +6 -0
  141. package/dist/matter/cluster-defaults.js +63 -0
  142. package/dist/matter/cluster-defaults.js.map +1 -0
  143. package/dist/matter/commissioning.d.ts +21 -0
  144. package/dist/matter/commissioning.js +88 -0
  145. package/dist/matter/commissioning.js.map +1 -0
  146. package/dist/matter/device-types.d.ts +44 -0
  147. package/dist/matter/device-types.js +230 -0
  148. package/dist/matter/device-types.js.map +1 -0
  149. package/dist/matter/ids.d.ts +31 -0
  150. package/dist/matter/ids.js +83 -0
  151. package/dist/matter/ids.js.map +1 -0
  152. package/dist/matter/index.d.ts +7 -0
  153. package/dist/matter/index.js +8 -0
  154. package/dist/matter/index.js.map +1 -0
  155. package/dist/matter/node-manager.d.ts +39 -0
  156. package/dist/matter/node-manager.js +161 -0
  157. package/dist/matter/node-manager.js.map +1 -0
  158. package/dist/matter/shards.d.ts +26 -0
  159. package/dist/matter/shards.js +93 -0
  160. package/dist/matter/shards.js.map +1 -0
  161. package/dist/model/attribute.d.ts +18 -0
  162. package/dist/model/attribute.js +28 -0
  163. package/dist/model/attribute.js.map +1 -0
  164. package/dist/model/catalog.d.ts +79 -0
  165. package/dist/model/catalog.js +223 -0
  166. package/dist/model/catalog.js.map +1 -0
  167. package/dist/model/index.d.ts +7 -0
  168. package/dist/model/index.js +8 -0
  169. package/dist/model/index.js.map +1 -0
  170. package/dist/model/migrate.d.ts +4 -0
  171. package/dist/model/migrate.js +39 -0
  172. package/dist/model/migrate.js.map +1 -0
  173. package/dist/model/options.d.ts +102 -0
  174. package/dist/model/options.js +88 -0
  175. package/dist/model/options.js.map +1 -0
  176. package/dist/model/presets.d.ts +37 -0
  177. package/dist/model/presets.js +105 -0
  178. package/dist/model/presets.js.map +1 -0
  179. package/dist/model/schema.d.ts +1747 -0
  180. package/dist/model/schema.js +243 -0
  181. package/dist/model/schema.js.map +1 -0
  182. package/dist/model/validate.d.ts +21 -0
  183. package/dist/model/validate.js +484 -0
  184. package/dist/model/validate.js.map +1 -0
  185. package/dist/mqtt/client.d.ts +38 -0
  186. package/dist/mqtt/client.js +94 -0
  187. package/dist/mqtt/client.js.map +1 -0
  188. package/dist/mqtt/index.d.ts +2 -0
  189. package/dist/mqtt/index.js +3 -0
  190. package/dist/mqtt/index.js.map +1 -0
  191. package/dist/mqtt/topic-cache.d.ts +20 -0
  192. package/dist/mqtt/topic-cache.js +58 -0
  193. package/dist/mqtt/topic-cache.js.map +1 -0
  194. package/dist/server/auth.d.ts +59 -0
  195. package/dist/server/auth.js +185 -0
  196. package/dist/server/auth.js.map +1 -0
  197. package/dist/server/catalog.d.ts +52 -0
  198. package/dist/server/catalog.js +96 -0
  199. package/dist/server/catalog.js.map +1 -0
  200. package/dist/server/compact.d.ts +3 -0
  201. package/dist/server/compact.js +105 -0
  202. package/dist/server/compact.js.map +1 -0
  203. package/dist/server/config-store.d.ts +36 -0
  204. package/dist/server/config-store.js +155 -0
  205. package/dist/server/config-store.js.map +1 -0
  206. package/dist/server/events.d.ts +50 -0
  207. package/dist/server/events.js +71 -0
  208. package/dist/server/events.js.map +1 -0
  209. package/dist/server/http.d.ts +27 -0
  210. package/dist/server/http.js +168 -0
  211. package/dist/server/http.js.map +1 -0
  212. package/dist/server/importers.d.ts +40 -0
  213. package/dist/server/importers.js +75 -0
  214. package/dist/server/importers.js.map +1 -0
  215. package/dist/server/index.d.ts +6 -0
  216. package/dist/server/index.js +8 -0
  217. package/dist/server/index.js.map +1 -0
  218. package/dist/server/log-buffer.d.ts +22 -0
  219. package/dist/server/log-buffer.js +55 -0
  220. package/dist/server/log-buffer.js.map +1 -0
  221. package/dist/server/presets.d.ts +17 -0
  222. package/dist/server/presets.js +55 -0
  223. package/dist/server/presets.js.map +1 -0
  224. package/dist/server/preview.d.ts +19 -0
  225. package/dist/server/preview.js +121 -0
  226. package/dist/server/preview.js.map +1 -0
  227. package/dist/server/server.d.ts +107 -0
  228. package/dist/server/server.js +810 -0
  229. package/dist/server/server.js.map +1 -0
  230. package/dist/server/update.d.ts +60 -0
  231. package/dist/server/update.js +191 -0
  232. package/dist/server/update.js.map +1 -0
  233. package/docs/api.md +128 -0
  234. package/docs/architecture.md +121 -0
  235. package/docs/config.md +538 -0
  236. package/docs/importers.md +241 -0
  237. package/example/mqtt2matter.json +276 -0
  238. package/package.json +90 -4
  239. package/presets/mqtt-smarthome/button.json +47 -0
  240. package/presets/mqtt-smarthome/contact.json +37 -0
  241. package/presets/mqtt-smarthome/cover.json +50 -0
  242. package/presets/mqtt-smarthome/dimmer.json +57 -0
  243. package/presets/mqtt-smarthome/humidity.json +38 -0
  244. package/presets/mqtt-smarthome/light.json +47 -0
  245. package/presets/mqtt-smarthome/occupancy.json +46 -0
  246. package/presets/mqtt-smarthome/switch.json +47 -0
  247. package/presets/mqtt-smarthome/temperature.json +38 -0
  248. package/presets/openbeken/color-light.json +64 -0
  249. package/presets/openbeken/ct-light.json +51 -0
  250. package/presets/openbeken/dimmer.json +47 -0
  251. package/presets/openbeken/humidity.json +37 -0
  252. package/presets/openbeken/relay.json +40 -0
  253. package/presets/openbeken/temperature.json +41 -0
  254. package/presets/shelly-gen1/dimmer.json +48 -0
  255. package/presets/shelly-gen1/door-window.json +43 -0
  256. package/presets/shelly-gen1/ht.json +43 -0
  257. package/presets/shelly-gen1/relay-pm.json +60 -0
  258. package/presets/shelly-gen1/relay.json +36 -0
  259. package/presets/shelly-gen1/roller.json +52 -0
  260. package/presets/shelly-gen2/cover.json +68 -0
  261. package/presets/shelly-gen2/dimmer.json +61 -0
  262. package/presets/shelly-gen2/ht.json +47 -0
  263. package/presets/shelly-gen2/i4.json +82 -0
  264. package/presets/shelly-gen2/switch-pm.json +101 -0
  265. package/presets/shelly-gen2/switch.json +47 -0
  266. package/presets/tasmota/climate.json +52 -0
  267. package/presets/tasmota/color-light.json +63 -0
  268. package/presets/tasmota/ct-light.json +50 -0
  269. package/presets/tasmota/dimmer.json +45 -0
  270. package/presets/tasmota/relay.json +39 -0
  271. package/presets/tasmota/shutter.json +46 -0
  272. package/presets/tasmota/temperature-humidity.json +42 -0
  273. package/presets/tasmota/temperature.json +32 -0
  274. package/presets/valetudo/vacuum.json +103 -0
  275. package/presets/wled/dimmer.json +46 -0
  276. package/presets/wled/light.json +59 -0
  277. package/ui/dist/assets/index-BDtT6bdH.js +10 -0
  278. package/ui/dist/assets/index-CHiG-aoU.css +1 -0
  279. package/ui/dist/index.html +18 -0
@@ -0,0 +1,308 @@
1
+ /* The cover family: WindowCovering with the movement logic of the maintainer's matterbridge-zigbee2mqtt
2
+ PR #170 as options. Commands set the target and publish it (or the up/down/stop command mappings); the
3
+ device's position reports drive the current position; `operationalStatus` follows from target vs
4
+ current; a report timeout ends a movement nobody reported the end of; an external move (a report while
5
+ no command is in flight) writes a predicted target — the direction's extreme — before the current
6
+ position, so controllers deriving the direction from target/current show it; the echo filter holds back
7
+ a first report after a command that merely repeats the old position until a second report or the
8
+ timeout. State-only covers and `moving`/`motor_state` reports bind the composite `motion`. Tilt runs
9
+ the same machine on its own attributes. */
10
+ import { MovementDirection, MovementType, WindowCoveringServer as BaseWindowCoveringServer, } from '@matter/main/behaviors/window-covering';
11
+ import { WindowCovering } from '@matter/main/clusters/window-covering';
12
+ import { contextOf, hasCommand, hasFeature, route, scratch } from "./registry.js";
13
+ const { MovementStatus } = WindowCovering;
14
+ export const LIFT_TARGET_KEY = 'WindowCovering.targetPositionLiftPercent100ths';
15
+ export const TILT_TARGET_KEY = 'WindowCovering.targetPositionTiltPercent100ths';
16
+ export const UP_KEY = 'WindowCovering.upOrOpen';
17
+ export const DOWN_KEY = 'WindowCovering.downOrClose';
18
+ export const STOP_KEY = 'WindowCovering.stopMotion';
19
+ export const MOTION_KEY = 'WindowCovering.motion';
20
+ const OPEN = 0;
21
+ const CLOSED = 10000;
22
+ const LIFT = {
23
+ name: 'lift',
24
+ current: 'currentPositionLiftPercent100ths',
25
+ target: 'targetPositionLiftPercent100ths',
26
+ targetKey: LIFT_TARGET_KEY,
27
+ positionAware: 'PositionAwareLift',
28
+ };
29
+ const TILT = {
30
+ name: 'tilt',
31
+ current: 'currentPositionTiltPercent100ths',
32
+ target: 'targetPositionTiltPercent100ths',
33
+ targetKey: TILT_TARGET_KEY,
34
+ positionAware: 'PositionAwareTilt',
35
+ };
36
+ function axisState(context, axis) {
37
+ return scratch(context, `cover.${axis.name}`, () => ({
38
+ inFlight: false,
39
+ awaitingFirstReport: true,
40
+ held: undefined,
41
+ external: false,
42
+ timer: undefined,
43
+ viaUpDown: false,
44
+ stopping: false,
45
+ }));
46
+ }
47
+ function clearTimer(state) {
48
+ if (state.timer !== undefined) {
49
+ clearTimeout(state.timer);
50
+ state.timer = undefined;
51
+ }
52
+ }
53
+ function armTimeout(context, axis, state, onExpiry) {
54
+ clearTimer(state);
55
+ state.timer = setTimeout(() => {
56
+ state.timer = undefined;
57
+ onExpiry().catch((error) => {
58
+ context.log.error(`cover ${axis.name}: report timeout handling failed`, error);
59
+ });
60
+ }, context.options.cover.reportTimeout * 1000);
61
+ state.timer.unref();
62
+ }
63
+ function wcState(context) {
64
+ return context.endpoint.state.windowCovering;
65
+ }
66
+ async function setWc(context, patch) {
67
+ await context.endpoint.set({ windowCovering: patch });
68
+ }
69
+ async function stopAxis(context, axis, state, snapTargetTo) {
70
+ clearTimer(state);
71
+ state.inFlight = false;
72
+ state.external = false;
73
+ state.stopping = false;
74
+ state.held = undefined;
75
+ const current = wcState(context);
76
+ const patch = {
77
+ operationalStatus: { ...current.operationalStatus, [axis.name]: MovementStatus.Stopped },
78
+ };
79
+ if (hasFeature(context, 'WindowCovering', axis.positionAware)) {
80
+ const position = snapTargetTo ?? current[axis.current];
81
+ if (position !== null) {
82
+ patch[axis.target] = position;
83
+ if (snapTargetTo !== undefined) {
84
+ patch[axis.current] = position;
85
+ }
86
+ }
87
+ }
88
+ await setWc(context, patch);
89
+ }
90
+ /** a device's position report on an axis */
91
+ async function reportPosition(context, axis, value) {
92
+ const state = axisState(context, axis);
93
+ const { tolerance, echoFilter } = context.options.cover;
94
+ const wc = wcState(context);
95
+ const previous = wc[axis.current];
96
+ const target = wc[axis.target];
97
+ if (state.stopping) {
98
+ // the report after a stop is where the cover came to rest
99
+ await stopAxis(context, axis, state, value);
100
+ return;
101
+ }
102
+ if (state.inFlight) {
103
+ if (state.awaitingFirstReport && echoFilter && previous !== null && value === previous && target !== value) {
104
+ // the FYRTUR echo: the old position repeated right after the command; wait for a second opinion
105
+ state.held = value;
106
+ state.awaitingFirstReport = false;
107
+ armTimeout(context, axis, state, async () => {
108
+ await stopAxis(context, axis, state, value);
109
+ });
110
+ return;
111
+ }
112
+ state.awaitingFirstReport = false;
113
+ state.held = undefined;
114
+ if (target !== null && Math.abs(value - target) <= tolerance) {
115
+ await stopAxis(context, axis, state, value);
116
+ return;
117
+ }
118
+ await setWc(context, { [axis.current]: value });
119
+ armTimeout(context, axis, state, async () => {
120
+ await stopAxis(context, axis, state);
121
+ });
122
+ return;
123
+ }
124
+ if (previous === null) {
125
+ await setWc(context, { [axis.target]: value, [axis.current]: value });
126
+ return;
127
+ }
128
+ if (value === previous) {
129
+ if (state.external) {
130
+ await stopAxis(context, axis, state, value);
131
+ }
132
+ return;
133
+ }
134
+ // an external move: somebody else moves the cover; predict the target from the direction
135
+ const predicted = value > previous ? CLOSED : OPEN;
136
+ if (!state.external || target !== predicted) {
137
+ await setWc(context, { [axis.target]: predicted });
138
+ }
139
+ state.external = true;
140
+ if (Math.abs(value - predicted) <= tolerance) {
141
+ await stopAxis(context, axis, state, value);
142
+ return;
143
+ }
144
+ await setWc(context, { [axis.current]: value });
145
+ armTimeout(context, axis, state, async () => {
146
+ await stopAxis(context, axis, state);
147
+ });
148
+ }
149
+ /** the `motion` composite: opening / closing / stopped / open / closed */
150
+ async function reportMotion(context, value) {
151
+ const text = (typeof value === 'string' ? value : JSON.stringify(value)).toLowerCase();
152
+ const wc = wcState(context);
153
+ const liftState = axisState(context, LIFT);
154
+ const positionAware = hasFeature(context, 'WindowCovering', LIFT.positionAware);
155
+ switch (text) {
156
+ case 'opening':
157
+ case 'closing': {
158
+ const status = text === 'opening' ? MovementStatus.Opening : MovementStatus.Closing;
159
+ const patch = {
160
+ operationalStatus: { ...wc.operationalStatus, lift: status },
161
+ };
162
+ if (positionAware && !liftState.inFlight) {
163
+ patch[LIFT.target] = text === 'opening' ? OPEN : CLOSED;
164
+ liftState.external = true;
165
+ }
166
+ await setWc(context, patch);
167
+ armTimeout(context, LIFT, liftState, async () => {
168
+ await stopAxis(context, LIFT, liftState);
169
+ });
170
+ return;
171
+ }
172
+ case 'stopped':
173
+ case 'stop':
174
+ case 'idle':
175
+ await stopAxis(context, LIFT, liftState);
176
+ return;
177
+ case 'open':
178
+ await stopAxis(context, LIFT, liftState, positionAware ? OPEN : undefined);
179
+ return;
180
+ case 'closed':
181
+ case 'close':
182
+ await stopAxis(context, LIFT, liftState, positionAware ? CLOSED : undefined);
183
+ return;
184
+ default:
185
+ throw new Error(`motion: "${text}" is not opening, closing, stopped, open or closed`);
186
+ }
187
+ }
188
+ /** the status side of WindowCovering; true = handled by the family */
189
+ export async function coverStatus(context, attribute, value) {
190
+ if (context === undefined) {
191
+ return false;
192
+ }
193
+ if (attribute === 'motion') {
194
+ await reportMotion(context, value);
195
+ return true;
196
+ }
197
+ if (attribute === LIFT.current && typeof value === 'number') {
198
+ await reportPosition(context, LIFT, value);
199
+ return true;
200
+ }
201
+ if (attribute === TILT.current && typeof value === 'number') {
202
+ await reportPosition(context, TILT, value);
203
+ return true;
204
+ }
205
+ return false;
206
+ }
207
+ function positionFields(target) {
208
+ return {
209
+ position: Math.round(target / 100),
210
+ percent: Math.round(target / 100),
211
+ /** the inverted scale many devices use: 100 = open */
212
+ open: 100 - Math.round(target / 100),
213
+ percent100ths: target,
214
+ };
215
+ }
216
+ export class WindowCoveringServer extends BaseWindowCoveringServer {
217
+ async upOrOpen() {
218
+ const context = contextOf(this.endpoint);
219
+ if (context !== undefined) {
220
+ axisState(context, LIFT).viaUpDown = true;
221
+ axisState(context, TILT).viaUpDown = true;
222
+ }
223
+ await super.upOrOpen();
224
+ }
225
+ async downOrClose() {
226
+ const context = contextOf(this.endpoint);
227
+ if (context !== undefined) {
228
+ axisState(context, LIFT).viaUpDown = true;
229
+ axisState(context, TILT).viaUpDown = true;
230
+ }
231
+ await super.downOrClose();
232
+ }
233
+ async handleMovement(type, reversed, direction, targetPercent100ths) {
234
+ const context = contextOf(this.endpoint);
235
+ const axis = type === MovementType.Lift ? LIFT : TILT;
236
+ if (context === undefined) {
237
+ await super.handleMovement(type, reversed, direction, targetPercent100ths);
238
+ return;
239
+ }
240
+ const state = axisState(context, axis);
241
+ const viaUpDown = state.viaUpDown;
242
+ state.viaUpDown = false;
243
+ clearTimer(state);
244
+ const positionAware = hasFeature(context, 'WindowCovering', axis.positionAware);
245
+ const directionKey = direction === MovementDirection.Close ? DOWN_KEY : UP_KEY;
246
+ let applied;
247
+ const fields = targetPercent100ths === undefined ? {} : positionFields(targetPercent100ths);
248
+ if ((viaUpDown || !positionAware || !hasCommand(context, axis.targetKey)) &&
249
+ hasCommand(context, directionKey)) {
250
+ applied = await route(this.endpoint, directionKey, direction === MovementDirection.Close ? 'close' : 'open', fields);
251
+ }
252
+ else if (targetPercent100ths !== undefined) {
253
+ applied = await route(this.endpoint, axis.targetKey, targetPercent100ths, fields);
254
+ }
255
+ else {
256
+ applied = true;
257
+ }
258
+ if (applied) {
259
+ // matter.js does not await this worker: the command's transaction is gone, so the writes go through
260
+ // the endpoint in a transaction of their own
261
+ if (positionAware && targetPercent100ths !== undefined) {
262
+ await setWc(context, { [axis.current]: targetPercent100ths });
263
+ }
264
+ else {
265
+ // nothing will report the end of the movement: it is over as far as Matter is concerned
266
+ const current = wcState(context);
267
+ await setWc(context, {
268
+ operationalStatus: { ...current.operationalStatus, [axis.name]: MovementStatus.Stopped },
269
+ });
270
+ }
271
+ return;
272
+ }
273
+ state.inFlight = true;
274
+ state.external = false;
275
+ state.awaitingFirstReport = true;
276
+ state.held = undefined;
277
+ armTimeout(context, axis, state, async () => {
278
+ context.log.info(`cover ${axis.name}: no position report within the timeout, movement counts as ended`);
279
+ await stopAxis(context, axis, state);
280
+ });
281
+ }
282
+ async handleStopMovement() {
283
+ const context = contextOf(this.endpoint);
284
+ if (context === undefined) {
285
+ await super.handleStopMovement();
286
+ return;
287
+ }
288
+ const applied = await route(this.endpoint, STOP_KEY, 'stop');
289
+ for (const axis of [LIFT, TILT]) {
290
+ const state = axisState(context, axis);
291
+ clearTimer(state);
292
+ state.inFlight = false;
293
+ state.external = false;
294
+ state.held = undefined;
295
+ if (applied || !hasFeature(context, 'WindowCovering', axis.positionAware)) {
296
+ await stopAxis(context, axis, state);
297
+ }
298
+ else {
299
+ // the device reports where it stopped; until then (or the timeout) the movement goes on
300
+ state.stopping = true;
301
+ armTimeout(context, axis, state, async () => {
302
+ await stopAxis(context, axis, state);
303
+ });
304
+ }
305
+ }
306
+ }
307
+ }
308
+ //# sourceMappingURL=cover.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cover.js","sourceRoot":"","sources":["../../src/families/cover.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { FanControlServer as BaseFanControlServer } from '@matter/main/behaviors/fan-control';
2
+ import type { Decoded } from '../engine/payload.ts';
3
+ import { type FamilyContext } from './registry.ts';
4
+ export declare const FAN_MODE_KEY = "FanControl.fanMode";
5
+ export declare const PERCENT_SETTING_KEY = "FanControl.percentSetting";
6
+ export declare const PERCENT_CURRENT_KEY = "FanControl.percentCurrent";
7
+ export declare const SPEED_SETTING_KEY = "FanControl.speedSetting";
8
+ export declare const SPEED_CURRENT_KEY = "FanControl.speedCurrent";
9
+ export declare class FanControlServer extends BaseFanControlServer {
10
+ }
11
+ export declare function percentToMode(context: FamilyContext, percent: number): number;
12
+ export declare function modeToPercent(context: FamilyContext, mode: number): number | undefined;
13
+ /** a controller wrote `fanMode` or `percentSetting` (already applied): keep the rest consistent, publish the rest */
14
+ export declare function fanWrite(context: FamilyContext, attribute: string, value: unknown): Promise<void>;
15
+ /** the device reported: a percent sets setting and current (and the mode unless bound), a mode the percent */
16
+ export declare function fanStatus(context: FamilyContext | undefined, attribute: string, value: Decoded): Promise<boolean>;
@@ -0,0 +1,154 @@
1
+ /* The fan family: FanControl. Controllers write `fanMode` and `percentSetting` (attribute writes, so they
2
+ are applied before we see them and routed by the generic write path); the family keeps the attributes
3
+ consistent — a percent write sets `percentCurrent` and derives `fanMode`, a mode write derives the
4
+ percent and publishes it when only the percent is bound — and does the same for the device's reports. */
5
+ import { FanControlServer as BaseFanControlServer } from '@matter/main/behaviors/fan-control';
6
+ import { FanControl } from '@matter/main/clusters/fan-control';
7
+ import { hasCommand, hasStatus, route } from "./registry.js";
8
+ export const FAN_MODE_KEY = 'FanControl.fanMode';
9
+ export const PERCENT_SETTING_KEY = 'FanControl.percentSetting';
10
+ export const PERCENT_CURRENT_KEY = 'FanControl.percentCurrent';
11
+ export const SPEED_SETTING_KEY = 'FanControl.speedSetting';
12
+ export const SPEED_CURRENT_KEY = 'FanControl.speedCurrent';
13
+ /** the fan modes as the numbers they are on the wire (FanControl.FanMode) */
14
+ const MODE = {
15
+ off: FanControl.FanMode.Off,
16
+ low: FanControl.FanMode.Low,
17
+ medium: FanControl.FanMode.Medium,
18
+ high: FanControl.FanMode.High,
19
+ };
20
+ export class FanControlServer extends BaseFanControlServer {
21
+ }
22
+ export function percentToMode(context, percent) {
23
+ if (percent <= 0) {
24
+ return MODE.off;
25
+ }
26
+ const { low, medium } = context.options.fan;
27
+ if (percent <= low) {
28
+ return MODE.low;
29
+ }
30
+ if (percent <= medium) {
31
+ return MODE.medium;
32
+ }
33
+ return MODE.high;
34
+ }
35
+ export function modeToPercent(context, mode) {
36
+ const { low, medium } = context.options.fan;
37
+ switch (mode) {
38
+ case MODE.off:
39
+ return 0;
40
+ case MODE.low:
41
+ return low;
42
+ case MODE.medium:
43
+ return medium;
44
+ case MODE.high:
45
+ return 100;
46
+ default:
47
+ return undefined;
48
+ }
49
+ }
50
+ function fanState(context) {
51
+ return context.endpoint.state.fanControl;
52
+ }
53
+ async function setFan(context, patch) {
54
+ await context.endpoint.set({ fanControl: patch });
55
+ }
56
+ function speedPatch(context, percent) {
57
+ const speedMax = context.options.fan.speedMax;
58
+ if (speedMax <= 0) {
59
+ return {};
60
+ }
61
+ const speed = Math.round((percent / 100) * speedMax);
62
+ return { speedSetting: speed, speedCurrent: speed };
63
+ }
64
+ /** a controller wrote `fanMode` or `percentSetting` (already applied): keep the rest consistent, publish the rest */
65
+ export async function fanWrite(context, attribute, value) {
66
+ if (attribute === 'percentSetting' && typeof value === 'number') {
67
+ const patch = { percentCurrent: value, ...speedPatch(context, value) };
68
+ if (!hasCommand(context, FAN_MODE_KEY)) {
69
+ patch.fanMode = percentToMode(context, value);
70
+ }
71
+ await setFan(context, patch);
72
+ return;
73
+ }
74
+ if (attribute === 'fanMode' && typeof value === 'number') {
75
+ const percent = modeToPercent(context, value);
76
+ if (percent === undefined) {
77
+ return;
78
+ }
79
+ const patch = {};
80
+ if (!hasCommand(context, PERCENT_SETTING_KEY)) {
81
+ patch.percentSetting = percent;
82
+ patch.percentCurrent = percent;
83
+ Object.assign(patch, speedPatch(context, percent));
84
+ }
85
+ else if (!hasCommand(context, FAN_MODE_KEY)) {
86
+ // only the percent reaches the device: publish the mode's percent
87
+ await route(context.endpoint, PERCENT_SETTING_KEY, percent, { percent, mode: value });
88
+ patch.percentSetting = percent;
89
+ patch.percentCurrent = percent;
90
+ Object.assign(patch, speedPatch(context, percent));
91
+ }
92
+ if (Object.keys(patch).length > 0) {
93
+ await setFan(context, patch);
94
+ }
95
+ return;
96
+ }
97
+ if (attribute === 'speedSetting' && typeof value === 'number' && context.options.fan.speedMax > 0) {
98
+ const percent = Math.round((value / context.options.fan.speedMax) * 100);
99
+ const patch = { speedCurrent: value };
100
+ if (!hasCommand(context, PERCENT_SETTING_KEY)) {
101
+ patch.percentSetting = percent;
102
+ patch.percentCurrent = percent;
103
+ }
104
+ else {
105
+ await route(context.endpoint, PERCENT_SETTING_KEY, percent, { percent, speed: value });
106
+ patch.percentSetting = percent;
107
+ patch.percentCurrent = percent;
108
+ }
109
+ if (!hasCommand(context, FAN_MODE_KEY)) {
110
+ patch.fanMode = percentToMode(context, percent);
111
+ }
112
+ await setFan(context, patch);
113
+ }
114
+ }
115
+ /** the device reported: a percent sets setting and current (and the mode unless bound), a mode the percent */
116
+ export async function fanStatus(context, attribute, value) {
117
+ if (context === undefined) {
118
+ return false;
119
+ }
120
+ if ((attribute === 'percentCurrent' || attribute === 'percentSetting') && typeof value === 'number') {
121
+ const patch = {
122
+ percentCurrent: value,
123
+ percentSetting: value,
124
+ ...speedPatch(context, value),
125
+ };
126
+ // a reported mode wins, except Auto: a fan in Auto reports no percent setting (null), so a percent means
127
+ // it left Auto even when the mode's own report says nothing (Home Assistant's preset None)
128
+ if (!hasStatus(context, FAN_MODE_KEY) || fanState(context).fanMode === FanControl.FanMode.Auto) {
129
+ patch.fanMode = percentToMode(context, value);
130
+ }
131
+ await setFan(context, patch);
132
+ return true;
133
+ }
134
+ if (attribute === 'fanMode' && typeof value === 'number') {
135
+ const patch = { fanMode: value };
136
+ const current = fanState(context);
137
+ if (!hasStatus(context, PERCENT_CURRENT_KEY) && !hasStatus(context, PERCENT_SETTING_KEY)) {
138
+ const percent = modeToPercent(context, value);
139
+ if (percent !== undefined) {
140
+ patch.percentSetting = percent;
141
+ patch.percentCurrent = percent;
142
+ Object.assign(patch, speedPatch(context, percent));
143
+ }
144
+ }
145
+ else if (value === MODE.off && current.percentCurrent !== 0) {
146
+ patch.percentSetting = 0;
147
+ patch.percentCurrent = 0;
148
+ }
149
+ await setFan(context, patch);
150
+ return true;
151
+ }
152
+ return false;
153
+ }
154
+ //# sourceMappingURL=fan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fan.js","sourceRoot":"","sources":["../../src/families/fan.ts"],"names":[],"mappings":"AAAA;;;2GAG2G;AAE3G,OAAO,EAAC,gBAAgB,IAAI,oBAAoB,EAAC,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAC,UAAU,EAAC,MAAM,mCAAmC,CAAC;AAG7D,OAAO,EAAqB,UAAU,EAAE,SAAS,EAAE,KAAK,EAAC,MAAM,eAAe,CAAC;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,IAAI,GAAsD;IAC5D,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG;IAC3B,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM;IACjC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI;CAChC,CAAC;AAEF,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;CAAG;AAE7D,MAAM,UAAU,aAAa,CAAC,OAAsB,EAAE,OAAe;IACjE,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,MAAM,EAAC,GAAG,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1C,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAsB,EAAE,IAAY;IAC9D,MAAM,EAAC,GAAG,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1C,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,GAAG;YACT,OAAO,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG;YACT,OAAO,GAAG,CAAC;QACf,KAAK,IAAI,CAAC,MAAM;YACZ,OAAO,MAAM,CAAC;QAClB,KAAK,IAAI,CAAC,IAAI;YACV,OAAO,GAAG,CAAC;QACf;YACI,OAAO,SAAS,CAAC;IACzB,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,OAAsB;IACpC,OAAQ,OAAO,CAAC,QAAQ,CAAC,KAAiC,CAAC,UAAqC,CAAC;AACrG,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,OAAsB,EAAE,KAA8B;IACxE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAC,UAAU,EAAE,KAAK,EAAU,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,OAAsB,EAAE,OAAe;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC9C,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IACrD,OAAO,EAAC,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAC,CAAC;AACtD,CAAC;AAED,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAsB,EAAE,SAAiB,EAAE,KAAc;IACpF,IAAI,SAAS,KAAK,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,KAAK,GAA4B,EAAC,cAAc,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAC,CAAC;QAC9F,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO;IACX,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YAC5C,kEAAkE;YAClE,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;YACpF,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO;IACX,CAAC;IACD,IAAI,SAAS,KAAK,cAAc,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChG,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QACzE,MAAM,KAAK,GAA4B,EAAC,YAAY,EAAE,KAAK,EAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;YACrF,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;YAC/B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;AACL,CAAC;AAED,8GAA8G;AAC9G,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,OAAkC,EAClC,SAAiB,EACjB,KAAc;IAEd,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,SAAS,KAAK,gBAAgB,IAAI,SAAS,KAAK,gBAAgB,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClG,MAAM,KAAK,GAA4B;YACnC,cAAc,EAAE,KAAK;YACrB,cAAc,EAAE,KAAK;YACrB,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;SAChC,CAAC;QACF,yGAAyG;QACzG,2FAA2F;QAC3F,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7F,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,KAAK,GAA4B,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;QACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;YACvF,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;gBAC/B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;YACzB,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}
@@ -0,0 +1,32 @@
1
+ import type { Behavior } from '@matter/main';
2
+ import type { Decoded } from '../engine/payload.ts';
3
+ import type { Options } from '../model/options.ts';
4
+ import type { FamilyContext } from './registry.ts';
5
+ export interface Family {
6
+ cluster: string;
7
+ server: Behavior.Type;
8
+ /** features the mappings imply (`Thermostat` from the setpoints); titles */
9
+ features?: (boundKeys: ReadonlySet<string>, options: Options) => string[];
10
+ /** attribute defaults for the endpoint's construction */
11
+ defaults?: (features: ReadonlySet<string>, options: Options) => Record<string, unknown>;
12
+ /** a status for an attribute of the cluster: a state patch for the cluster, true when applied itself, or false */
13
+ status?: (context: FamilyContext | undefined, attribute: string, value: Decoded) => Promise<Record<string, unknown> | boolean>;
14
+ /** a controller wrote a writable attribute (already applied) */
15
+ write?: (context: FamilyContext, attribute: string, value: unknown) => Promise<void>;
16
+ /** writable attributes the family watches even without a mapping (the fan derives one from the other) */
17
+ writes?: readonly string[];
18
+ /** the event channel of the cluster */
19
+ event?: (context: FamilyContext, value: Decoded) => Promise<void>;
20
+ }
21
+ export declare const FAMILIES: readonly Family[];
22
+ export declare function familyFor(cluster: string): Family | undefined;
23
+ export { registerContext, forgetContext, contextOf, type FamilyContext } from './registry.ts';
24
+ export { OnOffServer } from './on-off.ts';
25
+ export { LevelControlServer, ColorControlServer } from './light.ts';
26
+ export { WindowCoveringServer } from './cover.ts';
27
+ export { ThermostatServer } from './climate.ts';
28
+ export { DoorLockServer } from './lock.ts';
29
+ export { FanControlServer } from './fan.ts';
30
+ export { SwitchServer } from './switch.ts';
31
+ export { PowerSourceServer } from './power-source.ts';
32
+ export { RvcRunModeServer, RvcOperationalStateServer } from './rvc.ts';