matterbridge 1.5.10 → 1.6.1

package/CHANGELOG.md

@@ -8,17 +8,55 @@ If you like this project and find it useful, please consider giving it a star on
 
 The Home Assistant Community Add-ons and plugins are not verified to work with Matterbridge. I strongly advise against using them. If you do use them and encounter an issue (which is likely because some do not meet the Matterbridge guidelines), please do not open an issue in the Matterbridge repository.
 
-If you want to run Matterbridge in Home Assistant please use the official add-on https://github.com/Luligu/matterbridge-home-assistant-addon.
+If you want to run Matterbridge in Home Assistant please use the official add-on https://github.com/Luligu/matterbridge-home-assistant-addon that also has Ingress and side panel.
 
-### New Apple firmware v. 18.0
+### New Apple firmware v. 18.x
 
 Please read this: https://github.com/Luligu/matterbridge/discussions/135
 
 ### Discord
 
-Tamer (https://github.com/tammeryousef1006) has created the Matterbridge Discord group: https://discord.gg/raWywpD4.
+Tamer (https://github.com/tammeryousef1006) has created the Matterbridge Discord group: https://discord.gg/QX58CDe6hd.
 
-Feel free to join!
+Feel free to join (the link is now permanent)!
+
+## [1.6.1] - 2024-11-02
+
+### Added
+
+- [matterbridge]: Added automatic recovery for matterbridge node storage when it gets corrupted for a power outage or hardware failure. Unattended setups can automatically recover restoring the previous automatic backup.
+- [matterbridge]: Added automatic recovery for matter storage when it gets corrupted for a power outage or hardware failure. Unattended setups can automatically recover restoring the previous automatic backup.
+- [matterbridge]: Added parameter "-norestore" to avoid to restore automatically. In this case you need to manually restore the storages from a full backup made from the frontend.
+
+### Changed
+
+- [loggers]: Logging on file keeps the logger level of the logger (matterbridge and matter logs).
+- [matterbridge]: Added more api to WebSocket for the Matterbridge cockpit dashboard (Shelly gateway).
+- [package]: Update dependencies. 
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
+</a>
+
+## [1.6.0] - 2024-10-28
+
+### Added
+
+- [matterbridge]: Added WebSocket for the Matetrbridge cockpit dashboard (Shelly gateway).
+
+### Changed
+
+- [discord]: Discord group link: https://discord.gg/QX58CDe6hd.
+- [matterbridge]: Completed phase 1 of transition to edge (matter.js new API).
+- [matterbridgeDevice]: Refactor Thermostat cluster method to accept minHeatSetpointLimit, maxHeatSetpointLimit, minCoolSetpointLimit and maxCoolSetpointLimit.
+- [config]: The plugins config is rewritten only after onStart and no more after onConfigure (after the plugin starts is possible to change the plugins config and it will not be rewritten after the plugin configuration).
+- [matterbridgeDevice]: Removed deprecated methods of ColorControl cluster.
+- [package]: Removed EveHistory (it will be used only by single plugins).
+- [package]: Update dependencies.
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
+</a>
 
 ## [1.5.10] - 2024-10-01
 

package/README-SERVICE.md

@@ -100,7 +100,7 @@ sudo systemctl disable matterbridge.service
 ### View the log of Matterbridge in real time (this will show the log with colors)
 
 ```
-sudo journalctl -u matterbridge.service -f --output cat
+sudo journalctl -u matterbridge.service -n 1000 -f --output cat
 ```
 
 ### Delete the logs older then 3 days (all of them not only the ones of Matterbridge!)

package/README.md

@@ -51,13 +51,13 @@ To run Matterbridge, you need either a [Node.js](https://nodejs.org/en/download/
 Follow these steps to install Matterbridge:
 
 ```
-npm install -g matterbridge
+npm install -g matterbridge --omit=dev
 ```
 
 on Linux you may need the necessary permissions:
 
 ```
-sudo npm install -g matterbridge
+sudo npm install -g matterbridge --omit=dev
 ```
 
 Test the installation with:
@@ -68,7 +68,7 @@ matterbridge
 
 Now it is possible to open the frontend at the link provided in the log (e.g. http://MATTERBIDGE-IPV4-ADDRESS:8283).
 
-You can then change the bridge mode from the frontend.
+You can then change the bridge mode and other parameters from the frontend.
 
 ## Usage
 
@@ -128,19 +128,19 @@ Config editor:
 
 ### Run matterbridge as a daemon with systemctl (Linux only)
 
-[Advanced configurations](https://github.com/Luligu/matterbridge/blob/main/README-SERVICE.md)
+[Service configurations](https://github.com/Luligu/matterbridge/blob/main/README-SERVICE.md)
 
 ### Run matterbridge with docker and docker compose
 
-[Advanced configurations](https://github.com/Luligu/matterbridge/blob/main/README-DOCKER.md)
+[Docker configurations](https://github.com/Luligu/matterbridge/blob/main/README-DOCKER.md)
 
 ### Run matterbridge with podman
 
-[Advanced configurations](https://github.com/Luligu/matterbridge/blob/main/README-PODMAN.md)
+[Podman configurations](https://github.com/Luligu/matterbridge/blob/main/README-PODMAN.md)
 
 ### Run matterbridge as an home assistant add-on with the official add-on
 
-[Advanced configurations](https://github.com/Luligu/matterbridge-home-assistant-addon)
+[Home assistant add-on configurations](https://github.com/Luligu/matterbridge-home-assistant-addon)
 
 ### Other Home Assistant Community Add-ons
 
@@ -380,6 +380,8 @@ The HomePods, being a WiFi devices, sometimes pruduce message trasmission errors
 
 All issues have been solved from the version 17.5 of the HomePod/AppleTV. Now they are stable.
 
+If you have more then one Apple TV or Home Pod, you can herve better results setting to disabled "Automatic Selection" in "Home Setting", "Home Hubs & Bridges". When "Automatic selection" is disabled, select your Apple Tv if you have one or any of your Home Pod. In this way you should not have anymore more then one session for fabric.
+
 ## Home Assistant
 
 So far is the only controller supporting some Matter 1.2 and 1.3 device type:
@@ -409,6 +411,8 @@ Other supported cluster:
 
 If you face a problem pairing to Google Home from Ios app the solution is there https://github.com/Luligu/matterbridge/issues/61.
 
+If you face a problem changing the brightness check this for the explanation: https://github.com/Luligu/matterbridge-zigbee2mqtt/issues/80
+
 No other issues reported so far.
 
 ## Alexa

package/dist/cli.d.ts

@@ -7,7 +7,7 @@
  * @date 2023-12-29
  * @version 1.0.11
  *
- * Copyright 2023, 2024 Luca Liguori.
+ * Copyright 2023, 2024, 2025 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/cli.js

@@ -7,7 +7,7 @@
  * @date 2023-12-29
  * @version 1.0.11
  *
- * Copyright 2023, 2024 Luca Liguori.
+ * Copyright 2023, 2024, 2025 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -59,10 +59,12 @@ async function restart() {
 async function update() {
     if (process.argv.includes('-debug'))
         console.log(cli + 'CLI: received update event, updating...' + rs);
+    // TODO: Implement update logic outside of matterbridge
     instance = await Matterbridge.loadInstance(true);
     registerHandlers();
 }
 process.title = 'matterbridge';
+// Run the main function
 main().catch((error) => {
     console.error(er + `CLI: Matterbridge.loadInstance() failed with error: ${error}` + rs);
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+BAA+B;AAC/B,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,IAAI,QAAkC,CAAC;AACvC,MAAM,GAAG,GAAG,YAAY,CAAC;AACzB,MAAM,EAAE,GAAG,gBAAgB,CAAC;AAC5B,MAAM,EAAE,GAAG,cAAc,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;IACnB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,0CAA0C,GAAG,EAAE,CAAC,CAAC;IACxG,cAAc;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,MAAM;IACnB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;AAE/B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,uDAAuD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+BAA+B;AAC/B,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,IAAI,QAAkC,CAAC;AACvC,MAAM,GAAG,GAAG,YAAY,CAAC;AACzB,MAAM,EAAE,GAAG,gBAAgB,CAAC;AAC5B,MAAM,EAAE,GAAG,cAAc,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;IACnB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,QAAQ;QAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,0CAA0C,GAAG,EAAE,CAAC,CAAC;IACxG,cAAc;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,MAAM;IACnB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,yCAAyC,GAAG,EAAE,CAAC,CAAC;IACvG,uDAAuD;IACvD,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;AAE/B,wBAAwB;AACxB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,uDAAuD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC"}

package/dist/cluster/export.js

@@ -1,3 +1,3 @@
 export {};
-// Nothing to export
+// Nothing to export right now
 //# sourceMappingURL=export.js.map

package/dist/cluster/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/cluster/export.ts"],"names":[],"mappings":";AAAA,oBAAoB"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/cluster/export.ts"],"names":[],"mappings":";AAAA,8BAA8B"}

package/dist/defaultConfigSchema.d.ts

@@ -6,7 +6,7 @@
  * @date 2024-05-07
  * @version 1.0.1
  *
- * Copyright 2024 Luca Liguori.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/defaultConfigSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfigSchema.d.ts","sourceRoot":"","sources":["../src/defaultConfigSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,eAAO,MAAM,kBAAkB,EAAE,cAiBhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAWhC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAwB3B,CAAC"}
+{"version":3,"file":"defaultConfigSchema.d.ts","sourceRoot":"","sources":["../src/defaultConfigSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,eAAO,MAAM,kBAAkB,EAAE,cAiBhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAWhC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAgC3B,CAAC"}

package/dist/defaultConfigSchema.js

@@ -6,7 +6,7 @@
  * @date 2024-05-07
  * @version 1.0.1
  *
- * Copyright 2024 Luca Liguori.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -56,11 +56,19 @@ export const shelly_config = {
     username: '',
     password: '',
     exposeSwitch: 'switch',
+    switchList: [],
+    lightList: [],
+    outletList: [],
     exposeInput: 'momentary',
+    inputContactList: [],
+    inputMomentaryList: [],
+    inputLatchingList: [],
     exposeInputEvent: 'momentary',
-    exposePowerMeter: 'disabled',
+    inputEventList: [],
+    exposePowerMeter: 'matter13',
     blackList: [],
     whiteList: [],
+    nocacheList: [],
     deviceIp: {},
     enableMdnsDiscover: true,
     enableStorageDiscover: true,

package/dist/defaultConfigSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfigSchema.js","sourceRoot":"","sources":["../src/defaultConfigSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,aAAa;IACpB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,EAAE;IACpB,sBAAsB,EAAE,EAAE;IAC1B,KAAK,EAAE,KAAK;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,gBAAgB,EAAE,EAAE;IACpB,KAAK,EAAE,KAAK;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,WAAW;IACxB,gBAAgB,EAAE,WAAW;IAC7B,gBAAgB,EAAE,UAAU;IAC5B,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,kBAAkB,EAAE,IAAI;IACxB,qBAAqB,EAAE,IAAI;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}
+{"version":3,"file":"defaultConfigSchema.js","sourceRoot":"","sources":["../src/defaultConfigSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,aAAa;IACpB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,EAAE;IACpB,sBAAsB,EAAE,EAAE;IAC1B,KAAK,EAAE,KAAK;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,gBAAgB,EAAE,EAAE;IACpB,KAAK,EAAE,KAAK;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,WAAW;IACxB,gBAAgB,EAAE,EAAE;IACpB,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE;IACrB,gBAAgB,EAAE,WAAW;IAC7B,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,UAAU;IAC5B,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,kBAAkB,EAAE,IAAI;IACxB,qBAAqB,EAAE,IAAI;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/dist/deviceManager.d.ts

@@ -6,7 +6,7 @@
  * @date 2024-07-26
  * @version 1.0.8
  *
- * Copyright 2024, 2025 Luca Liguori.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/deviceManager.js

@@ -6,7 +6,7 @@
  * @date 2024-07-26
  * @version 1.0.8
  *
- * Copyright 2024, 2025 Luca Liguori.
+ * Copyright 2024, 2025, 2026 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * @date 2023-12-29
  * @version 1.0.6
  *
- * Copyright 2023, 2024 Luca Liguori.
+ * Copyright 2023, 2024, 2025 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/index.js

@@ -6,7 +6,7 @@
  * @date 2023-12-29
  * @version 1.0.6
  *
- * Copyright 2023, 2024 Luca Liguori.
+ * Copyright 2023, 2024, 2025 Luca Liguori.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/dist/matterbridge.d.ts

@@ -21,9 +21,17 @@
  * limitations under the License. *
  */
 import EventEmitter from 'events';
+import WebSocket from 'ws';
+import { NodeStorageManager, NodeStorage } from 'node-persist-manager';
 import { AnsiLogger } from 'node-ansi-logger';
 import { MatterbridgeDevice } from './matterbridgeDevice.js';
-import { MatterbridgeInformation, SanitizedExposedFabricInformation, SanitizedSessionInformation, SystemInformation } from './matterbridgeTypes.js';
+import { BaseRegisteredPlugin, MatterbridgeInformation, SanitizedExposedFabricInformation, SanitizedSessionInformation, SystemInformation } from './matterbridgeTypes.js';
+import { PluginManager } from './pluginManager.js';
+import { DeviceManager } from './deviceManager.js';
+import { CommissioningController, CommissioningServer, MatterServer } from '@project-chip/matter-node.js';
+import { DeviceTypeId, VendorId } from '@project-chip/matter-node.js/datatype';
+import { Aggregator } from '@project-chip/matter-node.js/device';
+import { StorageContext, StorageManager } from '@project-chip/matter-node.js/storage';
 /**
  * Represents the Matterbridge application.
  */
@@ -47,44 +55,47 @@ export declare class Matterbridge extends EventEmitter {
     restartMode: 'service' | 'docker' | '';
     profile: string | undefined;
     log: AnsiLogger;
-    private matterbrideLoggerFile;
-    private matterLoggerFile;
-    private plugins;
-    private devices;
-    private nodeStorage;
-    private nodeContext;
-    private matterStorageName;
-    private nodeStorageName;
+    protected matterbrideLoggerFile: string;
+    protected matterLoggerFile: string;
+    protected plugins: PluginManager;
+    protected devices: DeviceManager;
+    protected nodeStorage: NodeStorageManager | undefined;
+    protected nodeContext: NodeStorage | undefined;
+    protected matterStorageName: string;
+    protected nodeStorageName: string;
     private hasCleanupStarted;
     private initialized;
     private execRunningCount;
     private startMatterInterval;
-    private cleanupTimeout1;
-    private cleanupTimeout2;
     private checkUpdateInterval;
     private configureTimeout;
     private reachabilityTimeout;
     private sigintHandler;
     private sigtermHandler;
+    private exceptionHandler;
+    private rejectionHandler;
     private expressApp;
     private httpServer;
     private httpsServer;
     private webSocketServer;
-    private mdnsInterface;
-    private ipv4address;
-    private ipv6address;
-    private port;
-    private passcode?;
-    private discriminator?;
-    private storageManager;
-    private matterbridgeContext;
-    private mattercontrollerContext;
-    private matterServer;
-    private matterAggregator;
-    private commissioningServer;
-    private commissioningController;
-    private static instance;
-    private constructor();
+    protected mdnsInterface: string | undefined;
+    protected ipv4address: string | undefined;
+    protected ipv6address: string | undefined;
+    protected port: number;
+    protected passcode?: number;
+    protected discriminator?: number;
+    protected storageManager: StorageManager | undefined;
+    protected matterbridgeContext: StorageContext | undefined;
+    protected mattercontrollerContext: StorageContext | undefined;
+    protected matterServer: MatterServer | undefined;
+    protected matterAggregator: Aggregator | undefined;
+    protected commissioningServer: CommissioningServer | undefined;
+    protected commissioningController: CommissioningController | undefined;
+    protected aggregatorVendorId: VendorId;
+    protected aggregatorProductId: number;
+    protected static instance: Matterbridge | undefined;
+    protected constructor();
+    matterbridgeMessageHandler: (client: WebSocket, message: WebSocket.RawData) => Promise<void>;
     /** ***********************************************************************************************************************************/
     /**                                              loadInstance() and cleanup() methods                                                 */
     /** ***********************************************************************************************************************************/
@@ -120,14 +131,23 @@ export declare class Matterbridge extends EventEmitter {
      */
     private parseCommandLine;
     /**
-     * Registers the signal handlers for SIGINT and SIGTERM.
+     * Asynchronously loads and starts the registered plugins.
+     *
+     * This method is responsible for initializing and staarting all enabled plugins.
+     * It ensures that each plugin is properly loaded and started before the ridge starts.
+     *
+     * @returns {Promise<void>} A promise that resolves when all plugins have been loaded and started.
+     */
+    private startPlugins;
+    /**
+     * Registers the process handlers for uncaughtException, unhandledRejection, SIGINT and SIGTERM.
      * When either of these signals are received, the cleanup method is called with an appropriate message.
      */
-    private registerSignalHandlers;
+    private registerProcessHandlers;
     /**
-     * Deregisters the SIGINT and SIGTERM signal handlers.
+     * Deregisters the process uncaughtException, unhandledRejection, SIGINT and SIGTERM signal handlers.
      */
-    private deregisterSignalHandlers;
+    private deregisterProcesslHandlers;
     /**
      * Logs the node and system information.
      */
@@ -177,15 +197,15 @@ export declare class Matterbridge extends EventEmitter {
     /**
      * Update matterbridge and cleanup.
      */
-    private updateProcess;
+    protected updateProcess(): Promise<void>;
     /**
      * Restarts the process by spawning a new process and exiting the current process.
      */
-    private restartProcess;
+    protected restartProcess(): Promise<void>;
     /**
      * Shut down the process by exiting the current process.
      */
-    private shutdownProcess;
+    protected shutdownProcess(): Promise<void>;
     /**
      * Shut down the process and reset.
      */
@@ -204,7 +224,7 @@ export declare class Matterbridge extends EventEmitter {
      * @param restart - Indicates whether to restart the instance after cleanup. Default is `false`.
      * @returns A promise that resolves when the cleanup is completed.
      */
-    private cleanup;
+    protected cleanup(message: string, restart?: boolean): Promise<void>;
     /**
      * Adds a bridged device to the Matterbridge.
      * @param pluginName - The name of the plugin.
@@ -226,25 +246,24 @@ export declare class Matterbridge extends EventEmitter {
      * @returns A promise that resolves when all devices have been removed.
      */
     removeAllBridgedDevices(pluginName: string): Promise<void>;
-    private startTest;
     /**
      * Starts the Matterbridge in bridge mode.
      * @private
      * @returns {Promise<void>} A promise that resolves when the Matterbridge is started.
      */
-    private startBridge;
+    protected startBridge(): Promise<void>;
     /**
      * Starts the Matterbridge in childbridge mode.
      * @private
      * @returns {Promise<void>} A promise that resolves when the Matterbridge is started.
      */
-    private startChildbridge;
+    protected startChildbridge(): Promise<void>;
     /**
      * Starts the Matterbridge controller.
      * @private
      * @returns {Promise<void>} A promise that resolves when the Matterbridge is started.
      */
-    private startController;
+    protected startController(): Promise<void>;
     /** ***********************************************************************************************************************************/
     /**                                                     Matter.js methods                                                             */
     /** ***********************************************************************************************************************************/
@@ -254,40 +273,47 @@ export declare class Matterbridge extends EventEmitter {
      * @param {string} storageName - The name of the storage file.
      * @returns {Promise<void>} - A promise that resolves when the storage process is started.
      */
-    private startMatterStorage;
+    protected startMatterStorage(storageType: string, storageName: string): Promise<void>;
     /**
      * Makes a backup copy of the specified matter JSON storage file.
      *
      * @param storageName - The name of the JSON storage file to be backed up.
      * @param backupName - The name of the backup file to be created.
      */
-    private backupJsonMatterStorage;
+    protected backupMatterStorage(storageName: string, backupName: string): Promise<void>;
+    /**
+     * Restore the specified matter JSON storage file.
+     *
+     * @param backupName - The name of the backup file to restore from.
+     * @param storageName - The name of the JSON storage file to restored.
+     */
+    protected restoreMatterStorage(backupName: string, storageName: string): Promise<void>;
     /**
      * Stops the matter storage.
      * @returns {Promise<void>} A promise that resolves when the storage is stopped.
      */
-    private stopMatterStorage;
+    protected stopMatterStorage(): Promise<void>;
     /**
      * Creates a Matter server using the provided storage manager and the provided mdnsInterface.
      * @param storageManager The storage manager to be used by the Matter server.
      *
      */
-    private createMatterServer;
+    protected createMatterServer(storageManager: StorageManager): MatterServer;
     /**
      * Starts the Matter server.
      * If the Matter server is not initialized, it logs an error and performs cleanup.
      */
-    private startMatterServer;
+    protected startMatterServer(): Promise<void>;
     /**
      * Stops the Matter server, commissioningServer and commissioningController.
      */
-    private stopMatterServer;
+    protected stopMatterServer(): Promise<void>;
     /**
      * Creates a Matter Aggregator.
      * @param {StorageContext} context - The storage context.
      * @returns {Aggregator} - The created Matter Aggregator.
      */
-    private createMatterAggregator;
+    protected createMatterAggregator(context: StorageContext, pluginName: string): Promise<Aggregator>;
     /**
      * Creates a matter commissioning server.
      *
@@ -295,7 +321,7 @@ export declare class Matterbridge extends EventEmitter {
      * @param {string} pluginName - The name of the commissioning server.
      * @returns {CommissioningServer} The created commissioning server.
      */
-    private createCommisioningServer;
+    protected createCommisioningServer(context: StorageContext, pluginName: string): Promise<CommissioningServer>;
     /**
      * Creates a commissioning server storage context.
      *
@@ -314,7 +340,7 @@ export declare class Matterbridge extends EventEmitter {
      * @param hardwareVersionString - The hardware version string of the device (optional).
      * @returns The storage context for the commissioning server.
      */
-    private createCommissioningServerContext;
+    protected createCommissioningServerContext(pluginName: string, deviceName: string, deviceType: DeviceTypeId, vendorId: number, vendorName: string, productId: number, productName: string): Promise<StorageContext>;
     /**
      * Imports the commissioning server context for a specific plugin and device.
      * @param pluginName - The name of the plugin.
@@ -322,7 +348,7 @@ export declare class Matterbridge extends EventEmitter {
      * @returns The commissioning server context.
      * @throws Error if the BasicInformationCluster is not found.
      */
-    private importCommissioningServerContext;
+    protected importCommissioningServerContext(pluginName: string, device: MatterbridgeDevice): Promise<StorageContext>;
     /**
      * Shows the commissioning server QR code for a given plugin.
      * @param {CommissioningServer} commissioningServer - The commissioning server instance.
@@ -331,7 +357,7 @@ export declare class Matterbridge extends EventEmitter {
      * @param {string} pluginName - The name of the plugin of Matterbridge in bridge mode.
      * @returns {Promise<void>} - A promise that resolves when the QR code is shown.
      */
-    private showCommissioningQRCode;
+    protected showCommissioningQRCode(commissioningServer: CommissioningServer | undefined, storageContext: StorageContext | undefined, nodeContext: NodeStorage | undefined, pluginName: string): Promise<void>;
     /**
      * Sanitizes the fabric information by converting bigint properties to string cause res.json doesn't know bigint.
      *
@@ -352,33 +378,33 @@ export declare class Matterbridge extends EventEmitter {
      * @param {CommissioningServer} commissioningServer - The commissioning server to set the reachability for.
      * @param {boolean} reachable - The new reachability status.
      */
-    private setCommissioningServerReachability;
+    protected setCommissioningServerReachability(commissioningServer: CommissioningServer, reachable: boolean): void;
     /**
      * Sets the reachability of the specified matter aggregator and its bridged devices and trigger.
      * @param {Aggregator} matterAggregator - The matter aggregator to set the reachability for.
      * @param {boolean} reachable - A boolean indicating the reachability status to set.
      */
-    private setAggregatorReachability;
+    protected setAggregatorReachability(matterAggregator: Aggregator, reachable: boolean): void;
     /**
      * Sets the reachability of a device and trigger.
      *
      * @param {MatterbridgeDevice} device - The device to set the reachability for.
      * @param {boolean} reachable - The new reachability status of the device.
      */
-    private setDeviceReachability;
+    protected setDeviceReachability(device: MatterbridgeDevice, reachable: boolean): void;
     private getVendorIdName;
     /**
      * Retrieves the base registered plugins sanitized for res.json().
      * @returns {BaseRegisteredPlugin[]} A promise that resolves to an array of BaseRegisteredPlugin objects.
      */
-    private getBaseRegisteredPlugins;
+    protected getBaseRegisteredPlugins(): Promise<BaseRegisteredPlugin[]>;
     /**
      * Spawns a child process with the given command and arguments.
      * @param {string} command - The command to execute.
      * @param {string[]} args - The arguments to pass to the command (default: []).
-     * @returns {Promise<void>} A promise that resolves when the child process exits successfully, or rejects if there is an error.
+     * @returns {Promise<boolean>} A promise that resolves when the child process exits successfully, or rejects if there is an error.
      */
-    private spawnCommand;
+    protected spawnCommand(command: string, args?: string[]): Promise<boolean>;
     /**
      * Sends a WebSocket message to all connected clients.
      *
@@ -388,6 +414,16 @@ export declare class Matterbridge extends EventEmitter {
      * @param {string} message - The content of the message.
      */
     private wssSendMessage;
+    /**
+     * Sends a need to refresh WebSocket message to all connected clients.
+     *
+     */
+    private wssSendRefreshRequired;
+    /**
+     * Sends a need to restart WebSocket message to all connected clients.
+     *
+     */
+    private wssSendRestartRequired;
     /**
      * Initializes the frontend of Matterbridge.
      *
@@ -399,7 +435,7 @@ export declare class Matterbridge extends EventEmitter {
      * @param {MatterbridgeDevice} device - The MatterbridgeDevice object.
      * @returns {string} The attributes description of the cluster servers in the device.
      */
-    private getClusterTextFromDevice;
+    protected getClusterTextFromDevice(device: MatterbridgeDevice): string;
     /**
      * Initializes the Matterbridge instance as extension for zigbee2mqtt.
      * @deprecated This method is deprecated and will be removed in a future version.