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
package/dist/main.js ADDED
@@ -0,0 +1,202 @@
1
+ #!/usr/bin/env node
2
+ /* `mqtt2matter [config.json]`: load the configuration, start, stop on SIGINT/SIGTERM; the other commands are
3
+ in `commands/` and `matter/check.ts`. */
4
+ import { dirname, join } from 'node:path';
5
+ import { App, VERSION } from "./app.js";
6
+ import { importZ2m, parseImportArgs } from "./commands/import-z2m.js";
7
+ import { parseInstallArgs, runInstall, systemHost } from "./commands/install.js";
8
+ import { applyUpdate, systemUpdateHost } from "./commands/update.js";
9
+ import { ConfigError, loadConfig } from "./config/load.js";
10
+ import { createLogger, describeError } from "./log.js";
11
+ import { checkConfig, formatCheck } from "./matter/check.js";
12
+ import { Auth, ConfigStore, HaImporter, hashPassword, LogBuffer, RESTART_EXIT_CODE, Server, Updater, Z2mImporter, } from "./server/index.js";
13
+ /** how long a stop may take before the process exits anyway (the unit's TimeoutStopSec is 30 s) */
14
+ const STOP_TIMEOUT_MS = 20_000;
15
+ /** one line from stdin; on a terminal without echo */
16
+ async function readSecret(prompt) {
17
+ const stdin = process.stdin;
18
+ if (!stdin.isTTY) {
19
+ let text = '';
20
+ for await (const chunk of stdin) {
21
+ text += String(chunk);
22
+ }
23
+ return text.split(/\r?\n/)[0] ?? '';
24
+ }
25
+ process.stderr.write(prompt);
26
+ stdin.setRawMode(true);
27
+ stdin.resume();
28
+ stdin.setEncoding('utf8');
29
+ return new Promise((resolve, reject) => {
30
+ let value = '';
31
+ const done = (result) => {
32
+ stdin.setRawMode(false);
33
+ stdin.pause();
34
+ stdin.removeListener('data', onData);
35
+ process.stderr.write('\n');
36
+ if (result === undefined) {
37
+ reject(new Error('cancelled'));
38
+ }
39
+ else {
40
+ resolve(result);
41
+ }
42
+ };
43
+ const onData = (key) => {
44
+ for (const char of key) {
45
+ if (char === '\r' || char === '\n') {
46
+ done(value);
47
+ return;
48
+ }
49
+ if (char === '\u0003') {
50
+ done(undefined);
51
+ return;
52
+ }
53
+ value = char === '\u007f' ? value.slice(0, -1) : value + char;
54
+ }
55
+ };
56
+ stdin.on('data', onData);
57
+ });
58
+ }
59
+ async function main() {
60
+ const arg = process.argv[2];
61
+ if (arg === '--help' || arg === '-h') {
62
+ console.log(`mqtt2matter ${VERSION}\nusage: mqtt2matter [config.json]\n mqtt2matter --check [config.json] validate the devices against the Matter model and matter.js (strict), no network\n mqtt2matter --import-z2m [config.json] [--base-topic zigbee2mqtt] [--dry-run] [--no-groups] [--timeout 15]\n adopt the devices and groups zigbee2mqtt describes into the file, re-sync the adopted ones\n mqtt2matter --install [--mqtt-url mqtt://broker:1883] [--dry-run]\n run as the systemd service mqtt2matter.service (needs root): configuration\n /etc/mqtt2matter/mqtt2matter.json, storage /var/lib/mqtt2matter, user mqtt2matter\n mqtt2matter --uninstall [--dry-run] remove the service; the configuration and the storage (the pairings) stay\n mqtt2matter --apply-update [dir] (run by mqtt2matter-update.service as root) install the version the UI asked for\n mqtt2matter --hash-password read a password (stdin) and print its hash for server.auth.password\n the file defaults to $MQTT2MATTER_CONFIG, then ./mqtt2matter.json`);
63
+ return;
64
+ }
65
+ if (arg === '--apply-update') {
66
+ // the root oneshot of mqtt2matter-update.service; npm is the one next to this node
67
+ const dir = process.argv[3] ?? '/var/lib/mqtt2matter/update';
68
+ process.exit(await applyUpdate(dir, systemUpdateHost(join(dirname(process.execPath), 'npm'))));
69
+ }
70
+ if (arg === '--hash-password') {
71
+ const password = await readSecret('password: ');
72
+ if (password === '') {
73
+ console.error('an empty password');
74
+ process.exit(1);
75
+ }
76
+ console.log(await hashPassword(password));
77
+ return;
78
+ }
79
+ if (arg === '--install' || arg === '--uninstall') {
80
+ await runInstall(parseInstallArgs(process.argv.slice(2)), systemHost((line) => {
81
+ console.log(line);
82
+ }));
83
+ return;
84
+ }
85
+ if (arg === '--import-z2m') {
86
+ const code = await importZ2m(parseImportArgs(process.argv.slice(3)), {
87
+ out: (line) => {
88
+ console.log(line);
89
+ },
90
+ log: createLogger('warn'),
91
+ });
92
+ process.exit(code);
93
+ }
94
+ if (arg === '--check') {
95
+ const { config, path } = await loadConfig({
96
+ ...(process.argv[3] === undefined ? {} : { path: process.argv[3] }),
97
+ });
98
+ console.error(`checking ${path}`);
99
+ const result = await checkConfig(config);
100
+ for (const line of formatCheck(result)) {
101
+ console.log(line);
102
+ }
103
+ process.exit(result.ok ? 0 : 1);
104
+ }
105
+ if (arg === '--version' || arg === '-v') {
106
+ console.log(VERSION);
107
+ return;
108
+ }
109
+ const { config, path, fromFile, raw, overridden, migrated } = await loadConfig();
110
+ const logBuffer = new LogBuffer();
111
+ const log = createLogger(config.log.level, (line) => {
112
+ console.error(line);
113
+ logBuffer.push(line);
114
+ });
115
+ log.info(`mqtt2matter ${VERSION}, ${fromFile ? `configuration ${path}` : `no ${path}, defaults`}`);
116
+ if (migrated.length > 0) {
117
+ log.warn(`${path}: ${migrated.length} device(s) use the old field "bindings", read as "mappings"; ` +
118
+ 'the file is written in the new form at the next save from the UI');
119
+ }
120
+ const app = new App(config, { log });
121
+ let server;
122
+ let stopping = false;
123
+ /**
124
+ * Stop cleanly — the UI, the mappings, the bridges with their storage, the broker connection — then exit with
125
+ * `code` (the restart's one brings the systemd service back). A stop that hangs is cut off after
126
+ * STOP_TIMEOUT_MS, well inside the unit's TimeoutStopSec, so the process never waits for systemd's SIGKILL.
127
+ */
128
+ const stop = (reason, code = 0) => {
129
+ if (stopping) {
130
+ return;
131
+ }
132
+ stopping = true;
133
+ log.info(`${reason}, stopping`);
134
+ const timer = setTimeout(() => {
135
+ log.error(`the stop did not finish within ${STOP_TIMEOUT_MS / 1000} s, exiting anyway`);
136
+ process.exit(code === 0 ? 1 : code);
137
+ }, STOP_TIMEOUT_MS);
138
+ timer.unref();
139
+ Promise.resolve(server?.close())
140
+ .then(() => app.stop())
141
+ .then(() => process.exit(code), (error) => {
142
+ log.error('stop failed', error);
143
+ process.exit(code === 0 ? 1 : code);
144
+ });
145
+ };
146
+ if (config.server.enabled) {
147
+ const { auth, plain } = await Auth.create(config.server.auth);
148
+ if (plain && !overridden.includes('server.auth.password')) {
149
+ log.warn('server.auth.password is a plain password; store its hash instead (mqtt2matter --hash-password)');
150
+ }
151
+ if (auth.mode === 'none' && config.server.host !== '127.0.0.1' && config.server.host !== '::1') {
152
+ log.info(`the UI on port ${config.server.port} has no login (server.auth.mode none): keep it on a trusted network`);
153
+ }
154
+ const importers = [];
155
+ if (config.importers.z2m.enabled) {
156
+ importers.push(new Z2mImporter(config.importers.z2m.baseTopic, log.child('z2m')));
157
+ }
158
+ if (config.importers.ha.enabled) {
159
+ importers.push(new HaImporter(config.importers.ha.prefix, log.child('ha')));
160
+ }
161
+ server = new Server({
162
+ app,
163
+ store: new ConfigStore({ path, raw, config, overridden }),
164
+ log: log.child('server'),
165
+ logBuffer,
166
+ version: VERSION,
167
+ host: config.server.host,
168
+ port: config.server.port,
169
+ topics: config.server.topics,
170
+ importers,
171
+ auth,
172
+ updater: new Updater({
173
+ current: VERSION,
174
+ supervisor: process.env.MQTT2MATTER_SUPERVISOR,
175
+ updateDir: process.env.MQTT2MATTER_UPDATE_DIR,
176
+ }),
177
+ onRestart: () => {
178
+ stop('restart from the UI', RESTART_EXIT_CODE);
179
+ },
180
+ });
181
+ // the UI is reachable before the broker and the bridges are up, so a wrong setting can be fixed there
182
+ await server.listen();
183
+ }
184
+ process.on('SIGINT', () => {
185
+ stop('SIGINT');
186
+ });
187
+ process.on('SIGTERM', () => {
188
+ stop('SIGTERM');
189
+ });
190
+ await app.start();
191
+ await server?.start();
192
+ }
193
+ main().catch((error) => {
194
+ if (error instanceof ConfigError) {
195
+ console.error(error.message);
196
+ }
197
+ else {
198
+ console.error(`mqtt2matter failed to start: ${describeError(error)}`);
199
+ }
200
+ process.exit(1);
201
+ });
202
+ //# sourceMappingURL=main.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ import { Endpoint, ServerNode } from '@matter/main';
2
+ import type { DeviceTypeViolation } from '@matter/main/model';
3
+ import type { BridgeConfig } from '../config/schema.ts';
4
+ import type { CommandHandler, EndpointTarget } from '../engine/runtime.ts';
5
+ import type { Decoded, TargetShape } from '../engine/payload.ts';
6
+ import { type FamilyContext } from '../families/index.ts';
7
+ import type { Logger } from '../log.ts';
8
+ import type { AttributeRef } from '../model/attribute.ts';
9
+ import { type DeviceConfig, type EndpointConfig } from '../model/schema.ts';
10
+ import type { CommissioningValues } from './commissioning.ts';
11
+ import { type BuiltEndpoint } from './device-types.ts';
12
+ /** the messages of an aggregate error's causes, matter.js style (`errors`, `cause`), flattened */
13
+ export declare function nestedErrors(error: unknown, depth?: number): string[];
14
+ export interface BridgeOptions {
15
+ id: string;
16
+ config: BridgeConfig;
17
+ vendorId: number;
18
+ productId: number;
19
+ softwareVersion: string;
20
+ /** passcode and discriminator: configured, or generated once and persisted (`CommissioningStore`) */
21
+ commissioning: CommissioningValues;
22
+ log: Logger;
23
+ }
24
+ export interface PairingCodes {
25
+ manualPairingCode: string;
26
+ qrPairingCode: string;
27
+ }
28
+ export interface BridgeInfo {
29
+ id: string;
30
+ port: number;
31
+ online: boolean;
32
+ commissioned: boolean;
33
+ pairingCodes: PairingCodes | undefined;
34
+ devices: {
35
+ key: string;
36
+ endpointId: string;
37
+ number: number | undefined;
38
+ violations: number;
39
+ }[];
40
+ }
41
+ /** the Matter side of one endpoint of a device, as the runtime uses it */
42
+ export declare class EndpointHandle implements EndpointTarget {
43
+ readonly key: string;
44
+ readonly config: EndpointConfig;
45
+ readonly endpoint: Endpoint;
46
+ readonly built: BuiltEndpoint;
47
+ readonly context: FamilyContext;
48
+ /** the conformance violations matter.js reported for this endpoint */
49
+ violations: DeviceTypeViolation[];
50
+ private readonly log;
51
+ private readonly writeObservers;
52
+ constructor(key: string, config: EndpointConfig, endpoint: Endpoint, built: BuiltEndpoint, log: Logger);
53
+ get number(): number | undefined;
54
+ /** the endpoint's state (matter.js' immutable view), keyed by behavior id */
55
+ get state(): Record<string, Record<string, unknown>>;
56
+ shapeOf(ref: AttributeRef): TargetShape | undefined;
57
+ set(ref: AttributeRef, value: Decoded): Promise<void>;
58
+ emitEvent(channel: string, value: Decoded): Promise<void>;
59
+ onCommand(key: string, handler: CommandHandler | undefined): void;
60
+ /**
61
+ * A writable attribute: controllers write it (matter.js applies the write), so a command half is routed
62
+ * from the attribute's change with an online context, and the family keeps the cluster consistent.
63
+ * Observed once per attribute.
64
+ */
65
+ private observe;
66
+ setReachable(reachable: boolean): Promise<void>;
67
+ close(): void;
68
+ }
69
+ /** one device: its endpoints by id; the first is the bridged node */
70
+ export declare class DeviceHandle {
71
+ readonly key: string;
72
+ readonly device: DeviceConfig;
73
+ readonly endpoints: ReadonlyMap<string, EndpointHandle>;
74
+ constructor(key: string, device: DeviceConfig, endpoints: ReadonlyMap<string, EndpointHandle>);
75
+ get main(): EndpointHandle;
76
+ get endpoint(): Endpoint;
77
+ get number(): number | undefined;
78
+ get state(): Record<string, Record<string, unknown>>;
79
+ /** the runtime's targets, keyed by the model's endpoint id */
80
+ targets(): Map<string, EndpointTarget>;
81
+ violations(): {
82
+ endpointId: string;
83
+ violation: DeviceTypeViolation;
84
+ }[];
85
+ }
86
+ export declare class Bridge {
87
+ readonly id: string;
88
+ private readonly options;
89
+ private readonly log;
90
+ private node;
91
+ private aggregator;
92
+ private readonly handles;
93
+ private readonly pending;
94
+ constructor(options: BridgeOptions);
95
+ get online(): boolean;
96
+ get commissioned(): boolean;
97
+ get pairingCodes(): PairingCodes | undefined;
98
+ get port(): number;
99
+ get serverNode(): ServerNode | undefined;
100
+ devices(): DeviceHandle[];
101
+ handle(key: string): DeviceHandle | undefined;
102
+ /** register a device; installed when the bridge starts, or right away if it runs already */
103
+ addDevice(key: string, device: DeviceConfig): Promise<DeviceHandle | undefined>;
104
+ removeDevice(key: string): Promise<void>;
105
+ /** create the node and the endpoints without going online (the dry run uses this) */
106
+ build(): Promise<void>;
107
+ start(): Promise<void>;
108
+ /** stop the node; its storage stays, so a later start keeps fabrics and endpoint numbers */
109
+ stop(): Promise<void>;
110
+ info(): BridgeInfo;
111
+ private install;
112
+ private violationsOf;
113
+ }