matterbridge 3.4.1 → 3.4.2-dev-20251202-c41a119

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 (326) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/dist/broadcastServer.js +0 -112
  3. package/dist/broadcastServerTypes.js +0 -24
  4. package/dist/cli.js +1 -97
  5. package/dist/cliEmitter.js +0 -37
  6. package/dist/cliHistory.js +0 -38
  7. package/dist/clusters/export.js +0 -2
  8. package/dist/deviceManager.js +1 -113
  9. package/dist/devices/airConditioner.js +0 -57
  10. package/dist/devices/batteryStorage.js +1 -48
  11. package/dist/devices/cooktop.js +0 -56
  12. package/dist/devices/dishwasher.js +0 -57
  13. package/dist/devices/evse.js +10 -74
  14. package/dist/devices/export.js +0 -5
  15. package/dist/devices/extractorHood.js +0 -43
  16. package/dist/devices/heatPump.js +2 -50
  17. package/dist/devices/laundryDryer.js +3 -62
  18. package/dist/devices/laundryWasher.js +4 -70
  19. package/dist/devices/microwaveOven.js +5 -88
  20. package/dist/devices/oven.js +0 -85
  21. package/dist/devices/refrigerator.js +0 -102
  22. package/dist/devices/roboticVacuumCleaner.js +9 -100
  23. package/dist/devices/solarPower.js +0 -38
  24. package/dist/devices/speaker.js +0 -84
  25. package/dist/devices/temperatureControl.js +3 -24
  26. package/dist/devices/waterHeater.js +2 -82
  27. package/dist/dgram/coap.js +13 -126
  28. package/dist/dgram/dgram.js +2 -114
  29. package/dist/dgram/mb_coap.js +3 -41
  30. package/dist/dgram/mb_mdns.js +15 -80
  31. package/dist/dgram/mdns.js +137 -299
  32. package/dist/dgram/multicast.js +1 -62
  33. package/dist/dgram/unicast.js +0 -54
  34. package/dist/frontend.js +35 -455
  35. package/dist/frontendTypes.js +0 -45
  36. package/dist/helpers.js +0 -53
  37. package/dist/index.js +0 -25
  38. package/dist/jestutils/export.js +0 -1
  39. package/dist/jestutils/jestHelpers.js +13 -368
  40. package/dist/logger/export.js +0 -1
  41. package/dist/matter/behaviors.js +0 -2
  42. package/dist/matter/clusters.js +0 -2
  43. package/dist/matter/devices.js +0 -2
  44. package/dist/matter/endpoints.js +0 -2
  45. package/dist/matter/export.js +0 -3
  46. package/dist/matter/types.js +0 -3
  47. package/dist/matterNode.js +8 -369
  48. package/dist/matterbridge.js +46 -807
  49. package/dist/matterbridgeAccessoryPlatform.js +0 -38
  50. package/dist/matterbridgeBehaviors.js +5 -68
  51. package/dist/matterbridgeDeviceTypes.js +14 -635
  52. package/dist/matterbridgeDynamicPlatform.js +0 -38
  53. package/dist/matterbridgeEndpoint.js +53 -1444
  54. package/dist/matterbridgeEndpointHelpers.js +20 -483
  55. package/dist/matterbridgeEndpointTypes.js +0 -25
  56. package/dist/matterbridgePlatform.js +1 -450
  57. package/dist/matterbridgeTypes.js +0 -26
  58. package/dist/pluginManager.js +5 -341
  59. package/dist/shelly.js +7 -178
  60. package/dist/storage/export.js +0 -1
  61. package/dist/update.js +1 -93
  62. package/dist/utils/colorUtils.js +2 -97
  63. package/dist/utils/commandLine.js +0 -60
  64. package/dist/utils/copyDirectory.js +0 -37
  65. package/dist/utils/createDirectory.js +0 -33
  66. package/dist/utils/createZip.js +2 -47
  67. package/dist/utils/deepCopy.js +0 -39
  68. package/dist/utils/deepEqual.js +1 -72
  69. package/dist/utils/error.js +0 -42
  70. package/dist/utils/export.js +0 -1
  71. package/dist/utils/format.js +0 -49
  72. package/dist/utils/hex.js +0 -124
  73. package/dist/utils/inspector.js +1 -69
  74. package/dist/utils/isvalid.js +0 -101
  75. package/dist/utils/network.js +5 -96
  76. package/dist/utils/spawn.js +1 -71
  77. package/dist/utils/tracker.js +1 -64
  78. package/dist/utils/wait.js +8 -60
  79. package/dist/workerGlobalPrefix.js +5 -37
  80. package/dist/workerTypes.js +0 -24
  81. package/dist/workers.js +4 -68
  82. package/frontend/build/assets/index.js +4 -4
  83. package/frontend/build/assets/vendor_mui.js +1 -1
  84. package/frontend/package.json +1 -1
  85. package/npm-shrinkwrap.json +14 -10
  86. package/package.json +1 -2
  87. package/dist/broadcastServer.d.ts +0 -136
  88. package/dist/broadcastServer.d.ts.map +0 -1
  89. package/dist/broadcastServer.js.map +0 -1
  90. package/dist/broadcastServerTypes.d.ts +0 -841
  91. package/dist/broadcastServerTypes.d.ts.map +0 -1
  92. package/dist/broadcastServerTypes.js.map +0 -1
  93. package/dist/cli.d.ts +0 -30
  94. package/dist/cli.d.ts.map +0 -1
  95. package/dist/cli.js.map +0 -1
  96. package/dist/cliEmitter.d.ts +0 -50
  97. package/dist/cliEmitter.d.ts.map +0 -1
  98. package/dist/cliEmitter.js.map +0 -1
  99. package/dist/cliHistory.d.ts +0 -48
  100. package/dist/cliHistory.d.ts.map +0 -1
  101. package/dist/cliHistory.js.map +0 -1
  102. package/dist/clusters/export.d.ts +0 -2
  103. package/dist/clusters/export.d.ts.map +0 -1
  104. package/dist/clusters/export.js.map +0 -1
  105. package/dist/deviceManager.d.ts +0 -135
  106. package/dist/deviceManager.d.ts.map +0 -1
  107. package/dist/deviceManager.js.map +0 -1
  108. package/dist/devices/airConditioner.d.ts +0 -98
  109. package/dist/devices/airConditioner.d.ts.map +0 -1
  110. package/dist/devices/airConditioner.js.map +0 -1
  111. package/dist/devices/batteryStorage.d.ts +0 -48
  112. package/dist/devices/batteryStorage.d.ts.map +0 -1
  113. package/dist/devices/batteryStorage.js.map +0 -1
  114. package/dist/devices/cooktop.d.ts +0 -61
  115. package/dist/devices/cooktop.d.ts.map +0 -1
  116. package/dist/devices/cooktop.js.map +0 -1
  117. package/dist/devices/dishwasher.d.ts +0 -71
  118. package/dist/devices/dishwasher.d.ts.map +0 -1
  119. package/dist/devices/dishwasher.js.map +0 -1
  120. package/dist/devices/evse.d.ts +0 -76
  121. package/dist/devices/evse.d.ts.map +0 -1
  122. package/dist/devices/evse.js.map +0 -1
  123. package/dist/devices/export.d.ts +0 -17
  124. package/dist/devices/export.d.ts.map +0 -1
  125. package/dist/devices/export.js.map +0 -1
  126. package/dist/devices/extractorHood.d.ts +0 -46
  127. package/dist/devices/extractorHood.d.ts.map +0 -1
  128. package/dist/devices/extractorHood.js.map +0 -1
  129. package/dist/devices/heatPump.d.ts +0 -47
  130. package/dist/devices/heatPump.d.ts.map +0 -1
  131. package/dist/devices/heatPump.js.map +0 -1
  132. package/dist/devices/laundryDryer.d.ts +0 -67
  133. package/dist/devices/laundryDryer.d.ts.map +0 -1
  134. package/dist/devices/laundryDryer.js.map +0 -1
  135. package/dist/devices/laundryWasher.d.ts +0 -81
  136. package/dist/devices/laundryWasher.d.ts.map +0 -1
  137. package/dist/devices/laundryWasher.js.map +0 -1
  138. package/dist/devices/microwaveOven.d.ts +0 -168
  139. package/dist/devices/microwaveOven.d.ts.map +0 -1
  140. package/dist/devices/microwaveOven.js.map +0 -1
  141. package/dist/devices/oven.d.ts +0 -105
  142. package/dist/devices/oven.d.ts.map +0 -1
  143. package/dist/devices/oven.js.map +0 -1
  144. package/dist/devices/refrigerator.d.ts +0 -118
  145. package/dist/devices/refrigerator.d.ts.map +0 -1
  146. package/dist/devices/refrigerator.js.map +0 -1
  147. package/dist/devices/roboticVacuumCleaner.d.ts +0 -112
  148. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  149. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  150. package/dist/devices/solarPower.d.ts +0 -40
  151. package/dist/devices/solarPower.d.ts.map +0 -1
  152. package/dist/devices/solarPower.js.map +0 -1
  153. package/dist/devices/speaker.d.ts +0 -87
  154. package/dist/devices/speaker.d.ts.map +0 -1
  155. package/dist/devices/speaker.js.map +0 -1
  156. package/dist/devices/temperatureControl.d.ts +0 -166
  157. package/dist/devices/temperatureControl.d.ts.map +0 -1
  158. package/dist/devices/temperatureControl.js.map +0 -1
  159. package/dist/devices/waterHeater.d.ts +0 -111
  160. package/dist/devices/waterHeater.d.ts.map +0 -1
  161. package/dist/devices/waterHeater.js.map +0 -1
  162. package/dist/dgram/coap.d.ts +0 -205
  163. package/dist/dgram/coap.d.ts.map +0 -1
  164. package/dist/dgram/coap.js.map +0 -1
  165. package/dist/dgram/dgram.d.ts +0 -141
  166. package/dist/dgram/dgram.d.ts.map +0 -1
  167. package/dist/dgram/dgram.js.map +0 -1
  168. package/dist/dgram/mb_coap.d.ts +0 -24
  169. package/dist/dgram/mb_coap.d.ts.map +0 -1
  170. package/dist/dgram/mb_coap.js.map +0 -1
  171. package/dist/dgram/mb_mdns.d.ts +0 -24
  172. package/dist/dgram/mb_mdns.d.ts.map +0 -1
  173. package/dist/dgram/mb_mdns.js.map +0 -1
  174. package/dist/dgram/mdns.d.ts +0 -290
  175. package/dist/dgram/mdns.d.ts.map +0 -1
  176. package/dist/dgram/mdns.js.map +0 -1
  177. package/dist/dgram/multicast.d.ts +0 -67
  178. package/dist/dgram/multicast.d.ts.map +0 -1
  179. package/dist/dgram/multicast.js.map +0 -1
  180. package/dist/dgram/unicast.d.ts +0 -56
  181. package/dist/dgram/unicast.d.ts.map +0 -1
  182. package/dist/dgram/unicast.js.map +0 -1
  183. package/dist/frontend.d.ts +0 -238
  184. package/dist/frontend.d.ts.map +0 -1
  185. package/dist/frontend.js.map +0 -1
  186. package/dist/frontendTypes.d.ts +0 -529
  187. package/dist/frontendTypes.d.ts.map +0 -1
  188. package/dist/frontendTypes.js.map +0 -1
  189. package/dist/helpers.d.ts +0 -48
  190. package/dist/helpers.d.ts.map +0 -1
  191. package/dist/helpers.js.map +0 -1
  192. package/dist/index.d.ts +0 -34
  193. package/dist/index.d.ts.map +0 -1
  194. package/dist/index.js.map +0 -1
  195. package/dist/jestutils/export.d.ts +0 -2
  196. package/dist/jestutils/export.d.ts.map +0 -1
  197. package/dist/jestutils/export.js.map +0 -1
  198. package/dist/jestutils/jestHelpers.d.ts +0 -340
  199. package/dist/jestutils/jestHelpers.d.ts.map +0 -1
  200. package/dist/jestutils/jestHelpers.js.map +0 -1
  201. package/dist/logger/export.d.ts +0 -2
  202. package/dist/logger/export.d.ts.map +0 -1
  203. package/dist/logger/export.js.map +0 -1
  204. package/dist/matter/behaviors.d.ts +0 -2
  205. package/dist/matter/behaviors.d.ts.map +0 -1
  206. package/dist/matter/behaviors.js.map +0 -1
  207. package/dist/matter/clusters.d.ts +0 -2
  208. package/dist/matter/clusters.d.ts.map +0 -1
  209. package/dist/matter/clusters.js.map +0 -1
  210. package/dist/matter/devices.d.ts +0 -2
  211. package/dist/matter/devices.d.ts.map +0 -1
  212. package/dist/matter/devices.js.map +0 -1
  213. package/dist/matter/endpoints.d.ts +0 -2
  214. package/dist/matter/endpoints.d.ts.map +0 -1
  215. package/dist/matter/endpoints.js.map +0 -1
  216. package/dist/matter/export.d.ts +0 -5
  217. package/dist/matter/export.d.ts.map +0 -1
  218. package/dist/matter/export.js.map +0 -1
  219. package/dist/matter/types.d.ts +0 -3
  220. package/dist/matter/types.d.ts.map +0 -1
  221. package/dist/matter/types.js.map +0 -1
  222. package/dist/matterNode.d.ts +0 -342
  223. package/dist/matterNode.d.ts.map +0 -1
  224. package/dist/matterNode.js.map +0 -1
  225. package/dist/matterbridge.d.ts +0 -493
  226. package/dist/matterbridge.d.ts.map +0 -1
  227. package/dist/matterbridge.js.map +0 -1
  228. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -41
  229. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  230. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  231. package/dist/matterbridgeBehaviors.d.ts +0 -2404
  232. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  233. package/dist/matterbridgeBehaviors.js.map +0 -1
  234. package/dist/matterbridgeDeviceTypes.d.ts +0 -698
  235. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  236. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  237. package/dist/matterbridgeDynamicPlatform.d.ts +0 -41
  238. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  239. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  240. package/dist/matterbridgeEndpoint.d.ts +0 -1507
  241. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  242. package/dist/matterbridgeEndpoint.js.map +0 -1
  243. package/dist/matterbridgeEndpointHelpers.d.ts +0 -787
  244. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  245. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  246. package/dist/matterbridgeEndpointTypes.d.ts +0 -166
  247. package/dist/matterbridgeEndpointTypes.d.ts.map +0 -1
  248. package/dist/matterbridgeEndpointTypes.js.map +0 -1
  249. package/dist/matterbridgePlatform.d.ts +0 -537
  250. package/dist/matterbridgePlatform.d.ts.map +0 -1
  251. package/dist/matterbridgePlatform.js.map +0 -1
  252. package/dist/matterbridgeTypes.d.ts +0 -251
  253. package/dist/matterbridgeTypes.d.ts.map +0 -1
  254. package/dist/matterbridgeTypes.js.map +0 -1
  255. package/dist/pluginManager.d.ts +0 -372
  256. package/dist/pluginManager.d.ts.map +0 -1
  257. package/dist/pluginManager.js.map +0 -1
  258. package/dist/shelly.d.ts +0 -181
  259. package/dist/shelly.d.ts.map +0 -1
  260. package/dist/shelly.js.map +0 -1
  261. package/dist/storage/export.d.ts +0 -2
  262. package/dist/storage/export.d.ts.map +0 -1
  263. package/dist/storage/export.js.map +0 -1
  264. package/dist/update.d.ts +0 -84
  265. package/dist/update.d.ts.map +0 -1
  266. package/dist/update.js.map +0 -1
  267. package/dist/utils/colorUtils.d.ts +0 -101
  268. package/dist/utils/colorUtils.d.ts.map +0 -1
  269. package/dist/utils/colorUtils.js.map +0 -1
  270. package/dist/utils/commandLine.d.ts +0 -66
  271. package/dist/utils/commandLine.d.ts.map +0 -1
  272. package/dist/utils/commandLine.js.map +0 -1
  273. package/dist/utils/copyDirectory.d.ts +0 -35
  274. package/dist/utils/copyDirectory.d.ts.map +0 -1
  275. package/dist/utils/copyDirectory.js.map +0 -1
  276. package/dist/utils/createDirectory.d.ts +0 -34
  277. package/dist/utils/createDirectory.d.ts.map +0 -1
  278. package/dist/utils/createDirectory.js.map +0 -1
  279. package/dist/utils/createZip.d.ts +0 -39
  280. package/dist/utils/createZip.d.ts.map +0 -1
  281. package/dist/utils/createZip.js.map +0 -1
  282. package/dist/utils/deepCopy.d.ts +0 -32
  283. package/dist/utils/deepCopy.d.ts.map +0 -1
  284. package/dist/utils/deepCopy.js.map +0 -1
  285. package/dist/utils/deepEqual.d.ts +0 -54
  286. package/dist/utils/deepEqual.d.ts.map +0 -1
  287. package/dist/utils/deepEqual.js.map +0 -1
  288. package/dist/utils/error.d.ts +0 -45
  289. package/dist/utils/error.d.ts.map +0 -1
  290. package/dist/utils/error.js.map +0 -1
  291. package/dist/utils/export.d.ts +0 -13
  292. package/dist/utils/export.d.ts.map +0 -1
  293. package/dist/utils/export.js.map +0 -1
  294. package/dist/utils/format.d.ts +0 -53
  295. package/dist/utils/format.d.ts.map +0 -1
  296. package/dist/utils/format.js.map +0 -1
  297. package/dist/utils/hex.d.ts +0 -89
  298. package/dist/utils/hex.d.ts.map +0 -1
  299. package/dist/utils/hex.js.map +0 -1
  300. package/dist/utils/inspector.d.ts +0 -87
  301. package/dist/utils/inspector.d.ts.map +0 -1
  302. package/dist/utils/inspector.js.map +0 -1
  303. package/dist/utils/isvalid.d.ts +0 -103
  304. package/dist/utils/isvalid.d.ts.map +0 -1
  305. package/dist/utils/isvalid.js.map +0 -1
  306. package/dist/utils/network.d.ts +0 -111
  307. package/dist/utils/network.d.ts.map +0 -1
  308. package/dist/utils/network.js.map +0 -1
  309. package/dist/utils/spawn.d.ts +0 -33
  310. package/dist/utils/spawn.d.ts.map +0 -1
  311. package/dist/utils/spawn.js.map +0 -1
  312. package/dist/utils/tracker.d.ts +0 -108
  313. package/dist/utils/tracker.d.ts.map +0 -1
  314. package/dist/utils/tracker.js.map +0 -1
  315. package/dist/utils/wait.d.ts +0 -54
  316. package/dist/utils/wait.d.ts.map +0 -1
  317. package/dist/utils/wait.js.map +0 -1
  318. package/dist/workerGlobalPrefix.d.ts +0 -25
  319. package/dist/workerGlobalPrefix.d.ts.map +0 -1
  320. package/dist/workerGlobalPrefix.js.map +0 -1
  321. package/dist/workerTypes.d.ts +0 -52
  322. package/dist/workerTypes.d.ts.map +0 -1
  323. package/dist/workerTypes.js.map +0 -1
  324. package/dist/workers.d.ts +0 -69
  325. package/dist/workers.d.ts.map +0 -1
  326. package/dist/workers.js.map +0 -1
@@ -1,40 +1,9 @@
1
- /**
2
- * This file contains the DeviceManager class.
3
- *
4
- * @file devices.ts
5
- * @author Luca Liguori
6
- * @created 2024-07-26
7
- * @version 1.1.2
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2024, 2025, 2026 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
- // AnsiLogger module
25
1
  import { AnsiLogger, BLUE, CYAN, db, debugStringify, er } from 'node-ansi-logger';
26
2
  import { dev } from './matterbridgeTypes.js';
27
3
  import { BroadcastServer } from './broadcastServer.js';
28
4
  import { hasParameter } from './utils/commandLine.js';
29
- /**
30
- * Converts a MatterbridgeEndpoint to a BaseDevice.
31
- *
32
- * @param {MatterbridgeEndpoint} device The MatterbridgeEndpoint to convert.
33
- * @returns {BaseDevice} The converted BaseDevice.
34
- */
35
5
  export function toBaseDevice(device) {
36
6
  return {
37
- // MatterbridgeEndpoint properties
38
7
  mode: device.mode,
39
8
  plugin: device.plugin,
40
9
  configUrl: device.configUrl,
@@ -54,25 +23,18 @@ export function toBaseDevice(device) {
54
23
  originalId: device.originalId,
55
24
  name: device.name,
56
25
  deviceType: device.deviceType,
57
- // Endpoint properties
58
26
  number: device.number,
59
27
  id: device.id,
60
28
  };
61
29
  }
62
- /**
63
- * Manages Matterbridge devices.
64
- */
65
30
  export class DeviceManager {
66
31
  _devices = new Map();
67
32
  log;
68
33
  server;
69
34
  debug = hasParameter('debug') || hasParameter('verbose');
70
35
  verbose = hasParameter('verbose');
71
- /**
72
- * Creates an instance of DeviceManager.
73
- */
74
36
  constructor() {
75
- this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: hasParameter('debug') ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */ });
37
+ this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: hasParameter('debug') ? "debug" : "info" });
76
38
  this.log.debug('Matterbridge device manager starting...');
77
39
  this.server = new BroadcastServer('devices', this.log);
78
40
  this.server.on('broadcast_message', this.msgHandler.bind(this));
@@ -128,47 +90,18 @@ export class DeviceManager {
128
90
  }
129
91
  }
130
92
  }
131
- /**
132
- * Gets the number of devices.
133
- *
134
- * @returns {number} The number of devices.
135
- */
136
93
  get length() {
137
94
  return this._devices.size;
138
95
  }
139
- /**
140
- * Gets the number of devices.
141
- *
142
- * @returns {number} The number of devices.
143
- */
144
96
  get size() {
145
97
  return this._devices.size;
146
98
  }
147
- /**
148
- * Checks if a device with the specified unique ID exists.
149
- *
150
- * @param {string} uniqueId - The unique ID of the device.
151
- * @returns {boolean} True if the device exists, false otherwise.
152
- */
153
99
  has(uniqueId) {
154
100
  return this._devices.has(uniqueId);
155
101
  }
156
- /**
157
- * Gets a device by its unique ID.
158
- *
159
- * @param {string} uniqueId - The unique ID of the device.
160
- * @returns {MatterbridgeEndpoint | undefined} The device, or undefined if not found.
161
- */
162
102
  get(uniqueId) {
163
103
  return this._devices.get(uniqueId);
164
104
  }
165
- /**
166
- * Adds a device to the manager.
167
- *
168
- * @param {MatterbridgeEndpoint} device - The device to add.
169
- * @returns {MatterbridgeEndpoint} The added device.
170
- * @throws {Error} If the device does not have a unique ID.
171
- */
172
105
  set(device) {
173
106
  if (!device.uniqueId)
174
107
  throw new Error(`The device ${dev}${device.deviceName}${er} has not been initialized: uniqueId is required`);
@@ -177,13 +110,6 @@ export class DeviceManager {
177
110
  this._devices.set(device.uniqueId, device);
178
111
  return device;
179
112
  }
180
- /**
181
- * Removes a device from the manager.
182
- *
183
- * @param {MatterbridgeEndpoint} device - The device to remove.
184
- * @returns {boolean} True if the device was removed, false otherwise.
185
- * @throws {Error} If the device does not have a unique ID.
186
- */
187
113
  remove(device) {
188
114
  if (!device.uniqueId)
189
115
  throw new Error(`The device ${dev}${device.deviceName}${er} has not been initialized: uniqueId is required`);
@@ -191,59 +117,27 @@ export class DeviceManager {
191
117
  this.log.error(`The device ${dev}${device.deviceName}${er} with uniqueId ${BLUE}${device.uniqueId}${er} serialNumber ${BLUE}${device.serialNumber}${er} is not registered in the device manager`);
192
118
  return this._devices.delete(device.uniqueId);
193
119
  }
194
- /**
195
- * Clears all devices from the manager.
196
- */
197
120
  clear() {
198
121
  this._devices.clear();
199
122
  }
200
- /**
201
- * Converts a MatterbridgeEndpoint to a BaseDevice.
202
- *
203
- * @param {MatterbridgeEndpoint} device The MatterbridgeEndpoint to convert.
204
- * @returns {BaseDevice} The converted BaseDevice.
205
- */
206
123
  toBaseDevice(device) {
207
124
  return toBaseDevice(device);
208
125
  }
209
- /**
210
- * Gets an array of all devices.
211
- *
212
- * @returns {MatterbridgeEndpoint[]} An array of all devices.
213
- */
214
126
  array() {
215
127
  return Array.from(this._devices.values());
216
128
  }
217
- /**
218
- * Gets a base array of all devices suitable for serialization.
219
- *
220
- * @param {string} [pluginName] - Optional plugin name to filter devices.
221
- * @returns {ApiDevices[]} A base array of all devices.
222
- */
223
129
  baseArray(pluginName) {
224
130
  const devices = [];
225
131
  for (const device of Array.from(this._devices.values())) {
226
- // Filter by pluginName if provided
227
132
  if (pluginName && pluginName !== device.plugin)
228
133
  continue;
229
134
  devices.push(this.toBaseDevice(device));
230
135
  }
231
136
  return devices;
232
137
  }
233
- /**
234
- * Iterates over all devices.
235
- *
236
- * @returns {IterableIterator<MatterbridgeEndpoint>} An iterator for the devices.
237
- */
238
138
  [Symbol.iterator]() {
239
139
  return this._devices.values();
240
140
  }
241
- /**
242
- * Asynchronously iterates over each device and calls the provided callback function.
243
- *
244
- * @param {(device: MatterbridgeEndpoint) => Promise<void>} callback - The callback function to call with each device.
245
- * @returns {Promise<void>} A promise that resolves when all callbacks have been called.
246
- */
247
141
  async forEach(callback) {
248
142
  if (this.size === 0)
249
143
  return;
@@ -257,13 +151,7 @@ export class DeviceManager {
257
151
  });
258
152
  await Promise.all(tasks);
259
153
  }
260
- /**
261
- * Sets the log level.
262
- *
263
- * @param {LogLevel} logLevel - The log level to set.
264
- */
265
154
  set logLevel(logLevel) {
266
155
  this.log.logLevel = logLevel;
267
156
  }
268
157
  }
269
- //# sourceMappingURL=deviceManager.js.map
@@ -1,64 +1,8 @@
1
- /**
2
- * @description This file contains the AirConditioner class.
3
- * @file src/devices/airConditioner.ts
4
- * @author Luca Liguori
5
- * @created 2025-09-04
6
- * @version 1.0.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
- // Imports from @matter
24
1
  import { ThermostatUserInterfaceConfiguration } from '@matter/types/clusters/thermostat-user-interface-configuration';
25
2
  import { FanControl } from '@matter/types/clusters/fan-control';
26
- // Matterbridge
27
3
  import { airConditioner, powerSource } from '../matterbridgeDeviceTypes.js';
28
4
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
29
5
  export class AirConditioner extends MatterbridgeEndpoint {
30
- /**
31
- * Creates an instance of the AirConditioner class.
32
- *
33
- * A Room Air Conditioner is a device which at a minimum is capable of being turned on and off and of controlling the temperature in the living space.
34
- * A Room Air Conditioner MAY also support additional capabilities via endpoint composition.
35
- * The DF (Dead Front) feature is required for the On/Off cluster in this device type.
36
- *
37
- * @param {string} name - The name of the air conditioner.
38
- * @param {string} serial - The serial number of the air conditioner.
39
- * @param {AirConditionerOptions} [options] - Optional configuration values. Missing fields use defaults.
40
- *
41
- * Options defaults:
42
- * - localTemperature: 23
43
- * - occupiedHeatingSetpoint: 21
44
- * - occupiedCoolingSetpoint: 25
45
- * - minSetpointDeadBand: 1
46
- * - minHeatSetpointLimit: 0
47
- * - maxHeatSetpointLimit: 50
48
- * - minCoolSetpointLimit: 0
49
- * - maxCoolSetpointLimit: 50
50
- * - temperatureDisplayMode: Celsius
51
- * - keypadLockout: NoLockout
52
- * - scheduleProgrammingVisibility: ScheduleProgrammingPermitted
53
- * - fanMode: Off
54
- * - fanModeSequence: OffLowMedHighAuto
55
- * - percentSetting: 0
56
- * - percentCurrent: 0
57
- *
58
- * @returns {AirConditioner} The AirConditioner instance.
59
- *
60
- * @remarks Not supported by Google Home.
61
- */
62
6
  constructor(name, serial, options = {}) {
63
7
  const { localTemperature = 23, occupiedHeatingSetpoint = 21, occupiedCoolingSetpoint = 25, minSetpointDeadBand = 1, minHeatSetpointLimit = 0, maxHeatSetpointLimit = 50, minCoolSetpointLimit = 0, maxCoolSetpointLimit = 50, temperatureDisplayMode = ThermostatUserInterfaceConfiguration.TemperatureDisplayMode.Celsius, keypadLockout = ThermostatUserInterfaceConfiguration.KeypadLockout.NoLockout, scheduleProgrammingVisibility = ThermostatUserInterfaceConfiguration.ScheduleProgrammingVisibility.ScheduleProgrammingPermitted, fanMode = FanControl.FanMode.Off, fanModeSequence = FanControl.FanModeSequence.OffLowMedHighAuto, percentSetting = 0, percentCurrent = 0, } = options;
64
8
  super([airConditioner, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
@@ -71,4 +15,3 @@ export class AirConditioner extends MatterbridgeEndpoint {
71
15
  this.createDefaultFanControlClusterServer(fanMode, fanModeSequence, percentSetting, percentCurrent);
72
16
  }
73
17
  }
74
- //# sourceMappingURL=airConditioner.js.map
@@ -1,53 +1,9 @@
1
- /**
2
- * @description This file contains the BatteryStorage class.
3
- * @file src/devices/batteryStorage.ts
4
- * @author Luca Liguori
5
- * @contributor Ludovic BOUÉ
6
- * @created 2025-06-20
7
- * @version 1.0.0
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2025, 2026, 2027 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
- // @matter
25
1
  import { PowerSourceTag } from '@matter/node';
26
2
  import { DeviceEnergyManagement } from '@matter/types/clusters/device-energy-management';
27
3
  import { PowerSource } from '@matter/types/clusters/power-source';
28
- // Matterbridge
29
4
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
30
5
  import { deviceEnergyManagement, electricalSensor, batteryStorage, powerSource } from '../matterbridgeDeviceTypes.js';
31
6
  export class BatteryStorage extends MatterbridgeEndpoint {
32
- /**
33
- * Creates an instance of the BatteryStorage class.
34
- *
35
- * @param {string} name - The name of the BatteryStorage.
36
- * @param {string} serial - The serial number of the BatteryStorage.
37
- * @param {number} [batPercentRemaining] - The percentage of battery remaining, defaults to `100` if not provided.
38
- * @param {PowerSource.BatChargeLevel} [batChargeLevel] - The battery charge level (default: PowerSource.BatChargeLevel.Ok).
39
- * @param {number} voltage - The voltage value in millivolts.
40
- * @param {number} current - The current value in milliamperes.
41
- * @param {number} power - The power value in milliwatts.
42
- * @param {number} energyImported - The total production value in mW/h.
43
- * @param {number} energyExported - The total production value in mW/h.
44
- * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
45
- * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
46
- *
47
- * @remarks
48
- * - A battery storage inverter that can charge its battery at a maximum power of 2000W and can
49
- * discharge the battery at a maximum power of 3000W, would have a absMinPower: -3000W, absMaxPower: 2000W.
50
- */
51
7
  constructor(name, serial, batPercentRemaining = 100, batChargeLevel = PowerSource.BatChargeLevel.Ok, voltage = null, current = null, power = null, energyImported = null, energyExported = null, absMinPower = 0, absMaxPower = 0) {
52
8
  super([batteryStorage, electricalSensor, deviceEnergyManagement], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
53
9
  this.createDefaultIdentifyClusterServer()
@@ -58,12 +14,10 @@ export class BatteryStorage extends MatterbridgeEndpoint {
58
14
  .createDefaultDeviceEnergyManagementClusterServer(DeviceEnergyManagement.EsaType.BatteryStorage, true, DeviceEnergyManagement.EsaState.Online, absMinPower, absMaxPower)
59
15
  .createDefaultDeviceEnergyManagementModeClusterServer()
60
16
  .addRequiredClusterServers();
61
- // Add separate PowerSource child devices cause in matter.js the PowerSource cluster is not supported with both features Wired and Battery.
62
- // Probably this is also an error in the specification...
63
17
  this.addChildDeviceType('BatteryPowerSource', powerSource, {
64
18
  tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Battery.namespaceId, tag: PowerSourceTag.Battery.tag, label: null }],
65
19
  })
66
- .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000) // Battery voltage in mV (24V).
20
+ .createDefaultPowerSourceRechargeableBatteryClusterServer(batPercentRemaining, batChargeLevel, 24_000)
67
21
  .addRequiredClusterServers();
68
22
  this.addChildDeviceType('GridPowerSource', powerSource, {
69
23
  tagList: [{ mfgCode: null, namespaceId: PowerSourceTag.Grid.namespaceId, tag: PowerSourceTag.Grid.tag, label: null }],
@@ -72,4 +26,3 @@ export class BatteryStorage extends MatterbridgeEndpoint {
72
26
  .addRequiredClusterServers();
73
27
  }
74
28
  }
75
- //# sourceMappingURL=batteryStorage.js.map
@@ -1,45 +1,7 @@
1
- /**
2
- * @description This file contains the Cooktop class.
3
- * @file src/devices/cooktop.ts
4
- * @author Luca Liguori
5
- * @created 2025-05-25
6
- * @version 1.1.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
- // Matterbridge
24
1
  import { cookSurface, cooktop, powerSource } from '../matterbridgeDeviceTypes.js';
25
2
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
26
3
  import { createLevelTemperatureControlClusterServer } from './temperatureControl.js';
27
4
  export class Cooktop extends MatterbridgeEndpoint {
28
- /**
29
- * Creates an instance of the Cooktop class.
30
- *
31
- * @param {string} name - The name of the cooktop.
32
- * @param {string} serial - The serial number of the cooktop.
33
- *
34
- * @remarks
35
- * 13.8 A cooktop is a cooking surface that heats food either by transferring currents from an electromagnetic
36
- * field located below the glass surface directly to the magnetic induction cookware placed
37
- * above or through traditional gas or electric burners.
38
- *
39
- * 13.8.4 A Cooktop SHALL be composed of zero or more endpoints with the Cook Surface device type.
40
- * An Cooktop is always defined via endpoint composition.
41
- * - Use `addSurface` to add one or more surfaces to the cooktop.
42
- */
43
5
  constructor(name, serial) {
44
6
  super([cooktop, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
45
7
  this.createDefaultIdentifyClusterServer();
@@ -48,23 +10,6 @@ export class Cooktop extends MatterbridgeEndpoint {
48
10
  this.createOffOnlyOnOffClusterServer(true);
49
11
  this.addFixedLabel('composed', 'Cooktop');
50
12
  }
51
- /**
52
- * Adds a surface to the cooktop.
53
- *
54
- * @param {string} name - The name of the surface.
55
- * @param {Semtag[]} tagList - The tagList associated with the surface.
56
- * @param {number} selectedTemperatureLevel - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 2 (which corresponds to 'Level 3').
57
- * @param {string[]} supportedTemperatureLevels - The list of supported temperature levels for the surface. Defaults to ['Level 1', 'Level 2', 'Level 3', 'Level 4', 'Level 5'].
58
- *
59
- * @returns {MatterbridgeEndpoint} The MatterbridgeEndpoint instance representing the surface.
60
- *
61
- * @remarks
62
- * 13.7 A Cook Surface device type represents a heating object on a cooktop or other similar device. It
63
- * SHALL only be used when composed as part of another device type.
64
- *
65
- * The OffOnly feature is required for the On/Off cluster in this device type due to safety requirements.
66
- * TemperatureLevel is the only valid temperature control mode.
67
- */
68
13
  addSurface(name, tagList, selectedTemperatureLevel = 2, supportedTemperatureLevels = ['Level 1', 'Level 2', 'Level 3', 'Level 4', 'Level 5']) {
69
14
  const surface = this.addChildDeviceType(name, cookSurface, { tagList }, true);
70
15
  surface.log.logName = name;
@@ -74,4 +19,3 @@ export class Cooktop extends MatterbridgeEndpoint {
74
19
  return surface;
75
20
  }
76
21
  }
77
- //# sourceMappingURL=cooktop.js.map
@@ -1,54 +1,12 @@
1
- /**
2
- * @description This file contains the Dishwasher class.
3
- * @file src/devices/dishwasher.ts
4
- * @author Luca Liguori
5
- * @created 2025-05-25
6
- * @version 1.1.0
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2025, 2026, 2027 Luca Liguori.
10
- *
11
- * Licensed under the Apache License, Version 2.0 (the "License");
12
- * you may not use this file except in compliance with the License.
13
- * You may obtain a copy of the License at
14
- *
15
- * http://www.apache.org/licenses/LICENSE-2.0
16
- *
17
- * Unless required by applicable law or agreed to in writing, software
18
- * distributed under the License is distributed on an "AS IS" BASIS,
19
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
- * See the License for the specific language governing permissions and
21
- * limitations under the License.
22
- */
23
1
  import { ModeBase } from '@matter/types/clusters/mode-base';
24
2
  import { DishwasherMode } from '@matter/types/clusters/dishwasher-mode';
25
3
  import { DishwasherModeServer } from '@matter/node/behaviors/dishwasher-mode';
26
4
  import { DishwasherAlarmServer } from '@matter/node/behaviors/dishwasher-alarm';
27
- // Matterbridge
28
5
  import { dishwasher, powerSource } from '../matterbridgeDeviceTypes.js';
29
6
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
30
7
  import { MatterbridgeOnOffServer, MatterbridgeServer } from '../matterbridgeBehaviors.js';
31
8
  import { createLevelTemperatureControlClusterServer, createNumberTemperatureControlClusterServer } from './temperatureControl.js';
32
9
  export class Dishwasher extends MatterbridgeEndpoint {
33
- /**
34
- * Creates an instance of the DishWasher class.
35
- *
36
- * @param {string} name - The name of the dish washer.
37
- * @param {string} serial - The serial number of the dish washer.
38
- * @param {number} [currentMode] - The current mode of the dish washer. Defaults to 2 (Normal mode). Dead Front OnOff Cluster will set this to 2 when turned off. Persistent attribute.
39
- * @param {DishwasherMode.ModeOption[]} [supportedModes] - The supported modes of the dish washer. Defaults to a set of common modes (which include Light, Normal, Heavy). Fixed attribute.
40
- * @param {number} [selectedTemperatureLevel] - The selected temperature level as an index of the supportedTemperatureLevels array. Defaults to 1 (which corresponds to 'Warm').
41
- * @param {string[]} [supportedTemperatureLevels] - The supported temperature levels. Defaults to ['Cold', 'Warm', 'Hot', '30°', '40°', '60°', '80°']. Fixed attribute.
42
- * @param {number} [temperatureSetpoint] - The temperature setpoint * 100. Defaults to 40 * 100 (which corresponds to 40°C).
43
- * @param {number} [minTemperature] - The minimum temperature * 100. Defaults to 30 * 100 (which corresponds to 30°C). Fixed attribute.
44
- * @param {number} [maxTemperature] - The maximum temperature * 100. Defaults to 60 * 100 (which corresponds to 60°C). Fixed attribute.
45
- * @param {number} [step] - The step size for temperature changes. Defaults to 10 * 100 (which corresponds to 10°C). Fixed attribute.
46
- * @param {OperationalState.OperationalStateEnum} [operationalState] - The operational state of the laundry washer. Defaults to OperationalState.OperationalStateEnum.Off.
47
- *
48
- * Remarks:
49
- * - If `temperatureSetpoint` is provided, the `createNumberTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with features TemperatureNumber and TemperatureStep.
50
- * - If `temperatureSetpoint` is not provided, the `createLevelTemperatureControlClusterServer` method will be used to create the TemperatureControl Cluster Server with feature TemperatureLevel.
51
- */
52
10
  constructor(name, serial, currentMode, supportedModes, selectedTemperatureLevel, supportedTemperatureLevels, temperatureSetpoint, minTemperature, maxTemperature, step, operationalState) {
53
11
  super([dishwasher, powerSource], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
54
12
  this.createDefaultIdentifyClusterServer();
@@ -63,14 +21,6 @@ export class Dishwasher extends MatterbridgeEndpoint {
63
21
  createLevelTemperatureControlClusterServer(this, selectedTemperatureLevel, supportedTemperatureLevels);
64
22
  this.createDefaultOperationalStateClusterServer(operationalState);
65
23
  }
66
- /**
67
- * Creates a default Dishwasher Mode Cluster Server.
68
- *
69
- * @param {number} currentMode - The current mode of the dishwasher. Persistent attribute.
70
- * @param {DishwasherMode.ModeOption[]} supportedModes - The supported modes of the dishwasher. Defaults to a set of common modes (Light, Normal, Heavy). Fixed attribute.
71
- *
72
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
73
- */
74
24
  createDefaultDishwasherModeClusterServer(currentMode = 2, supportedModes = [
75
25
  { label: 'Light', mode: 1, modeTags: [{ value: DishwasherMode.ModeTag.Light }] },
76
26
  { label: 'Normal', mode: 2, modeTags: [{ value: DishwasherMode.ModeTag.Normal }] },
@@ -82,11 +32,6 @@ export class Dishwasher extends MatterbridgeEndpoint {
82
32
  });
83
33
  return this;
84
34
  }
85
- /**
86
- * Creates a default Dishwasher Alarm Cluster Server.
87
- *
88
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
89
- */
90
35
  createDefaultDishwasherAlarmClusterServer() {
91
36
  this.behaviors.require(DishwasherAlarmServer, {
92
37
  mask: { inflowError: true, drainError: true, doorError: true, tempTooLow: true, tempTooHigh: true, waterLevelError: true },
@@ -103,7 +48,6 @@ export class MatterbridgeDishwasherModeServer extends DishwasherModeServer {
103
48
  this.state.currentMode = 2;
104
49
  this.reactTo(this.agent.get(MatterbridgeOnOffServer).events.onOff$Changed, this.handleOnOffChange);
105
50
  }
106
- // Dead Front OnOff Cluster
107
51
  handleOnOffChange(onOff) {
108
52
  const device = this.endpoint.stateOf(MatterbridgeServer);
109
53
  if (onOff === false) {
@@ -127,4 +71,3 @@ export class MatterbridgeDishwasherModeServer extends DishwasherModeServer {
127
71
  }
128
72
  }
129
73
  }
130
- //# sourceMappingURL=dishwasher.js.map
@@ -1,54 +1,13 @@
1
- /**
2
- * @description This file contains the Evse class.
3
- * @file src/devices/energy-evse.ts
4
- * @author Luca Liguori
5
- * @contributor Ludovic BOUÉ
6
- * @created 2025-05-27
7
- * @version 1.1.0
8
- * @license Apache-2.0
9
- *
10
- * Copyright 2025, 2026, 2027 Luca Liguori.
11
- *
12
- * Licensed under the Apache License, Version 2.0 (the "License");
13
- * you may not use this file except in compliance with the License.
14
- * You may obtain a copy of the License at
15
- *
16
- * http://www.apache.org/licenses/LICENSE-2.0
17
- *
18
- * Unless required by applicable law or agreed to in writing, software
19
- * distributed under the License is distributed on an "AS IS" BASIS,
20
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- * See the License for the specific language governing permissions and
22
- * limitations under the License.
23
- */
24
1
  import { EnergyEvseMode } from '@matter/types/clusters/energy-evse-mode';
25
2
  import { EnergyEvse } from '@matter/types/clusters/energy-evse';
26
3
  import { DeviceEnergyManagement } from '@matter/types/clusters/device-energy-management';
27
4
  import { ModeBase } from '@matter/types/clusters/mode-base';
28
5
  import { EnergyEvseServer } from '@matter/node/behaviors/energy-evse';
29
6
  import { EnergyEvseModeServer } from '@matter/node/behaviors/energy-evse-mode';
30
- // Matterbridge
31
7
  import { MatterbridgeEndpoint } from '../matterbridgeEndpoint.js';
32
8
  import { MatterbridgeServer } from '../matterbridgeBehaviors.js';
33
9
  import { deviceEnergyManagement, electricalSensor, evse, powerSource } from '../matterbridgeDeviceTypes.js';
34
10
  export class Evse extends MatterbridgeEndpoint {
35
- /**
36
- * Creates an instance of the EVSE class.
37
- *
38
- * @param {string} name - The name of the EVSE.
39
- * @param {string} serial - The serial number of the EVSE.
40
- * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
41
- * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. This is a fixed attribute that defaults to a predefined set of EnergyEvseMode cluster modes.
42
- * @param {EnergyEvse.State} [state] - The current state of the EVSE. Defaults to NotPluggedIn.
43
- * @param {EnergyEvse.SupplyState} [supplyState] - The supply state of the EVSE. Defaults to Disabled.
44
- * @param {EnergyEvse.FaultState} [faultState] - The fault state of the EVSE. Defaults to NoError.
45
- * @param {number} [voltage] - The voltage value in millivolts. Defaults to null if not provided.
46
- * @param {number} [current] - The current value in milliamperes. Defaults to null if not provided.
47
- * @param {number} [power] - The power value in milliwatts. Defaults to null if not provided.
48
- * @param {number} [energy] - The total consumption value in mW/h. Defaults to null if not provided.
49
- * @param {number} [absMinPower] - Indicate the minimum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
50
- * @param {number} [absMaxPower] - Indicate the maximum electrical power in mw that the ESA can consume when switched on. Defaults to `0` if not provided.
51
- */
52
11
  constructor(name, serial, currentMode, supportedModes, state, supplyState, faultState, voltage = null, current = null, power = null, energy = null, absMinPower, absMaxPower) {
53
12
  super([evse, powerSource, electricalSensor, deviceEnergyManagement], { id: `${name.replaceAll(' ', '')}-${serial.replaceAll(' ', '')}` });
54
13
  this.createDefaultIdentifyClusterServer()
@@ -63,47 +22,30 @@ export class Evse extends MatterbridgeEndpoint {
63
22
  .createDefaultEnergyEvseModeClusterServer(currentMode, supportedModes)
64
23
  .addRequiredClusterServers();
65
24
  }
66
- /**
67
- * Creates a default EnergyEvseServer Cluster Server.
68
- *
69
- * @param {EnergyEvse.State} [state] - The initial state of the EnergyEvse cluster. Defaults to EnergyEvse.State.NotPluggedIn.
70
- * @param {EnergyEvse.SupplyState} [supplyState] - The initial supply state of the EnergyEvse cluster. Defaults to EnergyEvse.SupplyState.ChargingEnabled.
71
- * @param {EnergyEvse.FaultState} [faultState] - The initial fault state of the EnergyEvse cluster. Defaults to EnergyEvse.FaultState.NoError.
72
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
73
- */
74
25
  createDefaultEnergyEvseClusterServer(state, supplyState, faultState) {
75
26
  this.behaviors.require(MatterbridgeEnergyEvseServer, {
76
27
  state: state !== undefined ? state : EnergyEvse.State.NotPluggedIn,
77
28
  supplyState: supplyState !== undefined ? supplyState : EnergyEvse.SupplyState.ChargingEnabled,
78
29
  faultState: faultState !== undefined ? faultState : EnergyEvse.FaultState.NoError,
79
- chargingEnabledUntil: null, // Persistent attribute. A null value indicates the EVSE is always enabled for charging.
80
- circuitCapacity: 32_000, // Persistent attribute in mA. 32A in mA.
81
- minimumChargeCurrent: 6_000, // Persistent attribute in mA. 6A in mA.
82
- maximumChargeCurrent: 32_000, // Persistent attribute in mA. 32A in mA.
83
- userMaximumChargeCurrent: 32_000, // Persistent attribute in mA. 32A in mA.
84
- sessionId: null, // Persistent attribute
85
- sessionDuration: null, // Persistent attribute
86
- sessionEnergyCharged: null, // Persistent attribute
30
+ chargingEnabledUntil: null,
31
+ circuitCapacity: 32_000,
32
+ minimumChargeCurrent: 6_000,
33
+ maximumChargeCurrent: 32_000,
34
+ userMaximumChargeCurrent: 32_000,
35
+ sessionId: null,
36
+ sessionDuration: null,
37
+ sessionEnergyCharged: null,
87
38
  });
88
39
  return this;
89
40
  }
90
- /**
91
- * Creates a default EnergyEvseMode Cluster Server.
92
- *
93
- * @param {number} [currentMode] - The current mode of the EnergyEvseMode cluster. Defaults to mode 1 (EnergyEvseMode.ModeTag.Manual).
94
- * @param {EnergyEvseMode.ModeOption[]} [supportedModes] - The supported modes for the EnergyEvseMode cluster. Defaults all EnergyEvseMode cluster modes.
95
- *
96
- * @returns {this} The current MatterbridgeEndpoint instance for chaining.
97
- */
98
41
  createDefaultEnergyEvseModeClusterServer(currentMode, supportedModes) {
99
42
  this.behaviors.require(MatterbridgeEnergyEvseModeServer, {
100
43
  supportedModes: supportedModes ?? [
101
44
  { label: 'On demand', mode: 1, modeTags: [{ value: EnergyEvseMode.ModeTag.Manual }] },
102
45
  { label: 'Scheduled', mode: 2, modeTags: [{ value: EnergyEvseMode.ModeTag.TimeOfUse }] },
103
46
  { label: 'Solar charging', mode: 3, modeTags: [{ value: EnergyEvseMode.ModeTag.SolarCharging }] },
104
- // { label: 'Home to vehicle and Vehicle to home', mode: 4, modeTags: [{ value: EnergyEvseMode.ModeTag.V2X }] }, // This mode is not valid in charging only EVSEs
105
- ], // FixedAttribute
106
- currentMode: currentMode ?? 1, // Persistent attribute
47
+ ],
48
+ currentMode: currentMode ?? 1,
107
49
  });
108
50
  return this;
109
51
  }
@@ -119,8 +61,6 @@ export class MatterbridgeEnergyEvseServer extends EnergyEvseServer {
119
61
  this.state.state = EnergyEvse.State.PluggedInDemand;
120
62
  }
121
63
  this.state.chargingEnabledUntil = 0;
122
- // super.disable();
123
- // disable is not implemented in matter.js
124
64
  }
125
65
  enableCharging(request) {
126
66
  const device = this.endpoint.stateOf(MatterbridgeServer);
@@ -134,9 +74,6 @@ export class MatterbridgeEnergyEvseServer extends EnergyEvseServer {
134
74
  this.state.chargingEnabledUntil = request.chargingEnabledUntil;
135
75
  this.state.minimumChargeCurrent = request.minimumChargeCurrent;
136
76
  this.state.maximumChargeCurrent = request.maximumChargeCurrent;
137
- // The implementation should also stop the charging session at the required time and update the sessionId, sessionDuration, and sessionEnergyCharged attributes if needed.
138
- // super.enableCharging();
139
- // enableCharging is not implemented in matter.js
140
77
  }
141
78
  }
142
79
  export class MatterbridgeEnergyEvseModeServer extends EnergyEvseModeServer {
@@ -154,4 +91,3 @@ export class MatterbridgeEnergyEvseModeServer extends EnergyEvseModeServer {
154
91
  return { status: ModeBase.ModeChangeStatus.Success, statusText: 'Success' };
155
92
  }
156
93
  }
157
- //# sourceMappingURL=evse.js.map
@@ -1,8 +1,5 @@
1
- // Chapter 10. Media Device Types - Single class device types
2
1
  export * from './speaker.js';
3
- // Chapter 12. Robotic Device Types - Single class device types
4
2
  export * from './roboticVacuumCleaner.js';
5
- // Chapter 13. Appliances Device Types - Single class device types
6
3
  export * from './laundryWasher.js';
7
4
  export * from './laundryDryer.js';
8
5
  export * from './extractorHood.js';
@@ -12,10 +9,8 @@ export * from './oven.js';
12
9
  export * from './cooktop.js';
13
10
  export * from './refrigerator.js';
14
11
  export * from './airConditioner.js';
15
- // Chapter 14. Energy Device Types - Single class device types
16
12
  export * from './waterHeater.js';
17
13
  export * from './evse.js';
18
14
  export * from './solarPower.js';
19
15
  export * from './batteryStorage.js';
20
16
  export * from './heatPump.js';
21
- //# sourceMappingURL=export.js.map