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,484 @@
1
+ /* Static validation of a device against @matter/model (the first validation layer): device types exist, clusters
2
+ and attributes exist, the attribute's conformance holds under the endpoint's features, mappings fit the
3
+ attribute's shape (a boolean attribute does not take a number map, an enum map's values are member
4
+ names), commands and event channels exist, templates parse. Pure: no node is built; the strict dry run
5
+ (matter/check.ts) is layer 2. The result is a list of issues with paths the UI can point at. */
6
+ import { renderTemplate } from "../engine/template.js";
7
+ import { COMPOSITE_ATTRIBUTES, Conformance, cluster as clusterInfo, deviceType as deviceTypeInfo, } from "./catalog.js";
8
+ import { mappingTarget, } from "./schema.js";
9
+ /** the families' implied features, mirrored from src/families so the model stays free of matter.js */
10
+ function impliedFeatures(cluster, bound, options) {
11
+ switch (cluster) {
12
+ case 'ColorControl': {
13
+ const f = [];
14
+ if (bound.has('ColorControl.colorTemperatureMireds')) {
15
+ f.push('ColorTemperature');
16
+ }
17
+ if (bound.has('ColorControl.colorHs') || bound.has('ColorControl.currentHue')) {
18
+ f.push('HueSaturation');
19
+ }
20
+ if (bound.has('ColorControl.colorXy') || bound.has('ColorControl.currentX')) {
21
+ f.push('Xy');
22
+ }
23
+ return f;
24
+ }
25
+ case 'WindowCovering': {
26
+ const f = [];
27
+ if (bound.has('WindowCovering.currentPositionLiftPercent100ths') ||
28
+ bound.has('WindowCovering.targetPositionLiftPercent100ths')) {
29
+ f.push('Lift', 'PositionAwareLift');
30
+ }
31
+ if (bound.has('WindowCovering.currentPositionTiltPercent100ths') ||
32
+ bound.has('WindowCovering.targetPositionTiltPercent100ths')) {
33
+ f.push('Tilt', 'PositionAwareTilt');
34
+ }
35
+ return f.length === 0 ? ['Lift'] : f;
36
+ }
37
+ case 'Thermostat': {
38
+ const f = [];
39
+ const heating = bound.has('Thermostat.occupiedHeatingSetpoint');
40
+ const cooling = bound.has('Thermostat.occupiedCoolingSetpoint');
41
+ if (heating) {
42
+ f.push('Heating');
43
+ }
44
+ if (cooling) {
45
+ f.push('Cooling');
46
+ }
47
+ if (heating && cooling && bound.has('Thermostat.systemMode')) {
48
+ f.push('AutoMode');
49
+ }
50
+ return f;
51
+ }
52
+ case 'FanControl':
53
+ return options.fan.speedMax > 0 || bound.has('FanControl.speedSetting') ? ['MultiSpeed'] : [];
54
+ case 'Switch':
55
+ return options.switch.kind === 'latching'
56
+ ? ['LatchingSwitch']
57
+ : [
58
+ 'MomentarySwitch',
59
+ 'MomentarySwitchRelease',
60
+ 'MomentarySwitchLongPress',
61
+ 'MomentarySwitchMultiPress',
62
+ ];
63
+ case 'PowerSource':
64
+ return bound.has('PowerSource.wiredCurrentType') ? ['Wired'] : ['Battery'];
65
+ case 'OccupancySensing':
66
+ return ['PassiveInfrared'];
67
+ default:
68
+ return cluster.endsWith('ConcentrationMeasurement') ? ['NumericMeasurement'] : [];
69
+ }
70
+ }
71
+ /** the feature set an endpoint's cluster will run with: device type requirements ∪ implied ∪ configured */
72
+ export function effectiveFeatures(endpoint, cluster, bound) {
73
+ const set = new Set();
74
+ for (const name of endpoint.deviceTypes) {
75
+ for (const requirement of deviceTypeInfo(name)?.clusters ?? []) {
76
+ if (requirement.cluster === cluster) {
77
+ for (const f of requirement.features) {
78
+ set.add(f);
79
+ }
80
+ }
81
+ }
82
+ }
83
+ for (const f of impliedFeatures(cluster, bound, endpoint.options)) {
84
+ set.add(f);
85
+ }
86
+ const info = clusterInfo(cluster);
87
+ for (const requested of endpoint.features?.[cluster] ?? []) {
88
+ const feature = info?.feature(requested);
89
+ if (feature !== undefined) {
90
+ set.add(feature.title);
91
+ }
92
+ }
93
+ return set;
94
+ }
95
+ function scalarKind(value) {
96
+ return typeof value;
97
+ }
98
+ function checkValueShape(issues, path, info, value, what) {
99
+ if (value === null) {
100
+ if (!info.nullable) {
101
+ issues.push({ level: 'error', path, message: `${what} null: the attribute is not nullable` });
102
+ }
103
+ return;
104
+ }
105
+ const kind = scalarKind(value);
106
+ switch (info.metatype) {
107
+ case 'boolean':
108
+ if (kind !== 'boolean') {
109
+ issues.push({
110
+ level: 'error',
111
+ path,
112
+ message: `${what} ${JSON.stringify(value)}: the attribute is a boolean`,
113
+ });
114
+ }
115
+ break;
116
+ case 'integer':
117
+ case 'float':
118
+ if (kind !== 'number') {
119
+ issues.push({
120
+ level: 'error',
121
+ path,
122
+ message: `${what} ${JSON.stringify(value)}: the attribute is a number`,
123
+ });
124
+ }
125
+ else if (info.metatype === 'integer' && !Number.isInteger(value)) {
126
+ issues.push({
127
+ level: 'warning',
128
+ path,
129
+ message: `${what} ${String(value)} is rounded: the attribute is an integer`,
130
+ });
131
+ }
132
+ else if ((info.min !== undefined && value < info.min) ||
133
+ (info.max !== undefined && value > info.max)) {
134
+ issues.push({
135
+ level: 'warning',
136
+ path,
137
+ message: `${what} ${String(value)} is outside ${info.min ?? '…'}–${info.max ?? '…'}`,
138
+ });
139
+ }
140
+ break;
141
+ case 'enum': {
142
+ const members = info.enumMembers ?? new Map();
143
+ const known = kind === 'number'
144
+ ? [...members.values()].includes(value)
145
+ : kind === 'string' &&
146
+ [...members.keys()].some((m) => m.toLowerCase() ===
147
+ String(value)
148
+ .toLowerCase()
149
+ .replace(/[\s_-]/g, ''));
150
+ if (!known) {
151
+ issues.push({
152
+ level: 'error',
153
+ path,
154
+ message: `${what} ${JSON.stringify(value)} is not one of ${[...members.keys()].join(', ')}`,
155
+ });
156
+ }
157
+ break;
158
+ }
159
+ case 'bitmap': {
160
+ if (kind === 'string') {
161
+ const fields = (info.bitFields ?? []).map((f) => f.name.toLowerCase());
162
+ for (const name of String(value)
163
+ .split(/[,\s|]+/)
164
+ .filter((n) => n !== '')) {
165
+ if (!fields.includes(name.toLowerCase())) {
166
+ issues.push({
167
+ level: 'error',
168
+ path,
169
+ message: `${what} "${name}" is not one of ${fields.join(', ')}`,
170
+ });
171
+ }
172
+ }
173
+ }
174
+ break;
175
+ }
176
+ case 'string':
177
+ if (kind !== 'string') {
178
+ issues.push({
179
+ level: 'error',
180
+ path,
181
+ message: `${what} ${JSON.stringify(value)}: the attribute is a string`,
182
+ });
183
+ }
184
+ break;
185
+ default:
186
+ break;
187
+ }
188
+ }
189
+ function checkStatusHalf(issues, path, half, info) {
190
+ if (half.template !== undefined) {
191
+ const rendered = renderTemplate(half.template, { value: '', value_json: {}, topic: half.topic });
192
+ if (!rendered.ok && /template .*: (Parser|Lexer|Syntax|Unexpected)/i.test(rendered.reason)) {
193
+ issues.push({ level: 'error', path: `${path}.template`, message: rendered.reason });
194
+ }
195
+ }
196
+ if (half.invert === true &&
197
+ half.scale === undefined &&
198
+ half.map === undefined &&
199
+ half.type !== 'boolean' &&
200
+ info?.metatype !== 'boolean') {
201
+ issues.push({
202
+ level: 'warning',
203
+ path: `${path}.invert`,
204
+ message: 'invert needs a scale for numbers; it only negates booleans otherwise',
205
+ });
206
+ }
207
+ if (info === undefined) {
208
+ return;
209
+ }
210
+ if (half.map !== undefined) {
211
+ for (const [key, value] of Object.entries(half.map)) {
212
+ checkValueShape(issues, `${path}.map["${key}"]`, info, value, 'map value');
213
+ }
214
+ }
215
+ if (half.default !== undefined) {
216
+ checkValueShape(issues, `${path}.default`, info, half.default, 'default');
217
+ }
218
+ if (half.type !== undefined && half.map === undefined) {
219
+ const expected = info.metatype === 'boolean'
220
+ ? 'boolean'
221
+ : info.metatype === 'integer' || info.metatype === 'float' || info.metatype === 'enum'
222
+ ? 'number'
223
+ : info.metatype === 'string'
224
+ ? 'string'
225
+ : undefined;
226
+ // a bitmap takes a boolean (its first field), a number (raw) or a string (field names); an enum its name
227
+ if (expected !== undefined && half.type !== expected && !(info.metatype === 'enum' && half.type === 'string')) {
228
+ issues.push({
229
+ level: 'error',
230
+ path: `${path}.type`,
231
+ message: `type ${half.type}, but the attribute is a ${info.metatype}`,
232
+ });
233
+ }
234
+ }
235
+ }
236
+ function checkMapping(issues, path, endpoint, mapping, bound, clusters) {
237
+ const { kind, name } = mappingTarget(mapping);
238
+ const [clusterName, member] = name.split('.');
239
+ const info = clusters.get(clusterName) ?? clusterInfo(clusterName);
240
+ if (info === undefined) {
241
+ issues.push({ level: 'error', path, message: `cluster "${clusterName}" is not in the Matter model` });
242
+ return;
243
+ }
244
+ const features = effectiveFeatures(endpoint, clusterName, bound);
245
+ if (!clusters.has(clusterName)) {
246
+ issues.push({
247
+ level: 'warning',
248
+ path,
249
+ message: `cluster ${clusterName} is not part of ${endpoint.deviceTypes.join(', ')}; it is added, controllers may ignore it`,
250
+ });
251
+ }
252
+ if (kind === 'event') {
253
+ if (clusterName !== 'Switch') {
254
+ issues.push({ level: 'error', path, message: `event channel "${name}" is unknown; 1.0 knows Switch` });
255
+ }
256
+ else if (mapping.status === undefined) {
257
+ issues.push({ level: 'error', path, message: 'an event mapping needs a status half' });
258
+ }
259
+ return;
260
+ }
261
+ if (member === undefined) {
262
+ issues.push({
263
+ level: 'error',
264
+ path,
265
+ message: `"${name}" needs Cluster.${kind === 'invoke' ? 'command' : 'attribute'}`,
266
+ });
267
+ return;
268
+ }
269
+ if (kind === 'invoke') {
270
+ const command = info.commands.get(member);
271
+ if (command === undefined) {
272
+ issues.push({
273
+ level: 'error',
274
+ path,
275
+ message: `${clusterName} has no command ${member} (it has ${[...info.commands.keys()].join(', ')})`,
276
+ });
277
+ }
278
+ else if (command.applicability(features) === Conformance.Applicability.None) {
279
+ issues.push({ level: 'error', path, message: `${name} needs a feature the endpoint does not enable` });
280
+ }
281
+ if (mapping.command === undefined) {
282
+ issues.push({ level: 'error', path, message: 'a command mapping needs a command half' });
283
+ }
284
+ else if (mapping.command.payload === undefined &&
285
+ mapping.command.template === undefined &&
286
+ mapping.command.format === undefined) {
287
+ issues.push({
288
+ level: 'warning',
289
+ path: `${path}.command`,
290
+ message: 'no payload, template or format: the command publishes its name',
291
+ });
292
+ }
293
+ return;
294
+ }
295
+ const composite = COMPOSITE_ATTRIBUTES[name];
296
+ if (composite !== undefined) {
297
+ for (const feature of composite.features) {
298
+ if (!features.has(feature)) {
299
+ issues.push({ level: 'error', path, message: `${name} needs the ${clusterName} feature ${feature}` });
300
+ }
301
+ }
302
+ return;
303
+ }
304
+ const attribute = info.attributes.get(member);
305
+ if (attribute === undefined) {
306
+ issues.push({ level: 'error', path, message: `${clusterName} has no attribute ${member}` });
307
+ return;
308
+ }
309
+ if (attribute.applicability(features) === Conformance.Applicability.None) {
310
+ issues.push({
311
+ level: 'error',
312
+ path,
313
+ message: `${name} needs a ${clusterName} feature the endpoint does not enable (enabled: ${[...features].join(', ') || 'none'})`,
314
+ });
315
+ }
316
+ if (mapping.status !== undefined) {
317
+ checkStatusHalf(issues, `${path}.status`, mapping.status, attribute);
318
+ }
319
+ if (mapping.command !== undefined) {
320
+ const half = mapping.command;
321
+ if (half.format !== undefined) {
322
+ for (const key of Object.keys(half.format)) {
323
+ if (attribute.metatype === 'enum' && attribute.enumMembers !== undefined) {
324
+ const members = [...attribute.enumMembers.keys()];
325
+ if (!members.some((m) => m.toLowerCase() === key.toLowerCase()) && !/^\d+$/.test(key)) {
326
+ issues.push({
327
+ level: 'error',
328
+ path: `${path}.command.format`,
329
+ message: `"${key}" is not one of ${members.join(', ')}`,
330
+ });
331
+ }
332
+ }
333
+ else if (attribute.metatype === 'boolean' && key !== 'true' && key !== 'false') {
334
+ issues.push({
335
+ level: 'warning',
336
+ path: `${path}.command.format`,
337
+ message: `"${key}" is neither true nor false`,
338
+ });
339
+ }
340
+ }
341
+ }
342
+ if (half.template !== undefined) {
343
+ const rendered = renderTemplate(half.template, { value: 0 });
344
+ if (!rendered.ok && /(Parser|Lexer|Syntax|Unexpected)/i.test(rendered.reason)) {
345
+ issues.push({ level: 'error', path: `${path}.command.template`, message: rendered.reason });
346
+ }
347
+ }
348
+ if (attribute.writable && mapping.status !== undefined && half.optimistic === false) {
349
+ issues.push({
350
+ level: 'warning',
351
+ path: `${path}.command.optimistic`,
352
+ message: `${name} is written by controllers; matter.js applies the write before it is published, so it is optimistic in any case`,
353
+ });
354
+ }
355
+ }
356
+ }
357
+ /** validate one endpoint */
358
+ export function validateEndpoint(endpoint, path) {
359
+ const issues = [];
360
+ const clusters = new Map();
361
+ let utilityOnly = true;
362
+ for (const [i, name] of endpoint.deviceTypes.entries()) {
363
+ const info = deviceTypeInfo(name);
364
+ if (info === undefined) {
365
+ issues.push({
366
+ level: 'error',
367
+ path: `${path}.deviceTypes[${i}]`,
368
+ message: `device type "${name}" is not in the Matter model`,
369
+ });
370
+ continue;
371
+ }
372
+ if (info.classification !== 'utility') {
373
+ utilityOnly = false;
374
+ }
375
+ for (const requirement of info.clusters) {
376
+ const cluster = clusterInfo(requirement.cluster);
377
+ if (cluster !== undefined) {
378
+ clusters.set(requirement.cluster, cluster);
379
+ }
380
+ }
381
+ }
382
+ if (utilityOnly && endpoint.deviceTypes.length > 0 && issues.length === 0) {
383
+ issues.push({
384
+ level: 'warning',
385
+ path: `${path}.deviceTypes`,
386
+ message: `${endpoint.deviceTypes.join(', ')} alone is a utility type; controllers show no device for it`,
387
+ });
388
+ }
389
+ for (const [name, requested] of Object.entries(endpoint.features ?? {})) {
390
+ const info = clusterInfo(name);
391
+ if (info === undefined) {
392
+ issues.push({
393
+ level: 'error',
394
+ path: `${path}.features.${name}`,
395
+ message: `cluster "${name}" is not in the Matter model`,
396
+ });
397
+ continue;
398
+ }
399
+ for (const feature of requested) {
400
+ if (info.feature(feature) === undefined) {
401
+ issues.push({
402
+ level: 'error',
403
+ path: `${path}.features.${name}`,
404
+ message: `${name} has no feature "${feature}" (it has ${info.features.map((f) => f.title).join(', ')})`,
405
+ });
406
+ }
407
+ }
408
+ }
409
+ for (const [name, values] of Object.entries(endpoint.attributes ?? {})) {
410
+ const info = clusterInfo(name);
411
+ if (info === undefined) {
412
+ issues.push({
413
+ level: 'error',
414
+ path: `${path}.attributes.${name}`,
415
+ message: `cluster "${name}" is not in the Matter model`,
416
+ });
417
+ continue;
418
+ }
419
+ for (const attribute of Object.keys(values)) {
420
+ if (!info.attributes.has(attribute)) {
421
+ issues.push({
422
+ level: 'error',
423
+ path: `${path}.attributes.${name}.${attribute}`,
424
+ message: `${name} has no attribute ${attribute}`,
425
+ });
426
+ }
427
+ }
428
+ }
429
+ const bound = new Set();
430
+ for (const mapping of endpoint.mappings) {
431
+ bound.add(mappingTarget(mapping).name);
432
+ }
433
+ const seen = new Map();
434
+ for (const [i, mapping] of endpoint.mappings.entries()) {
435
+ const mappingPath = `${path}.mappings[${i}]`;
436
+ const key = mappingTarget(mapping).name;
437
+ const first = seen.get(key);
438
+ if (first !== undefined && mappingTarget(mapping).kind !== 'event') {
439
+ issues.push({
440
+ level: 'warning',
441
+ path: mappingPath,
442
+ message: `${key} is bound twice (also mappings[${first}])`,
443
+ });
444
+ }
445
+ else {
446
+ seen.set(key, i);
447
+ }
448
+ checkMapping(issues, mappingPath, endpoint, mapping, bound, clusters);
449
+ }
450
+ return issues;
451
+ }
452
+ /** validate a device: every endpoint, plus the device-level checks */
453
+ export function validateDevice(device) {
454
+ const issues = [];
455
+ for (const [i, endpoint] of device.endpoints.entries()) {
456
+ issues.push(...validateEndpoint(endpoint, `endpoints[${i}]`));
457
+ }
458
+ if (device.availability !== undefined) {
459
+ for (const [i, topic] of device.availability.topics.entries()) {
460
+ if (topic.online === topic.offline) {
461
+ issues.push({
462
+ level: 'error',
463
+ path: `availability.topics[${i}]`,
464
+ message: 'online and offline payloads are the same',
465
+ });
466
+ }
467
+ }
468
+ }
469
+ const errors = issues.filter((i) => i.level === 'error');
470
+ const warnings = issues.filter((i) => i.level === 'warning');
471
+ return { issues, errors, warnings, ok: errors.length === 0 };
472
+ }
473
+ /** validate every device of a config: device key → result (only devices with issues) */
474
+ export function validateDevices(devices) {
475
+ const results = new Map();
476
+ for (const [key, device] of Object.entries(devices)) {
477
+ const result = validateDevice(device);
478
+ if (result.issues.length > 0) {
479
+ results.set(key, result);
480
+ }
481
+ }
482
+ return results;
483
+ }
484
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/model/validate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import { EventEmitter } from 'node:events';
2
+ import type { Logger } from '../log.ts';
3
+ import { TopicCache } from './topic-cache.ts';
4
+ export interface MqttOptions {
5
+ url: string;
6
+ username?: string | undefined;
7
+ password?: string | undefined;
8
+ clientId?: string | undefined;
9
+ /** ms between reconnects (mqtt.js default 1000) */
10
+ reconnectPeriod?: number;
11
+ /** ms to wait for the first connection in `connect()`; default 30 s */
12
+ connectTimeout?: number;
13
+ }
14
+ export interface PublishOptions {
15
+ retain?: boolean;
16
+ qos?: 0 | 1 | 2;
17
+ }
18
+ export interface MqttEvents {
19
+ connect: [];
20
+ close: [];
21
+ error: [Error];
22
+ message: [topic: string, payload: Buffer, retain: boolean];
23
+ }
24
+ export declare class MqttClient extends EventEmitter<MqttEvents> {
25
+ readonly cache: TopicCache;
26
+ private readonly options;
27
+ private readonly log;
28
+ private client;
29
+ private readonly subscriptions;
30
+ constructor(options: MqttOptions, log: Logger);
31
+ get connected(): boolean;
32
+ /** connect and resolve on the first CONNACK; rejects after `connectTimeout` or on a refused connection */
33
+ connect(): Promise<void>;
34
+ /** subscribe once; mqtt.js re-subscribes after a reconnect (clean session, so we keep the list ourselves too) */
35
+ subscribe(topic: string): Promise<void>;
36
+ publish(topic: string, payload: string | Buffer, options?: PublishOptions): Promise<void>;
37
+ close(): Promise<void>;
38
+ }
@@ -0,0 +1,94 @@
1
+ /* The MQTT connection: mqtt.js with reconnect, the subscriptions it re-establishes itself, a message
2
+ event with the raw payload, and the topic cache fed with everything that arrives. */
3
+ import { EventEmitter } from 'node:events';
4
+ import mqtt, {} from 'mqtt';
5
+ import { TopicCache } from "./topic-cache.js";
6
+ export class MqttClient extends EventEmitter {
7
+ cache = new TopicCache();
8
+ options;
9
+ log;
10
+ client;
11
+ subscriptions = new Set();
12
+ constructor(options, log) {
13
+ super();
14
+ this.options = options;
15
+ this.log = log;
16
+ }
17
+ get connected() {
18
+ return this.client?.connected ?? false;
19
+ }
20
+ /** connect and resolve on the first CONNACK; rejects after `connectTimeout` or on a refused connection */
21
+ async connect() {
22
+ if (this.client !== undefined) {
23
+ return;
24
+ }
25
+ const clientOptions = {
26
+ clientId: this.options.clientId ?? `mqtt2matter_${Math.random().toString(16).slice(2, 10)}`,
27
+ reconnectPeriod: this.options.reconnectPeriod ?? 1000,
28
+ clean: true,
29
+ };
30
+ if (this.options.username !== undefined) {
31
+ clientOptions.username = this.options.username;
32
+ }
33
+ if (this.options.password !== undefined) {
34
+ clientOptions.password = this.options.password;
35
+ }
36
+ const client = mqtt.connect(this.options.url, clientOptions);
37
+ this.client = client;
38
+ client.on('connect', () => {
39
+ this.log.info(`connected to ${this.options.url}`);
40
+ this.emit('connect');
41
+ });
42
+ client.on('close', () => {
43
+ this.log.warn(`connection to ${this.options.url} closed`);
44
+ this.emit('close');
45
+ });
46
+ client.on('error', (error) => {
47
+ this.log.error('mqtt error', error);
48
+ this.emit('error', error);
49
+ });
50
+ client.on('message', (topic, payload, packet) => {
51
+ this.cache.store(topic, payload, packet.retain);
52
+ this.emit('message', topic, payload, packet.retain);
53
+ });
54
+ await new Promise((resolve, reject) => {
55
+ const timeout = setTimeout(() => {
56
+ reject(new Error(`no connection to ${this.options.url} within ${this.options.connectTimeout ?? 30_000} ms`));
57
+ }, this.options.connectTimeout ?? 30_000);
58
+ client.once('connect', () => {
59
+ clearTimeout(timeout);
60
+ resolve();
61
+ });
62
+ client.once('error', (error) => {
63
+ clearTimeout(timeout);
64
+ reject(error);
65
+ });
66
+ });
67
+ }
68
+ /** subscribe once; mqtt.js re-subscribes after a reconnect (clean session, so we keep the list ourselves too) */
69
+ async subscribe(topic) {
70
+ if (this.subscriptions.has(topic)) {
71
+ return;
72
+ }
73
+ this.subscriptions.add(topic);
74
+ if (this.client === undefined) {
75
+ return;
76
+ }
77
+ await this.client.subscribeAsync(topic);
78
+ this.log.debug(`subscribed ${topic}`);
79
+ }
80
+ async publish(topic, payload, options = {}) {
81
+ if (this.client === undefined) {
82
+ throw new Error('not connected');
83
+ }
84
+ await this.client.publishAsync(topic, payload, { retain: options.retain ?? false, qos: options.qos ?? 0 });
85
+ }
86
+ async close() {
87
+ const client = this.client;
88
+ this.client = undefined;
89
+ if (client !== undefined) {
90
+ await client.endAsync();
91
+ }
92
+ }
93
+ }
94
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mqtt/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from './client.ts';
2
+ export * from './topic-cache.ts';
@@ -0,0 +1,3 @@
1
+ export * from "./client.js";
2
+ export * from "./topic-cache.js";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mqtt/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}