matterbridge 3.2.6 → 3.2.7-dev-20250908-3bb699e

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 +20 -0
  2. package/dist/cli.js +2 -91
  3. package/dist/cliEmitter.js +0 -30
  4. package/dist/clusters/export.js +0 -2
  5. package/dist/defaultConfigSchema.js +3 -24
  6. package/dist/deviceManager.js +1 -94
  7. package/dist/devices/airConditioner.js +0 -57
  8. package/dist/devices/batteryStorage.js +1 -48
  9. package/dist/devices/cooktop.js +0 -55
  10. package/dist/devices/dishwasher.js +0 -57
  11. package/dist/devices/evse.js +10 -74
  12. package/dist/devices/export.js +0 -5
  13. package/dist/devices/extractorHood.js +0 -42
  14. package/dist/devices/heatPump.js +2 -50
  15. package/dist/devices/laundryDryer.js +3 -62
  16. package/dist/devices/laundryWasher.js +4 -70
  17. package/dist/devices/microwaveOven.js +5 -88
  18. package/dist/devices/oven.js +0 -85
  19. package/dist/devices/refrigerator.js +0 -102
  20. package/dist/devices/roboticVacuumCleaner.js +9 -100
  21. package/dist/devices/solarPower.js +0 -38
  22. package/dist/devices/speaker.js +0 -80
  23. package/dist/devices/temperatureControl.js +3 -25
  24. package/dist/devices/waterHeater.js +2 -82
  25. package/dist/dgram/coap.js +13 -126
  26. package/dist/dgram/dgram.js +2 -114
  27. package/dist/dgram/mb_coap.js +3 -41
  28. package/dist/dgram/mb_mdns.js +15 -80
  29. package/dist/dgram/mdns.js +137 -299
  30. package/dist/dgram/multicast.js +1 -62
  31. package/dist/dgram/unicast.js +0 -54
  32. package/dist/frontend.js +24 -450
  33. package/dist/globalMatterbridge.js +0 -47
  34. package/dist/helpers.js +0 -53
  35. package/dist/index.js +1 -30
  36. package/dist/jest-utils/jestHelpers.js +2 -124
  37. package/dist/logger/export.js +0 -1
  38. package/dist/matter/behaviors.js +0 -2
  39. package/dist/matter/clusters.js +0 -2
  40. package/dist/matter/devices.js +0 -2
  41. package/dist/matter/endpoints.js +0 -2
  42. package/dist/matter/export.js +0 -3
  43. package/dist/matter/types.js +0 -3
  44. package/dist/matterbridge.js +49 -780
  45. package/dist/matterbridgeAccessoryPlatform.js +0 -36
  46. package/dist/matterbridgeBehaviors.js +5 -65
  47. package/dist/matterbridgeDeviceTypes.js +17 -630
  48. package/dist/matterbridgeDynamicPlatform.js +0 -36
  49. package/dist/matterbridgeEndpoint.js +54 -1301
  50. package/dist/matterbridgeEndpointHelpers.js +12 -345
  51. package/dist/matterbridgePlatform.js +1 -305
  52. package/dist/matterbridgeTypes.js +0 -25
  53. package/dist/pluginManager.js +5 -251
  54. package/dist/shelly.js +7 -168
  55. package/dist/storage/export.js +0 -1
  56. package/dist/update.js +0 -69
  57. package/dist/utils/colorUtils.js +2 -97
  58. package/dist/utils/commandLine.js +0 -54
  59. package/dist/utils/copyDirectory.js +1 -38
  60. package/dist/utils/createDirectory.js +0 -33
  61. package/dist/utils/createZip.js +2 -47
  62. package/dist/utils/deepCopy.js +0 -39
  63. package/dist/utils/deepEqual.js +1 -72
  64. package/dist/utils/error.js +0 -41
  65. package/dist/utils/export.js +0 -1
  66. package/dist/utils/hex.js +0 -124
  67. package/dist/utils/isvalid.js +0 -101
  68. package/dist/utils/network.js +6 -92
  69. package/dist/utils/spawn.js +0 -40
  70. package/dist/utils/wait.js +8 -60
  71. package/npm-shrinkwrap.json +2 -2
  72. package/package.json +1 -2
  73. package/dist/cli.d.ts +0 -26
  74. package/dist/cli.d.ts.map +0 -1
  75. package/dist/cli.js.map +0 -1
  76. package/dist/cliEmitter.d.ts +0 -34
  77. package/dist/cliEmitter.d.ts.map +0 -1
  78. package/dist/cliEmitter.js.map +0 -1
  79. package/dist/clusters/export.d.ts +0 -2
  80. package/dist/clusters/export.d.ts.map +0 -1
  81. package/dist/clusters/export.js.map +0 -1
  82. package/dist/defaultConfigSchema.d.ts +0 -28
  83. package/dist/defaultConfigSchema.d.ts.map +0 -1
  84. package/dist/defaultConfigSchema.js.map +0 -1
  85. package/dist/deviceManager.d.ts +0 -112
  86. package/dist/deviceManager.d.ts.map +0 -1
  87. package/dist/deviceManager.js.map +0 -1
  88. package/dist/devices/airConditioner.d.ts +0 -98
  89. package/dist/devices/airConditioner.d.ts.map +0 -1
  90. package/dist/devices/airConditioner.js.map +0 -1
  91. package/dist/devices/batteryStorage.d.ts +0 -48
  92. package/dist/devices/batteryStorage.d.ts.map +0 -1
  93. package/dist/devices/batteryStorage.js.map +0 -1
  94. package/dist/devices/cooktop.d.ts +0 -60
  95. package/dist/devices/cooktop.d.ts.map +0 -1
  96. package/dist/devices/cooktop.js.map +0 -1
  97. package/dist/devices/dishwasher.d.ts +0 -71
  98. package/dist/devices/dishwasher.d.ts.map +0 -1
  99. package/dist/devices/dishwasher.js.map +0 -1
  100. package/dist/devices/evse.d.ts +0 -75
  101. package/dist/devices/evse.d.ts.map +0 -1
  102. package/dist/devices/evse.js.map +0 -1
  103. package/dist/devices/export.d.ts +0 -17
  104. package/dist/devices/export.d.ts.map +0 -1
  105. package/dist/devices/export.js.map +0 -1
  106. package/dist/devices/extractorHood.d.ts +0 -46
  107. package/dist/devices/extractorHood.d.ts.map +0 -1
  108. package/dist/devices/extractorHood.js.map +0 -1
  109. package/dist/devices/heatPump.d.ts +0 -47
  110. package/dist/devices/heatPump.d.ts.map +0 -1
  111. package/dist/devices/heatPump.js.map +0 -1
  112. package/dist/devices/laundryDryer.d.ts +0 -67
  113. package/dist/devices/laundryDryer.d.ts.map +0 -1
  114. package/dist/devices/laundryDryer.js.map +0 -1
  115. package/dist/devices/laundryWasher.d.ts +0 -81
  116. package/dist/devices/laundryWasher.d.ts.map +0 -1
  117. package/dist/devices/laundryWasher.js.map +0 -1
  118. package/dist/devices/microwaveOven.d.ts +0 -168
  119. package/dist/devices/microwaveOven.d.ts.map +0 -1
  120. package/dist/devices/microwaveOven.js.map +0 -1
  121. package/dist/devices/oven.d.ts +0 -105
  122. package/dist/devices/oven.d.ts.map +0 -1
  123. package/dist/devices/oven.js.map +0 -1
  124. package/dist/devices/refrigerator.d.ts +0 -118
  125. package/dist/devices/refrigerator.d.ts.map +0 -1
  126. package/dist/devices/refrigerator.js.map +0 -1
  127. package/dist/devices/roboticVacuumCleaner.d.ts +0 -112
  128. package/dist/devices/roboticVacuumCleaner.d.ts.map +0 -1
  129. package/dist/devices/roboticVacuumCleaner.js.map +0 -1
  130. package/dist/devices/solarPower.d.ts +0 -40
  131. package/dist/devices/solarPower.d.ts.map +0 -1
  132. package/dist/devices/solarPower.js.map +0 -1
  133. package/dist/devices/speaker.d.ts +0 -83
  134. package/dist/devices/speaker.d.ts.map +0 -1
  135. package/dist/devices/speaker.js.map +0 -1
  136. package/dist/devices/temperatureControl.d.ts +0 -166
  137. package/dist/devices/temperatureControl.d.ts.map +0 -1
  138. package/dist/devices/temperatureControl.js.map +0 -1
  139. package/dist/devices/waterHeater.d.ts +0 -111
  140. package/dist/devices/waterHeater.d.ts.map +0 -1
  141. package/dist/devices/waterHeater.js.map +0 -1
  142. package/dist/dgram/coap.d.ts +0 -205
  143. package/dist/dgram/coap.d.ts.map +0 -1
  144. package/dist/dgram/coap.js.map +0 -1
  145. package/dist/dgram/dgram.d.ts +0 -141
  146. package/dist/dgram/dgram.d.ts.map +0 -1
  147. package/dist/dgram/dgram.js.map +0 -1
  148. package/dist/dgram/mb_coap.d.ts +0 -24
  149. package/dist/dgram/mb_coap.d.ts.map +0 -1
  150. package/dist/dgram/mb_coap.js.map +0 -1
  151. package/dist/dgram/mb_mdns.d.ts +0 -24
  152. package/dist/dgram/mb_mdns.d.ts.map +0 -1
  153. package/dist/dgram/mb_mdns.js.map +0 -1
  154. package/dist/dgram/mdns.d.ts +0 -290
  155. package/dist/dgram/mdns.d.ts.map +0 -1
  156. package/dist/dgram/mdns.js.map +0 -1
  157. package/dist/dgram/multicast.d.ts +0 -67
  158. package/dist/dgram/multicast.d.ts.map +0 -1
  159. package/dist/dgram/multicast.js.map +0 -1
  160. package/dist/dgram/unicast.d.ts +0 -56
  161. package/dist/dgram/unicast.d.ts.map +0 -1
  162. package/dist/dgram/unicast.js.map +0 -1
  163. package/dist/frontend.d.ts +0 -313
  164. package/dist/frontend.d.ts.map +0 -1
  165. package/dist/frontend.js.map +0 -1
  166. package/dist/globalMatterbridge.d.ts +0 -59
  167. package/dist/globalMatterbridge.d.ts.map +0 -1
  168. package/dist/globalMatterbridge.js.map +0 -1
  169. package/dist/helpers.d.ts +0 -48
  170. package/dist/helpers.d.ts.map +0 -1
  171. package/dist/helpers.js.map +0 -1
  172. package/dist/index.d.ts +0 -33
  173. package/dist/index.d.ts.map +0 -1
  174. package/dist/index.js.map +0 -1
  175. package/dist/jest-utils/jestHelpers.d.ts +0 -103
  176. package/dist/jest-utils/jestHelpers.d.ts.map +0 -1
  177. package/dist/jest-utils/jestHelpers.js.map +0 -1
  178. package/dist/logger/export.d.ts +0 -2
  179. package/dist/logger/export.d.ts.map +0 -1
  180. package/dist/logger/export.js.map +0 -1
  181. package/dist/matter/behaviors.d.ts +0 -2
  182. package/dist/matter/behaviors.d.ts.map +0 -1
  183. package/dist/matter/behaviors.js.map +0 -1
  184. package/dist/matter/clusters.d.ts +0 -2
  185. package/dist/matter/clusters.d.ts.map +0 -1
  186. package/dist/matter/clusters.js.map +0 -1
  187. package/dist/matter/devices.d.ts +0 -2
  188. package/dist/matter/devices.d.ts.map +0 -1
  189. package/dist/matter/devices.js.map +0 -1
  190. package/dist/matter/endpoints.d.ts +0 -2
  191. package/dist/matter/endpoints.d.ts.map +0 -1
  192. package/dist/matter/endpoints.js.map +0 -1
  193. package/dist/matter/export.d.ts +0 -5
  194. package/dist/matter/export.d.ts.map +0 -1
  195. package/dist/matter/export.js.map +0 -1
  196. package/dist/matter/types.d.ts +0 -3
  197. package/dist/matter/types.d.ts.map +0 -1
  198. package/dist/matter/types.js.map +0 -1
  199. package/dist/matterbridge.d.ts +0 -457
  200. package/dist/matterbridge.d.ts.map +0 -1
  201. package/dist/matterbridge.js.map +0 -1
  202. package/dist/matterbridgeAccessoryPlatform.d.ts +0 -42
  203. package/dist/matterbridgeAccessoryPlatform.d.ts.map +0 -1
  204. package/dist/matterbridgeAccessoryPlatform.js.map +0 -1
  205. package/dist/matterbridgeBehaviors.d.ts +0 -1351
  206. package/dist/matterbridgeBehaviors.d.ts.map +0 -1
  207. package/dist/matterbridgeBehaviors.js.map +0 -1
  208. package/dist/matterbridgeDeviceTypes.d.ts +0 -761
  209. package/dist/matterbridgeDeviceTypes.d.ts.map +0 -1
  210. package/dist/matterbridgeDeviceTypes.js.map +0 -1
  211. package/dist/matterbridgeDynamicPlatform.d.ts +0 -42
  212. package/dist/matterbridgeDynamicPlatform.d.ts.map +0 -1
  213. package/dist/matterbridgeDynamicPlatform.js.map +0 -1
  214. package/dist/matterbridgeEndpoint.d.ts +0 -1438
  215. package/dist/matterbridgeEndpoint.d.ts.map +0 -1
  216. package/dist/matterbridgeEndpoint.js.map +0 -1
  217. package/dist/matterbridgeEndpointHelpers.d.ts +0 -407
  218. package/dist/matterbridgeEndpointHelpers.d.ts.map +0 -1
  219. package/dist/matterbridgeEndpointHelpers.js.map +0 -1
  220. package/dist/matterbridgePlatform.d.ts +0 -379
  221. package/dist/matterbridgePlatform.d.ts.map +0 -1
  222. package/dist/matterbridgePlatform.js.map +0 -1
  223. package/dist/matterbridgeTypes.d.ts +0 -198
  224. package/dist/matterbridgeTypes.d.ts.map +0 -1
  225. package/dist/matterbridgeTypes.js.map +0 -1
  226. package/dist/pluginManager.d.ts +0 -270
  227. package/dist/pluginManager.d.ts.map +0 -1
  228. package/dist/pluginManager.js.map +0 -1
  229. package/dist/shelly.d.ts +0 -174
  230. package/dist/shelly.d.ts.map +0 -1
  231. package/dist/shelly.js.map +0 -1
  232. package/dist/storage/export.d.ts +0 -2
  233. package/dist/storage/export.d.ts.map +0 -1
  234. package/dist/storage/export.js.map +0 -1
  235. package/dist/update.d.ts +0 -75
  236. package/dist/update.d.ts.map +0 -1
  237. package/dist/update.js.map +0 -1
  238. package/dist/utils/colorUtils.d.ts +0 -99
  239. package/dist/utils/colorUtils.d.ts.map +0 -1
  240. package/dist/utils/colorUtils.js.map +0 -1
  241. package/dist/utils/commandLine.d.ts +0 -59
  242. package/dist/utils/commandLine.d.ts.map +0 -1
  243. package/dist/utils/commandLine.js.map +0 -1
  244. package/dist/utils/copyDirectory.d.ts +0 -33
  245. package/dist/utils/copyDirectory.d.ts.map +0 -1
  246. package/dist/utils/copyDirectory.js.map +0 -1
  247. package/dist/utils/createDirectory.d.ts +0 -34
  248. package/dist/utils/createDirectory.d.ts.map +0 -1
  249. package/dist/utils/createDirectory.js.map +0 -1
  250. package/dist/utils/createZip.d.ts +0 -39
  251. package/dist/utils/createZip.d.ts.map +0 -1
  252. package/dist/utils/createZip.js.map +0 -1
  253. package/dist/utils/deepCopy.d.ts +0 -32
  254. package/dist/utils/deepCopy.d.ts.map +0 -1
  255. package/dist/utils/deepCopy.js.map +0 -1
  256. package/dist/utils/deepEqual.d.ts +0 -54
  257. package/dist/utils/deepEqual.d.ts.map +0 -1
  258. package/dist/utils/deepEqual.js.map +0 -1
  259. package/dist/utils/error.d.ts +0 -44
  260. package/dist/utils/error.d.ts.map +0 -1
  261. package/dist/utils/error.js.map +0 -1
  262. package/dist/utils/export.d.ts +0 -13
  263. package/dist/utils/export.d.ts.map +0 -1
  264. package/dist/utils/export.js.map +0 -1
  265. package/dist/utils/hex.d.ts +0 -89
  266. package/dist/utils/hex.d.ts.map +0 -1
  267. package/dist/utils/hex.js.map +0 -1
  268. package/dist/utils/isvalid.d.ts +0 -103
  269. package/dist/utils/isvalid.d.ts.map +0 -1
  270. package/dist/utils/isvalid.js.map +0 -1
  271. package/dist/utils/network.d.ts +0 -84
  272. package/dist/utils/network.d.ts.map +0 -1
  273. package/dist/utils/network.js.map +0 -1
  274. package/dist/utils/spawn.d.ts +0 -33
  275. package/dist/utils/spawn.d.ts.map +0 -1
  276. package/dist/utils/spawn.js.map +0 -1
  277. package/dist/utils/wait.d.ts +0 -54
  278. package/dist/utils/wait.d.ts.map +0 -1
  279. package/dist/utils/wait.js.map +0 -1
package/dist/utils/hex.js CHANGED
@@ -1,114 +1,39 @@
1
- /**
2
- * This file contains the hex functions.
3
- *
4
- * @file hex.ts
5
- * @author Luca Liguori
6
- * @created 2025-05-06
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
1
  import { createPublicKey, createPrivateKey, X509Certificate } from 'node:crypto';
25
- /**
26
- * Converts an ArrayBuffer or Uint8Array to a hexadecimal string.
27
- *
28
- * Accepts any {ArrayBufferLike} input: a raw ArrayBuffer (binary data storage) or
29
- * a Uint8Array (TypedArray view over an ArrayBuffer). While an ArrayBuffer holds
30
- * the raw memory, a Uint8Array is a typed view into that memory, letting you access
31
- * its bytes directly. This function normalizes both by creating a Uint8Array view
32
- * before conversion.
33
- *
34
- * @param {ArrayBufferLike} buffer - The buffer or typed-array view to convert.
35
- * @returns {string} A lowercase hex string representation of the buffer's bytes.
36
- *
37
- * @throws {TypeError} If the input is not an ArrayBuffer or ArrayBufferView.
38
- */
39
2
  export function bufferToHex(buffer) {
40
- // Check if the input is an ArrayBuffer or ArrayBufferView
41
3
  if (!(buffer instanceof ArrayBuffer || ArrayBuffer.isView(buffer))) {
42
4
  throw new TypeError('Expected input to be an ArrayBuffer or ArrayBufferView');
43
5
  }
44
- // Create a Uint8Array view over the buffer
45
6
  const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
46
- // Convert each byte to 2-digit hex
47
7
  return Array.from(bytes)
48
8
  .map((byte) => byte.toString(16).padStart(2, '0'))
49
9
  .join('');
50
10
  }
51
- /**
52
- * Converts a hexadecimal string to a Uint8Array.
53
- *
54
- * @param {string} hex - The hex string to convert. Can include uppercase or lowercase characters.
55
- * @returns {Uint8Array} A Uint8Array representing the corresponding binary data.
56
- *
57
- * @throws {TypeError} If the input is not a string.
58
- * @throws {Error} If the input length is odd or contains non-hex characters.
59
- */
60
11
  export function hexToBuffer(hex) {
61
- // Ensure the input is a string
62
12
  if (typeof hex !== 'string') {
63
13
  throw new TypeError('Expected a string for hex input');
64
14
  }
65
- // Trim any whitespace from the input string
66
15
  const cleaned = hex.trim();
67
- // Check if the length of the hex string is even
68
16
  if (cleaned.length % 2 !== 0) {
69
17
  throw new Error('Invalid hex string length, must be even');
70
18
  }
71
- // Validate that the string contains only valid hex characters
72
19
  if (!/^[0-9a-fA-F]*$/.test(cleaned)) {
73
20
  throw new Error('Invalid hex string, contains non-hex characters');
74
21
  }
75
- // Calculate the length of the resulting Uint8Array
76
22
  const length = cleaned.length / 2;
77
- // Create a Uint8Array to hold the binary data
78
23
  const result = new Uint8Array(length);
79
- // Convert each pair of hex characters into a byte
80
24
  for (let i = 0; i < length; i++) {
81
25
  result[i] = parseInt(cleaned.substr(i * 2, 2), 16);
82
26
  }
83
- // Return the resulting Uint8Array
84
27
  return result;
85
28
  }
86
- /**
87
- * Converts a PEM (Privacy-Enhanced Mail) formatted string to a Uint8Array.
88
- *
89
- * PEM format is a base64-encoded format commonly used for cryptographic keys and certificates,
90
- * wrapped with header and footer lines like "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----".
91
- * This function extracts the base64 content and converts it to binary data using Node.js Buffer API.
92
- *
93
- * @param {string} pem - The PEM formatted string to convert.
94
- * @param {boolean} validate - Whether to validate the PEM content using Node.js crypto module. Default is false.
95
- * @returns {Uint8Array} A Uint8Array representing the decoded binary data.
96
- *
97
- * @throws {TypeError} If the input is not a string.
98
- * @throws {Error} If the PEM format is invalid, contains invalid base64 characters, or validation fails.
99
- */
100
29
  export function pemToBuffer(pem, validate = false) {
101
- // Ensure the input is a string
102
30
  if (typeof pem !== 'string') {
103
31
  throw new TypeError('Expected a string for PEM input');
104
32
  }
105
- // Trim whitespace from the input
106
33
  const cleaned = pem.trim();
107
- // Check if the string appears to be in PEM format
108
34
  if (!cleaned.includes('-----BEGIN') || !cleaned.includes('-----END')) {
109
35
  throw new Error('Invalid PEM format: missing BEGIN/END markers');
110
36
  }
111
- // Extract the base64 content between the header and footer
112
37
  const lines = cleaned.split('\n');
113
38
  const base64Lines = [];
114
39
  let inContent = false;
@@ -129,114 +54,65 @@ export function pemToBuffer(pem, validate = false) {
129
54
  if (base64Lines.length === 0) {
130
55
  throw new Error('Invalid PEM format: no content found between BEGIN/END markers');
131
56
  }
132
- // Join all base64 lines together
133
57
  const base64String = base64Lines.join('');
134
- // Validate base64 string format
135
58
  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64String)) {
136
59
  throw new Error('Invalid PEM format: contains invalid base64 characters');
137
60
  }
138
61
  try {
139
- // Use Node.js Buffer API instead of legacy atob()
140
62
  const buffer = Buffer.from(base64String, 'base64');
141
- // Convert Buffer to Uint8Array
142
63
  const result = new Uint8Array(buffer);
143
- // Validate PEM content using Node.js crypto module if requested
144
64
  if (validate) {
145
65
  try {
146
- // Determine PEM type from the header and validate accordingly
147
66
  const pemType = cleaned.match(/-----BEGIN\s+([^-]+)-----/)?.[1]?.trim();
148
67
  if (pemType?.includes('CERTIFICATE')) {
149
- // Use X509Certificate for robust certificate validation
150
68
  const cert = new X509Certificate(pem);
151
- // Check validity period
152
69
  if (cert.validFrom && cert.validTo) {
153
70
  const now = Date.now();
154
71
  const from = Date.parse(cert.validFrom);
155
72
  const to = Date.parse(cert.validTo);
156
- // istanbul ignore next if
157
73
  if (now < from || now > to) {
158
74
  throw new Error('Certificate is not currently valid');
159
75
  }
160
76
  }
161
- // Check subject/issuer fields
162
- // istanbul ignore next if
163
77
  if (!cert.subject || !cert.issuer) {
164
78
  throw new Error('Certificate missing subject or issuer');
165
79
  }
166
- // Optionally check signature (not possible without CA chain)
167
80
  }
168
81
  else if (pemType?.includes('PRIVATE KEY')) {
169
- // For private keys, try to create a private key
170
82
  createPrivateKey({ key: pem, format: 'pem' });
171
83
  }
172
84
  else if (pemType?.includes('PUBLIC KEY')) {
173
- // For public keys, try to create a public key
174
85
  createPublicKey({ key: pem, format: 'pem' });
175
86
  }
176
- // If no specific type is detected, skip validation
177
87
  }
178
88
  catch (validationError) {
179
- // istanbul ignore next
180
89
  throw new Error(`PEM validation failed: ${validationError instanceof Error ? validationError.message : String(validationError)}`);
181
90
  }
182
91
  }
183
92
  return result;
184
93
  }
185
94
  catch (error) {
186
- // istanbul ignore next
187
95
  throw new Error(`Failed to decode base64 content: ${error instanceof Error ? error.message : String(error)}`);
188
96
  }
189
97
  }
190
- /**
191
- * Extracts the raw 32-byte private key scalar from an EC private key PEM.
192
- *
193
- * This function parses an EC private key in PEM format and extracts the raw
194
- * 32-byte private scalar (the "d" value) used in elliptic curve cryptography.
195
- * This is the actual secret key material.
196
- *
197
- * @param {string} pemPrivateKey - The EC private key in PEM format
198
- * @returns {Uint8Array} The raw 32-byte private key scalar
199
- * @throws {Error} If the input is not a valid EC private key PEM
200
- *
201
- * @example
202
- * ```typescript
203
- * const pemKey = `-----BEGIN EC PRIVATE KEY-----
204
- * MHcCAQEEIFBxqFkUxMoN2JkUXLFeiZnLNUpftjLi0sKMbZ6uajHXoAoGCCqGSM49
205
- * AwEHoUQDQgAEcJ3eH/rG3zf9WmqMjh5eBSkeXz3Cb4Fig1rTosfHmgyjx/WnLPEe
206
- * BF4SHvLo0G2COJEHa/VDE5EiKWO9ZR6AOQ==
207
- * -----END EC PRIVATE KEY-----`;
208
- *
209
- * const rawKey = extractPrivateKeyRaw(pemKey);
210
- * console.log(rawKey.length); // 32
211
- * console.log(bufferToHex(rawKey)); // hex representation of the private scalar
212
- * ```
213
- */
214
98
  export function extractPrivateKeyRaw(pemPrivateKey) {
215
99
  if (typeof pemPrivateKey !== 'string') {
216
100
  throw new TypeError('Expected a string for PEM private key input');
217
101
  }
218
- // Extract the private key block
219
102
  const keyBlock = /-----BEGIN (?:EC )?PRIVATE KEY-----[^-]+-----END (?:EC )?PRIVATE KEY-----/s.exec(pemPrivateKey);
220
103
  if (!keyBlock) {
221
104
  throw new Error('No EC PRIVATE KEY block found in the supplied PEM');
222
105
  }
223
106
  try {
224
- // Create a private key object
225
107
  const privateKey = createPrivateKey(keyBlock[0]);
226
- // Export as PKCS#8 DER format
227
108
  const pkcs8Der = privateKey.export({ format: 'der', type: 'pkcs8' });
228
- // For P-256 curves, the private scalar is the last 32 bytes of the PKCS#8 DER
229
- // istanbul ignore next
230
109
  if (pkcs8Der.length < 32) {
231
110
  throw new Error('Invalid private key: DER data too short');
232
111
  }
233
- // Extract the last 32 bytes which contain the raw private scalar
234
112
  const rawPrivateKey = pkcs8Der.subarray(pkcs8Der.length - 32);
235
113
  return new Uint8Array(rawPrivateKey);
236
114
  }
237
115
  catch (error) {
238
- // istanbul ignore next
239
116
  throw new Error(`Failed to extract private key: ${error instanceof Error ? error.message : String(error)}`);
240
117
  }
241
118
  }
242
- //# sourceMappingURL=hex.js.map
@@ -1,45 +1,7 @@
1
- /**
2
- * This file contains the validation functions.
3
- *
4
- * @file isvalid.ts
5
- * @author Luca Liguori
6
- * @created 2025-02-16
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
- /**
25
- * Checks if a given string is a valid IPv4 address.
26
- *
27
- * @param {string} ipv4Address - The string to be checked.
28
- * @returns {boolean} - Returns true if the string is a valid IPv4 address, otherwise returns false.
29
- */
30
1
  export function isValidIpv4Address(ipv4Address) {
31
2
  const ipv4Regex = /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
32
3
  return ipv4Regex.test(ipv4Address);
33
4
  }
34
- /**
35
- * Checks if a value is a valid number within the specified range.
36
- *
37
- * @param {any} value - The value to be checked.
38
- * @param {number} min - The minimum value allowed (optional).
39
- * @param {number} max - The maximum value allowed (optional).
40
- * @returns {value is number} Returns true if the value is a valid number within the specified range, otherwise false.
41
- */
42
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
43
5
  export function isValidNumber(value, min, max) {
44
6
  if (value === undefined || value === null || typeof value !== 'number' || Number.isNaN(value) || !Number.isFinite(value))
45
7
  return false;
@@ -49,25 +11,9 @@ export function isValidNumber(value, min, max) {
49
11
  return false;
50
12
  return true;
51
13
  }
52
- /**
53
- * Checks if a value is a valid boolean.
54
- *
55
- * @param {any} value - The value to be checked.
56
- * @returns {value is boolean} `true` if the value is a valid boolean, `false` otherwise.
57
- */
58
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
59
14
  export function isValidBoolean(value) {
60
15
  return value !== undefined && value !== null && typeof value === 'boolean';
61
16
  }
62
- /**
63
- * Checks if a value is a valid string.
64
- *
65
- * @param {any} value - The value to be checked.
66
- * @param {number} minLength - The min string length (optional).
67
- * @param {number} maxLength - The max string length (optional).
68
- * @returns {value is string} A boolean indicating whether the value is a valid string.
69
- */
70
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
71
17
  export function isValidString(value, minLength, maxLength) {
72
18
  if (value === undefined || value === null || typeof value !== 'string')
73
19
  return false;
@@ -77,25 +23,9 @@ export function isValidString(value, minLength, maxLength) {
77
23
  return false;
78
24
  return true;
79
25
  }
80
- /**
81
- * Checks if a value is a valid RegExp.
82
- *
83
- * @param {any} value - The value to be checked.
84
- * @returns {value is RegExp} A boolean indicating whether the value is a valid RegExp.
85
- */
86
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
87
26
  export function isValidRegExp(value) {
88
27
  return value !== undefined && value !== null && value instanceof RegExp;
89
28
  }
90
- /**
91
- * Checks if a value is a valid object.
92
- *
93
- * @param {any} value - The value to be checked.
94
- * @param {number} minLength - The min number of keys (optional).
95
- * @param {number} maxLength - The max number of keys (optional).
96
- * @returns {value is object} A boolean indicating whether the value is a valid object.
97
- */
98
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
99
29
  export function isValidObject(value, minLength, maxLength) {
100
30
  if (value === undefined || value === null || typeof value !== 'object' || Array.isArray(value))
101
31
  return false;
@@ -106,15 +36,6 @@ export function isValidObject(value, minLength, maxLength) {
106
36
  return false;
107
37
  return true;
108
38
  }
109
- /**
110
- * Checks if a value is a valid array.
111
- *
112
- * @param {any} value - The value to be checked.
113
- * @param {number} minLength - The min number of elements (optional).
114
- * @param {number} maxLength - The max number of elements (optional).
115
- * @returns {value is unknown[]} A boolean indicating whether the value is a valid array.
116
- */
117
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
118
39
  export function isValidArray(value, minLength, maxLength) {
119
40
  if (value === undefined || value === null || !Array.isArray(value))
120
41
  return false;
@@ -124,33 +45,12 @@ export function isValidArray(value, minLength, maxLength) {
124
45
  return false;
125
46
  return true;
126
47
  }
127
- /**
128
- * Checks if the given value is null.
129
- *
130
- * @param {any} value - The value to check.
131
- * @returns {value is null} `true` if the value is null, `false` otherwise.
132
- */
133
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
134
48
  export function isValidNull(value) {
135
49
  return value === null;
136
50
  }
137
- /**
138
- * Checks if a value is undefined.
139
- *
140
- * @param {any} value - The value to check.
141
- * @returns {value is undefined} `true` if the value is undefined, `false` otherwise.
142
- */
143
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
144
51
  export function isValidUndefined(value) {
145
52
  return value === undefined;
146
53
  }
147
- /**
148
- * Converts a semantic version string like "6.11.0-1011-raspi" to a numeric version code like 61100.
149
- * Format: major * 10000 + minor * 100 + patch
150
- *
151
- * @param {string} versionString The version string to parse
152
- * @returns {number | undefined} A numeric version code or undefined if parsing fails
153
- */
154
54
  export function parseVersionString(versionString) {
155
55
  if (!isValidString(versionString))
156
56
  return undefined;
@@ -167,4 +67,3 @@ export function parseVersionString(versionString) {
167
67
  }
168
68
  return major * 10000 + minor * 100 + patch;
169
69
  }
170
- //# sourceMappingURL=isvalid.js.map
@@ -1,38 +1,8 @@
1
- /**
2
- * @description This file contains the network functions.
3
- * @file network.ts
4
- * @author Luca Liguori
5
- * @created 2024-02-17
6
- * @version 1.0.1
7
- * @license Apache-2.0
8
- *
9
- * Copyright 2024, 2025, 2026 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
- // Node.js modules
24
1
  import os from 'node:os';
25
- // AnsiLogger module
26
2
  import { AnsiLogger, BLUE, CYAN, nf } from 'node-ansi-logger';
27
- /**
28
- * Retrieves the IPv4 address of the first non-internal network interface.
29
- *
30
- * @returns {string | undefined} The IPv4 address of the selected network interface, or undefined if not found.
31
- */
32
3
  export function getIpv4InterfaceAddress() {
33
4
  let ipv4Address;
34
5
  const networkInterfaces = os.networkInterfaces();
35
- // console.log('Available Network Interfaces:', networkInterfaces);
36
6
  for (const interfaceDetails of Object.values(networkInterfaces)) {
37
7
  if (!interfaceDetails) {
38
8
  break;
@@ -46,18 +16,11 @@ export function getIpv4InterfaceAddress() {
46
16
  break;
47
17
  }
48
18
  }
49
- // console.log('Selected Network Interfaces:', ipv4Address);
50
19
  return ipv4Address;
51
20
  }
52
- /**
53
- * Retrieves the IPv6 address of the first non-internal network interface.
54
- *
55
- * @returns {string | undefined} The IPv4 address of the selected network interface, or undefined if not found.
56
- */
57
21
  export function getIpv6InterfaceAddress() {
58
22
  let ipv6Address;
59
23
  const networkInterfaces = os.networkInterfaces();
60
- // console.log('Available Network Interfaces:', networkInterfaces);
61
24
  for (const interfaceDetails of Object.values(networkInterfaces)) {
62
25
  if (!interfaceDetails) {
63
26
  break;
@@ -71,18 +34,11 @@ export function getIpv6InterfaceAddress() {
71
34
  break;
72
35
  }
73
36
  }
74
- // console.log('Selected Network Interfaces:', ipv6Address);
75
37
  return ipv6Address;
76
38
  }
77
- /**
78
- * Retrieves the mac address of the first non-internal network interface.
79
- *
80
- * @returns {string | undefined} The mac address, or undefined if not found.
81
- */
82
39
  export function getMacAddress() {
83
40
  let macAddress;
84
41
  const networkInterfaces = os.networkInterfaces();
85
- // console.log('Available Network Interfaces:', networkInterfaces);
86
42
  for (const interfaceDetails of Object.values(networkInterfaces)) {
87
43
  if (!interfaceDetails) {
88
44
  break;
@@ -98,14 +54,9 @@ export function getMacAddress() {
98
54
  }
99
55
  return macAddress;
100
56
  }
101
- /**
102
- * Logs the available network interfaces and their details.
103
- *
104
- * @returns {void}
105
- */
106
57
  export function logInterfaces() {
107
- const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: "info" /* LogLevel.INFO */ });
108
- log.logLevel = "info" /* LogLevel.INFO */;
58
+ const log = new AnsiLogger({ logName: 'MatterbridgeUtils', logTimestampFormat: 4, logLevel: "info" });
59
+ log.logLevel = "info";
109
60
  log.logName = 'LogInterfaces';
110
61
  log.info('Available Network Interfaces:');
111
62
  const availableAddresses = Object.entries(os.networkInterfaces());
@@ -119,36 +70,16 @@ export function logInterfaces() {
119
70
  }
120
71
  }
121
72
  }
122
- /**
123
- * Resolves the given hostname to an IP address.
124
- *
125
- * @param {string} hostname - The hostname to resolve.
126
- * @param {0 | 4 | 6} [family] - The address family to use (0 for any, 4 for IPv4, 6 for IPv6). Default is 4.
127
- * @returns {Promise<string | null>} - A promise that resolves to the IP address or null if not found.
128
- *
129
- * @remarks
130
- * This function uses DNS lookup to resolve the hostname, which can take some time to complete.
131
- */
132
73
  export async function resolveHostname(hostname, family = 4) {
133
74
  const dns = await import('node:dns');
134
75
  try {
135
- const addresses = await dns.promises.lookup(hostname.toLowerCase() /* + '.local'*/, { family });
76
+ const addresses = await dns.promises.lookup(hostname.toLowerCase(), { family });
136
77
  return addresses.address;
137
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
138
78
  }
139
79
  catch (error) {
140
80
  return null;
141
81
  }
142
82
  }
143
- /**
144
- * Retrieves the version of an npm package from the npm registry.
145
- *
146
- * @param {string} packageName - The name of the npm package.
147
- * @param {string} [tag] - The tag of the package version to retrieve (default is 'latest').
148
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 10000ms).
149
- * @returns {Promise<string>} A promise that resolves to the version string of the package.
150
- * @throws {Error} If the request fails or the tag is not found.
151
- */
152
83
  export async function getNpmPackageVersion(packageName, tag = 'latest', timeout = 10000) {
153
84
  const https = await import('node:https');
154
85
  return new Promise((resolve, reject) => {
@@ -162,7 +93,7 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
162
93
  let data = '';
163
94
  if (res.statusCode !== 200) {
164
95
  clearTimeout(timeoutId);
165
- res.resume(); // Discard response data to close the socket properly
96
+ res.resume();
166
97
  reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
167
98
  return;
168
99
  }
@@ -173,7 +104,6 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
173
104
  clearTimeout(timeoutId);
174
105
  try {
175
106
  const jsonData = JSON.parse(data);
176
- // console.log(`Package ${packageName} tag ${tag}`, jsonData);
177
107
  const version = jsonData['dist-tags']?.[tag];
178
108
  if (version) {
179
109
  resolve(version);
@@ -193,19 +123,10 @@ export async function getNpmPackageVersion(packageName, tag = 'latest', timeout
193
123
  });
194
124
  });
195
125
  }
196
- /**
197
- * Retrieves a file from the public directory of the Matterbridge GitHub repository.
198
- *
199
- * @param {string} branch - The branch from which to fetch the file.
200
- * @param {string} file - The file path to fetch.
201
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 10000ms).
202
- * @returns {Promise<Record<string, boolean | string | number>>} A promise that resolves to the parsed JSON object from the file.
203
- * @throws {Error} If the request fails or the JSON parsing fails.
204
- */
205
126
  export async function getGitHubUpdate(branch, file, timeout = 10000) {
206
127
  const https = await import('node:https');
207
128
  return new Promise((resolve, reject) => {
208
- const url = `https://raw.githubusercontent.com/Luligu/matterbridge/${branch}/public/${file}`;
129
+ const url = `https://matterbridge.io/${branch}_${file}`;
209
130
  const controller = new AbortController();
210
131
  const timeoutId = setTimeout(() => {
211
132
  controller.abort();
@@ -215,7 +136,7 @@ export async function getGitHubUpdate(branch, file, timeout = 10000) {
215
136
  let data = '';
216
137
  if (res.statusCode !== 200) {
217
138
  clearTimeout(timeoutId);
218
- res.resume(); // Discard response data to close the socket properly
139
+ res.resume();
219
140
  reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
220
141
  return;
221
142
  }
@@ -233,18 +154,12 @@ export async function getGitHubUpdate(branch, file, timeout = 10000) {
233
154
  }
234
155
  });
235
156
  });
236
- // istanbul ignore next
237
157
  req.on('error', (error) => {
238
158
  clearTimeout(timeoutId);
239
159
  reject(new Error(`Request failed: ${error instanceof Error ? error.message : error}`));
240
160
  });
241
161
  });
242
162
  }
243
- /**
244
- * Retrieves the path to the global Node.js modules directory.
245
- *
246
- * @returns {Promise<string>} A promise that resolves to the path of the global Node.js modules directory.
247
- */
248
163
  export async function getGlobalNodeModules() {
249
164
  const { exec } = await import('node:child_process');
250
165
  return new Promise((resolve, reject) => {
@@ -258,4 +173,3 @@ export async function getGlobalNodeModules() {
258
173
  });
259
174
  });
260
175
  }
261
- //# sourceMappingURL=network.js.map
@@ -1,51 +1,12 @@
1
- /**
2
- * @description This file contains the spawn functions.
3
- * @file spawn.ts
4
- * @author Luca Liguori
5
- * @created 2025-02-16
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 { hasParameter } from './commandLine.js';
24
- /**
25
- * Spawns a child process with the given command and arguments.
26
- *
27
- * @param {Matterbridge} matterbridge - The Matterbridge instance to use for logging and sending messages.
28
- * @param {string} command - The command to execute.
29
- * @param {string[]} args - The arguments to pass to the command (default: []).
30
- * @returns {Promise<boolean>} A promise that resolves when the child process exits successfully, or rejects if there is an error.
31
- */
32
2
  export async function spawnCommand(matterbridge, command, args) {
33
3
  const { spawn } = await import('node:child_process');
34
- /*
35
- npm > npm.cmd on windows
36
- cmd.exe ['dir'] on windows
37
- await this.spawnCommand('npm', ['install', '-g', 'matterbridge']);
38
- */
39
4
  const cmdLine = command + ' ' + args.join(' ');
40
5
  if (process.platform === 'win32' && command === 'npm') {
41
- // Must be spawn('cmd.exe', ['/c', 'npm -g install <package>']);
42
6
  const argstring = 'npm ' + args.join(' ');
43
7
  args.splice(0, args.length, '/c', argstring);
44
8
  command = 'cmd.exe';
45
9
  }
46
- // Decide when using sudo on linux and macOS
47
- // When you need sudo: Spawn stderr: npm error Error: EACCES: permission denied
48
- // When you don't need sudo: Failed to start child process "npm install -g matterbridge-eve-door": spawn sudo ENOENT
49
10
  if (hasParameter('sudo') || (process.platform !== 'win32' && command === 'npm' && !hasParameter('docker') && !hasParameter('nosudo'))) {
50
11
  args.unshift(command);
51
12
  command = 'sudo';
@@ -103,4 +64,3 @@ export async function spawnCommand(matterbridge, command, args) {
103
64
  }
104
65
  });
105
66
  }
106
- //# sourceMappingURL=spawn.js.map