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,60 @@
1
+ /* The power source family: PowerSource on the same endpoint (device type `PowerSource`, feature `Battery`
2
+ or `Wired`). Status is plain attributes — `batPercentRemaining` in Matter's half percents (bind with
3
+ `unit: halfPercent`), `batVoltage` in mV (`unit: volt`), `batChargeLevel` by name — plus one derivation:
4
+ the charge level from the percentage when it is not bound itself. */
5
+ import { PowerSourceServer as BasePowerSourceServer } from '@matter/main/behaviors/power-source';
6
+ import { PowerSource } from '@matter/main/clusters/power-source';
7
+ import { hasStatus } from "./registry.js";
8
+ export const BAT_CHARGE_LEVEL_KEY = 'PowerSource.batChargeLevel';
9
+ export class PowerSourceServer extends BasePowerSourceServer {
10
+ }
11
+ export function chargeLevelFor(context, halfPercent) {
12
+ const percent = halfPercent / 2;
13
+ const { warning, critical } = context.options.powerSource;
14
+ if (percent <= critical) {
15
+ return PowerSource.BatChargeLevel.Critical;
16
+ }
17
+ if (percent <= warning) {
18
+ return PowerSource.BatChargeLevel.Warning;
19
+ }
20
+ return PowerSource.BatChargeLevel.Ok;
21
+ }
22
+ /** the status side; true = handled */
23
+ export async function powerSourceStatus(context, attribute, value) {
24
+ if (context === undefined || attribute !== 'batPercentRemaining' || typeof value !== 'number') {
25
+ return false;
26
+ }
27
+ const patch = { batPercentRemaining: value };
28
+ if (!hasStatus(context, BAT_CHARGE_LEVEL_KEY) && context.features.get('PowerSource')?.has('Battery') === true) {
29
+ patch.batChargeLevel = chargeLevelFor(context, value);
30
+ }
31
+ await context.endpoint.set({ powerSource: patch });
32
+ return true;
33
+ }
34
+ /** the attribute defaults a PowerSource endpoint needs beyond matter.js' own */
35
+ export function powerSourceDefaults(features) {
36
+ const defaults = {
37
+ status: PowerSource.PowerSourceStatus.Active,
38
+ order: 0,
39
+ };
40
+ if (features.has('Battery')) {
41
+ defaults.description = 'Battery';
42
+ defaults.batChargeLevel = PowerSource.BatChargeLevel.Ok;
43
+ defaults.batReplacementNeeded = false;
44
+ defaults.batReplaceability = PowerSource.BatReplaceability.Unspecified;
45
+ if (features.has('Rechargeable')) {
46
+ // mandatory with the feature: Unknown until the first report
47
+ defaults.batChargeState = PowerSource.BatChargeState.Unknown;
48
+ defaults.batFunctionalWhileCharging = true;
49
+ }
50
+ }
51
+ else if (features.has('Wired')) {
52
+ defaults.description = 'Mains';
53
+ defaults.wiredCurrentType = PowerSource.WiredCurrentType.Ac;
54
+ }
55
+ else {
56
+ defaults.description = 'Power';
57
+ }
58
+ return defaults;
59
+ }
60
+ //# sourceMappingURL=power-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"power-source.js","sourceRoot":"","sources":["../../src/families/power-source.ts"],"names":[],"mappings":"AAAA;;;uEAGuE;AAEvE,OAAO,EAAC,iBAAiB,IAAI,qBAAqB,EAAC,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAAC,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAG/D,OAAO,EAAqB,SAAS,EAAC,MAAM,eAAe,CAAC;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEjE,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;CAAG;AAE/D,MAAM,UAAU,cAAc,CAAC,OAAsB,EAAE,WAAmB;IACtE,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC;IAChC,MAAM,EAAC,OAAO,EAAE,QAAQ,EAAC,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;IACxD,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACrB,OAAO,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC;IAC9C,CAAC;IACD,OAAO,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,OAAkC,EAClC,SAAiB,EACjB,KAAc;IAEd,IAAI,OAAO,KAAK,SAAS,IAAI,SAAS,KAAK,qBAAqB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5F,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAA4B,EAAC,mBAAmB,EAAE,KAAK,EAAC,CAAC;IACpE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5G,KAAK,CAAC,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAC,WAAW,EAAE,KAAK,EAAU,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,QAA6B;IAC7D,MAAM,QAAQ,GAA4B;QACtC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,MAAM;QAC5C,KAAK,EAAE,CAAC;KACX,CAAC;IACF,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,oBAAoB,GAAG,KAAK,CAAC;QACtC,QAAQ,CAAC,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC;QACvE,IAAI,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/B,6DAA6D;YAC7D,QAAQ,CAAC,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC;YAC7D,QAAQ,CAAC,0BAA0B,GAAG,IAAI,CAAC;QAC/C,CAAC;IACL,CAAC;SAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,WAAW,GAAG,OAAO,CAAC;QAC/B,QAAQ,CAAC,gBAAgB,GAAG,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAChE,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,WAAW,GAAG,OAAO,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}
@@ -0,0 +1,40 @@
1
+ import type { Behavior, Endpoint } from '@matter/main';
2
+ import type { CommandHandler } from '../engine/runtime.ts';
3
+ import type { Logger } from '../log.ts';
4
+ import type { Options } from '../model/options.ts';
5
+ export interface FamilyContext {
6
+ readonly endpoint: Endpoint;
7
+ readonly options: Options;
8
+ /** enabled feature titles per cluster, e.g. `ColorControl → {HueSaturation, ColorTemperature}` */
9
+ readonly features: ReadonlyMap<string, ReadonlySet<string>>;
10
+ /** the keys with a command half (`OnOff.onOff`, `ColorControl.colorHs`, `WindowCovering.stopMotion`) */
11
+ readonly commands: Map<string, CommandHandler>;
12
+ /** the keys with a status half */
13
+ readonly statuses: ReadonlySet<string>;
14
+ readonly log: Logger;
15
+ /** per-family scratch state (the cover's movement, the switch's queue) */
16
+ readonly scratch: Map<string, unknown>;
17
+ }
18
+ export declare function registerContext(context: FamilyContext): void;
19
+ export declare function forgetContext(endpoint: Endpoint): void;
20
+ export declare function contextOf(endpoint: Endpoint): FamilyContext | undefined;
21
+ export declare function hasFeature(context: FamilyContext | undefined, cluster: string, feature: string): boolean;
22
+ export declare function hasCommand(context: FamilyContext | undefined, key: string): boolean;
23
+ export declare function hasStatus(context: FamilyContext | undefined, key: string): boolean;
24
+ /**
25
+ * A controller's command for `key`: the runtime's handler publishes it and says whether the value is to be
26
+ * applied locally now. Without a handler the default applies (true): a cluster nobody bound behaves like a
27
+ * local device, so a controller still sees a consistent endpoint.
28
+ */
29
+ export declare function route(endpoint: Endpoint, key: string, value: unknown, fields?: Record<string, unknown>): Promise<boolean>;
30
+ /**
31
+ * Take the behavior's state lock after an await. The default implementations write state synchronously and
32
+ * throw when a `set()` of ours — a status message a moment earlier — still holds it.
33
+ */
34
+ export declare function lock(behavior: Behavior): Promise<void>;
35
+ /** a behavior's state without the feature-dependent typing (our classes extend the servers before `with()`) */
36
+ export declare function loose(state: object): Record<string, unknown>;
37
+ /** a scratch slot of the context, created on first use */
38
+ export declare function scratch<T>(context: FamilyContext, key: string, create: () => T): T;
39
+ /** a controller's transition time in tenths of a second → the template field `transition` in seconds */
40
+ export declare function transitionField(context: FamilyContext | undefined, transitionTime: number | null | undefined): Record<string, unknown>;
@@ -0,0 +1,72 @@
1
+ /* What every family shares: the per-endpoint context (options, the enabled features, the mappings it has,
2
+ the command handlers the runtime registered) and `route()`, which hands a controller's command to the
3
+ runtime's handler and answers whether the family applies the value locally. The context is keyed by
4
+ the matter.js Endpoint in a WeakMap, so a behavior finds it through `this.endpoint`. */
5
+ const contexts = new WeakMap();
6
+ export function registerContext(context) {
7
+ contexts.set(context.endpoint, context);
8
+ }
9
+ export function forgetContext(endpoint) {
10
+ contexts.delete(endpoint);
11
+ }
12
+ export function contextOf(endpoint) {
13
+ return contexts.get(endpoint);
14
+ }
15
+ export function hasFeature(context, cluster, feature) {
16
+ return context?.features.get(cluster)?.has(feature) ?? false;
17
+ }
18
+ export function hasCommand(context, key) {
19
+ return context?.commands.has(key) ?? false;
20
+ }
21
+ export function hasStatus(context, key) {
22
+ return context?.statuses.has(key) ?? false;
23
+ }
24
+ /**
25
+ * A controller's command for `key`: the runtime's handler publishes it and says whether the value is to be
26
+ * applied locally now. Without a handler the default applies (true): a cluster nobody bound behaves like a
27
+ * local device, so a controller still sees a consistent endpoint.
28
+ */
29
+ export async function route(endpoint, key, value, fields = {}) {
30
+ const context = contexts.get(endpoint);
31
+ const handler = context?.commands.get(key);
32
+ if (handler === undefined) {
33
+ return true;
34
+ }
35
+ try {
36
+ return await handler(value, fields);
37
+ }
38
+ catch (error) {
39
+ context?.log.error(`${key}: publishing the command failed`, error);
40
+ return false;
41
+ }
42
+ }
43
+ /**
44
+ * Take the behavior's state lock after an await. The default implementations write state synchronously and
45
+ * throw when a `set()` of ours — a status message a moment earlier — still holds it.
46
+ */
47
+ export async function lock(behavior) {
48
+ const { transaction } = behavior.context;
49
+ await transaction.addResources(behavior);
50
+ await transaction.begin();
51
+ }
52
+ /** a behavior's state without the feature-dependent typing (our classes extend the servers before `with()`) */
53
+ export function loose(state) {
54
+ return state;
55
+ }
56
+ /** a scratch slot of the context, created on first use */
57
+ export function scratch(context, key, create) {
58
+ let value = context.scratch.get(key);
59
+ if (value === undefined) {
60
+ value = create();
61
+ context.scratch.set(key, value);
62
+ }
63
+ return value;
64
+ }
65
+ /** a controller's transition time in tenths of a second → the template field `transition` in seconds */
66
+ export function transitionField(context, transitionTime) {
67
+ if (transitionTime === null || transitionTime === undefined || context?.options.light.transition === false) {
68
+ return {};
69
+ }
70
+ return { transition: transitionTime / 10 };
71
+ }
72
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/families/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import { RvcOperationalStateServer as BaseRvcOperationalStateServer } from '@matter/main/behaviors/rvc-operational-state';
2
+ import { RvcRunModeServer as BaseRvcRunModeServer } from '@matter/main/behaviors/rvc-run-mode';
3
+ import { ModeBase } from '@matter/main/clusters/mode-base';
4
+ import { OperationalState } from '@matter/main/clusters/operational-state';
5
+ import { RvcOperationalState } from '@matter/main/clusters/rvc-operational-state';
6
+ import { RvcRunMode } from '@matter/main/clusters/rvc-run-mode';
7
+ export declare const RUN_MODE_KEY = "RvcRunMode.currentMode";
8
+ export declare const PAUSE_KEY = "RvcOperationalState.pause";
9
+ export declare const RESUME_KEY = "RvcOperationalState.resume";
10
+ export declare const GO_HOME_KEY = "RvcOperationalState.goHome";
11
+ /** mode 0 is Idle, mode 1 Cleaning — what a mapping's `map` and `format` name */
12
+ export declare const RUN_MODES: {
13
+ label: string;
14
+ mode: number;
15
+ modeTags: {
16
+ value: RvcRunMode.ModeTag;
17
+ }[];
18
+ }[];
19
+ export declare const OPERATIONAL_STATES: {
20
+ operationalStateId: RvcOperationalState.OperationalState;
21
+ }[];
22
+ export declare function runModeDefaults(): Record<string, unknown>;
23
+ export declare function operationalStateDefaults(): Record<string, unknown>;
24
+ export declare class RvcRunModeServer extends BaseRvcRunModeServer {
25
+ changeToMode({ newMode }: ModeBase.ChangeToModeRequest): Promise<ModeBase.ChangeToModeResponse>;
26
+ }
27
+ declare const accepted: {
28
+ commandResponseState: {
29
+ errorStateId: OperationalState.ErrorState;
30
+ };
31
+ };
32
+ /** OperationCompletion is optional in the base cluster and mandatory for a vacuum */
33
+ declare const OperationalStateBase: import("@matter/node").ClusterBehavior.Type<typeof BaseRvcOperationalStateServer, import("@matter/types").ClusterType.WithEnabledAttributes<import("@matter/types").ClusterType.WithEnabledEvents<RvcOperationalState, "operationCompletion">, never>, import("@matter/types").ClusterType.Concrete, new () => {}, "rvcOperationalState">;
34
+ export declare class RvcOperationalStateServer extends OperationalStateBase {
35
+ #private;
36
+ pause(): Promise<typeof accepted>;
37
+ resume(): Promise<typeof accepted>;
38
+ goHome(): Promise<typeof accepted>;
39
+ }
40
+ export {};
@@ -0,0 +1,83 @@
1
+ /* The robot vacuum family: RvcRunMode and RvcOperationalState. matter.js' run mode server only checks and
2
+ applies a mode change, its operational state server implements no command; here a controller's mode change
3
+ goes to the `RvcRunMode.currentMode` mapping and pause, resume and go home to the `invoke` mappings of the
4
+ same names, applied locally only where nothing reports back. The defaults give the clusters the two run
5
+ modes Matter demands (Idle, Cleaning) and the operational states a vacuum has. */
6
+ import { ModeUtils } from '@matter/main/behaviors/mode-base';
7
+ import { RvcOperationalStateServer as BaseRvcOperationalStateServer } from '@matter/main/behaviors/rvc-operational-state';
8
+ import { RvcRunModeServer as BaseRvcRunModeServer } from '@matter/main/behaviors/rvc-run-mode';
9
+ import { ModeBase } from '@matter/main/clusters/mode-base';
10
+ import { OperationalState } from '@matter/main/clusters/operational-state';
11
+ import { RvcOperationalState } from '@matter/main/clusters/rvc-operational-state';
12
+ import { RvcRunMode } from '@matter/main/clusters/rvc-run-mode';
13
+ import { contextOf, hasCommand, lock, route } from "./registry.js";
14
+ export const RUN_MODE_KEY = 'RvcRunMode.currentMode';
15
+ export const PAUSE_KEY = 'RvcOperationalState.pause';
16
+ export const RESUME_KEY = 'RvcOperationalState.resume';
17
+ export const GO_HOME_KEY = 'RvcOperationalState.goHome';
18
+ /** mode 0 is Idle, mode 1 Cleaning — what a mapping's `map` and `format` name */
19
+ export const RUN_MODES = [
20
+ { label: 'Idle', mode: 0, modeTags: [{ value: RvcRunMode.ModeTag.Idle }] },
21
+ { label: 'Cleaning', mode: 1, modeTags: [{ value: RvcRunMode.ModeTag.Cleaning }] },
22
+ ];
23
+ const { OperationalState: State } = RvcOperationalState;
24
+ export const OPERATIONAL_STATES = [
25
+ State.Stopped,
26
+ State.Running,
27
+ State.Paused,
28
+ State.Error,
29
+ State.SeekingCharger,
30
+ State.Charging,
31
+ State.Docked,
32
+ ].map((operationalStateId) => ({ operationalStateId }));
33
+ export function runModeDefaults() {
34
+ return { supportedModes: RUN_MODES, currentMode: 0 };
35
+ }
36
+ export function operationalStateDefaults() {
37
+ return {
38
+ operationalStateList: OPERATIONAL_STATES,
39
+ operationalState: State.Docked,
40
+ operationalError: { errorStateId: OperationalState.ErrorState.NoError },
41
+ phaseList: null,
42
+ currentPhase: null,
43
+ };
44
+ }
45
+ export class RvcRunModeServer extends BaseRvcRunModeServer {
46
+ async changeToMode({ newMode }) {
47
+ const result = ModeUtils.assertModeChange(this.state.supportedModes, this.state.currentMode, newMode);
48
+ if (result.status !== ModeBase.ModeChangeStatus.Success) {
49
+ return result;
50
+ }
51
+ if (await route(this.endpoint, RUN_MODE_KEY, newMode)) {
52
+ await lock(this);
53
+ this.state.currentMode = newMode;
54
+ }
55
+ return result;
56
+ }
57
+ }
58
+ const accepted = { commandResponseState: { errorStateId: OperationalState.ErrorState.NoError } };
59
+ const refused = { commandResponseState: { errorStateId: OperationalState.ErrorState.CommandInvalidInState } };
60
+ /** OperationCompletion is optional in the base cluster and mandatory for a vacuum */
61
+ const OperationalStateBase = BaseRvcOperationalStateServer.enable({ events: { operationCompletion: true } });
62
+ export class RvcOperationalStateServer extends OperationalStateBase {
63
+ async #invoke(key, applied) {
64
+ if (!hasCommand(contextOf(this.endpoint), key)) {
65
+ return refused;
66
+ }
67
+ if (await route(this.endpoint, key, true)) {
68
+ await lock(this);
69
+ this.state.operationalState = applied;
70
+ }
71
+ return accepted;
72
+ }
73
+ pause() {
74
+ return this.#invoke(PAUSE_KEY, State.Paused);
75
+ }
76
+ resume() {
77
+ return this.#invoke(RESUME_KEY, State.Running);
78
+ }
79
+ goHome() {
80
+ return this.#invoke(GO_HOME_KEY, State.SeekingCharger);
81
+ }
82
+ }
83
+ //# sourceMappingURL=rvc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rvc.js","sourceRoot":"","sources":["../../src/families/rvc.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { SwitchServer as BaseSwitchServer } from '@matter/main/behaviors/switch';
2
+ import type { Decoded } from '../engine/payload.ts';
3
+ import { type FamilyContext } from './registry.ts';
4
+ export declare class SwitchServer extends BaseSwitchServer {
5
+ }
6
+ type Step = {
7
+ kind: 'press';
8
+ position: number;
9
+ } | {
10
+ kind: 'release';
11
+ } | {
12
+ kind: 'wait';
13
+ ms: number;
14
+ };
15
+ /** the position changes a press kind consists of */
16
+ export declare function pressSteps(kind: string, options: FamilyContext['options']['switch']): Step[] | undefined;
17
+ /** play a press kind (momentary) or a position (latching) */
18
+ export declare function switchEvent(context: FamilyContext, value: Decoded): Promise<void>;
19
+ export {};
@@ -0,0 +1,94 @@
1
+ /* The switch family: GenericSwitch events from a device's action strings. The event channel `Switch`
2
+ receives a press kind — `single`, `double`, `triple`, a number of presses, `long`, `press`, `release`,
3
+ `longRelease` — and plays it as position changes into matter.js' SwitchServer, whose own machine
4
+ emits the events controllers expect (initialPress, shortRelease, multiPressOngoing/Complete, longPress,
5
+ longRelease) with the delays the options set. A latching switch takes the value as the position. Kinds
6
+ arriving while one plays are queued, so a double press stays a double press. */
7
+ import { SwitchServer as BaseSwitchServer } from '@matter/main/behaviors/switch';
8
+ import { scratch } from "./registry.js";
9
+ export class SwitchServer extends BaseSwitchServer {
10
+ }
11
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
12
+ const WORDS = {
13
+ single: 1,
14
+ click: 1,
15
+ short: 1,
16
+ double: 2,
17
+ triple: 3,
18
+ quadruple: 4,
19
+ quintuple: 5,
20
+ };
21
+ /** the position changes a press kind consists of */
22
+ export function pressSteps(kind, options) {
23
+ const text = kind
24
+ .trim()
25
+ .toLowerCase()
26
+ .replace(/[\s-]+/g, '_');
27
+ const { pressDuration, longPressDelay } = options;
28
+ const steps = [];
29
+ const count = WORDS[text] ?? (/^\d+$/.test(text) ? Number(text) : undefined);
30
+ if (count !== undefined && count > 0) {
31
+ for (let i = 0; i < count; i++) {
32
+ if (i > 0) {
33
+ steps.push({ kind: 'wait', ms: pressDuration });
34
+ }
35
+ steps.push({ kind: 'press', position: 1 }, { kind: 'wait', ms: pressDuration }, { kind: 'release' });
36
+ }
37
+ return steps;
38
+ }
39
+ switch (text) {
40
+ case 'long':
41
+ case 'hold':
42
+ case 'long_press':
43
+ return [
44
+ { kind: 'press', position: 1 },
45
+ { kind: 'wait', ms: longPressDelay + pressDuration },
46
+ { kind: 'release' },
47
+ ];
48
+ case 'press':
49
+ case 'initial_press':
50
+ return [{ kind: 'press', position: 1 }];
51
+ case 'release':
52
+ case 'long_release':
53
+ case 'short_release':
54
+ return [{ kind: 'release' }];
55
+ default:
56
+ return undefined;
57
+ }
58
+ }
59
+ async function setPosition(context, position) {
60
+ await context.endpoint.set({ switch: { rawPosition: position } });
61
+ }
62
+ /** play a press kind (momentary) or a position (latching) */
63
+ export async function switchEvent(context, value) {
64
+ const options = context.options.switch;
65
+ if (options.kind === 'latching') {
66
+ const position = typeof value === 'boolean' ? (value ? 1 : 0) : Number(value);
67
+ if (!Number.isInteger(position) || position < 0 || position >= options.numberOfPositions) {
68
+ throw new Error(`switch: ${JSON.stringify(value)} is not a position`);
69
+ }
70
+ await setPosition(context, position);
71
+ return;
72
+ }
73
+ const kind = typeof value === 'string' ? value : JSON.stringify(value);
74
+ const steps = pressSteps(kind, options);
75
+ if (steps === undefined) {
76
+ throw new Error(`switch: "${kind}" is not a press kind (single, double, triple, <n>, long, press, release)`);
77
+ }
78
+ const queue = scratch(context, 'switch.queue', () => ({ chain: Promise.resolve() }));
79
+ const run = queue.chain.then(async () => {
80
+ for (const step of steps) {
81
+ if (step.kind === 'wait') {
82
+ await sleep(step.ms);
83
+ }
84
+ else {
85
+ await setPosition(context, step.kind === 'press' ? step.position : 0);
86
+ }
87
+ }
88
+ });
89
+ queue.chain = run.catch((error) => {
90
+ context.log.error(`switch: playing "${kind}" failed`, error);
91
+ });
92
+ await run;
93
+ }
94
+ //# sourceMappingURL=switch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"switch.js","sourceRoot":"","sources":["../../src/families/switch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ export declare const PRESS_COUNT: Record<string, number>;
2
+ export interface Button {
3
+ /** the button's name: `''` for the device's only button, else the prefix/suffix (`l1`, `brightness_up`, `on`) */
4
+ name: string;
5
+ /** action value → press kind */
6
+ kinds: Map<string, string>;
7
+ }
8
+ export interface ParsedActions {
9
+ buttons: Button[];
10
+ /** action values that are no presses */
11
+ ignored: string[];
12
+ }
13
+ export declare function parseAction(value: string): {
14
+ button: string;
15
+ kind: string;
16
+ } | undefined;
17
+ export declare function parseActions(values: readonly (string | number)[]): ParsedActions;
18
+ /** the most presses a button's kinds announce (the switch family's `multiPressMax`) */
19
+ export declare function multiPressMax(button: Button): number;
@@ -0,0 +1,98 @@
1
+ /* Action names → buttons with press kinds, shared by the importers: zigbee2mqtt's `action` enum and Home
2
+ Assistant's `event_types` and device trigger types. A device's actions are strings like `single`,
3
+ `double`, `hold`, `release` (one button), `single_l1` / `single_l2` (a button per endpoint),
4
+ `brightness_up_click` / `brightness_up_hold` / `arrow_left_click` (IKEA and Philips remotes: a button
5
+ per prefix), `on` / `off` / `toggle` / `open` / `close` / `stop` (remotes whose actions name the button
6
+ only: one single-press button each), `shake` / `tap` / `flip90` (the cube: gestures as buttons).
7
+ Continuous actions — `brightness_move_up`, `brightness_stop`, `hue_move`, `rotate_left`, `scene_1` — are
8
+ no presses and are left out. Each button becomes one GenericSwitch endpoint. Home Assistant's
9
+ `button_short_press` / `button_double_press` / `button_long_release` (device triggers) and ESPHome's
10
+ `double_press` / `long_press` (event types) are read through the same table. */
11
+ const KINDS = {
12
+ single: 'single',
13
+ click: 'single',
14
+ press: 'single',
15
+ short: 'single',
16
+ short_press: 'single',
17
+ single_press: 'single',
18
+ double: 'double',
19
+ double_click: 'double',
20
+ double_press: 'double',
21
+ triple: 'triple',
22
+ triple_click: 'triple',
23
+ triple_press: 'triple',
24
+ quadruple: 'quadruple',
25
+ quadruple_press: 'quadruple',
26
+ quintuple: 'quintuple',
27
+ quintuple_press: 'quintuple',
28
+ many: 'quintuple',
29
+ hold: 'long',
30
+ long: 'long',
31
+ long_press: 'long',
32
+ long_click: 'long',
33
+ release: 'longRelease',
34
+ hold_release: 'longRelease',
35
+ long_release: 'longRelease',
36
+ short_release: 'release',
37
+ };
38
+ /** longest first, so `long_release` wins over `release` */
39
+ const KIND_WORDS = Object.keys(KINDS).sort((a, b) => b.length - a.length);
40
+ const SUFFIX = new RegExp(`^(.+?)_(${KIND_WORDS.join('|')})$`);
41
+ const PREFIX = new RegExp(`^(${KIND_WORDS.join('|')})_(.+)$`);
42
+ /** actions that are no presses: continuous moves and steps, scene recalls, rotations, identify */
43
+ const NOT_A_PRESS = [
44
+ /(^|_)(move|step|level|scene|recall|rotate|identify)(_|$)/,
45
+ /^.+_stop$/,
46
+ /^(hue|saturation|color|colour|brightness|color_temperature)_/,
47
+ ];
48
+ export const PRESS_COUNT = { single: 1, double: 2, triple: 3, quadruple: 4, quintuple: 5 };
49
+ export function parseAction(value) {
50
+ const v = value.trim().toLowerCase();
51
+ if (v === '') {
52
+ return undefined;
53
+ }
54
+ const direct = KINDS[v];
55
+ if (direct !== undefined) {
56
+ return { button: '', kind: direct };
57
+ }
58
+ const suffix = SUFFIX.exec(v);
59
+ if (suffix !== null) {
60
+ return { button: suffix[1] ?? '', kind: KINDS[suffix[2] ?? ''] ?? 'single' };
61
+ }
62
+ const prefix = PREFIX.exec(v);
63
+ if (prefix !== null) {
64
+ return { button: prefix[2] ?? '', kind: KINDS[prefix[1] ?? ''] ?? 'single' };
65
+ }
66
+ if (NOT_A_PRESS.some((pattern) => pattern.test(v))) {
67
+ return undefined;
68
+ }
69
+ return { button: v, kind: 'single' };
70
+ }
71
+ export function parseActions(values) {
72
+ const buttons = new Map();
73
+ const ignored = [];
74
+ for (const raw of values) {
75
+ const value = String(raw);
76
+ const parsed = parseAction(value);
77
+ if (parsed === undefined) {
78
+ ignored.push(value);
79
+ continue;
80
+ }
81
+ let button = buttons.get(parsed.button);
82
+ if (button === undefined) {
83
+ button = { name: parsed.button, kinds: new Map() };
84
+ buttons.set(parsed.button, button);
85
+ }
86
+ button.kinds.set(value, parsed.kind);
87
+ }
88
+ return { buttons: [...buttons.values()], ignored };
89
+ }
90
+ /** the most presses a button's kinds announce (the switch family's `multiPressMax`) */
91
+ export function multiPressMax(button) {
92
+ let max = 1;
93
+ for (const kind of button.kinds.values()) {
94
+ max = Math.max(max, PRESS_COUNT[kind] ?? 1);
95
+ }
96
+ return max;
97
+ }
98
+ //# sourceMappingURL=actions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/importers/actions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /** the Common Area tag for an area name, or undefined when the name matches none */
2
+ export declare function areaTag(name: string): {
3
+ name: string;
4
+ id: number;
5
+ } | undefined;
6
+ export declare const AREA_TAGS: Readonly<Record<string, number>>;