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,63 @@
1
+ /* The few clusters whose mandatory attributes have no default in the model, or that need a feature chosen
2
+ before matter.js accepts them (an occupancy sensor's detector type, a concentration cluster's numeric
3
+ feature). Everything else matter.js and the families default; the config's `attributes` override all
4
+ of it. Sensors have no family, so their needs live here. */
5
+ import { AirQuality } from '@matter/main/clusters/air-quality';
6
+ import { ConcentrationMeasurement } from '@matter/main/clusters/concentration-measurement';
7
+ import { DoorLock } from '@matter/main/clusters/door-lock';
8
+ import { OccupancySensing } from '@matter/main/clusters/occupancy-sensing';
9
+ const concentration = (unit) => ({
10
+ features: ['NumericMeasurement'],
11
+ attributes: () => ({
12
+ measuredValue: null,
13
+ measurementMedium: ConcentrationMeasurement.MeasurementMedium.Air,
14
+ measurementUnit: unit,
15
+ }),
16
+ });
17
+ export const CLUSTER_DEFAULTS = {
18
+ OccupancySensing: {
19
+ features: ['PassiveInfrared'],
20
+ attributes: (features) => ({
21
+ occupancy: { occupied: false },
22
+ occupancySensorType: features.has('Ultrasonic')
23
+ ? OccupancySensing.OccupancySensorType.Ultrasonic
24
+ : features.has('PhysicalContact')
25
+ ? OccupancySensing.OccupancySensorType.PhysicalContact
26
+ : OccupancySensing.OccupancySensorType.Pir,
27
+ occupancySensorTypeBitmap: {
28
+ pir: features.has('PassiveInfrared') || !(features.has('Ultrasonic') || features.has('PhysicalContact')),
29
+ ultrasonic: features.has('Ultrasonic'),
30
+ physicalContact: features.has('PhysicalContact'),
31
+ },
32
+ }),
33
+ },
34
+ DoorLock: {
35
+ attributes: () => ({
36
+ lockType: DoorLock.LockType.DeadBolt,
37
+ lockState: DoorLock.LockState.Unlocked,
38
+ actuatorEnabled: true,
39
+ operatingMode: DoorLock.OperatingMode.Normal,
40
+ }),
41
+ },
42
+ AirQuality: {
43
+ features: ['Fair', 'Moderate', 'VeryPoor', 'ExtremelyPoor'],
44
+ attributes: () => ({ airQuality: AirQuality.AirQualityEnum.Unknown }),
45
+ },
46
+ CarbonDioxideConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppm),
47
+ CarbonMonoxideConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppm),
48
+ NitrogenDioxideConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppb),
49
+ OzoneConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppb),
50
+ FormaldehydeConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppb),
51
+ TotalVolatileOrganicCompoundsConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ppb),
52
+ Pm1ConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ugm3),
53
+ Pm25ConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ugm3),
54
+ Pm10ConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Ugm3),
55
+ RadonConcentrationMeasurement: concentration(ConcentrationMeasurement.MeasurementUnit.Bqm3),
56
+ BooleanState: { attributes: () => ({ stateValue: false }) },
57
+ TemperatureMeasurement: { attributes: () => ({ measuredValue: null }) },
58
+ RelativeHumidityMeasurement: { attributes: () => ({ measuredValue: null }) },
59
+ IlluminanceMeasurement: { attributes: () => ({ measuredValue: null }) },
60
+ PressureMeasurement: { attributes: () => ({ measuredValue: null }) },
61
+ FlowMeasurement: { attributes: () => ({ measuredValue: null }) },
62
+ };
63
+ //# sourceMappingURL=cluster-defaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cluster-defaults.js","sourceRoot":"","sources":["../../src/matter/cluster-defaults.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ export interface CommissioningValues {
2
+ passcode: number;
3
+ discriminator: number;
4
+ }
5
+ export declare class CommissioningStore {
6
+ private readonly file;
7
+ private readonly values;
8
+ private dirty;
9
+ constructor(file: string, entries?: Record<string, CommissioningValues>);
10
+ static load(file: string): Promise<CommissioningStore>;
11
+ /**
12
+ * The bridge's values: the configured ones where set, the others as remembered, generated (and remembered)
13
+ * the first time a bridge has none.
14
+ */
15
+ resolve(bridgeId: string, configured: {
16
+ passcode?: number | undefined;
17
+ discriminator?: number | undefined;
18
+ }): CommissioningValues;
19
+ /** persist when something was generated; atomic through a temp file */
20
+ save(): Promise<void>;
21
+ }
@@ -0,0 +1,88 @@
1
+ /* Each bridge's passcode and discriminator: generated once, persisted next to matter.js' storage and reused at
2
+ every start, so the pairing code a user noted down (or the QR code printed from it) stays valid across
3
+ restarts and updates until the bridge is commissioned. matter.js keeps no commissioning values of its own.
4
+ Values in the configuration win and are not written here. */
5
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
6
+ import { dirname } from 'node:path';
7
+ import { randomDiscriminator, randomPasscode } from "./ids.js";
8
+ function isValues(value) {
9
+ if (typeof value !== 'object' || value === null) {
10
+ return false;
11
+ }
12
+ const { passcode, discriminator } = value;
13
+ return (Number.isInteger(passcode) &&
14
+ passcode >= 1 &&
15
+ passcode <= 99999998 &&
16
+ Number.isInteger(discriminator) &&
17
+ discriminator >= 0 &&
18
+ discriminator <= 4095);
19
+ }
20
+ export class CommissioningStore {
21
+ file;
22
+ values;
23
+ dirty = false;
24
+ constructor(file, entries = {}) {
25
+ this.file = file;
26
+ this.values = new Map(Object.entries(entries));
27
+ }
28
+ static async load(file) {
29
+ let text;
30
+ try {
31
+ text = await readFile(file, 'utf8');
32
+ }
33
+ catch (error) {
34
+ if (error.code === 'ENOENT') {
35
+ return new CommissioningStore(file);
36
+ }
37
+ throw error;
38
+ }
39
+ try {
40
+ const parsed = JSON.parse(text);
41
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
42
+ throw new Error('not an object');
43
+ }
44
+ const entries = {};
45
+ for (const [id, value] of Object.entries(parsed)) {
46
+ if (!isValues(value)) {
47
+ throw new Error(`"${id}" has no valid passcode and discriminator`);
48
+ }
49
+ entries[id] = { passcode: value.passcode, discriminator: value.discriminator };
50
+ }
51
+ return new CommissioningStore(file, entries);
52
+ }
53
+ catch (error) {
54
+ throw new Error(`${file} is unreadable: ${error.message}`, { cause: error });
55
+ }
56
+ }
57
+ /**
58
+ * The bridge's values: the configured ones where set, the others as remembered, generated (and remembered)
59
+ * the first time a bridge has none.
60
+ */
61
+ resolve(bridgeId, configured) {
62
+ if (configured.passcode !== undefined && configured.discriminator !== undefined) {
63
+ return { passcode: configured.passcode, discriminator: configured.discriminator };
64
+ }
65
+ let stored = this.values.get(bridgeId);
66
+ if (stored === undefined) {
67
+ stored = { passcode: randomPasscode(), discriminator: randomDiscriminator() };
68
+ this.values.set(bridgeId, stored);
69
+ this.dirty = true;
70
+ }
71
+ return {
72
+ passcode: configured.passcode ?? stored.passcode,
73
+ discriminator: configured.discriminator ?? stored.discriminator,
74
+ };
75
+ }
76
+ /** persist when something was generated; atomic through a temp file */
77
+ async save() {
78
+ if (!this.dirty) {
79
+ return;
80
+ }
81
+ await mkdir(dirname(this.file), { recursive: true });
82
+ const tmp = `${this.file}.tmp`;
83
+ await writeFile(tmp, `${JSON.stringify(Object.fromEntries(this.values), null, 2)}\n`, { mode: 0o600 });
84
+ await rename(tmp, this.file);
85
+ this.dirty = false;
86
+ }
87
+ }
88
+ //# sourceMappingURL=commissioning.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commissioning.js","sourceRoot":"","sources":["../../src/matter/commissioning.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import type { Behavior, EndpointType } from '@matter/main';
2
+ import type { Options } from '../model/options.ts';
3
+ import { type EndpointConfig } from '../model/schema.ts';
4
+ interface DeviceDefinition {
5
+ name: string;
6
+ deviceType: number;
7
+ deviceRevision: number;
8
+ behaviors: Record<string, Behavior.Type>;
9
+ requirements: {
10
+ server?: {
11
+ mandatory?: Record<string, Behavior.Type>;
12
+ optional?: Record<string, Behavior.Type>;
13
+ };
14
+ };
15
+ with(...behaviors: Behavior.Type[]): EndpointType;
16
+ }
17
+ /** the matter.js device definition for a model device type name, or undefined */
18
+ export declare function deviceDefinition(name: string): DeviceDefinition | undefined;
19
+ /** the device type names this build can construct */
20
+ export declare function supportedDeviceTypes(): string[];
21
+ export interface BuiltEndpoint {
22
+ type: EndpointType;
23
+ /** the enabled feature titles per cluster */
24
+ features: ReadonlyMap<string, ReadonlySet<string>>;
25
+ /** behavior options per behavior id, for the Endpoint's construction */
26
+ defaults: Record<string, Record<string, unknown>>;
27
+ /** the Descriptor's device type list */
28
+ deviceTypeList: {
29
+ deviceType: number;
30
+ revision: number;
31
+ }[];
32
+ /** cluster name → behavior id of every cluster on the endpoint */
33
+ clusters: ReadonlyMap<string, string>;
34
+ }
35
+ /** the keys every mapping of the endpoint names (`Cluster.attribute`, `Cluster.command`, `Cluster`) */
36
+ export declare function boundKeys(endpoint: EndpointConfig): Set<string>;
37
+ /**
38
+ * Build the endpoint type and its construction defaults for one endpoint of the model. Throws when a
39
+ * device type or cluster is unknown; conformance beyond that is the validator's and matter.js' business.
40
+ */
41
+ export declare function buildEndpoint(endpoint: EndpointConfig, options?: Options, { bridged }?: {
42
+ bridged?: boolean | undefined;
43
+ }): BuiltEndpoint;
44
+ export {};
@@ -0,0 +1,230 @@
1
+ /* The endpoint type for an endpoint of the model, built from matter.js' own device definitions — every
2
+ `<Name>Device` it ships plus the utility `PowerSource` — and @matter/model: the first device type is the
3
+ endpoint's type, the others are added to the Descriptor's device type list and their mandatory clusters
4
+ merged; the clusters are the device types' mandatory ones, the optional ones a mapping or the config
5
+ names, and any other cluster a mapping names; each cluster's server is the family's class where there
6
+ is one (it routes controller commands), else matter.js' default; its features are the union of what the
7
+ device type requires (`OnOffServer.with("Lighting")` on lights), what the mappings imply and what the
8
+ config asks for. No table of device types lives here. */
9
+ import * as behaviors from '@matter/main/behaviors';
10
+ import { BridgedDeviceBasicInformationServer } from '@matter/main/behaviors/bridged-device-basic-information';
11
+ import * as devices from '@matter/main/devices';
12
+ import * as endpoints from '@matter/main/endpoints';
13
+ import { familyFor } from "../families/index.js";
14
+ import { CLUSTER_DEFAULTS } from "./cluster-defaults.js";
15
+ import { cluster as clusterInfo, deviceType as deviceTypeInfo, upperCamel } from "../model/catalog.js";
16
+ import { mappingTarget } from "../model/schema.js";
17
+ /**
18
+ * What a device type's requirement class changed on the default server (`remainingTime` mandatory on a
19
+ * colour light, `currentLevel` 1–254 on a dimmable one), read off its altered schema, so the family's
20
+ * server gets the same alterations.
21
+ */
22
+ function alterationsOf(requirement, base) {
23
+ const changes = {};
24
+ if (requirement?.schema === undefined || Object.is(requirement, base)) {
25
+ return changes;
26
+ }
27
+ const baseAttributes = new Map(base.schema.attributes.map((a) => [a.name, a]));
28
+ for (const attribute of requirement.schema.attributes) {
29
+ const original = baseAttributes.get(attribute.name);
30
+ if (original === undefined) {
31
+ continue;
32
+ }
33
+ const change = {};
34
+ if (String(attribute.conformance) === 'M' && String(original.conformance) !== 'M') {
35
+ change.optional = false;
36
+ }
37
+ if (typeof attribute.constraint.min === 'number' && attribute.constraint.min !== original.constraint.min) {
38
+ change.min = attribute.constraint.min;
39
+ }
40
+ if (typeof attribute.constraint.max === 'number' && attribute.constraint.max !== original.constraint.max) {
41
+ change.max = attribute.constraint.max;
42
+ }
43
+ if (attribute.default !== undefined &&
44
+ attribute.default !== original.default &&
45
+ typeof attribute.default !== 'object') {
46
+ change.default = attribute.default;
47
+ }
48
+ if (Object.keys(change).length > 0) {
49
+ changes[lowerFirst(attribute.name)] = change;
50
+ }
51
+ }
52
+ return changes;
53
+ }
54
+ function lowerFirst(name) {
55
+ return name.charAt(0).toLowerCase() + name.slice(1);
56
+ }
57
+ /** the matter.js device definition for a model device type name, or undefined */
58
+ export function deviceDefinition(name) {
59
+ const fromDevices = devices[`${name}Device`];
60
+ if (fromDevices !== undefined) {
61
+ return fromDevices;
62
+ }
63
+ const fromEndpoints = endpoints[`${name}Endpoint`];
64
+ if (fromEndpoints !== undefined && name !== 'Root' && name !== 'Aggregator') {
65
+ return fromEndpoints;
66
+ }
67
+ return undefined;
68
+ }
69
+ /** the device type names this build can construct */
70
+ export function supportedDeviceTypes() {
71
+ const names = new Set();
72
+ for (const key of Object.keys(devices)) {
73
+ if (key.endsWith('Device') && !key.endsWith('DeviceDefinition')) {
74
+ names.add(key.slice(0, -'Device'.length));
75
+ }
76
+ }
77
+ names.add('PowerSource');
78
+ names.add('ElectricalSensor');
79
+ return [...names].sort();
80
+ }
81
+ function featureTitles(server) {
82
+ if (server?.features === undefined) {
83
+ return [];
84
+ }
85
+ return Object.entries(server.features)
86
+ .filter(([, on]) => on)
87
+ .map(([key]) => upperCamel(key));
88
+ }
89
+ /** the keys every mapping of the endpoint names (`Cluster.attribute`, `Cluster.command`, `Cluster`) */
90
+ export function boundKeys(endpoint) {
91
+ const keys = new Set();
92
+ for (const mapping of endpoint.mappings) {
93
+ keys.add(mappingTarget(mapping).name);
94
+ }
95
+ return keys;
96
+ }
97
+ function clustersNamed(endpoint) {
98
+ const names = new Set();
99
+ for (const key of boundKeys(endpoint)) {
100
+ names.add(key.split('.')[0] ?? key);
101
+ }
102
+ for (const name of Object.keys(endpoint.features ?? {})) {
103
+ names.add(name);
104
+ }
105
+ for (const name of Object.keys(endpoint.attributes ?? {})) {
106
+ names.add(name);
107
+ }
108
+ return names;
109
+ }
110
+ /**
111
+ * Build the endpoint type and its construction defaults for one endpoint of the model. Throws when a
112
+ * device type or cluster is unknown; conformance beyond that is the validator's and matter.js' business.
113
+ */
114
+ export function buildEndpoint(endpoint, options = endpoint.options, { bridged = false } = {}) {
115
+ const definitions = endpoint.deviceTypes.map((name) => {
116
+ const definition = deviceDefinition(name);
117
+ const info = deviceTypeInfo(name);
118
+ if (definition === undefined || info === undefined) {
119
+ throw new Error(`device type "${name}" is not known to matter.js ${definition === undefined ? '' : '(model)'}`.trim());
120
+ }
121
+ return { definition, info };
122
+ });
123
+ const [primary, ...others] = definitions;
124
+ if (primary === undefined) {
125
+ throw new Error('an endpoint needs at least one device type');
126
+ }
127
+ const bound = boundKeys(endpoint);
128
+ const named = clustersNamed(endpoint);
129
+ // the clusters: cluster name → the server the device type requires (features and alterations included)
130
+ const required = new Map();
131
+ const add = (name, server) => {
132
+ const info = clusterInfo(name);
133
+ if (info === undefined) {
134
+ throw new Error(`cluster "${name}" is not known to the Matter model`);
135
+ }
136
+ const existing = required.get(name);
137
+ if (existing === undefined || (existing.server === undefined && server !== undefined)) {
138
+ required.set(name, { server: server, info });
139
+ }
140
+ };
141
+ for (const { definition } of definitions) {
142
+ for (const [name, server] of Object.entries(definition.requirements.server?.mandatory ?? {})) {
143
+ add(name, server);
144
+ }
145
+ }
146
+ for (const { definition } of definitions) {
147
+ for (const [name, server] of Object.entries(definition.requirements.server?.optional ?? {})) {
148
+ if (named.has(name)) {
149
+ add(name, server);
150
+ }
151
+ }
152
+ }
153
+ for (const name of named) {
154
+ if (!required.has(name)) {
155
+ const server = behaviors[`${name}Server`];
156
+ if (server === undefined) {
157
+ throw new Error(`cluster "${name}" has no server in matter.js`);
158
+ }
159
+ add(name, server);
160
+ }
161
+ }
162
+ // the features per cluster: device type requirement ∪ family ∪ config
163
+ const features = new Map();
164
+ for (const [name, { server, info }] of required) {
165
+ const set = new Set(featureTitles(server));
166
+ const family = familyFor(name);
167
+ for (const title of family?.features?.(bound, options) ?? []) {
168
+ set.add(title);
169
+ }
170
+ for (const requested of endpoint.features?.[name] ?? []) {
171
+ const feature = info.feature(requested);
172
+ if (feature === undefined) {
173
+ throw new Error(`cluster ${name} has no feature "${requested}" (it has ${info.features.map((f) => f.title).join(', ')})`);
174
+ }
175
+ set.add(feature.title);
176
+ }
177
+ if (set.size === 0) {
178
+ for (const title of CLUSTER_DEFAULTS[name]?.features ?? []) {
179
+ set.add(title);
180
+ }
181
+ }
182
+ features.set(name, set);
183
+ }
184
+ // the servers: the family's class with the features, else the device type's, else the default
185
+ const servers = [];
186
+ const clusters = new Map();
187
+ const defaults = {};
188
+ for (const [name, { server, info }] of required) {
189
+ const family = familyFor(name);
190
+ const set = features.get(name) ?? new Set();
191
+ let chosen;
192
+ if (family !== undefined) {
193
+ chosen = family.server;
194
+ if (set.size > 0) {
195
+ chosen = chosen.with(...set);
196
+ }
197
+ const alterations = alterationsOf(server, family.server);
198
+ if (Object.keys(alterations).length > 0 && chosen.alter !== undefined) {
199
+ chosen = chosen.alter({ attributes: alterations });
200
+ }
201
+ }
202
+ else {
203
+ chosen = server ?? behaviors[`${name}Server`];
204
+ const own = new Set(featureTitles(chosen));
205
+ if ([...set].some((f) => !own.has(f))) {
206
+ chosen = chosen.with(...set);
207
+ }
208
+ }
209
+ servers.push(chosen);
210
+ clusters.set(name, info.behaviorId);
211
+ const clusterDefaults = CLUSTER_DEFAULTS[name]?.attributes?.(set);
212
+ const familyDefaults = family?.defaults?.(set, options);
213
+ const configured = endpoint.attributes?.[name];
214
+ if (clusterDefaults !== undefined || familyDefaults !== undefined || configured !== undefined) {
215
+ defaults[info.behaviorId] = { ...clusterDefaults, ...familyDefaults, ...configured };
216
+ }
217
+ }
218
+ const deviceTypeList = definitions.map(({ info }) => ({ deviceType: info.id, revision: info.revision }));
219
+ let type = primary.definition.with(...servers);
220
+ if (bridged) {
221
+ // the device's own endpoint under the aggregator: BridgedDeviceBasicInformation adds the BridgedNode type
222
+ type = type.with(BridgedDeviceBasicInformationServer);
223
+ clusters.set('BridgedDeviceBasicInformation', 'bridgedDeviceBasicInformation');
224
+ }
225
+ if (others.length > 0) {
226
+ defaults.descriptor = { ...defaults.descriptor, deviceTypeList };
227
+ }
228
+ return { type, features, defaults, deviceTypeList, clusters };
229
+ }
230
+ //# sourceMappingURL=device-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"device-types.js","sourceRoot":"","sources":["../../src/matter/device-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /** the characters matter.js accepts in an endpoint id; anything else becomes `_` */
2
+ export declare function sanitizeId(text: string): string;
3
+ export declare function deviceEndpointId(deviceKey: string): string;
4
+ export declare function childEndpointId(deviceKey: string, endpointId: string): string;
5
+ /** BridgedDeviceBasicInformation.uniqueId: 32 characters, stable per (bridge, device) */
6
+ export declare function uniqueId(bridgeId: string, deviceKey: string): string;
7
+ /** Matter's 32-character strings (labels, product names, serial numbers) */
8
+ export declare function label32(text: string | undefined, fallback: string): string;
9
+ /** a random passcode outside the values the specification forbids */
10
+ export declare function randomPasscode(): number;
11
+ export declare function randomDiscriminator(): number;
12
+ /**
13
+ * BasicInformation.softwareVersion (uint32) from the package's semver: major·1 000 000 + minor·1 000 + patch.
14
+ * It grows with every release, which is what controllers and OTA compare; a pre-release counts as its release.
15
+ */
16
+ export declare function softwareVersionNumber(version: string): number;
17
+ /** the product's own hardware: mqtt2matter is software, its "hardware" is version 1 */
18
+ export declare const HARDWARE_VERSION = 1;
19
+ /** the vendor name of the bridge node itself */
20
+ export declare const VENDOR_NAME = "mqtt2matter";
21
+ /** the bridge's productLabel: Matter says it should not include the vendor name */
22
+ export declare const BRIDGE_PRODUCT_LABEL = "MQTT to Matter bridge";
23
+ /** a productLabel without the vendor name (Matter: "should not include" it); the fallback when nothing is left */
24
+ export declare function productLabel(text: string | undefined, vendorName: string, fallback: string): string;
25
+ /** BridgedDeviceBasicInformation of a bridged device */
26
+ export declare function bridgedInformation(bridgeId: string, key: string, device: {
27
+ name: string;
28
+ vendor?: string | undefined;
29
+ model?: string | undefined;
30
+ serial?: string | undefined;
31
+ }, primaryType: string, softwareVersion: string): Record<string, unknown>;
@@ -0,0 +1,83 @@
1
+ /* Identity on the Matter side. matter.js persists endpoint numbers per endpoint id path, so the ids
2
+ here are what keeps a device's endpoint number stable across restarts: the device key is the id of
3
+ the bridged node, `<key>~<endpoint id>` a child's. The unique id controllers use to recognise a device
4
+ is a hash of the bridge id and the device key; it never changes while the key does not. Renaming a
5
+ device changes `name`, never the key. */
6
+ import { createHash } from 'node:crypto';
7
+ /** the characters matter.js accepts in an endpoint id; anything else becomes `_` */
8
+ export function sanitizeId(text) {
9
+ return text.replace(/[^A-Za-z0-9:._-]/g, '_');
10
+ }
11
+ export function deviceEndpointId(deviceKey) {
12
+ return sanitizeId(deviceKey);
13
+ }
14
+ export function childEndpointId(deviceKey, endpointId) {
15
+ return `${sanitizeId(deviceKey)}~${sanitizeId(endpointId)}`;
16
+ }
17
+ /** BridgedDeviceBasicInformation.uniqueId: 32 characters, stable per (bridge, device) */
18
+ export function uniqueId(bridgeId, deviceKey) {
19
+ return createHash('sha256').update(`${bridgeId}|${deviceKey}`).digest('hex').slice(0, 32);
20
+ }
21
+ /** Matter's 32-character strings (labels, product names, serial numbers) */
22
+ export function label32(text, fallback) {
23
+ const value = (text ?? '').trim() || fallback;
24
+ return value.length > 32 ? value.slice(0, 32) : value;
25
+ }
26
+ /** a random passcode outside the values the specification forbids */
27
+ export function randomPasscode() {
28
+ const forbidden = new Set([
29
+ 0, 11111111, 22222222, 33333333, 44444444, 55555555, 66666666, 77777777, 88888888, 99999999, 12345678, 87654321,
30
+ ]);
31
+ for (;;) {
32
+ const candidate = 1 + Math.floor(Math.random() * 99999998);
33
+ if (!forbidden.has(candidate)) {
34
+ return candidate;
35
+ }
36
+ }
37
+ }
38
+ export function randomDiscriminator() {
39
+ return Math.floor(Math.random() * 4096);
40
+ }
41
+ /**
42
+ * BasicInformation.softwareVersion (uint32) from the package's semver: major·1 000 000 + minor·1 000 + patch.
43
+ * It grows with every release, which is what controllers and OTA compare; a pre-release counts as its release.
44
+ */
45
+ export function softwareVersionNumber(version) {
46
+ const [major = 0, minor = 0, patch = 0] = (version.split('-')[0] ?? '')
47
+ .split('.')
48
+ .map((part) => Math.min(Number.parseInt(part, 10) || 0, 999));
49
+ return Math.min(major, 4293) * 1_000_000 + minor * 1_000 + patch;
50
+ }
51
+ /** the product's own hardware: mqtt2matter is software, its "hardware" is version 1 */
52
+ export const HARDWARE_VERSION = 1;
53
+ /** the vendor name of the bridge node itself */
54
+ export const VENDOR_NAME = 'mqtt2matter';
55
+ /** the bridge's productLabel: Matter says it should not include the vendor name */
56
+ export const BRIDGE_PRODUCT_LABEL = 'MQTT to Matter bridge';
57
+ /** a productLabel without the vendor name (Matter: "should not include" it); the fallback when nothing is left */
58
+ export function productLabel(text, vendorName, fallback) {
59
+ const label = label32(text, fallback);
60
+ if (vendorName === '' || !label.includes(vendorName)) {
61
+ return label;
62
+ }
63
+ const stripped = label.split(vendorName).join(' ').replace(/\s+/g, ' ').trim();
64
+ return stripped === '' || stripped.includes(vendorName) ? fallback.slice(0, 32) : stripped;
65
+ }
66
+ /** BridgedDeviceBasicInformation of a bridged device */
67
+ export function bridgedInformation(bridgeId, key, device, primaryType, softwareVersion) {
68
+ const vendorName = label32(device.vendor, VENDOR_NAME);
69
+ return {
70
+ nodeLabel: label32(device.name, key),
71
+ vendorName,
72
+ productName: label32(device.model, primaryType),
73
+ productLabel: productLabel(device.model, vendorName, primaryType),
74
+ serialNumber: label32(device.serial, key),
75
+ uniqueId: uniqueId(bridgeId, key),
76
+ softwareVersion: softwareVersionNumber(softwareVersion),
77
+ softwareVersionString: softwareVersion.slice(0, 64),
78
+ hardwareVersion: HARDWARE_VERSION,
79
+ hardwareVersionString: String(HARDWARE_VERSION),
80
+ reachable: true,
81
+ };
82
+ }
83
+ //# sourceMappingURL=ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/matter/ids.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export * from './bridge.ts';
2
+ export * from './check.ts';
3
+ export * from './cluster-defaults.ts';
4
+ export * from './device-types.ts';
5
+ export * from './ids.ts';
6
+ export * from './node-manager.ts';
7
+ export * from './shards.ts';
@@ -0,0 +1,8 @@
1
+ export * from "./bridge.js";
2
+ export * from "./check.js";
3
+ export * from "./cluster-defaults.js";
4
+ export * from "./device-types.js";
5
+ export * from "./ids.js";
6
+ export * from "./node-manager.js";
7
+ export * from "./shards.js";
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}