matterbridge 3.1.8-dev-20250727-662308b → 3.1.8

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 (248) hide show
  1. package/CHANGELOG.md +1 -1
  2. package/dist/cli.d.ts +26 -0
  3. package/dist/cli.d.ts.map +1 -0
  4. package/dist/cli.js +91 -2
  5. package/dist/cli.js.map +1 -0
  6. package/dist/cliEmitter.d.ts +34 -0
  7. package/dist/cliEmitter.d.ts.map +1 -0
  8. package/dist/cliEmitter.js +30 -0
  9. package/dist/cliEmitter.js.map +1 -0
  10. package/dist/clusters/export.d.ts +2 -0
  11. package/dist/clusters/export.d.ts.map +1 -0
  12. package/dist/clusters/export.js +2 -0
  13. package/dist/clusters/export.js.map +1 -0
  14. package/dist/defaultConfigSchema.d.ts +28 -0
  15. package/dist/defaultConfigSchema.d.ts.map +1 -0
  16. package/dist/defaultConfigSchema.js +24 -0
  17. package/dist/defaultConfigSchema.js.map +1 -0
  18. package/dist/deviceManager.d.ts +112 -0
  19. package/dist/deviceManager.d.ts.map +1 -0
  20. package/dist/deviceManager.js +94 -1
  21. package/dist/deviceManager.js.map +1 -0
  22. package/dist/devices/batteryStorage.d.ts +48 -0
  23. package/dist/devices/batteryStorage.d.ts.map +1 -0
  24. package/dist/devices/batteryStorage.js +48 -1
  25. package/dist/devices/batteryStorage.js.map +1 -0
  26. package/dist/devices/dishwasher.d.ts +91 -0
  27. package/dist/devices/dishwasher.d.ts.map +1 -0
  28. package/dist/devices/dishwasher.js +78 -3
  29. package/dist/devices/dishwasher.js.map +1 -0
  30. package/dist/devices/evse.d.ts +75 -0
  31. package/dist/devices/evse.d.ts.map +1 -0
  32. package/dist/devices/evse.js +74 -10
  33. package/dist/devices/evse.js.map +1 -0
  34. package/dist/devices/export.d.ts +11 -0
  35. package/dist/devices/export.d.ts.map +1 -0
  36. package/dist/devices/export.js +2 -0
  37. package/dist/devices/export.js.map +1 -0
  38. package/dist/devices/extractorHood.d.ts +46 -0
  39. package/dist/devices/extractorHood.d.ts.map +1 -0
  40. package/dist/devices/extractorHood.js +42 -0
  41. package/dist/devices/extractorHood.js.map +1 -0
  42. package/dist/devices/heatPump.d.ts +47 -0
  43. package/dist/devices/heatPump.d.ts.map +1 -0
  44. package/dist/devices/heatPump.js +50 -2
  45. package/dist/devices/heatPump.js.map +1 -0
  46. package/dist/devices/laundryDryer.d.ts +87 -0
  47. package/dist/devices/laundryDryer.d.ts.map +1 -0
  48. package/dist/devices/laundryDryer.js +83 -6
  49. package/dist/devices/laundryDryer.js.map +1 -0
  50. package/dist/devices/laundryWasher.d.ts +242 -0
  51. package/dist/devices/laundryWasher.d.ts.map +1 -0
  52. package/dist/devices/laundryWasher.js +91 -7
  53. package/dist/devices/laundryWasher.js.map +1 -0
  54. package/dist/devices/roboticVacuumCleaner.d.ts +112 -0
  55. package/dist/devices/roboticVacuumCleaner.d.ts.map +1 -0
  56. package/dist/devices/roboticVacuumCleaner.js +93 -7
  57. package/dist/devices/roboticVacuumCleaner.js.map +1 -0
  58. package/dist/devices/solarPower.d.ts +40 -0
  59. package/dist/devices/solarPower.d.ts.map +1 -0
  60. package/dist/devices/solarPower.js +38 -0
  61. package/dist/devices/solarPower.js.map +1 -0
  62. package/dist/devices/waterHeater.d.ts +111 -0
  63. package/dist/devices/waterHeater.d.ts.map +1 -0
  64. package/dist/devices/waterHeater.js +82 -2
  65. package/dist/devices/waterHeater.js.map +1 -0
  66. package/dist/dgram/coap.d.ts +205 -0
  67. package/dist/dgram/coap.d.ts.map +1 -0
  68. package/dist/dgram/coap.js +126 -13
  69. package/dist/dgram/coap.js.map +1 -0
  70. package/dist/dgram/dgram.d.ts +140 -0
  71. package/dist/dgram/dgram.d.ts.map +1 -0
  72. package/dist/dgram/dgram.js +113 -2
  73. package/dist/dgram/dgram.js.map +1 -0
  74. package/dist/dgram/mb_coap.d.ts +24 -0
  75. package/dist/dgram/mb_coap.d.ts.map +1 -0
  76. package/dist/dgram/mb_coap.js +41 -3
  77. package/dist/dgram/mb_coap.js.map +1 -0
  78. package/dist/dgram/mb_mdns.d.ts +24 -0
  79. package/dist/dgram/mb_mdns.d.ts.map +1 -0
  80. package/dist/dgram/mb_mdns.js +51 -13
  81. package/dist/dgram/mb_mdns.js.map +1 -0
  82. package/dist/dgram/mdns.d.ts +288 -0
  83. package/dist/dgram/mdns.d.ts.map +1 -0
  84. package/dist/dgram/mdns.js +298 -137
  85. package/dist/dgram/mdns.js.map +1 -0
  86. package/dist/dgram/multicast.d.ts +65 -0
  87. package/dist/dgram/multicast.d.ts.map +1 -0
  88. package/dist/dgram/multicast.js +60 -1
  89. package/dist/dgram/multicast.js.map +1 -0
  90. package/dist/dgram/unicast.d.ts +56 -0
  91. package/dist/dgram/unicast.d.ts.map +1 -0
  92. package/dist/dgram/unicast.js +54 -0
  93. package/dist/dgram/unicast.js.map +1 -0
  94. package/dist/frontend.d.ts +313 -0
  95. package/dist/frontend.d.ts.map +1 -0
  96. package/dist/frontend.js +449 -23
  97. package/dist/frontend.js.map +1 -0
  98. package/dist/globalMatterbridge.d.ts +59 -0
  99. package/dist/globalMatterbridge.d.ts.map +1 -0
  100. package/dist/globalMatterbridge.js +47 -0
  101. package/dist/globalMatterbridge.js.map +1 -0
  102. package/dist/helpers.d.ts +48 -0
  103. package/dist/helpers.d.ts.map +1 -0
  104. package/dist/helpers.js +53 -0
  105. package/dist/helpers.js.map +1 -0
  106. package/dist/index.d.ts +33 -0
  107. package/dist/index.d.ts.map +1 -0
  108. package/dist/index.js +30 -1
  109. package/dist/index.js.map +1 -0
  110. package/dist/logger/export.d.ts +2 -0
  111. package/dist/logger/export.d.ts.map +1 -0
  112. package/dist/logger/export.js +1 -0
  113. package/dist/logger/export.js.map +1 -0
  114. package/dist/matter/behaviors.d.ts +2 -0
  115. package/dist/matter/behaviors.d.ts.map +1 -0
  116. package/dist/matter/behaviors.js +2 -0
  117. package/dist/matter/behaviors.js.map +1 -0
  118. package/dist/matter/clusters.d.ts +2 -0
  119. package/dist/matter/clusters.d.ts.map +1 -0
  120. package/dist/matter/clusters.js +2 -0
  121. package/dist/matter/clusters.js.map +1 -0
  122. package/dist/matter/devices.d.ts +2 -0
  123. package/dist/matter/devices.d.ts.map +1 -0
  124. package/dist/matter/devices.js +2 -0
  125. package/dist/matter/devices.js.map +1 -0
  126. package/dist/matter/endpoints.d.ts +2 -0
  127. package/dist/matter/endpoints.d.ts.map +1 -0
  128. package/dist/matter/endpoints.js +2 -0
  129. package/dist/matter/endpoints.js.map +1 -0
  130. package/dist/matter/export.d.ts +5 -0
  131. package/dist/matter/export.d.ts.map +1 -0
  132. package/dist/matter/export.js +3 -0
  133. package/dist/matter/export.js.map +1 -0
  134. package/dist/matter/types.d.ts +3 -0
  135. package/dist/matter/types.d.ts.map +1 -0
  136. package/dist/matter/types.js +3 -0
  137. package/dist/matter/types.js.map +1 -0
  138. package/dist/matterbridge.d.ts +463 -0
  139. package/dist/matterbridge.d.ts.map +1 -0
  140. package/dist/matterbridge.js +803 -50
  141. package/dist/matterbridge.js.map +1 -0
  142. package/dist/matterbridgeAccessoryPlatform.d.ts +42 -0
  143. package/dist/matterbridgeAccessoryPlatform.d.ts.map +1 -0
  144. package/dist/matterbridgeAccessoryPlatform.js +36 -0
  145. package/dist/matterbridgeAccessoryPlatform.js.map +1 -0
  146. package/dist/matterbridgeBehaviors.d.ts +1351 -0
  147. package/dist/matterbridgeBehaviors.d.ts.map +1 -0
  148. package/dist/matterbridgeBehaviors.js +65 -5
  149. package/dist/matterbridgeBehaviors.js.map +1 -0
  150. package/dist/matterbridgeDeviceTypes.d.ts +709 -0
  151. package/dist/matterbridgeDeviceTypes.d.ts.map +1 -0
  152. package/dist/matterbridgeDeviceTypes.js +579 -15
  153. package/dist/matterbridgeDeviceTypes.js.map +1 -0
  154. package/dist/matterbridgeDynamicPlatform.d.ts +42 -0
  155. package/dist/matterbridgeDynamicPlatform.d.ts.map +1 -0
  156. package/dist/matterbridgeDynamicPlatform.js +36 -0
  157. package/dist/matterbridgeDynamicPlatform.js.map +1 -0
  158. package/dist/matterbridgeEndpoint.d.ts +1348 -0
  159. package/dist/matterbridgeEndpoint.d.ts.map +1 -0
  160. package/dist/matterbridgeEndpoint.js +1214 -54
  161. package/dist/matterbridgeEndpoint.js.map +1 -0
  162. package/dist/matterbridgeEndpointHelpers.d.ts +406 -0
  163. package/dist/matterbridgeEndpointHelpers.d.ts.map +1 -0
  164. package/dist/matterbridgeEndpointHelpers.js +344 -12
  165. package/dist/matterbridgeEndpointHelpers.js.map +1 -0
  166. package/dist/matterbridgePlatform.d.ts +310 -0
  167. package/dist/matterbridgePlatform.d.ts.map +1 -0
  168. package/dist/matterbridgePlatform.js +233 -0
  169. package/dist/matterbridgePlatform.js.map +1 -0
  170. package/dist/matterbridgeTypes.d.ts +197 -0
  171. package/dist/matterbridgeTypes.d.ts.map +1 -0
  172. package/dist/matterbridgeTypes.js +25 -0
  173. package/dist/matterbridgeTypes.js.map +1 -0
  174. package/dist/pluginManager.d.ts +270 -0
  175. package/dist/pluginManager.d.ts.map +1 -0
  176. package/dist/pluginManager.js +249 -3
  177. package/dist/pluginManager.js.map +1 -0
  178. package/dist/shelly.d.ts +174 -0
  179. package/dist/shelly.d.ts.map +1 -0
  180. package/dist/shelly.js +168 -7
  181. package/dist/shelly.js.map +1 -0
  182. package/dist/storage/export.d.ts +2 -0
  183. package/dist/storage/export.d.ts.map +1 -0
  184. package/dist/storage/export.js +1 -0
  185. package/dist/storage/export.js.map +1 -0
  186. package/dist/update.d.ts +68 -0
  187. package/dist/update.d.ts.map +1 -0
  188. package/dist/update.js +63 -0
  189. package/dist/update.js.map +1 -0
  190. package/dist/utils/colorUtils.d.ts +117 -0
  191. package/dist/utils/colorUtils.d.ts.map +1 -0
  192. package/dist/utils/colorUtils.js +263 -2
  193. package/dist/utils/colorUtils.js.map +1 -0
  194. package/dist/utils/commandLine.d.ts +59 -0
  195. package/dist/utils/commandLine.d.ts.map +1 -0
  196. package/dist/utils/commandLine.js +54 -0
  197. package/dist/utils/commandLine.js.map +1 -0
  198. package/dist/utils/copyDirectory.d.ts +33 -0
  199. package/dist/utils/copyDirectory.d.ts.map +1 -0
  200. package/dist/utils/copyDirectory.js +38 -1
  201. package/dist/utils/copyDirectory.js.map +1 -0
  202. package/dist/utils/createDirectory.d.ts +34 -0
  203. package/dist/utils/createDirectory.d.ts.map +1 -0
  204. package/dist/utils/createDirectory.js +33 -0
  205. package/dist/utils/createDirectory.js.map +1 -0
  206. package/dist/utils/createZip.d.ts +39 -0
  207. package/dist/utils/createZip.d.ts.map +1 -0
  208. package/dist/utils/createZip.js +47 -2
  209. package/dist/utils/createZip.js.map +1 -0
  210. package/dist/utils/deepCopy.d.ts +32 -0
  211. package/dist/utils/deepCopy.d.ts.map +1 -0
  212. package/dist/utils/deepCopy.js +39 -0
  213. package/dist/utils/deepCopy.js.map +1 -0
  214. package/dist/utils/deepEqual.d.ts +54 -0
  215. package/dist/utils/deepEqual.d.ts.map +1 -0
  216. package/dist/utils/deepEqual.js +72 -1
  217. package/dist/utils/deepEqual.js.map +1 -0
  218. package/dist/utils/error.d.ts +44 -0
  219. package/dist/utils/error.d.ts.map +1 -0
  220. package/dist/utils/error.js +41 -0
  221. package/dist/utils/error.js.map +1 -0
  222. package/dist/utils/export.d.ts +12 -0
  223. package/dist/utils/export.d.ts.map +1 -0
  224. package/dist/utils/export.js +1 -0
  225. package/dist/utils/export.js.map +1 -0
  226. package/dist/utils/hex.d.ts +89 -0
  227. package/dist/utils/hex.d.ts.map +1 -0
  228. package/dist/utils/hex.js +123 -0
  229. package/dist/utils/hex.js.map +1 -0
  230. package/dist/utils/isvalid.d.ts +103 -0
  231. package/dist/utils/isvalid.d.ts.map +1 -0
  232. package/dist/utils/isvalid.js +101 -0
  233. package/dist/utils/isvalid.js.map +1 -0
  234. package/dist/utils/network.d.ts +74 -0
  235. package/dist/utils/network.d.ts.map +1 -0
  236. package/dist/utils/network.js +81 -5
  237. package/dist/utils/network.js.map +1 -0
  238. package/dist/utils/spawn.d.ts +33 -0
  239. package/dist/utils/spawn.d.ts.map +1 -0
  240. package/dist/utils/spawn.js +40 -0
  241. package/dist/utils/spawn.js.map +1 -0
  242. package/dist/utils/wait.d.ts +56 -0
  243. package/dist/utils/wait.d.ts.map +1 -0
  244. package/dist/utils/wait.js +62 -9
  245. package/dist/utils/wait.js.map +1 -0
  246. package/npm-shrinkwrap.json +2 -2
  247. package/package.json +2 -1
  248. package/vitest/matterbridge.test.ts +0 -218
@@ -0,0 +1,56 @@
1
+ /**
2
+ * This file contains the wait, waiter and withTimeout functions.
3
+ *
4
+ * @file wait.ts
5
+ * @author Luca Liguori
6
+ * @created 2025-02-16
7
+ * @version 1.0.1
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
+ import { AnsiLogger } from '../logger/export.js';
25
+ export declare const log: AnsiLogger;
26
+ /**
27
+ * Asynchronous waiter function that resolves when the provided condition is met or rejects on timeout.
28
+ *
29
+ * @param {string} name - The name of the waiter.
30
+ * @param {() => boolean} check - A function that checks the condition. Should return a boolean.
31
+ * @param {boolean} [exitWithReject] - Optional. If true, the promise will be rejected on timeout. Default is false.
32
+ * @param {number} [resolveTimeout] - Optional. The timeout duration in milliseconds. Default is 5000ms.
33
+ * @param {number} [resolveInterval] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
34
+ * @param {boolean} [debug] - Optional. If true, debug messages will be logged to the console. Default is false.
35
+ * @returns {Promise<boolean>} A promise that resolves to true when the condition is met, or false if the timeout occurs.
36
+ */
37
+ export declare function waiter(name: string, check: () => boolean, exitWithReject?: boolean, resolveTimeout?: number, resolveInterval?: number, debug?: boolean): Promise<boolean>;
38
+ /**
39
+ * Asynchronously waits for a specified amount of time.
40
+ *
41
+ * @param {number} timeout - The duration to wait in milliseconds. Default is 1000ms.
42
+ * @param {string} name - The name of the wait operation. Default is undefined.
43
+ * @param {boolean} debug - Whether to enable debug logging. Default is false.
44
+ * @returns {Promise<void>} A Promise that resolves after the specified timeout.
45
+ */
46
+ export declare function wait(timeout?: number, name?: string, debug?: boolean): Promise<void>;
47
+ /**
48
+ * Wraps a promise with a timeout. If the promise does not resolve or reject within the specified time, it will be rejected.
49
+ *
50
+ * @param {Promise<T>} promise - The promise to wrap.
51
+ * @param {number} [timeoutMillisecs] - The timeout duration in milliseconds. Default is 10000ms.
52
+ * @param {boolean} [reThrow] - Optional. If true, the promise will rethrow the original promise and will reject on timeout. Default is true.
53
+ * @returns {Promise<T>} A new promise that resolves or rejects based on the original promise and the timeout.
54
+ */
55
+ export declare function withTimeout<T>(promise: Promise<T>, timeoutMillisecs?: number, reThrow?: boolean): Promise<T>;
56
+ //# sourceMappingURL=wait.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,UAAU,EAA6B,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,GAAG,YAA6H,CAAC;AAE9I;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,EAAE,cAAc,GAAE,OAAe,EAAE,cAAc,GAAE,MAAa,EAAE,eAAe,GAAE,MAAY,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBxM;AAED;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,MAAa,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvG;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,GAAE,MAAc,EAAE,OAAO,GAAE,OAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBzH"}
@@ -1,9 +1,44 @@
1
+ /**
2
+ * This file contains the wait, waiter and withTimeout functions.
3
+ *
4
+ * @file wait.ts
5
+ * @author Luca Liguori
6
+ * @created 2025-02-16
7
+ * @version 1.0.1
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
+ // AnsiLogger module
1
25
  import { AnsiLogger } from '../logger/export.js';
2
- export const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
26
+ export const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "info" /* LogLevel.INFO */ });
27
+ /**
28
+ * Asynchronous waiter function that resolves when the provided condition is met or rejects on timeout.
29
+ *
30
+ * @param {string} name - The name of the waiter.
31
+ * @param {() => boolean} check - A function that checks the condition. Should return a boolean.
32
+ * @param {boolean} [exitWithReject] - Optional. If true, the promise will be rejected on timeout. Default is false.
33
+ * @param {number} [resolveTimeout] - Optional. The timeout duration in milliseconds. Default is 5000ms.
34
+ * @param {number} [resolveInterval] - Optional. The interval duration in milliseconds between condition checks. Default is 500ms.
35
+ * @param {boolean} [debug] - Optional. If true, debug messages will be logged to the console. Default is false.
36
+ * @returns {Promise<boolean>} A promise that resolves to true when the condition is met, or false if the timeout occurs.
37
+ */
3
38
  export async function waiter(name, check, exitWithReject = false, resolveTimeout = 5000, resolveInterval = 500, debug = false) {
4
39
  if (check())
5
40
  return true;
6
- log.logLevel = "debug";
41
+ log.logLevel = "debug" /* LogLevel.DEBUG */;
7
42
  log.logName = 'Waiter';
8
43
  if (debug)
9
44
  log.debug(`Waiter "${name}" started...`);
@@ -30,11 +65,20 @@ export async function waiter(name, check, exitWithReject = false, resolveTimeout
30
65
  }, resolveInterval);
31
66
  });
32
67
  }
68
+ /**
69
+ * Asynchronously waits for a specified amount of time.
70
+ *
71
+ * @param {number} timeout - The duration to wait in milliseconds. Default is 1000ms.
72
+ * @param {string} name - The name of the wait operation. Default is undefined.
73
+ * @param {boolean} debug - Whether to enable debug logging. Default is false.
74
+ * @returns {Promise<void>} A Promise that resolves after the specified timeout.
75
+ */
33
76
  export async function wait(timeout = 1000, name, debug = false) {
34
- log.logLevel = "debug";
77
+ log.logLevel = "debug" /* LogLevel.DEBUG */;
35
78
  log.logName = 'Wait';
36
79
  if (debug)
37
80
  log.debug(`Wait "${name}" started...`);
81
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
38
82
  return new Promise((resolve, reject) => {
39
83
  const timeoutId = setTimeout(() => {
40
84
  if (debug)
@@ -44,6 +88,14 @@ export async function wait(timeout = 1000, name, debug = false) {
44
88
  }, timeout);
45
89
  });
46
90
  }
91
+ /**
92
+ * Wraps a promise with a timeout. If the promise does not resolve or reject within the specified time, it will be rejected.
93
+ *
94
+ * @param {Promise<T>} promise - The promise to wrap.
95
+ * @param {number} [timeoutMillisecs] - The timeout duration in milliseconds. Default is 10000ms.
96
+ * @param {boolean} [reThrow] - Optional. If true, the promise will rethrow the original promise and will reject on timeout. Default is true.
97
+ * @returns {Promise<T>} A new promise that resolves or rejects based on the original promise and the timeout.
98
+ */
47
99
  export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
48
100
  return new Promise((resolve, reject) => {
49
101
  const timer = setTimeout(() => {
@@ -51,23 +103,24 @@ export function withTimeout(promise, timeoutMillisecs = 10000, reThrow = true) {
51
103
  reject(new Error('Operation timed out'));
52
104
  }
53
105
  else {
54
- resolve(undefined);
106
+ resolve(undefined); // Resolve with undefined if reThrow is false
55
107
  }
56
- }, timeoutMillisecs).unref();
108
+ }, timeoutMillisecs).unref(); // Unref the timer to prevent it from keeping the event loop alive
57
109
  promise
58
110
  .then((result) => {
59
- clearTimeout(timer);
111
+ clearTimeout(timer); // Prevent memory leak
60
112
  resolve(result);
61
113
  return result;
62
114
  })
63
115
  .catch((error) => {
64
- clearTimeout(timer);
116
+ clearTimeout(timer); // Ensure timeout does not fire if promise rejects first
65
117
  if (reThrow) {
66
- reject(error);
118
+ reject(error); // Reject with the original error
67
119
  }
68
120
  else {
69
- resolve(undefined);
121
+ resolve(undefined); // Resolve with undefined if reThrow is false
70
122
  }
71
123
  });
72
124
  });
73
125
  }
126
+ //# sourceMappingURL=wait.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"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"}
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "matterbridge",
3
- "version": "3.1.8-dev-20250727-662308b",
3
+ "version": "3.1.8",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "matterbridge",
9
- "version": "3.1.8-dev-20250727-662308b",
9
+ "version": "3.1.8",
10
10
  "license": "Apache-2.0",
11
11
  "dependencies": {
12
12
  "@matter/main": "0.15.1",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "matterbridge",
3
- "version": "3.1.8-dev-20250727-662308b",
3
+ "version": "3.1.8",
4
4
  "description": "Matterbridge plugin manager for Matter",
5
5
  "author": "https://github.com/Luligu",
6
6
  "license": "Apache-2.0",
@@ -41,6 +41,7 @@
41
41
  ],
42
42
  "type": "module",
43
43
  "main": "dist/index.js",
44
+ "types": "dist/index.d.ts",
44
45
  "bin": {
45
46
  "matterbridge": "bin/matterbridge.js",
46
47
  "mb_mdns": "bin/mb_mdns.js",
@@ -1,218 +0,0 @@
1
- import path from 'node:path';
2
-
3
- import { vi, describe, it, expect, beforeEach, afterEach, MockInstance } from 'vitest';
4
- import { AnsiLogger, LogLevel, TimestampFormat } from 'node-ansi-logger';
5
-
6
- import * as spawn from '../src/utils/spawn.ts';
7
- import { Matterbridge } from '../src/matterbridge.ts';
8
-
9
- const NAME = 'ViMatterbridgeGlobal';
10
- const HOMEDIR = path.join('jest', NAME);
11
-
12
- process.argv = ['node', 'matterbridge.test.js', '-novirtual', '-frontend', '0', '-homedir', HOMEDIR, '-logger', 'debug', '-matterlogger', 'debug'];
13
-
14
- // Partial mock for @matter/main, preserving all actual exports except Logger
15
- vi.mock('@matter/main', async (importOriginal) => {
16
- const actual = await importOriginal();
17
- return {
18
- ...(actual as Record<string, unknown>),
19
- Logger: {
20
- log: vi.fn(),
21
- info: vi.fn(),
22
- debug: vi.fn(),
23
- warn: vi.fn(),
24
- error: vi.fn(),
25
- fatal: vi.fn(),
26
- addLogger: vi.fn(),
27
- setLogger: vi.fn(),
28
- removeLogger: vi.fn(),
29
- toJSON: vi.fn(() => ''),
30
- },
31
- };
32
- });
33
-
34
- let loggerLogSpy: MockInstance<typeof AnsiLogger.prototype.log>;
35
- let consoleLogSpy: MockInstance<typeof console.log>;
36
- let consoleDebugSpy: MockInstance<typeof console.debug>;
37
- let consoleInfoSpy: MockInstance<typeof console.info>;
38
- let consoleWarnSpy: MockInstance<typeof console.warn>;
39
- let consoleErrorSpy: MockInstance<typeof console.error>;
40
- const debug = false; // Set to true to enable debug logging
41
-
42
- if (!debug) {
43
- loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log').mockImplementation((level: string, message: string, ...parameters: any[]) => {});
44
- consoleLogSpy = vi.spyOn(console, 'log').mockImplementation((...args: any[]) => {});
45
- consoleDebugSpy = vi.spyOn(console, 'debug').mockImplementation((...args: any[]) => {});
46
- consoleInfoSpy = vi.spyOn(console, 'info').mockImplementation((...args: any[]) => {});
47
- consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation((...args: any[]) => {});
48
- consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation((...args: any[]) => {});
49
- } else {
50
- loggerLogSpy = vi.spyOn(AnsiLogger.prototype, 'log');
51
- consoleLogSpy = vi.spyOn(console, 'log');
52
- consoleDebugSpy = vi.spyOn(console, 'debug');
53
- consoleInfoSpy = vi.spyOn(console, 'info');
54
- consoleWarnSpy = vi.spyOn(console, 'warn');
55
- consoleErrorSpy = vi.spyOn(console, 'error');
56
- }
57
-
58
- describe('Matterbridge', () => {
59
- let matterbridge: Matterbridge;
60
-
61
- beforeEach(async () => {
62
- matterbridge = await Matterbridge.loadInstance(false);
63
- // Set up required properties/mocks
64
- matterbridge.log = { debug: vi.fn(), info: vi.fn(), notice: vi.fn(), warn: vi.fn(), error: vi.fn(), fatal: vi.fn(), now: vi.fn() } as any;
65
- // matterbridge.log = new AnsiLogger({ logName: 'Matterbridge', logTimestampFormat: TimestampFormat.TIME_MILLIS, logLevel: LogLevel.DEBUG });
66
- matterbridge.plugins = { array: () => [], clear: vi.fn(), [Symbol.iterator]: function* () {} } as any;
67
- matterbridge.devices = { array: () => [], clear: vi.fn(), [Symbol.iterator]: function* () {} } as any;
68
- matterbridge.frontend = {
69
- start: vi.fn(),
70
- stop: vi.fn(),
71
- wssSendRefreshRequired: vi.fn(),
72
- wssSendRestartRequired: vi.fn(),
73
- wssSendSnackbarMessage: vi.fn(),
74
- wssSendMessage: vi.fn(),
75
- } as any;
76
- });
77
-
78
- afterEach(() => {
79
- vi.clearAllMocks();
80
- });
81
-
82
- it('should initialize system and matterbridge information', () => {
83
- expect(matterbridge.systemInformation).toBeDefined();
84
- expect(matterbridge.matterbridgeInformation).toBeDefined();
85
- });
86
-
87
- it('should emit initialize_completed after initialize', async () => {
88
- const spy = vi.fn();
89
- matterbridge.on('initialize_completed', spy);
90
- await matterbridge.initialize();
91
- expect(spy).toHaveBeenCalled();
92
- expect((matterbridge as any)['initialized']).toBe(true);
93
- });
94
-
95
- it('should call parseCommandLine during initialize', async () => {
96
- const spy = vi.spyOn(matterbridge as any, 'parseCommandLine').mockResolvedValue(undefined);
97
- await matterbridge.initialize();
98
- expect(spy).toHaveBeenCalled();
99
- });
100
-
101
- it('should log system info in logNodeAndSystemInfo', async () => {
102
- await (matterbridge as any)['logNodeAndSystemInfo']();
103
- expect(matterbridge.log.debug).toHaveBeenCalled();
104
- });
105
-
106
- it('should register and deregister process handlers', () => {
107
- (matterbridge as any)['registerProcessHandlers']();
108
- (matterbridge as any)['deregisterProcessHandlers']();
109
- expect(matterbridge.log.error).not.toHaveBeenCalled();
110
- });
111
-
112
- it('should call cleanup and emit cleanup events', async () => {
113
- (matterbridge as any)['initialized'] = true;
114
- (matterbridge as any)['hasCleanupStarted'] = false;
115
- const spyStart = vi.fn();
116
- const spyComplete = vi.fn();
117
- matterbridge.on('cleanup_started', spyStart);
118
- matterbridge.on('cleanup_completed', spyComplete);
119
- await (matterbridge as any)['cleanup']('test cleanup');
120
- expect(spyStart).toHaveBeenCalled();
121
- expect(spyComplete).toHaveBeenCalled();
122
- });
123
-
124
- it('should not run cleanup if already started', async () => {
125
- (matterbridge as any)['initialized'] = true;
126
- (matterbridge as any)['hasCleanupStarted'] = true;
127
- const debugSpy = matterbridge.log.debug as any;
128
- await (matterbridge as any)['cleanup']('test cleanup');
129
- expect(debugSpy).toHaveBeenCalledWith('Cleanup already started...');
130
- });
131
-
132
- it('should get devices using getDevices()', () => {
133
- const fakeDevices = [{ id: 1 }, { id: 2 }];
134
- matterbridge.devices.array = vi.fn(() => fakeDevices) as any;
135
- expect(matterbridge.getDevices()).toBe(fakeDevices);
136
- });
137
-
138
- it('should get plugins using getPlugins()', () => {
139
- const fakePlugins = [{ name: 'p1' }, { name: 'p2' }];
140
- matterbridge.plugins.array = vi.fn(() => fakePlugins) as any;
141
- expect(matterbridge.getPlugins()).toBe(fakePlugins);
142
- });
143
-
144
- it('should set log level and propagate to dependencies', async () => {
145
- const setLevel = vi.fn();
146
- matterbridge.frontend.logLevel = LogLevel.NONE; // Set to NONE initially
147
- matterbridge.devices.logLevel = LogLevel.NONE;
148
- matterbridge.plugins.logLevel = LogLevel.NONE;
149
- (global as any).MatterbridgeEndpoint = { logLevel: LogLevel.NONE };
150
- matterbridge.log = { debug: vi.fn() } as any;
151
- await matterbridge.setLogLevel(LogLevel.INFO);
152
- expect(matterbridge.frontend.logLevel).toBe(LogLevel.INFO);
153
- expect(matterbridge.devices.logLevel).toBe(LogLevel.INFO);
154
- expect(matterbridge.plugins.logLevel).toBe(LogLevel.INFO);
155
- expect(matterbridge.log.debug).toHaveBeenCalled();
156
- });
157
-
158
- it('should emit and listen to custom events', () => {
159
- const handler = vi.fn();
160
- matterbridge.on('online', handler);
161
- matterbridge.emit('online', 'nodeid');
162
- expect(handler).toHaveBeenCalledWith('nodeid');
163
- });
164
-
165
- it('should call destroyInstance and cleanup', async () => {
166
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
167
- matterbridge.log.info = vi.fn();
168
- await matterbridge.destroyInstance(10);
169
- expect(cleanupSpy).toHaveBeenCalled();
170
- expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Destroy instance...'));
171
- });
172
-
173
- it('should call restartProcess and cleanup', async () => {
174
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
175
- await matterbridge.restartProcess();
176
- expect(cleanupSpy).toHaveBeenCalledWith('restarting...', true);
177
- });
178
-
179
- it('should call shutdownProcess and cleanup', async () => {
180
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
181
- await matterbridge.shutdownProcess();
182
- expect(cleanupSpy).toHaveBeenCalledWith('shutting down...', false);
183
- });
184
-
185
- it('should call updateProcess and cleanup', async () => {
186
- const spawnSpy = vi.spyOn(spawn, 'spawnCommand').mockResolvedValueOnce(true);
187
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
188
- matterbridge.log.info = vi.fn();
189
- await matterbridge.updateProcess();
190
- expect(spawnSpy).toHaveBeenCalledWith(matterbridge, 'npm', ['install', '-g', 'matterbridge', '--omit=dev', '--verbose']);
191
- expect(cleanupSpy).toHaveBeenCalledWith('updating...', false);
192
- expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Updating matterbridge...'));
193
- expect((matterbridge.frontend as any).wssSendRestartRequired).toHaveBeenCalled();
194
- });
195
-
196
- it('should call unregisterAndShutdownProcess and cleanup', async () => {
197
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
198
- matterbridge.log.info = vi.fn();
199
- matterbridge.plugins = [{ name: 'p1' }] as any;
200
- matterbridge.removeAllBridgedEndpoints = vi.fn().mockResolvedValue(undefined);
201
- matterbridge.devices.clear = vi.fn();
202
- await matterbridge.unregisterAndShutdownProcess();
203
- expect(cleanupSpy).toHaveBeenCalledWith('unregistered all devices and shutting down...', false);
204
- expect(matterbridge.log.info).toHaveBeenCalledWith(expect.stringContaining('Unregistering all devices and shutting down...'));
205
- });
206
-
207
- it('should call shutdownProcessAndReset and cleanup', async () => {
208
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
209
- await matterbridge.shutdownProcessAndReset();
210
- expect(cleanupSpy).toHaveBeenCalledWith('shutting down with reset...', false);
211
- });
212
-
213
- it('should call shutdownProcessAndFactoryReset and cleanup', async () => {
214
- const cleanupSpy = vi.spyOn(matterbridge as any, 'cleanup').mockResolvedValue(undefined);
215
- await matterbridge.shutdownProcessAndFactoryReset();
216
- expect(cleanupSpy).toHaveBeenCalledWith('shutting down with factory reset...', false);
217
- });
218
- });