matterbridge 1.6.7 → 1.6.8-dev.10

package/CHANGELOG.md

@@ -6,20 +6,40 @@ If you like this project and find it useful, please consider giving it a star on
 
 ### Home Assistant
 
-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. 
+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.
 It is also available the official Matterbridge Home Assistant plugin https://github.com/Luligu/matterbridge-hass.
 
 ### Discord
 
 Tamer (https://github.com/tammeryousef1006) has created the Matterbridge Discord group: https://discord.gg/QX58CDe6hd.
 
+## [1.6.8-dev.10] - 2024-12-21
+
+### Added
+
+- [storage]: Added conversion from old matter storage to the new api format with fabrics, resumptionRecords, network, commissioning, operationalCredentials, acl and parts number. The conversion is triggered every time you shutdown or restart matterbridge till the new storage has been used with matterbridge edge. 
+- [storage]: Added conversion for child endpoint numbers. 
+- [package]: Update README.md and README-SERVICE.md to include instructions for using SSL on port 443.
+- [platform]: Added checkEndpointNumbers() to detect endpoint numbers changes.
+
+### Changed
+
+- [edge]: Fixes to edge mode.
+- [package]: Update dependencies.
+
+### Fixed
+
+<a href="https://www.buymeacoffee.com/luligugithub">
+  <img src="./yellow-button.png" alt="Buy me a coffee" width="120">
+</a>
+
+## [1.6.7] - 2024-12-15
+
 ### Breaking Changes
 
 In this release some device types and the OnOff, LevelControl and ColorControl have been updated to be fully compliant with Matter 1.3 specifications.
 It is possible that some controllers see them as new devices or need time to read the new clusters. It can be useful after the upgrade to power off the controller, wait a few minutes and power it on again.
 
-## [1.6.7] - 2024-12-15
-
 ### Added
 
 - [readme]: Update README to clarify Node.js installation instructions and emphasize LTS version.

package/README-SERVICE.md

@@ -35,7 +35,7 @@ Create a systemctl configuration file for Matterbridge
 sudo nano /etc/systemd/system/matterbridge.service
 ```
 
-Add the following to this file, replacing twice (!) USER with your user name (e.g. WorkingDirectory=/home/pi/Matterbridge and User=pi):
+Add the following to this file, replacing 3 times (!) USER with your user name (e.g. WorkingDirectory=/home/pi/Matterbridge, User=pi and Group=pi):
 
 You may need to adapt the configuration to your setup:
 
@@ -49,18 +49,27 @@ After=network-online.target
 [Service]
 Type=simple
 ExecStart=matterbridge -service
-WorkingDirectory=/home/<USER>/Matterbridge
+WorkingDirectory=/home/<USER>/Matterbridge  # Replace <USER> with your system username
 StandardOutput=inherit
 StandardError=inherit
 Restart=always
 RestartSec=10s
 TimeoutStopSec=30s
-User=<USER>
+User=<USER>                                 # Replace <USER> with your system username
+Group=<USER>                                # Replace <USER> with your system username
 
 [Install]
 WantedBy=multi-user.target
 ```
 
+If you use the frontend with -ssl -frontend 443 and get an error message: "Port 443 requires elevated privileges",
+add this:
+
+```
+[Service]
+AmbientCapabilities=CAP_NET_BIND_SERVICE
+```
+
 If you modify it after, then run:
 
 ```

package/README.md

@@ -46,7 +46,7 @@ A special thank to Apollon77 for his incredible work.
 
 To run Matterbridge, you need either a [Node.js](https://nodejs.org/en) environment or [Docker](https://docs.docker.com/get-started/get-docker/) installed on your system.
 
-If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions. 
+If you don't have Node.js already install, please use this method to install it on a debian device: https://github.com/nodesource/distributions.
 The supported versions of node are 18, 20 and 22. Please install node 22 LTS.
 Nvm is not a good choice and should not be used for production.
 
@@ -116,6 +116,8 @@ Here's how to specify a different port number:
 matterbridge -frontend [port number]
 ```
 
+To use the frontend with ssl place the certificates in the .matterbridge/certs directory: cert.pem, key.pem and ca.pem (optional).
+
 From the frontend you can do all operations in an easy way.
 
 Home page:

package/dist/cli.js

@@ -1,27 +1,4 @@
 #!/usr/bin/env node
-/**
- * This file contains the CLI entry point of Matterbridge.
- *
- * @file cli.ts
- * @author Luca Liguori
- * @date 2023-12-29
- * @version 1.0.11
- *
- * 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.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
-/* eslint-disable no-console */
 import { Matterbridge } from './matterbridge.js';
 import { MatterbridgeEdge } from './matterbridgeEdge.js';
 let instance;
@@ -64,7 +41,6 @@ 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
     if (process.argv.includes('-edge'))
         instance = await MatterbridgeEdge.loadInstance();
     else
@@ -72,8 +48,6 @@ async function update() {
     registerHandlers();
 }
 process.title = 'matterbridge';
-// Run the main function
 main().catch((error) => {
     console.error(er + `CLI: Matterbridge.loadInstance() failed with error: ${error}` + rs);
 });
-//# sourceMappingURL=cli.js.map

package/dist/cluster/export.js

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

package/dist/defaultConfigSchema.js

@@ -1,25 +1,3 @@
-/**
- * This file contains the default config for the plugins.
- *
- * @file defaultConfigSchema.ts
- * @author Luca Liguori
- * @date 2024-05-07
- * @version 1.0.1
- *
- * 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.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
 export const zigbee2mqtt_config = {
     name: 'matterbridge-zigbee2mqtt',
     type: 'DynamicPlatform',
@@ -55,7 +33,7 @@ export const shelly_config = {
     type: 'DynamicPlatform',
     username: '',
     password: '',
-    exposeSwitch: 'switch',
+    exposeSwitch: 'outlet',
     switchList: [],
     lightList: [],
     outletList: [],
@@ -68,6 +46,8 @@ export const shelly_config = {
     exposePowerMeter: 'matter13',
     blackList: [],
     whiteList: [],
+    entityBlackList: [],
+    deviceEntityBlackList: {},
     nocacheList: [],
     deviceIp: {},
     enableMdnsDiscover: true,
@@ -83,4 +63,3 @@ export const shelly_config = {
     debugWs: false,
     unregisterOnShutdown: false,
 };
-//# sourceMappingURL=defaultConfigSchema.js.map

package/dist/deviceManager.js

@@ -1,26 +1,3 @@
-/**
- * This file contains the DeviceManager class.
- *
- * @file devices.ts
- * @author Luca Liguori
- * @date 2024-07-26
- * @version 1.0.8
- *
- * 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.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
-// NodeStorage and AnsiLogger modules
 import { AnsiLogger, BLUE, er } from 'node-ansi-logger';
 import { dev } from './matterbridgeTypes.js';
 export class DeviceManager {
@@ -31,7 +8,7 @@ export class DeviceManager {
     constructor(matterbridge, nodeContext) {
         this.matterbridge = matterbridge;
         this.nodeContext = nodeContext;
-        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4 /* TimestampFormat.TIME_MILLIS */, logLevel: matterbridge.log.logLevel });
+        this.log = new AnsiLogger({ logName: 'DeviceManager', logTimestampFormat: 4, logLevel: matterbridge.log.logLevel });
         this.log.debug('Matterbridge device manager starting...');
     }
     get length() {
@@ -77,7 +54,6 @@ export class DeviceManager {
             }
             catch (error) {
                 this.log.error(`Error processing forEach device ${dev}${device.deviceName}${er} serialNumber ${BLUE}${device.serialNumber}${er} uniqueId: ${BLUE}${device.uniqueId}${er}:`, error);
-                // throw error;
             }
         });
         await Promise.all(tasks);
@@ -89,4 +65,3 @@ export class DeviceManager {
         this.log.logLevel = logLevel;
     }
 }
-//# sourceMappingURL=deviceManager.js.map

package/dist/index.js

@@ -1,36 +1,10 @@
-/**
- * This file contains the entry point of Matterbridge.
- *
- * @file index.ts
- * @author Luca Liguori
- * @date 2023-12-29
- * @version 1.0.6
- *
- * 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.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License. *
- */
 import { Matterbridge } from './matterbridge.js';
 import { MatterbridgeEdge } from './matterbridgeEdge.js';
-// @matter
-// export { Identity, AtLeastOne } from '@matter/main';
 export * from '@matter/main/clusters';
 export * from '@matter/main/types';
 export { SemanticNamespace, ClosureTag, CompassDirectionTag, CompassLocationTag, DirectionTag, ElectricalMeasurementTag, LaundryTag, LevelTag, LocationTag, NumberTag, PositionTag, PowerSourceTag, RefrigeratorTag, RoomAirConditionerTag, SwitchesTag, } from '@matter/node';
-// @project-chip
 export * from '@project-chip/matter.js/device';
 export * from '@project-chip/matter.js/cluster';
-// Matterbridge
 export * from './matterbridge.js';
 export * from './matterbridgeTypes.js';
 export * from './matterbridgeDevice.js';
@@ -43,19 +17,15 @@ const cli = '\u001B[32m';
 const er = '\u001B[38;5;9m';
 const rs = '\u001B[40;0m';
 async function main() {
-    // eslint-disable-next-line no-console
     if (process.argv.includes('-debug'))
         console.log(cli + 'MAIN: Matterbridge.loadInstance() called' + rs);
     if (process.argv.includes('-edge'))
         await MatterbridgeEdge.loadInstance();
     else
         await Matterbridge.loadInstance();
-    // eslint-disable-next-line no-console
     if (process.argv.includes('-debug'))
         console.log(cli + 'MAIN: Matterbridge.loadInstance() exited' + rs);
 }
 main().catch((error) => {
-    // eslint-disable-next-line no-console
     console.error(er + `MAIN: Matterbridge.loadInstance() failed with error: ${error}` + rs);
 });
-//# sourceMappingURL=index.js.map

package/dist/logger/export.js

@@ -1,2 +1 @@
 export * from 'node-ansi-logger';
-//# sourceMappingURL=export.js.map

package/dist/matter/export.js

@@ -1,6 +1,10 @@
 export * from '@matter/main';
+export { AggregatorEndpoint } from '@matter/main/endpoints';
+export * from '@matter/main/devices';
+export * from '@matter/main/behaviors';
+export { FabricAction, MdnsService, PaseClient } from '@matter/main/protocol';
 export { AttributeElement, ClusterElement, ClusterModel, CommandElement, EventElement, FieldElement } from '@matter/main/model';
 export * from '../matterbridgeDeviceTypes.js';
 export * from '../matterbridgeEndpoint.js';
 export * from '../matterbridgeBehaviors.js';
-//# sourceMappingURL=export.js.map
+export * from '../matterbridgeEdge.js';