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,224 @@
1
+ /* Baseline + patch: an importer generates a device (the baseline) from a foreign description; the user
2
+ edits the result; when the description changes, the baseline is regenerated and the user's edits are
3
+ reapplied. The edits are the difference between the old baseline and the device as it is now, taken
4
+ over a *keyed tree* of the device: endpoints by their id, mappings by their target, so a mapping keeps
5
+ its edits when the importer reorders or adds mappings. A conflict is a changed value on a path the new
6
+ baseline changed too; it is reported, never silently resolved (the edit still wins, so nothing the user
7
+ wrote is lost — the report says what the importer would have written). What the user removed stays
8
+ removed. Nothing here knows about zigbee2mqtt. */
9
+ export function isRecord(value) {
10
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
11
+ }
12
+ export function deepEqual(a, b) {
13
+ if (a === b) {
14
+ return true;
15
+ }
16
+ if (Array.isArray(a) || Array.isArray(b)) {
17
+ return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((v, i) => deepEqual(v, b[i]));
18
+ }
19
+ if (isRecord(a) && isRecord(b)) {
20
+ const keys = Object.keys(a);
21
+ return keys.length === Object.keys(b).length && keys.every((k) => k in b && deepEqual(a[k], b[k]));
22
+ }
23
+ return false;
24
+ }
25
+ /** the key of a mapping in the tree: its target, with a counter for a repeated target */
26
+ function mappingKey(mapping, seen) {
27
+ const target = 'attribute' in mapping
28
+ ? `attribute:${mapping.attribute}`
29
+ : 'invoke' in mapping
30
+ ? `invoke:${mapping.invoke}`
31
+ : `event:${mapping.event}`;
32
+ const n = (seen.get(target) ?? 0) + 1;
33
+ seen.set(target, n);
34
+ return n === 1 ? target : `${target}#${n}`;
35
+ }
36
+ export const MAIN_ENDPOINT = 'main';
37
+ /** the keyed tree: endpoints by id, mappings by target; `source` left out (it is the importer's) */
38
+ export function toTree(device) {
39
+ const { endpoints, ...rest } = device;
40
+ const tree = structuredClone(rest);
41
+ delete tree.source;
42
+ const byId = {};
43
+ for (const endpoint of endpoints) {
44
+ const { mappings, ...endpointRest } = endpoint;
45
+ const seen = new Map();
46
+ const byTarget = {};
47
+ for (const mapping of mappings ?? []) {
48
+ byTarget[mappingKey(mapping, seen)] = structuredClone(mapping);
49
+ }
50
+ byId[endpoint.id ?? MAIN_ENDPOINT] = { ...structuredClone(endpointRest), mappings: byTarget };
51
+ }
52
+ tree.endpoints = byId;
53
+ return tree;
54
+ }
55
+ /** back to the array form; `order` says which endpoints and mappings come first (the baseline's order) */
56
+ export function fromTree(tree, order) {
57
+ const { endpoints, ...rest } = tree;
58
+ const result = structuredClone(rest);
59
+ const list = [];
60
+ const endpointIds = orderedKeys(isRecord(endpoints) ? endpoints : {}, isRecord(order?.endpoints) ? order.endpoints : {});
61
+ for (const id of endpointIds) {
62
+ const node = isRecord(endpoints) ? endpoints[id] : undefined;
63
+ if (!isRecord(node)) {
64
+ continue;
65
+ }
66
+ const { mappings, ...endpointRest } = node;
67
+ const orderNode = isRecord(order?.endpoints) ? order.endpoints[id] : undefined;
68
+ const mappingOrder = isRecord(orderNode) && isRecord(orderNode.mappings) ? orderNode.mappings : {};
69
+ const mappingList = [];
70
+ if (isRecord(mappings)) {
71
+ for (const key of orderedKeys(mappings, mappingOrder)) {
72
+ const mapping = mappings[key];
73
+ if (isRecord(mapping)) {
74
+ mappingList.push(structuredClone(mapping));
75
+ }
76
+ }
77
+ }
78
+ const endpoint = { ...structuredClone(endpointRest), mappings: mappingList };
79
+ if (id !== MAIN_ENDPOINT) {
80
+ endpoint.id = id;
81
+ }
82
+ list.push(endpoint);
83
+ }
84
+ result.endpoints = list;
85
+ return result;
86
+ }
87
+ function orderedKeys(tree, order) {
88
+ const keys = Object.keys(order).filter((k) => k in tree);
89
+ for (const key of Object.keys(tree)) {
90
+ if (!keys.includes(key)) {
91
+ keys.push(key);
92
+ }
93
+ }
94
+ return keys;
95
+ }
96
+ /** the edits that turn `base` into `current`: sets of changed or added leaves and subtrees, deletes of removed ones */
97
+ export function diffTrees(base, current, path = []) {
98
+ const ops = [];
99
+ if (isRecord(base) && isRecord(current)) {
100
+ for (const key of Object.keys(base)) {
101
+ if (!(key in current)) {
102
+ ops.push({ op: 'delete', path: [...path, key] });
103
+ }
104
+ }
105
+ for (const [key, value] of Object.entries(current)) {
106
+ if (key in base) {
107
+ ops.push(...diffTrees(base[key], value, [...path, key]));
108
+ }
109
+ else {
110
+ ops.push({ op: 'set', path: [...path, key], value: structuredClone(value) });
111
+ }
112
+ }
113
+ return ops;
114
+ }
115
+ if (!deepEqual(base, current)) {
116
+ ops.push({ op: 'set', path, value: structuredClone(current) });
117
+ }
118
+ return ops;
119
+ }
120
+ function getPath(tree, path) {
121
+ let cursor = tree;
122
+ for (const key of path) {
123
+ if (!isRecord(cursor)) {
124
+ return undefined;
125
+ }
126
+ cursor = cursor[key];
127
+ }
128
+ return cursor;
129
+ }
130
+ function hasPath(tree, path) {
131
+ let cursor = tree;
132
+ for (const key of path) {
133
+ if (!isRecord(cursor) || !(key in cursor)) {
134
+ return false;
135
+ }
136
+ cursor = cursor[key];
137
+ }
138
+ return true;
139
+ }
140
+ function setPath(tree, path, value) {
141
+ let cursor = tree;
142
+ for (const key of path.slice(0, -1)) {
143
+ const next = cursor[key];
144
+ if (!isRecord(next)) {
145
+ const created = {};
146
+ cursor[key] = created;
147
+ cursor = created;
148
+ }
149
+ else {
150
+ cursor = next;
151
+ }
152
+ }
153
+ const last = path.at(-1);
154
+ if (last !== undefined) {
155
+ cursor[last] = value;
156
+ }
157
+ }
158
+ function deletePath(tree, path) {
159
+ const parent = getPath(tree, path.slice(0, -1));
160
+ const last = path.at(-1);
161
+ if (isRecord(parent) && last !== undefined) {
162
+ // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
163
+ delete parent[last];
164
+ }
165
+ }
166
+ /** reapply the edits on the new baseline; an edit on a path the baseline changed too is a conflict */
167
+ export function applyOps(ops, oldBase, newBase) {
168
+ const tree = structuredClone(newBase);
169
+ const conflicts = [];
170
+ for (const op of ops) {
171
+ const before = getPath(oldBase, op.path);
172
+ const now = getPath(newBase, op.path);
173
+ const baseChanged = !deepEqual(before, now);
174
+ const dotted = op.path.join('.');
175
+ if (op.op === 'set') {
176
+ const parent = op.path.slice(0, -1);
177
+ if (parent.length > 0 && !hasPath(newBase, parent) && hasPath(oldBase, parent)) {
178
+ conflicts.push({
179
+ path: dotted,
180
+ op: 'set',
181
+ user: op.value,
182
+ before,
183
+ applied: false,
184
+ reason: 'the importer no longer generates what this edit belongs to',
185
+ });
186
+ continue;
187
+ }
188
+ if (baseChanged) {
189
+ conflicts.push({
190
+ path: dotted,
191
+ op: 'set',
192
+ user: op.value,
193
+ before,
194
+ now,
195
+ applied: true,
196
+ reason: 'the importer changed this value too; the edit was kept',
197
+ });
198
+ }
199
+ setPath(tree, op.path, structuredClone(op.value));
200
+ }
201
+ else if (hasPath(newBase, op.path)) {
202
+ // what the user removed stays removed, whatever the importer did to it since
203
+ deletePath(tree, op.path);
204
+ }
205
+ }
206
+ return { tree, conflicts };
207
+ }
208
+ /** the new baseline with the user's edits (current − old baseline) reapplied */
209
+ export function resync(oldBaseline, current, newBaseline) {
210
+ const oldTree = toTree(oldBaseline);
211
+ const newTree = toTree(newBaseline);
212
+ const edits = diffTrees(oldTree, toTree(current));
213
+ const { tree, conflicts } = applyOps(edits, oldTree, newTree);
214
+ const device = fromTree(tree, newTree);
215
+ if (current.source !== undefined) {
216
+ device.source = structuredClone(current.source);
217
+ }
218
+ return { device, edits, conflicts };
219
+ }
220
+ /** the user's edits of `current` against its baseline (for a display, or to tell an untouched device) */
221
+ export function editsOf(baseline, current) {
222
+ return diffTrees(toTree(baseline), toTree(current));
223
+ }
224
+ //# sourceMappingURL=patch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/importers/patch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,112 @@
1
+ import { type DeviceInput, type DevicesInput, type SourceInput } from '../model/index.ts';
2
+ import { type Conflict, editsOf } from './patch.ts';
3
+ export interface Generated {
4
+ device: DeviceInput;
5
+ /** what the description carries that has no Matter equivalent (shown, not dropped silently) */
6
+ unmapped: string[];
7
+ }
8
+ export interface Discovered {
9
+ key: string;
10
+ /** `device` or `group` — what the UI shows as a badge */
11
+ kind: 'device' | 'group';
12
+ name: string;
13
+ vendor?: string;
14
+ model?: string;
15
+ description?: string;
16
+ /** the area the source suggests for the device (Home Assistant's `suggested_area`) */
17
+ area?: string;
18
+ /** the key of another importer's native description of the same device (`z2m:0x…`): native preferred */
19
+ native?: string;
20
+ /** a baseline could be generated */
21
+ supported: boolean;
22
+ /** why not */
23
+ reason?: string;
24
+ baseline?: DeviceInput;
25
+ unmapped: string[];
26
+ }
27
+ export type SyncStatus =
28
+ /** described by the source, not in the config */
29
+ 'new' | 'unchanged'
30
+ /** the baseline changed; the user's edits were reapplied */
31
+ | 'updated'
32
+ /** gone from the source; kept, marked */
33
+ | 'orphaned'
34
+ /** back in the source after being orphaned */
35
+ | 'restored'
36
+ /** the merge of baseline and edits does not validate; the device was left as it was */
37
+ | 'invalid'
38
+ /** the source describes it, but it cannot be adopted (or no longer can) */
39
+ | 'unsupported'
40
+ /** not in the config, and another importer describes the same device natively or has it adopted already:
41
+ adopting it would make a second Matter device for one device, so `adopt` takes it only with `force` */
42
+ | 'covered';
43
+ export interface SyncEntry {
44
+ key: string;
45
+ kind: 'device' | 'group';
46
+ name: string;
47
+ status: SyncStatus;
48
+ /** the device as it would be (is) after adopting; absent for unsupported ones not in the config */
49
+ device?: DeviceInput;
50
+ conflicts: Conflict[];
51
+ /** how many edits of the user's were found and carried over */
52
+ edits: number;
53
+ unmapped: string[];
54
+ /** reasons and validation messages */
55
+ notes: string[];
56
+ area?: string;
57
+ native?: string;
58
+ /** for `covered`: the key of the description that covers it — the native one, or the adopted twin */
59
+ covered?: string;
60
+ /** the configured devices (not disabled, not orphaned) that stand for the same physical device */
61
+ twins?: string[];
62
+ }
63
+ export interface AdoptOptions {
64
+ /** the new devices to add; default: every supported one */
65
+ keys?: readonly string[] | undefined;
66
+ /** re-sync the devices already in the config (default true) */
67
+ resync?: boolean | undefined;
68
+ /** mark the devices the source no longer describes (default true) */
69
+ orphan?: boolean | undefined;
70
+ /** adopt the `covered` entries among `keys` too — a second Matter device for one device, asked for */
71
+ force?: boolean | undefined;
72
+ /** with `force`: disable the twins of the forced entries, so the new one replaces them on the bridge
73
+ (they stay in the config; removing them is the user's click) */
74
+ replace?: boolean | undefined;
75
+ }
76
+ export interface AdoptResult {
77
+ devices: DevicesInput;
78
+ report: SyncEntry[];
79
+ }
80
+ /** what an importer hands the generic sync */
81
+ export interface SyncSource<Raw> {
82
+ kind: SourceInput['kind'];
83
+ isRaw(value: unknown): value is Raw;
84
+ /** regenerate the baseline from a stored `source.raw`; undefined when nothing maps */
85
+ generate(raw: Raw): Generated | undefined;
86
+ /** the kind of a configured device the discovery does not mention */
87
+ kindOf(key: string, raw: Raw | undefined): 'device' | 'group';
88
+ }
89
+ /** a discovery as the generic sync reads it: the items and whether the source was seen for a kind */
90
+ export interface SyncDiscovery {
91
+ items: Discovered[];
92
+ /** the source published its description for this kind: devices missing from it are orphaned */
93
+ seen(kind: 'device' | 'group'): boolean;
94
+ /** the note for a device the discovery cannot judge because the source was not seen */
95
+ notSeenNote(kind: 'device' | 'group'): string;
96
+ }
97
+ export declare class Sync<Raw> {
98
+ private readonly source;
99
+ constructor(source: SyncSource<Raw>);
100
+ isOwn(device: DeviceInput): boolean;
101
+ orphaned(devices: DevicesInput): string[];
102
+ /** the old baseline from `source.raw`, or undefined when it cannot be regenerated */
103
+ private oldBaselineOf;
104
+ /** the user's edits of a device against its baseline; empty when it is untouched or has no baseline */
105
+ edits(device: DeviceInput): ReturnType<typeof editsOf>;
106
+ /** one config entry against its discovery */
107
+ private syncOne;
108
+ /** what adopting the discovery onto `devices` would do, entry by entry */
109
+ diff(discovery: SyncDiscovery, devices: DevicesInput): SyncEntry[];
110
+ /** the `devices` record after adopting: existing entries in place and order, new ones appended */
111
+ adopt(devices: DevicesInput, discovery: SyncDiscovery, options?: AdoptOptions): AdoptResult;
112
+ }
@@ -0,0 +1,220 @@
1
+ /* What every importer does with its discoveries, once: the report over a `devices` record (`diff`) and the
2
+ adoption (`adopt`) — new entries added, known ones re-synced from their stored `source.raw` with the
3
+ user's edits carried over and conflicts reported, missing ones marked orphaned and never removed,
4
+ orphaned ones restored when they are back, manual devices untouched. An importer brings its kind, how
5
+ to recognise and regenerate its `source.raw`, and its discovery; everything else is here. */
6
+ import { DeviceSchema } from "../model/index.js";
7
+ import { deepEqual, editsOf, resync } from "./patch.js";
8
+ import { isLive, twinsOf } from "./twins.js";
9
+ function withoutSource(device) {
10
+ const rest = structuredClone(device);
11
+ delete rest.source;
12
+ return rest;
13
+ }
14
+ function validationNotes(device) {
15
+ const parsed = DeviceSchema.safeParse(device);
16
+ return parsed.success ? [] : parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);
17
+ }
18
+ /** the configured twins of `key` that are live on the bridge */
19
+ function liveTwins(key, devices, native) {
20
+ return twinsOf(key, devices, native).filter((twin) => {
21
+ const device = devices[twin];
22
+ return device !== undefined && isLive(device);
23
+ });
24
+ }
25
+ /** an adopted device whose twin is adopted too: two Matter devices for one device, said in the report */
26
+ function withTwins(entry, devices) {
27
+ const current = devices[entry.key];
28
+ const twins = current !== undefined && isLive(current) ? liveTwins(entry.key, devices, entry.native) : [];
29
+ if (twins.length === 0) {
30
+ return entry;
31
+ }
32
+ return {
33
+ ...entry,
34
+ twins,
35
+ notes: [...entry.notes, `the same device is adopted as ${twins.join(', ')} too: two Matter devices`],
36
+ };
37
+ }
38
+ export class Sync {
39
+ source;
40
+ constructor(source) {
41
+ this.source = source;
42
+ }
43
+ isOwn(device) {
44
+ return device.source?.kind === this.source.kind;
45
+ }
46
+ orphaned(devices) {
47
+ return Object.entries(devices)
48
+ .filter(([, device]) => this.isOwn(device) && device.source?.orphaned === true)
49
+ .map(([key]) => key);
50
+ }
51
+ /** the old baseline from `source.raw`, or undefined when it cannot be regenerated */
52
+ oldBaselineOf(current) {
53
+ const raw = current.source?.raw;
54
+ return this.source.isRaw(raw) ? this.source.generate(raw)?.device : undefined;
55
+ }
56
+ /** the user's edits of a device against its baseline; empty when it is untouched or has no baseline */
57
+ edits(device) {
58
+ const baseline = this.oldBaselineOf(device);
59
+ return baseline === undefined ? [] : editsOf(baseline, device);
60
+ }
61
+ /** one config entry against its discovery */
62
+ syncOne(key, current, item) {
63
+ const base = {
64
+ key,
65
+ kind: item.kind,
66
+ name: item.name,
67
+ conflicts: [],
68
+ edits: 0,
69
+ unmapped: item.unmapped,
70
+ notes: [],
71
+ ...(item.area === undefined ? {} : { area: item.area }),
72
+ ...(item.native === undefined ? {} : { native: item.native }),
73
+ };
74
+ const wasOrphaned = current.source?.orphaned === true;
75
+ const newBaseline = item.baseline;
76
+ if (newBaseline === undefined) {
77
+ return { ...base, status: 'unsupported', device: current, notes: [item.reason ?? 'cannot be adopted'] };
78
+ }
79
+ const oldBaseline = this.oldBaselineOf(current);
80
+ if (oldBaseline === undefined) {
81
+ // no baseline to tell the user's edits from: the device stays as it is, only the source is refreshed
82
+ const device = structuredClone(current);
83
+ device.source = structuredClone(newBaseline.source);
84
+ return {
85
+ ...base,
86
+ status: wasOrphaned ? 'restored' : 'unchanged',
87
+ device,
88
+ notes: ['no baseline in source.raw; the device was kept as it is'],
89
+ };
90
+ }
91
+ const result = resync(oldBaseline, current, newBaseline);
92
+ const device = result.device;
93
+ device.source = structuredClone(newBaseline.source);
94
+ const notes = validationNotes(device);
95
+ if (notes.length > 0) {
96
+ const kept = structuredClone(current);
97
+ if (kept.source !== undefined) {
98
+ delete kept.source.orphaned;
99
+ }
100
+ return {
101
+ ...base,
102
+ status: 'invalid',
103
+ device: kept,
104
+ conflicts: result.conflicts,
105
+ edits: result.edits.length,
106
+ notes,
107
+ };
108
+ }
109
+ // a conflict means the baseline moved under an edit: reported as updated even when the edit kept its value
110
+ const changed = !deepEqual(withoutSource(device), withoutSource(current)) || result.conflicts.length > 0;
111
+ const status = wasOrphaned ? 'restored' : changed ? 'updated' : 'unchanged';
112
+ return { ...base, status, device, conflicts: result.conflicts, edits: result.edits.length };
113
+ }
114
+ /** what adopting the discovery onto `devices` would do, entry by entry */
115
+ diff(discovery, devices) {
116
+ const entries = [];
117
+ const byKey = new Map(discovery.items.map((item) => [item.key, item]));
118
+ for (const [key, current] of Object.entries(devices)) {
119
+ if (!this.isOwn(current)) {
120
+ continue;
121
+ }
122
+ const item = byKey.get(key);
123
+ if (item !== undefined) {
124
+ entries.push(withTwins(this.syncOne(key, current, item), devices));
125
+ byKey.delete(key);
126
+ continue;
127
+ }
128
+ const raw = current.source?.raw;
129
+ const kind = this.source.kindOf(key, this.source.isRaw(raw) ? raw : undefined);
130
+ const seen = discovery.seen(kind);
131
+ const device = structuredClone(current);
132
+ if (seen) {
133
+ device.source = { ...(device.source ?? { kind: this.source.kind }), orphaned: true };
134
+ }
135
+ entries.push({
136
+ key,
137
+ kind,
138
+ name: current.name,
139
+ status: seen ? 'orphaned' : 'unchanged',
140
+ device,
141
+ conflicts: [],
142
+ edits: 0,
143
+ unmapped: [],
144
+ notes: seen ? [] : [discovery.notSeenNote(kind)],
145
+ });
146
+ }
147
+ for (const item of byKey.values()) {
148
+ const twins = liveTwins(item.key, devices, item.native);
149
+ const covered = item.native ?? twins[0];
150
+ entries.push({
151
+ key: item.key,
152
+ kind: item.kind,
153
+ name: item.name,
154
+ status: !item.supported ? 'unsupported' : covered === undefined ? 'new' : 'covered',
155
+ ...(item.supported && covered !== undefined ? { covered } : {}),
156
+ ...(twins.length > 0 ? { twins } : {}),
157
+ ...(item.baseline === undefined ? {} : { device: item.baseline }),
158
+ conflicts: [],
159
+ edits: 0,
160
+ unmapped: item.unmapped,
161
+ notes: item.reason === undefined ? [] : [item.reason],
162
+ ...(item.area === undefined ? {} : { area: item.area }),
163
+ ...(item.native === undefined ? {} : { native: item.native }),
164
+ });
165
+ }
166
+ return entries;
167
+ }
168
+ /** the `devices` record after adopting: existing entries in place and order, new ones appended */
169
+ adopt(devices, discovery, options = {}) {
170
+ const report = this.diff(discovery, devices);
171
+ const wanted = options.keys === undefined ? undefined : new Set(options.keys);
172
+ const result = {};
173
+ const byKey = new Map(report.map((entry) => [entry.key, entry]));
174
+ for (const [key, current] of Object.entries(devices)) {
175
+ const entry = byKey.get(key);
176
+ if (entry?.device === undefined) {
177
+ result[key] = current;
178
+ continue;
179
+ }
180
+ if (entry.status === 'orphaned' && options.orphan === false) {
181
+ result[key] = current;
182
+ entry.status = 'unchanged';
183
+ continue;
184
+ }
185
+ if ((entry.status === 'updated' || entry.status === 'restored') && options.resync === false) {
186
+ result[key] = current;
187
+ entry.status = 'unchanged';
188
+ continue;
189
+ }
190
+ result[key] = entry.device;
191
+ }
192
+ for (const entry of report) {
193
+ if (entry.device === undefined) {
194
+ continue;
195
+ }
196
+ if (wanted !== undefined && !wanted.has(entry.key)) {
197
+ continue;
198
+ }
199
+ if (entry.status === 'new') {
200
+ result[entry.key] = entry.device;
201
+ continue;
202
+ }
203
+ // a covered entry only when it was named and forced: never by "adopt everything"
204
+ if (entry.status !== 'covered' || wanted === undefined || options.force !== true) {
205
+ continue;
206
+ }
207
+ result[entry.key] = entry.device;
208
+ if (options.replace === true) {
209
+ for (const twin of entry.twins ?? []) {
210
+ const device = result[twin];
211
+ if (device !== undefined) {
212
+ result[twin] = { ...device, enabled: false };
213
+ }
214
+ }
215
+ }
216
+ }
217
+ return { devices: result, report };
218
+ }
219
+ }
220
+ //# sourceMappingURL=sync.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/importers/sync.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { DeviceInput, DevicesInput } from '../model/index.ts';
2
+ /** the key of the native description a configured device is a twin of (`z2m:0x…`), or undefined */
3
+ export declare function nativeOfDevice(device: DeviceInput): string | undefined;
4
+ /** does a configured device stand for its physical device on the bridge (not disabled, not orphaned)? */
5
+ export declare function isLive(device: DeviceInput): boolean;
6
+ /**
7
+ * The configured devices that describe the same physical device as `key` — the native one an HA device
8
+ * names, and the HA devices that name `key` as theirs — without `key` itself.
9
+ */
10
+ export declare function twinsOf(key: string, devices: DevicesInput, native?: string): string[];
@@ -0,0 +1,34 @@
1
+ /* One physical device, two descriptions: zigbee2mqtt describes its devices natively (`bridge/devices`) and,
2
+ when its Home Assistant integration is on, a second time through discovery. Both importers would make a
3
+ Matter device of it. The twin of a device is the other importer's key for the same device; the native
4
+ description is preferred, and the shared sync refuses to adopt a second one without an explicit `force`. */
5
+ import { isRaw as isHaRaw, nativeKey } from "./ha/generate.js";
6
+ /** the key of the native description a configured device is a twin of (`z2m:0x…`), or undefined */
7
+ export function nativeOfDevice(device) {
8
+ if (device.source?.kind !== 'ha-discovery') {
9
+ return undefined;
10
+ }
11
+ const raw = device.source.raw;
12
+ return isHaRaw(raw) ? nativeKey(raw.identity, raw.device) : undefined;
13
+ }
14
+ /** does a configured device stand for its physical device on the bridge (not disabled, not orphaned)? */
15
+ export function isLive(device) {
16
+ return device.enabled !== false && device.source?.orphaned !== true;
17
+ }
18
+ /**
19
+ * The configured devices that describe the same physical device as `key` — the native one an HA device
20
+ * names, and the HA devices that name `key` as theirs — without `key` itself.
21
+ */
22
+ export function twinsOf(key, devices, native) {
23
+ const twins = new Set();
24
+ if (native !== undefined && native !== key && devices[native] !== undefined) {
25
+ twins.add(native);
26
+ }
27
+ for (const [other, device] of Object.entries(devices)) {
28
+ if (other !== key && nativeOfDevice(device) === key) {
29
+ twins.add(other);
30
+ }
31
+ }
32
+ return [...twins];
33
+ }
34
+ //# sourceMappingURL=twins.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twins.js","sourceRoot":"","sources":["../../src/importers/twins.ts"],"names":[],"mappings":"AAAA;;;8GAG8G;AAG9G,OAAO,EAAC,KAAK,IAAI,OAAO,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAE7D,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAAC,MAAmB;IAC9C,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,cAAc,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,GAAG,GAAY,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;IACvC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,MAAM,CAAC,MAAmB;IACtC,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,OAAqB,EAAE,MAAe;IACvE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1E,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;YAClD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACtB,CAAC"}