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":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export declare const UPDATE_REQUEST = "request";
2
+ export declare const UPDATE_LOG = "update.log";
3
+ export declare const PACKAGE = "mqtt2matter";
4
+ export declare const VERSION_PATTERN: RegExp;
5
+ export interface UpdateHost {
6
+ /** run the installer; resolves with its exit code; its output goes to `log` */
7
+ install(version: string, log: (text: string) => void): Promise<number>;
8
+ /** restart the service onto the new version */
9
+ restart(): void;
10
+ }
11
+ /** take the request, install the version, restart; the exit code for systemd */
12
+ export declare function applyUpdate(dir: string, host: UpdateHost): Promise<number>;
13
+ /** the real host: npm next to this node, systemctl */
14
+ export declare function systemUpdateHost(npm: string): UpdateHost;
@@ -0,0 +1,109 @@
1
+ /* `mqtt2matter --apply-update`: the root side of the update from the UI.
2
+
3
+ The service runs as an unprivileged user and cannot write the global npm prefix (/usr/local/lib). So the UI's
4
+ "Update" only writes the wanted version into a request file in the service's state directory; a systemd path
5
+ unit that `--install` sets up (`mqtt2matter-update.path`, PathExists=) starts `mqtt2matter-update.service`, a
6
+ root oneshot that runs this command: it takes the request, installs exactly `mqtt2matter@<version>` from the
7
+ registry with npm, logs into the same directory for the UI, and restarts mqtt2matter.service. No sudo rule, no
8
+ polkit: the only thing the service user can ask for is a version string of the one package.
9
+
10
+ The directory belongs to the service user, so nothing in it is trusted: the request is opened without following
11
+ a symlink and must be a short regular file with a version in it; the log is created anew (O_EXCL), never written
12
+ through a link. */
13
+ import { execFileSync, spawn } from 'node:child_process';
14
+ import { constants } from 'node:fs';
15
+ import { open, unlink } from 'node:fs/promises';
16
+ import { join } from 'node:path';
17
+ export const UPDATE_REQUEST = 'request';
18
+ export const UPDATE_LOG = 'update.log';
19
+ export const PACKAGE = 'mqtt2matter';
20
+ export const VERSION_PATTERN = /^\d{1,6}\.\d{1,6}\.\d{1,6}(?:-[0-9A-Za-z.-]{1,40})?$/;
21
+ /** the request's version, or an error; the request is gone afterwards either way */
22
+ async function takeRequest(dir) {
23
+ const path = join(dir, UPDATE_REQUEST);
24
+ let handle;
25
+ try {
26
+ handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
27
+ }
28
+ catch (error) {
29
+ await unlink(path).catch(() => undefined);
30
+ throw new Error(`no readable request (${error.code ?? 'error'})`, { cause: error });
31
+ }
32
+ try {
33
+ const info = await handle.stat();
34
+ if (!info.isFile() || info.size > 64) {
35
+ throw new Error('the request is not a short regular file');
36
+ }
37
+ return (await handle.readFile('utf8')).trim();
38
+ }
39
+ finally {
40
+ await handle.close();
41
+ await unlink(path).catch(() => undefined);
42
+ }
43
+ }
44
+ /** take the request, install the version, restart; the exit code for systemd */
45
+ export async function applyUpdate(dir, host) {
46
+ const logPath = join(dir, UPDATE_LOG);
47
+ await unlink(logPath).catch(() => undefined);
48
+ // O_EXCL: a link planted after the unlink makes this fail instead of writing through it
49
+ const log = await open(logPath, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o644);
50
+ let pending = Promise.resolve();
51
+ const write = (text) => {
52
+ pending = pending.then(() => log.write(text.endsWith('\n') ? text : `${text}\n`));
53
+ };
54
+ try {
55
+ let version;
56
+ try {
57
+ version = await takeRequest(dir);
58
+ }
59
+ catch (error) {
60
+ write(`refused: ${error.message}`);
61
+ return 1;
62
+ }
63
+ if (!VERSION_PATTERN.test(version)) {
64
+ write('refused: the request holds no version');
65
+ return 1;
66
+ }
67
+ write(`installing ${PACKAGE}@${version}`);
68
+ const code = await host.install(version, write);
69
+ if (code !== 0) {
70
+ write(`failed: npm exited with ${code}; ${PACKAGE} keeps running the old version`);
71
+ return 1;
72
+ }
73
+ write(`installed ${PACKAGE}@${version}; restarting`);
74
+ host.restart();
75
+ return 0;
76
+ }
77
+ finally {
78
+ await pending.catch(() => undefined);
79
+ await log.close();
80
+ }
81
+ }
82
+ /** the real host: npm next to this node, systemctl */
83
+ export function systemUpdateHost(npm) {
84
+ return {
85
+ install: (version, log) => new Promise((resolve) => {
86
+ const child = spawn(npm, ['install', '--global', '--no-audit', '--no-fund', `${PACKAGE}@${version}`], {
87
+ stdio: ['ignore', 'pipe', 'pipe'],
88
+ });
89
+ child.stdout.on('data', (chunk) => {
90
+ log(chunk.toString('utf8'));
91
+ });
92
+ child.stderr.on('data', (chunk) => {
93
+ log(chunk.toString('utf8'));
94
+ });
95
+ child.on('error', (error) => {
96
+ log(`npm: ${error.message}`);
97
+ resolve(127);
98
+ });
99
+ child.on('close', (code) => {
100
+ resolve(code ?? 1);
101
+ });
102
+ }),
103
+ restart: () => {
104
+ // --no-block: queue the restart and return; this oneshot must not wait for the service it restarts
105
+ execFileSync('systemctl', ['--no-block', 'restart', `${PACKAGE}.service`], { stdio: 'ignore' });
106
+ },
107
+ };
108
+ }
109
+ //# sourceMappingURL=update.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from './schema.ts';
2
+ export * from './load.ts';
@@ -0,0 +1,3 @@
1
+ export * from "./schema.js";
2
+ export * from "./load.js";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
@@ -0,0 +1,57 @@
1
+ import { type Config } from './schema.ts';
2
+ export declare const DEFAULT_CONFIG_FILE = "mqtt2matter.json";
3
+ /** the environment variables and the config paths they override */
4
+ export declare const ENV: {
5
+ /** the config file; also the first command line argument */
6
+ readonly MQTT2MATTER_CONFIG: "config file";
7
+ readonly MQTT2MATTER_MQTT_URL: "mqtt.url";
8
+ readonly MQTT2MATTER_MQTT_USERNAME: "mqtt.username";
9
+ readonly MQTT2MATTER_MQTT_PASSWORD: "mqtt.password";
10
+ readonly MQTT2MATTER_MQTT_CLIENT_ID: "mqtt.clientId";
11
+ readonly MQTT2MATTER_STORAGE: "storage";
12
+ readonly MQTT2MATTER_LOG_LEVEL: "log.level";
13
+ readonly MQTT2MATTER_MATTER_LOG_LEVEL: "log.matter";
14
+ readonly MQTT2MATTER_SERVER_HOST: "server.host";
15
+ readonly MQTT2MATTER_SERVER_PORT: "server.port";
16
+ readonly MQTT2MATTER_AUTH: "server.auth.mode";
17
+ readonly MQTT2MATTER_AUTH_PASSWORD: "server.auth.password";
18
+ readonly MQTT2MATTER_AUTH_PROXY_HEADER: "server.auth.proxyHeader";
19
+ readonly MQTT2MATTER_AUTH_PROXY_LOGOUT_URL: "server.auth.proxyLogoutUrl";
20
+ };
21
+ export type Env = Record<string, string | undefined>;
22
+ export declare class ConfigError extends Error {
23
+ constructor(message: string);
24
+ }
25
+ /** the config paths the environment sets */
26
+ export declare function envOverrides(env: Env): string[];
27
+ /** a copy of `raw` with the environment's overrides written in */
28
+ export declare function applyEnv(raw: unknown, env: Env): Record<string, unknown>;
29
+ /** validate a raw object; the error message lists every problem with its path */
30
+ export declare function parseConfig(raw: unknown): Config;
31
+ /** the config file to read: the first argument, else the environment, else the default in the cwd */
32
+ export declare function configPath(argv: readonly string[], env: Env): {
33
+ path: string;
34
+ explicit: boolean;
35
+ };
36
+ export interface LoadOptions {
37
+ /** the file; default: `configPath(process.argv, process.env)` */
38
+ path?: string;
39
+ /** a missing file is an error (true) or an empty configuration (false, the default for the default path) */
40
+ explicit?: boolean;
41
+ env?: Env;
42
+ }
43
+ export interface Loaded {
44
+ config: Config;
45
+ path: string;
46
+ /** false when the file did not exist and the defaults were used */
47
+ fromFile: boolean;
48
+ /** the file's content as written, without the environment and without defaults — what an editor saves back */
49
+ raw: Record<string, unknown>;
50
+ /** the config paths the environment overrides (`mqtt.url`), which an editor must not write back */
51
+ overridden: string[];
52
+ /** the devices brought from an earlier format to the current one in `raw`; the file is unchanged until saved */
53
+ migrated: string[];
54
+ }
55
+ /** bring a raw file content written by an earlier version to the current format, in place; the migrated devices */
56
+ export declare function migrateRaw(raw: Record<string, unknown>): string[];
57
+ export declare function loadConfig(options?: LoadOptions): Promise<Loaded>;
@@ -0,0 +1,137 @@
1
+ /* Loading the configuration: a JSON file, then the environment on top of it. The environment wins
2
+ because that is how a container is configured; the file is what the UI edits. */
3
+ import { readFile } from 'node:fs/promises';
4
+ import { resolve } from 'node:path';
5
+ import { z } from 'zod';
6
+ import { migrateDevices } from "../model/migrate.js";
7
+ import { ConfigSchema } from "./schema.js";
8
+ export const DEFAULT_CONFIG_FILE = 'mqtt2matter.json';
9
+ /** the environment variables and the config paths they override */
10
+ export const ENV = {
11
+ /** the config file; also the first command line argument */
12
+ MQTT2MATTER_CONFIG: 'config file',
13
+ MQTT2MATTER_MQTT_URL: 'mqtt.url',
14
+ MQTT2MATTER_MQTT_USERNAME: 'mqtt.username',
15
+ MQTT2MATTER_MQTT_PASSWORD: 'mqtt.password',
16
+ MQTT2MATTER_MQTT_CLIENT_ID: 'mqtt.clientId',
17
+ MQTT2MATTER_STORAGE: 'storage',
18
+ MQTT2MATTER_LOG_LEVEL: 'log.level',
19
+ MQTT2MATTER_MATTER_LOG_LEVEL: 'log.matter',
20
+ MQTT2MATTER_SERVER_HOST: 'server.host',
21
+ MQTT2MATTER_SERVER_PORT: 'server.port',
22
+ MQTT2MATTER_AUTH: 'server.auth.mode',
23
+ MQTT2MATTER_AUTH_PASSWORD: 'server.auth.password',
24
+ MQTT2MATTER_AUTH_PROXY_HEADER: 'server.auth.proxyHeader',
25
+ MQTT2MATTER_AUTH_PROXY_LOGOUT_URL: 'server.auth.proxyLogoutUrl',
26
+ };
27
+ /** the environment paths whose values are numbers in the schema */
28
+ const NUMERIC_PATHS = new Set(['server.port']);
29
+ export class ConfigError extends Error {
30
+ constructor(message) {
31
+ super(message);
32
+ this.name = 'ConfigError';
33
+ }
34
+ }
35
+ function isRecord(value) {
36
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
37
+ }
38
+ function setPath(target, path, value) {
39
+ const keys = path.split('.');
40
+ const last = keys.pop() ?? path;
41
+ let cursor = target;
42
+ for (const key of keys) {
43
+ const next = cursor[key];
44
+ if (!isRecord(next)) {
45
+ cursor[key] = {};
46
+ }
47
+ cursor = cursor[key];
48
+ }
49
+ cursor[last] = value;
50
+ }
51
+ /** the config paths the environment sets */
52
+ export function envOverrides(env) {
53
+ const paths = [];
54
+ for (const [name, path] of Object.entries(ENV)) {
55
+ const value = env[name];
56
+ if (path !== 'config file' && value !== undefined && value !== '') {
57
+ paths.push(path);
58
+ }
59
+ }
60
+ return paths;
61
+ }
62
+ /** a copy of `raw` with the environment's overrides written in */
63
+ export function applyEnv(raw, env) {
64
+ const result = isRecord(raw) ? structuredClone(raw) : {};
65
+ for (const [name, path] of Object.entries(ENV)) {
66
+ if (path === 'config file') {
67
+ continue;
68
+ }
69
+ const value = env[name];
70
+ if (value !== undefined && value !== '') {
71
+ setPath(result, path, NUMERIC_PATHS.has(path) && /^\d+$/.test(value) ? Number(value) : value);
72
+ }
73
+ }
74
+ return result;
75
+ }
76
+ /** validate a raw object; the error message lists every problem with its path */
77
+ export function parseConfig(raw) {
78
+ const result = ConfigSchema.safeParse(raw);
79
+ if (!result.success) {
80
+ throw new ConfigError(`invalid configuration:\n${z.prettifyError(result.error)}`);
81
+ }
82
+ return result.data;
83
+ }
84
+ /** the config file to read: the first argument, else the environment, else the default in the cwd */
85
+ export function configPath(argv, env) {
86
+ const fromArgs = argv[2];
87
+ if (fromArgs !== undefined && fromArgs !== '') {
88
+ return { path: resolve(fromArgs), explicit: true };
89
+ }
90
+ const fromEnv = env.MQTT2MATTER_CONFIG;
91
+ if (fromEnv !== undefined && fromEnv !== '') {
92
+ return { path: resolve(fromEnv), explicit: true };
93
+ }
94
+ return { path: resolve(DEFAULT_CONFIG_FILE), explicit: false };
95
+ }
96
+ /** bring a raw file content written by an earlier version to the current format, in place; the migrated devices */
97
+ export function migrateRaw(raw) {
98
+ return migrateDevices(raw.devices);
99
+ }
100
+ export async function loadConfig(options = {}) {
101
+ const env = options.env ?? process.env;
102
+ const located = options.path === undefined ? configPath(process.argv, env) : { path: options.path, explicit: true };
103
+ const explicit = options.explicit ?? located.explicit;
104
+ let raw = {};
105
+ let fromFile = false;
106
+ try {
107
+ const text = await readFile(located.path, 'utf8');
108
+ try {
109
+ raw = JSON.parse(text);
110
+ }
111
+ catch (error) {
112
+ throw new ConfigError(`${located.path} is not valid JSON: ${error.message}`);
113
+ }
114
+ fromFile = true;
115
+ }
116
+ catch (error) {
117
+ if (error instanceof ConfigError) {
118
+ throw error;
119
+ }
120
+ if (error.code !== 'ENOENT' || explicit) {
121
+ throw new ConfigError(`cannot read ${located.path}: ${error.message}`);
122
+ }
123
+ }
124
+ if (fromFile && !isRecord(raw)) {
125
+ throw new ConfigError(`${located.path} must hold a JSON object`);
126
+ }
127
+ const migrated = isRecord(raw) ? migrateRaw(raw) : [];
128
+ return {
129
+ config: parseConfig(applyEnv(raw, env)),
130
+ path: located.path,
131
+ fromFile,
132
+ raw: isRecord(raw) ? raw : {},
133
+ overridden: envOverrides(env),
134
+ migrated,
135
+ };
136
+ }
137
+ //# sourceMappingURL=load.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"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"}