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,20 @@
1
+ export interface CachedMessage {
2
+ topic: string;
3
+ payload: Buffer;
4
+ retain: boolean;
5
+ /** ms since epoch */
6
+ ts: number;
7
+ }
8
+ /** does `filter` (with `+` and `#`) match `topic`? */
9
+ export declare function topicMatches(filter: string, topic: string): boolean;
10
+ export declare class TopicCache {
11
+ private readonly messages;
12
+ private readonly limit;
13
+ constructor(limit?: number);
14
+ get size(): number;
15
+ store(topic: string, payload: Buffer, retain: boolean, ts?: number): CachedMessage;
16
+ get(topic: string): CachedMessage | undefined;
17
+ /** every cached message whose topic matches the filter */
18
+ match(filter: string): CachedMessage[];
19
+ topics(): string[];
20
+ }
@@ -0,0 +1,58 @@
1
+ /* The last payload per topic. The UI's live view and the importers read it; the runtime
2
+ does not need it, but every message passes through here so a mapping added later sees the retained
3
+ state at once. MQTT wildcard matching lives here too. */
4
+ /** does `filter` (with `+` and `#`) match `topic`? */
5
+ export function topicMatches(filter, topic) {
6
+ if (filter === topic) {
7
+ return true;
8
+ }
9
+ const f = filter.split('/');
10
+ const t = topic.split('/');
11
+ for (let i = 0; i < f.length; i++) {
12
+ const part = f[i];
13
+ if (part === '#') {
14
+ return true;
15
+ }
16
+ if (i >= t.length) {
17
+ return false;
18
+ }
19
+ if (part !== '+' && part !== t[i]) {
20
+ return false;
21
+ }
22
+ }
23
+ return f.length === t.length;
24
+ }
25
+ export class TopicCache {
26
+ messages = new Map();
27
+ limit;
28
+ constructor(limit = 10_000) {
29
+ this.limit = limit;
30
+ }
31
+ get size() {
32
+ return this.messages.size;
33
+ }
34
+ store(topic, payload, retain, ts = Date.now()) {
35
+ const message = { topic, payload, retain, ts };
36
+ if (!this.messages.has(topic) && this.messages.size >= this.limit) {
37
+ // the oldest entry goes; insertion order is the map's order
38
+ const oldest = this.messages.keys().next().value;
39
+ if (oldest !== undefined) {
40
+ this.messages.delete(oldest);
41
+ }
42
+ }
43
+ this.messages.delete(topic);
44
+ this.messages.set(topic, message);
45
+ return message;
46
+ }
47
+ get(topic) {
48
+ return this.messages.get(topic);
49
+ }
50
+ /** every cached message whose topic matches the filter */
51
+ match(filter) {
52
+ return [...this.messages.values()].filter((m) => topicMatches(filter, m.topic));
53
+ }
54
+ topics() {
55
+ return [...this.messages.keys()];
56
+ }
57
+ }
58
+ //# sourceMappingURL=topic-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"topic-cache.js","sourceRoot":"","sources":["../../src/mqtt/topic-cache.ts"],"names":[],"mappings":"AAAA;;2DAE2D;AAU3D,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAa;IACtD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,UAAU;IACF,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC5C,KAAK,CAAS;IAE/B,YAAY,KAAK,GAAG,MAAM;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAa,EAAE,OAAe,EAAE,MAAe,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QAClE,MAAM,OAAO,GAAkB,EAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChE,4DAA4D;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,KAAa;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,MAAc;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;CACJ"}
@@ -0,0 +1,59 @@
1
+ import type { IncomingMessage } from 'node:http';
2
+ export type AuthMode = 'none' | 'password' | 'proxy';
3
+ export interface AuthSettings {
4
+ mode: AuthMode;
5
+ password?: string | undefined;
6
+ proxyHeader: string;
7
+ proxyLogoutUrl?: string | undefined;
8
+ sessionHours: number;
9
+ }
10
+ export declare const COOKIE = "mqtt2matter_session";
11
+ export declare function isPasswordHash(value: string): boolean;
12
+ /** the stored form of a password */
13
+ export declare function hashPassword(password: string): Promise<string>;
14
+ export declare function verifyPassword(password: string, stored: string): Promise<boolean>;
15
+ export interface AuthState {
16
+ mode: AuthMode;
17
+ authenticated: boolean;
18
+ /** proxy mode: the user the proxy named */
19
+ user?: string;
20
+ /** proxy mode: where the UI sends a logout */
21
+ logoutUrl?: string;
22
+ }
23
+ export declare class Auth {
24
+ private settings;
25
+ /** the scrypt hash in password mode */
26
+ private hash;
27
+ /** session token → expiry (ms) */
28
+ private readonly sessions;
29
+ private readonly failures;
30
+ private readonly now;
31
+ private constructor();
32
+ /** a plain password in the settings is hashed here; `plain` says so, for a warning */
33
+ static create(settings: AuthSettings, now?: () => number): Promise<{
34
+ auth: Auth;
35
+ plain: boolean;
36
+ }>;
37
+ /** open to everyone: the default when no settings are given */
38
+ static open(): Auth;
39
+ get mode(): AuthMode;
40
+ /** the stored hash in password mode (kept when the mode is set again without a new password) */
41
+ get passwordHash(): string | undefined;
42
+ /** the running settings, the password masked */
43
+ view(): AuthSettings;
44
+ private proxyUser;
45
+ private validSession;
46
+ /** may this request use the API (and the event stream)? */
47
+ check(request: IncomingMessage): boolean;
48
+ state(request: IncomingMessage): AuthState;
49
+ /** too many failed logins from this address lately? */
50
+ throttled(address: string): boolean;
51
+ /** a session for the password, or undefined; a failure is counted against the address */
52
+ login(password: string, address: string): Promise<string | undefined>;
53
+ newSession(): string;
54
+ logout(request: IncomingMessage): void;
55
+ /** the Set-Cookie value for a session, or the one that clears it */
56
+ cookie(request: IncomingMessage, token: string | undefined): string;
57
+ /** apply new settings at once (the UI's access settings); every session ends, `hash` is already a hash */
58
+ reconfigure(settings: AuthSettings, hash: string | undefined): void;
59
+ }
@@ -0,0 +1,185 @@
1
+ /* Who may use the UI and its API. Three modes, as the maintainer's other web UIs have them:
2
+
3
+ - `none`: everyone who reaches the port (the default; keep the port on a trusted network);
4
+ - `password`: one password; a login answers an HttpOnly, SameSite=Strict session cookie; sessions live in
5
+ memory and end with the process, after `sessionHours`, or at a logout;
6
+ - `proxy`: a reverse proxy (nginx with authentik, Authelia, oauth2-proxy, …) authenticates and sets a
7
+ header with the user (`X-Remote-User`); a request without it is refused. Only safe when nothing but the
8
+ proxy reaches the port — bind `server.host` to 127.0.0.1 or firewall it.
9
+
10
+ The password is kept as an scrypt hash (node's own, no dependency): `scrypt$<N>$<r>$<p>$<salt>$<hash>`,
11
+ salt and hash base64. A plain string in the configuration is hashed at start and works too, with a warning. */
12
+ import { randomBytes, scrypt as scryptCallback, timingSafeEqual } from 'node:crypto';
13
+ export const COOKIE = 'mqtt2matter_session';
14
+ const KEY_LENGTH = 32;
15
+ const COST = { N: 16384, r: 8, p: 1 };
16
+ /** failed logins per address within the window before further attempts are refused */
17
+ const MAX_FAILURES = 10;
18
+ const FAILURE_WINDOW_MS = 15 * 60 * 1000;
19
+ function scrypt(password, salt, length, options) {
20
+ return new Promise((resolve, reject) => {
21
+ scryptCallback(password, salt, length, { ...options, maxmem: 64 * 1024 * 1024 }, (error, key) => {
22
+ if (error === null) {
23
+ resolve(key);
24
+ }
25
+ else {
26
+ reject(error);
27
+ }
28
+ });
29
+ });
30
+ }
31
+ export function isPasswordHash(value) {
32
+ return /^scrypt\$\d+\$\d+\$\d+\$[A-Za-z0-9+/=]+\$[A-Za-z0-9+/=]+$/.test(value);
33
+ }
34
+ /** the stored form of a password */
35
+ export async function hashPassword(password) {
36
+ const salt = randomBytes(16);
37
+ const key = await scrypt(password, salt, KEY_LENGTH, COST);
38
+ return `scrypt$${COST.N}$${COST.r}$${COST.p}$${salt.toString('base64')}$${key.toString('base64')}`;
39
+ }
40
+ export async function verifyPassword(password, stored) {
41
+ if (!isPasswordHash(stored)) {
42
+ return false;
43
+ }
44
+ const [, n, r, p, salt, hash] = stored.split('$');
45
+ const expected = Buffer.from(hash ?? '', 'base64');
46
+ const key = await scrypt(password, Buffer.from(salt ?? '', 'base64'), expected.length, {
47
+ N: Number(n),
48
+ r: Number(r),
49
+ p: Number(p),
50
+ });
51
+ return key.length === expected.length && timingSafeEqual(key, expected);
52
+ }
53
+ function cookieToken(request) {
54
+ const header = request.headers.cookie ?? '';
55
+ const match = new RegExp(`(?:^|;\\s*)${COOKIE}=([a-f0-9]{64})`).exec(header);
56
+ return match?.[1];
57
+ }
58
+ /** behind a TLS-terminating proxy the cookie gets `Secure` */
59
+ function isHttps(request) {
60
+ const forwarded = request.headers['x-forwarded-proto'];
61
+ const proto = Array.isArray(forwarded) ? forwarded[0] : forwarded;
62
+ return proto?.split(',')[0]?.trim() === 'https' || 'encrypted' in request.socket;
63
+ }
64
+ export class Auth {
65
+ settings;
66
+ /** the scrypt hash in password mode */
67
+ hash;
68
+ /** session token → expiry (ms) */
69
+ sessions = new Map();
70
+ failures = new Map();
71
+ now;
72
+ constructor(settings, hash, now) {
73
+ this.settings = settings;
74
+ this.hash = hash;
75
+ this.now = now;
76
+ }
77
+ /** a plain password in the settings is hashed here; `plain` says so, for a warning */
78
+ static async create(settings, now = Date.now) {
79
+ const password = settings.password;
80
+ const plain = password !== undefined && !isPasswordHash(password);
81
+ const hash = password === undefined ? undefined : plain ? await hashPassword(password) : password;
82
+ return { auth: new Auth(settings, hash, now), plain };
83
+ }
84
+ /** open to everyone: the default when no settings are given */
85
+ static open() {
86
+ return new Auth({ mode: 'none', proxyHeader: 'X-Remote-User', sessionHours: 24 * 7 }, undefined, Date.now);
87
+ }
88
+ get mode() {
89
+ return this.settings.mode;
90
+ }
91
+ /** the stored hash in password mode (kept when the mode is set again without a new password) */
92
+ get passwordHash() {
93
+ return this.hash;
94
+ }
95
+ /** the running settings, the password masked */
96
+ view() {
97
+ return { ...this.settings, password: this.hash === undefined ? undefined : '***' };
98
+ }
99
+ proxyUser(request) {
100
+ const value = request.headers[this.settings.proxyHeader.toLowerCase()];
101
+ const user = (Array.isArray(value) ? value[0] : value)?.trim();
102
+ return user === undefined || user === '' ? undefined : user;
103
+ }
104
+ validSession(request) {
105
+ const token = cookieToken(request);
106
+ if (token === undefined) {
107
+ return false;
108
+ }
109
+ const expires = this.sessions.get(token);
110
+ if (expires === undefined) {
111
+ return false;
112
+ }
113
+ if (expires < this.now()) {
114
+ this.sessions.delete(token);
115
+ return false;
116
+ }
117
+ return true;
118
+ }
119
+ /** may this request use the API (and the event stream)? */
120
+ check(request) {
121
+ switch (this.settings.mode) {
122
+ case 'none':
123
+ return true;
124
+ case 'proxy':
125
+ return this.proxyUser(request) !== undefined;
126
+ case 'password':
127
+ return this.validSession(request);
128
+ }
129
+ }
130
+ state(request) {
131
+ const state = { mode: this.settings.mode, authenticated: this.check(request) };
132
+ if (this.settings.mode === 'proxy') {
133
+ const user = this.proxyUser(request);
134
+ if (user !== undefined) {
135
+ state.user = user;
136
+ }
137
+ if (this.settings.proxyLogoutUrl !== undefined) {
138
+ state.logoutUrl = this.settings.proxyLogoutUrl;
139
+ }
140
+ }
141
+ return state;
142
+ }
143
+ /** too many failed logins from this address lately? */
144
+ throttled(address) {
145
+ const since = this.now() - FAILURE_WINDOW_MS;
146
+ const recent = (this.failures.get(address) ?? []).filter((at) => at > since);
147
+ this.failures.set(address, recent);
148
+ return recent.length >= MAX_FAILURES;
149
+ }
150
+ /** a session for the password, or undefined; a failure is counted against the address */
151
+ async login(password, address) {
152
+ const ok = this.hash !== undefined && (await verifyPassword(password, this.hash));
153
+ if (!ok) {
154
+ this.failures.set(address, [...(this.failures.get(address) ?? []), this.now()]);
155
+ return undefined;
156
+ }
157
+ this.failures.delete(address);
158
+ return this.newSession();
159
+ }
160
+ newSession() {
161
+ const token = randomBytes(32).toString('hex');
162
+ this.sessions.set(token, this.now() + this.settings.sessionHours * 3600 * 1000);
163
+ return token;
164
+ }
165
+ logout(request) {
166
+ const token = cookieToken(request);
167
+ if (token !== undefined) {
168
+ this.sessions.delete(token);
169
+ }
170
+ }
171
+ /** the Set-Cookie value for a session, or the one that clears it */
172
+ cookie(request, token) {
173
+ const secure = isHttps(request) ? '; Secure' : '';
174
+ return token === undefined
175
+ ? `${COOKIE}=; HttpOnly; SameSite=Strict; Path=/; Max-Age=0${secure}`
176
+ : `${COOKIE}=${token}; HttpOnly; SameSite=Strict; Path=/; Max-Age=${this.settings.sessionHours * 3600}${secure}`;
177
+ }
178
+ /** apply new settings at once (the UI's access settings); every session ends, `hash` is already a hash */
179
+ reconfigure(settings, hash) {
180
+ this.settings = settings;
181
+ this.hash = hash;
182
+ this.sessions.clear();
183
+ }
184
+ }
185
+ //# sourceMappingURL=auth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import { COMPOSITE_ATTRIBUTES } from '../model/catalog.ts';
2
+ export interface DeviceTypeJson {
3
+ name: string;
4
+ id: number;
5
+ classification: string;
6
+ clusters: {
7
+ cluster: string;
8
+ mandatory: boolean;
9
+ features: readonly string[];
10
+ }[];
11
+ }
12
+ export interface AttributeJson {
13
+ name: string;
14
+ id: number;
15
+ metatype: string;
16
+ nullable: boolean;
17
+ writable: boolean;
18
+ enumMembers?: Record<string, number>;
19
+ bitFields?: {
20
+ name: string;
21
+ bit: number;
22
+ }[];
23
+ min?: number;
24
+ max?: number;
25
+ /** `M` mandatory, `O` optional, `X` not applicable under the cluster's default features … */
26
+ conformance: string;
27
+ }
28
+ export interface ClusterJson {
29
+ name: string;
30
+ id: number;
31
+ features: {
32
+ code: string;
33
+ title: string;
34
+ }[];
35
+ attributes: AttributeJson[];
36
+ commands: {
37
+ name: string;
38
+ id: number;
39
+ fields: readonly string[];
40
+ }[];
41
+ events: readonly string[];
42
+ }
43
+ export declare function deviceTypesJson(): DeviceTypeJson[];
44
+ export declare function clusterNames(): string[];
45
+ export declare function clusterJson(name: string): ClusterJson;
46
+ export declare function catalogJson(): {
47
+ deviceTypes: DeviceTypeJson[];
48
+ clusters: string[];
49
+ composites: typeof COMPOSITE_ATTRIBUTES;
50
+ units: readonly string[];
51
+ eventChannels: string[];
52
+ };
@@ -0,0 +1,96 @@
1
+ /* The catalogue as JSON for the editor's pickers: device types with their cluster requirements, a
2
+ cluster's attributes (with type, range, enum members, bitmap fields, writability), commands and
3
+ events, the composite attributes the families own, the units. Everything comes from src/model, which
4
+ reads @matter/model. */
5
+ import { Matter } from '@matter/main/model';
6
+ import { COMPOSITE_ATTRIBUTES, cluster, deviceType, deviceTypeNames } from "../model/catalog.js";
7
+ import { UnitSchema } from "../model/schema.js";
8
+ import { HttpError } from "./http.js";
9
+ let deviceTypesCache;
10
+ export function deviceTypesJson() {
11
+ if (deviceTypesCache === undefined) {
12
+ deviceTypesCache = [];
13
+ for (const name of deviceTypeNames()) {
14
+ const info = deviceType(name);
15
+ if (info === undefined) {
16
+ continue;
17
+ }
18
+ deviceTypesCache.push({
19
+ name: info.name,
20
+ id: info.id,
21
+ classification: info.classification,
22
+ clusters: info.clusters.map((c) => ({
23
+ cluster: c.cluster,
24
+ mandatory: c.mandatory,
25
+ features: c.features,
26
+ })),
27
+ });
28
+ }
29
+ }
30
+ return deviceTypesCache;
31
+ }
32
+ export function clusterNames() {
33
+ return Matter.clusters
34
+ .filter((c) => c.id !== undefined)
35
+ .map((c) => c.name)
36
+ .sort();
37
+ }
38
+ const clusterCache = new Map();
39
+ function applicabilityCode(info, applicability) {
40
+ const value = applicability(info.features.map((f) => f.title));
41
+ return String(value);
42
+ }
43
+ export function clusterJson(name) {
44
+ const cached = clusterCache.get(name);
45
+ if (cached !== undefined) {
46
+ return cached;
47
+ }
48
+ const info = cluster(name);
49
+ if (info === undefined) {
50
+ throw new HttpError(404, `unknown cluster ${name}`);
51
+ }
52
+ const attributes = [];
53
+ for (const a of info.attributes.values()) {
54
+ const json = {
55
+ name: a.name,
56
+ id: a.id,
57
+ metatype: a.metatype,
58
+ nullable: a.nullable,
59
+ writable: a.writable,
60
+ conformance: applicabilityCode(info, (features) => a.applicability(features)),
61
+ };
62
+ if (a.enumMembers !== undefined) {
63
+ json.enumMembers = Object.fromEntries(a.enumMembers);
64
+ }
65
+ if (a.bitFields !== undefined) {
66
+ json.bitFields = [...a.bitFields];
67
+ }
68
+ if (a.min !== undefined) {
69
+ json.min = a.min;
70
+ }
71
+ if (a.max !== undefined) {
72
+ json.max = a.max;
73
+ }
74
+ attributes.push(json);
75
+ }
76
+ const json = {
77
+ name: info.name,
78
+ id: info.id,
79
+ features: info.features.map((f) => ({ code: f.code, title: f.title })),
80
+ attributes,
81
+ commands: [...info.commands.values()].map((c) => ({ name: c.name, id: c.id, fields: c.fields })),
82
+ events: info.events,
83
+ };
84
+ clusterCache.set(name, json);
85
+ return json;
86
+ }
87
+ export function catalogJson() {
88
+ return {
89
+ deviceTypes: deviceTypesJson(),
90
+ clusters: clusterNames(),
91
+ composites: COMPOSITE_ATTRIBUTES,
92
+ units: UnitSchema.options,
93
+ eventChannels: ['Switch'],
94
+ };
95
+ }
96
+ //# sourceMappingURL=catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/server/catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { DeviceConfig } from '../model/schema.ts';
2
+ /** the device entry for the file */
3
+ export declare function compactDevice(device: DeviceConfig): Record<string, unknown>;
@@ -0,0 +1,105 @@
1
+ /* A parsed device written back to the file without its defaults: the editor works on the parsed
2
+ entry (every field present), the file keeps what the user chose. Nothing semantic changes — the
3
+ compact entry parses to the same device. */
4
+ import { OptionsSchema } from "../model/options.js";
5
+ const OPTION_DEFAULTS = OptionsSchema.parse({});
6
+ function same(a, b) {
7
+ return JSON.stringify(a) === JSON.stringify(b);
8
+ }
9
+ function dropUndefined(value) {
10
+ return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
11
+ }
12
+ function compactStatus(half) {
13
+ const out = { ...half };
14
+ if (half.scale?.clamp === true) {
15
+ out.scale = { from: half.scale.from, to: half.scale.to };
16
+ }
17
+ if (half.get?.payload === '') {
18
+ out.get = { topic: half.get.topic };
19
+ }
20
+ return dropUndefined(out);
21
+ }
22
+ function compactCommand(half) {
23
+ const out = { ...half };
24
+ if (!half.retain) {
25
+ delete out.retain;
26
+ }
27
+ if (half.qos === 0) {
28
+ delete out.qos;
29
+ }
30
+ if (half.scale?.clamp === true) {
31
+ out.scale = { from: half.scale.from, to: half.scale.to };
32
+ }
33
+ return dropUndefined(out);
34
+ }
35
+ function compactEndpoint(endpoint, first) {
36
+ const out = { ...endpoint };
37
+ if (first && endpoint.id === 'main') {
38
+ delete out.id;
39
+ }
40
+ if (endpoint.mappings.length === 0) {
41
+ delete out.mappings;
42
+ }
43
+ else {
44
+ out.mappings = endpoint.mappings.map((mapping) => {
45
+ const b = { ...mapping };
46
+ if (mapping.status !== undefined) {
47
+ b.status = compactStatus(mapping.status);
48
+ }
49
+ if (mapping.command !== undefined) {
50
+ b.command = compactCommand(mapping.command);
51
+ }
52
+ return dropUndefined(b);
53
+ });
54
+ }
55
+ if (endpoint.coalesce === 0) {
56
+ delete out.coalesce;
57
+ }
58
+ const options = {};
59
+ for (const [family, values] of Object.entries(endpoint.options)) {
60
+ const defaults = OPTION_DEFAULTS[family] ?? {};
61
+ const kept = Object.fromEntries(Object.entries(values).filter(([k, v]) => !same(v, defaults[k])));
62
+ if (Object.keys(kept).length > 0) {
63
+ options[family] = kept;
64
+ }
65
+ }
66
+ if (Object.keys(options).length === 0) {
67
+ delete out.options;
68
+ }
69
+ else {
70
+ out.options = options;
71
+ }
72
+ return dropUndefined(out);
73
+ }
74
+ /** the device entry for the file */
75
+ export function compactDevice(device) {
76
+ const out = { ...device };
77
+ if (device.enabled) {
78
+ delete out.enabled;
79
+ }
80
+ if (same(device.source, { kind: 'manual' })) {
81
+ delete out.source;
82
+ }
83
+ else {
84
+ out.source = dropUndefined({ ...device.source, orphaned: device.source.orphaned === true ? true : undefined });
85
+ }
86
+ if (device.availability !== undefined) {
87
+ const topics = device.availability.topics.map((t) => {
88
+ const topic = { ...t };
89
+ if (t.online === 'online') {
90
+ delete topic.online;
91
+ }
92
+ if (t.offline === 'offline') {
93
+ delete topic.offline;
94
+ }
95
+ return dropUndefined(topic);
96
+ });
97
+ out.availability =
98
+ topics.length === 1 && device.availability.mode === 'latest'
99
+ ? topics[0]
100
+ : { mode: device.availability.mode, topics };
101
+ }
102
+ out.endpoints = device.endpoints.map((endpoint, index) => compactEndpoint(endpoint, index === 0));
103
+ return dropUndefined(out);
104
+ }
105
+ //# sourceMappingURL=compact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compact.js","sourceRoot":"","sources":["../../src/server/compact.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import { type Config } from '../config/schema.ts';
2
+ import { type DeviceConfig } from '../model/schema.ts';
3
+ export interface ConfigStoreOptions {
4
+ path: string;
5
+ raw: Record<string, unknown>;
6
+ config: Config;
7
+ /** config paths the environment overrides; a save that touches one is refused */
8
+ overridden?: readonly string[];
9
+ }
10
+ /** the top-level settings the UI edits (everything but the devices) */
11
+ export declare const SETTINGS_KEYS: readonly ["mqtt", "storage", "log", "vendorId", "productId", "bridges", "server", "presets", "importers"];
12
+ export declare class ConfigStore {
13
+ readonly path: string;
14
+ readonly raw: Record<string, unknown>;
15
+ readonly config: Config;
16
+ readonly overridden: readonly string[];
17
+ private writing;
18
+ constructor(options: ConfigStoreOptions);
19
+ /** the raw devices, as the file has them */
20
+ get rawDevices(): Record<string, unknown>;
21
+ rawDevice(key: string): unknown;
22
+ /** the raw settings (no devices), for the settings editor */
23
+ rawSettings(): Record<string, unknown>;
24
+ /** validate a raw device entry; the error names every problem with its path */
25
+ static parseDevice(raw: unknown): DeviceConfig;
26
+ static checkKey(key: string): void;
27
+ /** store a device raw and return it parsed; the file is written */
28
+ saveDevice(key: string, raw: unknown): Promise<DeviceConfig>;
29
+ deleteDevice(key: string): Promise<void>;
30
+ /** replace the top-level settings; the environment's paths must not change */
31
+ saveSettings(raw: unknown): Promise<Config>;
32
+ /** replace every device (an import with `replace`), raw; returns the parsed entries */
33
+ replaceDevices(raw: Record<string, unknown>): Promise<Map<string, DeviceConfig>>;
34
+ /** write the file atomically: a temporary file next to it, then a rename */
35
+ write(): Promise<void>;
36
+ }