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 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import { RESTART_EXIT_CODE } from '../commands/install.ts';
2
+ export { RESTART_EXIT_CODE };
3
+ /** the registry's latest version; undefined when the package is not published */
4
+ export type FetchLatest = () => Promise<string | undefined>;
5
+ export declare const npmLatest: FetchLatest;
6
+ /** -1, 0, 1 over x.y.z; a pre-release sorts before its release */
7
+ export declare function compareVersions(a: string, b: string): number;
8
+ export interface UpdaterOptions {
9
+ current: string;
10
+ /** `systemd` when the unit restarts the process on RESTART_EXIT_CODE */
11
+ supervisor?: string | undefined;
12
+ /** where the update request goes (the path unit watches it) */
13
+ updateDir?: string | undefined;
14
+ fetchLatest?: FetchLatest;
15
+ now?: () => number;
16
+ }
17
+ export interface UpdateStatus {
18
+ current: string;
19
+ /** the registry's latest; absent when not published or not checked */
20
+ latest?: string;
21
+ published: boolean | undefined;
22
+ newer: boolean;
23
+ checkedAt?: string;
24
+ error?: string;
25
+ restart: {
26
+ available: boolean;
27
+ reason?: string;
28
+ };
29
+ update: {
30
+ available: boolean;
31
+ reason?: string;
32
+ requested?: string;
33
+ log: string[];
34
+ };
35
+ }
36
+ export declare class Updater {
37
+ private readonly options;
38
+ private readonly fetchLatest;
39
+ private readonly now;
40
+ private latest;
41
+ private published;
42
+ private checkedAt;
43
+ private error;
44
+ private checking;
45
+ constructor(options: UpdaterOptions);
46
+ get restartReason(): string | undefined;
47
+ /** the latest version seen, without asking the registry (for /api/status) */
48
+ get known(): {
49
+ latest?: string;
50
+ newer: boolean;
51
+ };
52
+ /** ask the registry when the last answer is older than the interval (or `force`) */
53
+ check(force?: boolean): Promise<void>;
54
+ private updateReason;
55
+ private readLog;
56
+ private pending;
57
+ status(): Promise<UpdateStatus>;
58
+ /** write the request for the root helper; the reason it cannot be done, or undefined */
59
+ request(version: string): Promise<string | undefined>;
60
+ }
@@ -0,0 +1,191 @@
1
+ /* Restart and update from the UI.
2
+
3
+ - Restart: under systemd (`--install` writes `MQTT2MATTER_SUPERVISOR=systemd` and `RestartForceExitStatus=75`
4
+ into the unit) the process stops cleanly and exits with 75, and systemd starts it again. Anywhere else there
5
+ is nothing that would bring it back, so the UI says so instead of exiting.
6
+ - Update: the registry's `latest` of the package, checked at most every few hours; "not published" while there
7
+ is none. Installing needs root (the global npm prefix), so the service writes the version into the request
8
+ file of `MQTT2MATTER_UPDATE_DIR`; the root oneshot `mqtt2matter --apply-update` (commands/update.ts), started
9
+ by the path unit `--install` sets up, installs it, logs into the same directory and restarts the service. */
10
+ import { readFile, rename, stat, writeFile } from 'node:fs/promises';
11
+ import { join } from 'node:path';
12
+ import { RESTART_EXIT_CODE } from "../commands/install.js";
13
+ import { PACKAGE, UPDATE_LOG, UPDATE_REQUEST, VERSION_PATTERN } from "../commands/update.js";
14
+ export { RESTART_EXIT_CODE };
15
+ const CHECK_INTERVAL_MS = 6 * 3600 * 1000;
16
+ export const npmLatest = async () => {
17
+ const response = await fetch(`https://registry.npmjs.org/${PACKAGE}/latest`, {
18
+ headers: { accept: 'application/json' },
19
+ signal: AbortSignal.timeout(10_000),
20
+ });
21
+ if (response.status === 404) {
22
+ return undefined;
23
+ }
24
+ if (!response.ok) {
25
+ throw new Error(`the registry answered ${response.status}`);
26
+ }
27
+ const body = (await response.json());
28
+ return typeof body.version === 'string' ? body.version : undefined;
29
+ };
30
+ /** -1, 0, 1 over x.y.z; a pre-release sorts before its release */
31
+ export function compareVersions(a, b) {
32
+ const parse = (v) => {
33
+ const [core = '', pre = ''] = v.split('-', 2);
34
+ return [core.split('.').map((n) => Number(n) || 0), pre];
35
+ };
36
+ const [ca, pa] = parse(a);
37
+ const [cb, pb] = parse(b);
38
+ for (let i = 0; i < 3; i++) {
39
+ const d = (ca[i] ?? 0) - (cb[i] ?? 0);
40
+ if (d !== 0) {
41
+ return Math.sign(d);
42
+ }
43
+ }
44
+ if (pa === pb) {
45
+ return 0;
46
+ }
47
+ if (pa === '') {
48
+ return 1;
49
+ }
50
+ if (pb === '') {
51
+ return -1;
52
+ }
53
+ return pa < pb ? -1 : 1;
54
+ }
55
+ export class Updater {
56
+ options;
57
+ fetchLatest;
58
+ now;
59
+ latest;
60
+ published;
61
+ checkedAt;
62
+ error;
63
+ checking;
64
+ constructor(options) {
65
+ this.options = options;
66
+ this.fetchLatest = options.fetchLatest ?? npmLatest;
67
+ this.now = options.now ?? Date.now;
68
+ }
69
+ get restartReason() {
70
+ return this.options.supervisor === 'systemd'
71
+ ? undefined
72
+ : 'not running as the systemd service (mqtt2matter --install): nothing would start it again';
73
+ }
74
+ /** the latest version seen, without asking the registry (for /api/status) */
75
+ get known() {
76
+ return {
77
+ ...(this.latest === undefined ? {} : { latest: this.latest }),
78
+ newer: this.latest !== undefined && compareVersions(this.latest, this.options.current) > 0,
79
+ };
80
+ }
81
+ /** ask the registry when the last answer is older than the interval (or `force`) */
82
+ async check(force = false) {
83
+ if (!force && this.checkedAt !== undefined && this.now() - this.checkedAt < CHECK_INTERVAL_MS) {
84
+ return;
85
+ }
86
+ this.checking ??= (async () => {
87
+ try {
88
+ this.latest = await this.fetchLatest();
89
+ this.published = this.latest !== undefined;
90
+ this.error = undefined;
91
+ }
92
+ catch (error) {
93
+ this.error = error instanceof Error ? error.message : String(error);
94
+ }
95
+ finally {
96
+ this.checkedAt = this.now();
97
+ this.checking = undefined;
98
+ }
99
+ })();
100
+ await this.checking;
101
+ }
102
+ async updateReason() {
103
+ const dir = this.options.updateDir;
104
+ if (this.options.supervisor !== 'systemd' || dir === undefined) {
105
+ return 'installed without the systemd service (mqtt2matter --install): update with npm or deploy.sh';
106
+ }
107
+ try {
108
+ if (!(await stat(dir)).isDirectory()) {
109
+ return `${dir} is not a directory`;
110
+ }
111
+ }
112
+ catch {
113
+ return `${dir} is missing: run mqtt2matter --install again`;
114
+ }
115
+ return undefined;
116
+ }
117
+ async readLog() {
118
+ if (this.options.updateDir === undefined) {
119
+ return [];
120
+ }
121
+ try {
122
+ const text = await readFile(join(this.options.updateDir, UPDATE_LOG), 'utf8');
123
+ return text
124
+ .split('\n')
125
+ .filter((line) => line !== '')
126
+ .slice(-200);
127
+ }
128
+ catch {
129
+ return [];
130
+ }
131
+ }
132
+ async pending() {
133
+ if (this.options.updateDir === undefined) {
134
+ return undefined;
135
+ }
136
+ try {
137
+ return (await readFile(join(this.options.updateDir, UPDATE_REQUEST), 'utf8')).trim();
138
+ }
139
+ catch {
140
+ return undefined;
141
+ }
142
+ }
143
+ async status() {
144
+ const restartReason = this.restartReason;
145
+ const updateReason = await this.updateReason();
146
+ const requested = await this.pending();
147
+ return {
148
+ current: this.options.current,
149
+ ...(this.latest === undefined ? {} : { latest: this.latest }),
150
+ published: this.published,
151
+ newer: this.known.newer,
152
+ ...(this.checkedAt === undefined ? {} : { checkedAt: new Date(this.checkedAt).toISOString() }),
153
+ ...(this.error === undefined ? {} : { error: this.error }),
154
+ restart: {
155
+ available: restartReason === undefined,
156
+ ...(restartReason === undefined ? {} : { reason: restartReason }),
157
+ },
158
+ update: {
159
+ available: updateReason === undefined,
160
+ ...(updateReason === undefined ? {} : { reason: updateReason }),
161
+ ...(requested === undefined ? {} : { requested }),
162
+ log: await this.readLog(),
163
+ },
164
+ };
165
+ }
166
+ /** write the request for the root helper; the reason it cannot be done, or undefined */
167
+ async request(version) {
168
+ const reason = await this.updateReason();
169
+ if (reason !== undefined) {
170
+ return reason;
171
+ }
172
+ if (!VERSION_PATTERN.test(version)) {
173
+ return 'not a version';
174
+ }
175
+ if (this.latest === undefined) {
176
+ return this.published === false
177
+ ? `${PACKAGE} is not published on npm yet`
178
+ : 'no version known yet: check first';
179
+ }
180
+ if (version !== this.latest || compareVersions(version, this.options.current) <= 0) {
181
+ return `only the newer latest version ${this.latest} can be installed`;
182
+ }
183
+ const dir = this.options.updateDir ?? '';
184
+ const tmp = join(dir, `.${UPDATE_REQUEST}.${process.pid}`);
185
+ await writeFile(tmp, `${version}\n`, { mode: 0o640 });
186
+ // the rename makes the path unit see a complete file
187
+ await rename(tmp, join(dir, UPDATE_REQUEST));
188
+ return undefined;
189
+ }
190
+ }
191
+ //# sourceMappingURL=update.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/server/update.ts"],"names":[],"mappings":"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"}
package/docs/api.md ADDED
@@ -0,0 +1,128 @@
1
+ # The API
2
+
3
+ The web UI talks to the bridge through this API and nothing else; it is the contract between `ui/` and
4
+ `src/server/`. REST under `/api/`, JSON both ways; one WebSocket at `/api/events`. The server listens
5
+ on `server.host:server.port` (`0.0.0.0:8282` by default, see [config.md](config.md)) and serves the built
6
+ UI for every other path.
7
+
8
+ **Access** is `server.auth` ([config.md](config.md#access)): with `none` (the default) every route is open;
9
+ with `password` or `proxy` every route but the three under `/api/auth` answers `401` without a session cookie or
10
+ the proxy's header, and the WebSocket upgrade of `/api/events` is refused with `401`.
11
+
12
+ ## Authentication
13
+
14
+ | Route | Answer |
15
+ | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
16
+ | `GET /api/auth` | open; `{mode, authenticated, user?, logoutUrl?}` — `user` and `logoutUrl` in proxy mode |
17
+ | `POST /api/auth/login` | open; `{password}` → `{mode, authenticated: true}` and the session cookie `mqtt2matter_session`; `401` for a wrong password, `429` after ten failures from the address within 15 minutes, `400` outside password mode |
18
+ | `POST /api/auth/logout` | open; ends the session and clears the cookie |
19
+ | `PUT /api/auth` | `{mode, password?, proxyHeader?, proxyLogoutUrl?}`: the access settings, written to the file (the password as its hash) and applied at once; every session ends, the caller gets a new one in password mode. `400` for password mode without a password (none set before), `409` for proxy mode on a request without the header, or when the environment sets the mode |
20
+
21
+ ## Conventions
22
+
23
+ - A request body is JSON (`content-type: application/json`), at most 8 MB.
24
+ - A success is `200` with a JSON body, or `204` without one. An error is `4xx`/`5xx` with
25
+ `{"error": "<message>", "details"?: …}`; a device that does not parse comes back as `400` with
26
+ `details.issues: [{level, path, message}]`, the same shape the validator uses.
27
+ - Values matter.js hands out as bigints are strings in JSON; byte arrays are hex.
28
+ - A **device** in a request or response is a device entry of [config.md](config.md) — the parsed form
29
+ (every field present, defaults filled) in responses; a request may leave the defaults out. The file is
30
+ written in the compact form (no defaults).
31
+ - `:key` is a device key, `:id` a bridge id.
32
+
33
+ ## Status and configuration
34
+
35
+ | Route | Answer |
36
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
37
+ | `GET /api/status` | `{version, uptime (s), running, configPath, mqtt: {url, connected}, bridges: [bridge…], devices: n, importers: ["z2m", …], update: {latest?, newer}}` |
38
+ | `GET /api/config` | `{path, settings, overridden, effective}` — `settings` is the file's top level without `devices` (what the editor saves back), `overridden` the paths the environment sets (`["mqtt.url"]`), `effective` the running values with the MQTT password masked |
39
+ | `PUT /api/config` | body: the `settings` object (`mqtt`, `storage`, `log`, `vendorId`, `productId`, `bridges`, `server`, `presets`, `importers`); validated as a whole; `409` when a path the environment owns would change; answers `{saved: true, restartNeeded: true}` — settings apply at the next start |
40
+ | `GET /api/update` | `?check=1` asks the registry now (else at most every 6 hours); `{current, latest?, published, newer, checkedAt?, error?, restart: {available, reason?}, update: {available, reason?, requested?, log}}` — `published: false` while the package is not on npm, `log` the last lines of the update helper's log |
41
+ | `POST /api/update` | `{version}`: the registry's newer latest version only; writes the request the root helper takes (README "Restart and update from the UI"); `409` with the reason otherwise (not under the service, not published, not the latest) |
42
+ | `POST /api/restart` | `{restarting: true}`, then a clean stop with exit code 75, which the service's unit restarts on; `409` when not running as that service |
43
+
44
+ ## Devices
45
+
46
+ | Route | Answer |
47
+ | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
48
+ | `GET /api/devices` | `[{key, name, enabled, deviceTypes, endpoints: n, source, bridge, number, reachable, built, violations, errors, warnings}]` — `number` is the Matter endpoint number, `built` whether the endpoint exists in a bridge, `errors`/`warnings` the static validator's counts |
49
+ | `GET /api/devices/:key` | `{key, device, issues: [{level, path, message}], built, bridge, number, state}` — `issues` are the static ones plus the running endpoint's conformance violations; `state` as below, or absent when not built |
50
+ | `PUT /api/devices/:key` | body: the device. Creates or replaces: the file is written, the old endpoint (if any) is removed, the new one built and wired without a restart — the endpoint number stays with the key. A device with validation errors is saved but not built. Answers like `GET` |
51
+ | `DELETE /api/devices/:key` | removes the device from the file and the bridge; `204` |
52
+ | `GET /api/devices/:key/state` | `{<endpointId>: {number, state: {<Cluster>: {<attribute>: value}}}}` — the live Matter state of every endpoint of the device; `404` when not built |
53
+ | `POST /api/validate` | body `{device}`; answers `{ok, issues}` from the schema and the static validator, nothing is saved |
54
+ | `POST /api/check` | body `{}` for the whole configuration or `{devices: {<key>: device}}`; runs the strict dry run of `mqtt2matter --check` (a throw-away node, no network) and answers `{ok, devices: {<key>: issues[]}}` — only devices with issues are listed |
55
+
56
+ ## The mapping editor
57
+
58
+ | Route | Answer |
59
+ | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
60
+ | `POST /api/preview` | `{direction: "status", half, payload, attribute?, topic?}` → the payload through the status half's steps; `{direction: "command", half, value, attribute?, fields?}` → the value through the command half's. Answers `{ok, stages: [{step, ok, value?, reason?}], result?, reason?}`; the stages are `extract`, `template`, `map`, `unit`, `scale`, `attribute` (status) and `value`, `scale`, `format`, `wrap`, `payload` (command), only those the half uses. `attribute` (`Cluster.attribute`) gives the attribute's shape (enum names, bitmaps) |
61
+ | `POST /api/publish` | `{topic, payload, retain?, qos?}` → publishes; `{published: true}` |
62
+ | `GET /api/topics` | `?prefix=` optional; `[{topic, payload, retain, ts}]` — the topic cache: every topic seen on the subscriptions (`server.topics` plus the mappings'), payloads cut at 16 kB, sorted |
63
+
64
+ ## The catalogue
65
+
66
+ | Route | Answer |
67
+ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
68
+ | `GET /api/catalog` | `{deviceTypes: [{name, id, classification, clusters: [{cluster, mandatory, features}]}], clusters: [name…], composites: {"ColorControl.colorHs": {cluster, fields, features, description}, …}, units: [name…], eventChannels: ["Switch"]}` |
69
+ | `GET /api/catalog/clusters/:name` | `{name, id, features: [{code, title}], attributes: [{name, id, metatype, nullable, writable, enumMembers?, bitFields?, min?, max?, conformance}], commands: [{name, id, fields}], events: [name…]}` |
70
+
71
+ ## Presets
72
+
73
+ | Route | Answer |
74
+ | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
75
+ | `GET /api/presets` | `{presets: [{id, name, description, vendor, variables, shipped, file}], problems: [{file, message}]}` — the shipped presets and every `*.json` below the `presets` directories, read on each call |
76
+ | `POST /api/presets/:id/apply` | body `{values: {<variable>: "…"}}`; answers `{device, issues}` — the device the preset yields (`source.kind` `preset`), not saved: `PUT /api/devices/:key` saves it |
77
+
78
+ ## Bridges
79
+
80
+ | Route | Answer |
81
+ | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
82
+ | `GET /api/bridges` | `[{id, port, online, commissioned, pairingCodes: {manualPairingCode, qrPairingCode}, devices: n, fabrics: [{index, label, vendorId, nodeId, fabricId}], windowStatus}]` — `windowStatus` 0 closed, 1 enhanced window open, 2 basic window open |
83
+ | `POST /api/bridges/:id/commissioning` | `{open: true, minutes?}` opens a basic commissioning window with the bridge's passcode (≤ 15 minutes, the default); `{open: false}` closes it; answers the bridge |
84
+ | `DELETE /api/bridges/:id/fabrics/:index` | removes a fabric (the controller loses the bridge); `204` |
85
+
86
+ ## Adopt
87
+
88
+ The importers ([importers.md](importers.md)) describe devices from a source; the server subscribes their topics
89
+ (`zigbee2mqtt/bridge/devices`, `…/groups`, `homeassistant/#`), hands them every message, and asks them for the report over the
90
+ devices as they stand in the file. The server moves results into the file and the running bridge; the logic —
91
+ baseline, the user's edits, conflicts, orphaning — is the importer's.
92
+
93
+ | Route | Answer |
94
+ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
95
+ | `GET /api/adopt` | `{importers: [kind…], entries: [SyncEntry…]}` — the importer's `diff` over the file's devices; each entry is `{importer, key, kind: "device" \| "group", name, status, conflicts: [{path, user, before, now, applied}], edits, unmapped, notes, area?, native?, covered?, twins?}` with `status` one of `new`, `unchanged`, `updated`, `restored`, `orphaned`, `invalid`, `unsupported`, `covered`; `area` is the source's suggested area, `native` the key of another importer's native description of the same device, `covered` what covers a `covered` entry, `twins` the configured devices for the same physical device |
96
+ | `POST /api/adopt/resync` | runs `adopt` with every importer over the file (`resync: true`, `orphan: true`, no new keys): updated and restored devices take the new baseline with the user's edits reapplied, missing ones are marked `source.orphaned`; every device that changed is written and rebuilt. Answers `{importers, entries, written: [key…]}` |
97
+ | `POST /api/adopt/:kind/:key` | body `{force?, replace?}`; adopts one entry: a `new` one is added, an `updated` or `restored` one re-synced; nothing else is touched (`orphan: false`). A `covered` one (the same device as another importer's, see importers.md) is `409` with `details: {covered, twins}` unless `force: true`; `replace: true` also disables its twins. `409` for an `unsupported` or `invalid` entry, `404` for an unknown one. Answers the device like `GET /api/devices/:key` plus `entry` |
98
+
99
+ An orphaned device is never removed by the bridge: removing it is `DELETE /api/devices/:key`.
100
+
101
+ ## Import and export
102
+
103
+ | Route | Answer |
104
+ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
105
+ | `GET /api/export` | the configuration file as it is (`content-disposition: attachment`); `?device=<key>` gives `{<key>: device}` for one device |
106
+ | `POST /api/import` | `{devices: {<key>: device}}` or `{config: {devices: …}}`, with `replace: true` to drop every device not in the body; each device is validated first, then saved and built one by one; `{imported: n}` |
107
+
108
+ ## Log
109
+
110
+ | Route | Answer |
111
+ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
112
+ | `GET /api/log` | `?limit=500&after=<id>`; `[{id, ts, level, scope, message}]`, oldest first — the last 2000 lines of the bridge's own log (not matter.js') |
113
+
114
+ ## The event stream
115
+
116
+ `GET /api/events` upgrades to a WebSocket; every event is one JSON text frame. A client may send
117
+ `{"type": "subscribe", "mqtt": false}` to stop receiving MQTT events (and `true` to resume).
118
+
119
+ | Event | Fields | When |
120
+ | ------------ | ------------------------------------------ | -------------------------------------------------------------------- |
121
+ | `hello` | `version` | right after the connection |
122
+ | `mqtt` | `topic, payload, retain, ts` | every message on a subscribed topic (payload cut at 16 kB) |
123
+ | `attribute` | `key, endpoint, cluster, attribute, value` | an attribute of a device's endpoint changed (a status, a controller) |
124
+ | `log` | `entry: {id, ts, level, scope, message}` | a log line |
125
+ | `devices` | — | the device list changed (created, replaced, removed, imported) |
126
+ | `bridges` | — | commissioning state or fabrics changed, a window opened or closed |
127
+ | `discovered` | — | an importer's view of its source changed |
128
+ | `status` | `mqtt: boolean` | the broker connection came or went |
@@ -0,0 +1,121 @@
1
+ # Architecture
2
+
3
+ mqtt2matter is one package with internal module boundaries. The manual device model is the core;
4
+ everything else generates it (importers), renders it (UI) or runs it (engine, families, matter).
5
+
6
+ ```
7
+ src/
8
+ config/ the configuration file and the environment: schema, loading, defaults
9
+ model/ the manual model — devices, endpoints, mappings, family options — the @matter/model catalogue,
10
+ the static validator, the preset format
11
+ engine/ the payload engine (pure functions over the model's halves: extract, template, map, unit, scale,
12
+ wrap …), the Jinja templates, the mapping runtime (availability, expire, get, coalescing)
13
+ families/ cluster semantics that live in code: the servers that route controller commands, the status
14
+ hooks (colour composites, the cover's movement, fan consistency, battery levels), switch events
15
+ mqtt/ the broker connection and the topic cache (last payload per topic)
16
+ matter/ the node manager (n ≥ 1 bridges), one bridge = ServerNode + aggregator, the model-driven endpoint
17
+ builder, the strict dry run, ids, the shard map
18
+ importers/ foreign descriptions → model devices: patch.ts (baseline + edits), sync.ts (the report, the
19
+ re-sync, orphaning — shared), actions.ts (press kinds — shared), z2m/ (zigbee2mqtt), ha/ (Home
20
+ Assistant MQTT discovery) — docs/importers.md
21
+ commands/ the command line's subcommands beyond start and --check (`--import-z2m`, `--install`)
22
+ server/ node:http + ws: the REST API and the event stream of docs/api.md, the config file as the UI
23
+ edits it (compact, atomic writes), the catalogue as JSON, the preview of a mapping's halves,
24
+ the importers as the server runs them, the built UI as static files
25
+ app.ts wiring and lifecycle; devices are added and removed while it runs
26
+ main.ts the command line entry (`--check` is the dry run)
27
+ log.ts the leveled, scoped logger
28
+ ui/ the Svelte 5 app (Vite, TypeScript strict, svelte-check): built into ui/dist, served by
29
+ src/server; it talks to the server through docs/api.md only
30
+ ```
31
+
32
+ ## Data flow
33
+
34
+ MQTT message → `mqtt/` (cache) → `engine/runtime` finds the mappings on that topic → `engine/payload`
35
+ decodes (extract, template, map, type, unit, scale, offset, invert, round, then the attribute's shape from the
36
+ model: enum names, bitmap fields, integers) → the endpoint handle in `matter/` hands the value to the
37
+ cluster's family (a composite, a state machine) or sets the attribute.
38
+
39
+ Controller command → the family server in `families/` (e.g. `LevelControlServer.moveToLevelLogic`) →
40
+ `route()` finds the handler the runtime registered for the key → `engine/payload` encodes (numeric steps
41
+ inverted, format, template, wrap) → `mqtt/` publishes (coalesced per topic when the endpoint asks) → the family
42
+ applies the value locally only when the mapping is optimistic (its default without a status half, or without
43
+ a related one); otherwise the device's status report sets it.
44
+
45
+ Controller write of a writable attribute → matter.js applies it → the endpoint handle's observer sees the
46
+ change with an online context → the same handler publishes it → the family keeps the cluster consistent (a
47
+ fan's mode from its percent).
48
+
49
+ ## Dependency rules
50
+
51
+ Enforced by `no-restricted-imports` in `eslint.config.js` per folder:
52
+
53
+ - `importers/` depend on `model/` and `mqtt/` only — never on `matter/`, `families/`, `engine/`, `config/`,
54
+ `server/`. An importer writes `config.devices` entries with `source` metadata; the runtime does not know
55
+ where a device came from. `commands/` wires an importer to the configuration file and the broker for the
56
+ command line; the server does the same for the UI.
57
+ - `families/` depend on `engine/` outputs, `model/` and matter.js — never on an importer, config loading,
58
+ `mqtt/` or the server.
59
+ - `engine/` and `model/` are pure: no matter.js node, no MQTT, no files. They use `@matter/model` (the data
60
+ model) for lookups; the model's catalogue is the only place that reads it.
61
+ - `mqtt/` knows nothing above it.
62
+ - `server/` may use everything below it; `ui/` (outside `src/`, its own tsconfig, type-checked by svelte-check)
63
+ talks to `server/` through the documented REST/WS contract only — nothing from `src/` is imported there.
64
+
65
+ ## The model-driven endpoint
66
+
67
+ `matter/device-types.ts` builds an endpoint type from matter.js' own device definitions (every `*Device` it
68
+ ships, plus the utility `PowerSource`) and `@matter/model`: the first device type is the endpoint's type, the
69
+ others go into the Descriptor's device type list with their mandatory clusters; the clusters are the device
70
+ types' mandatory ones, the optional ones a mapping or the config names, and any other cluster a mapping names;
71
+ each cluster's server is the family's class (it routes commands) with the device type's alterations re-applied
72
+ (read off the requirement's schema: `remainingTime` mandatory on colour lights, `currentLevel` 1–254 on
73
+ dimmable ones), else matter.js' default; the features are the union of what the device type requires, what
74
+ the mappings imply and what the config asks for. `matter/cluster-defaults.ts` holds the few mandatory
75
+ attributes the model gives no default for. There is no table of device types.
76
+
77
+ ## Validation
78
+
79
+ Two layers: `model/validate.ts` checks a device statically against the model — device types,
80
+ clusters, attributes, features, conformance under the endpoint's features, map and format values against the
81
+ attribute's shape, templates — and the app refuses to build a device with errors; `matter/check.ts` builds every
82
+ device in a throw-away `ServerNode` of its own `Environment` with `endpoint.validation=strict` and memory
83
+ storage, never online, and reports what matter.js refuses plus the `DeviceTypeConformanceService`'s violations
84
+ (`mqtt2matter --check`). Production runs matter.js' `warn` mode and logs each endpoint's violations once.
85
+
86
+ ## Identity and persistence
87
+
88
+ - A device's key in `config.devices` is its Matter endpoint id. matter.js persists endpoint numbers per id,
89
+ so numbers survive restarts and config edits as long as the key stays. Renaming a device changes `name`,
90
+ never the key.
91
+ - Child endpoints are `<key>~<endpoint id>`, parts of the device's endpoint.
92
+ - `BridgedDeviceBasicInformation.uniqueId` is a hash of the bridge id and the device key.
93
+ - Each bridge is a `ServerNode` with its own id, storage directory (under `storage`), port, passcode and
94
+ discriminator; the mDNS service is shared process-wide. Passcode and discriminator are random on the
95
+ first start unless configured, and persisted in `storage/commissioning.json` (matter.js keeps none), so
96
+ the pairing code survives restarts.
97
+ - `storage/shards.json` maps device keys to bridge ids: written once, never rebalanced. 1.0 runs one
98
+ bridge; the map exists so the multi-bridge split (1.1) moves no device between nodes.
99
+
100
+ ## A rule learned the hard way
101
+
102
+ matter.js does not await every hook it calls: `WindowCoveringServer.handleMovement` and `handleStopMovement`
103
+ are workers; the command's transaction commits while they run. A behavior that writes `this.state` after an
104
+ `await` in such a hook hits a committed transaction, and that error is fatal for the whole node. Family code
105
+ writes through `endpoint.set()` (a transaction of its own) after any `await` in a hook it does not know to be
106
+ awaited; `lock()` + `this.state` is only for the hooks matter.js awaits (`on`/`off`, `moveToLevelLogic`, the
107
+ colour logic, `lockDoor`).
108
+
109
+ ## Testing
110
+
111
+ - Unit tests over the pure parts (engine steps, templates, units, the runtime with fakes, the validator,
112
+ presets, the endpoint builder, config, topic cache, shard map) with vitest.
113
+ - `test/check.test.ts` runs the strict dry run; `test/e2e.test.ts` and `test/families.e2e.test.ts` start an
114
+ in-process aedes broker on an ephemeral port and a real matter.js `ServerNode` on a free UDP port, drive it
115
+ through the node's own interaction API (`endpoint.act`) and, for attribute writes, emit the attribute's change
116
+ with an online context. Nothing binds a fixed port.
117
+ - `test/server.test.ts` runs the whole API against the real application (broker, node, the config file in a
118
+ temporary directory, the zigbee2mqtt importer with the test corpus); `ui/test/e2e/` are the Playwright
119
+ tests of the UI, against the same stack started by `ui/test/serve.ts` on an ephemeral port (the global
120
+ setup starts it and hands the address to the tests). The UI's own unit tests (`ui/src/**/*.test.ts`, run
121
+ with `ui/vitest.config.ts`) check among other things that every string has both languages.