Release 0.12 from 23.01.2025

[Apollon77]

matter.js 0.12 - New Year, New Version ;-)

We’re excited to announce the release of version 0.12 of matter.js, the Matter JavaScript SDK!

What’s New in Version 0.12

This release focuses on feedback from our open-source community of developers. By addressing reported issues, we’ve enhanced the stability and reliability of matter.js in key areas, including MDNS and BLE, for seamless device discovery and commissioning.

We’ve also made improvements to better align with the Matter specification, particularly for controller use cases. This includes adding the fabric label during commissioning, which is now also verified and updated during new connections.

Behind the scenes, we’ve strengthened our automated compliance testing and prepared our tools and model features for Matter 1.4. These updates ensure matter.js remains prepared for the newest evolution of the Matter standard to land soon.

For a detailed breakdown of all changes, head over to the 0.12 release notes on GitHub.

Another significant milestone for matter.js is its official listing in the “Build With Matter Handbook” as one of the options for building Matter-compliant devices, bridges, and controllers. We’d like to thank the Connectivity Standards Alliance and its members for this opportunity.

Looking ahead, version 0.13 will upgrade all clusters and device types to Matter 1.4 and remove the legacy API for device building, which was replaced by the new API in version 0.8 already. Stay tuned for more updates in the near future!

Breaking Changes

The main Breaking change is the requirement to provide a "Fabric label" when creating a Controller instance.

For other topics please check the changelog below.

Legacy API Notice

If you’re still using the “Legacy Device Building API,” we encourage you to upgrade because the legacy Device building API is scheduled for removal in the next 0.13 version. The new API is faster, feature-rich, and will be the focus of future enhancements. Reach out if you need support with the migration.

Get Involved

Update to matter.js 0.12 on npm, and share your experiences, feedback, and questions on GitHub or Discord. Our team is here to help!

For a complete list of changes, see the Release Notes below.

• @matter/general

  • Enhancement: Limits MDNS expires just to te relevant operational records when removing a fabric

• @matter/model

  • Feature: The constraint evaluator now supports simple mathematical expressions
  • Feature: The constraint evaluator now supports limits on the number of Unicode codepoints in a string
  • Feature: Default values may now be a reference to another field

• @matter/node

  • Feature: Constraint and conformance expressions may now reference values by name in any owner of a constrained value
  • Enhancement: Each new PASE session now automatically arms the failsafe timer for 60s as required by specs
  • Enhancement: Optimizes Node shutdown logic to close sessions and subscriptions before shutting down the network
  • Fix: Fixes withBehaviors() method on endpoints

• @matter/nodejs

  • Breaking: Also the Sync Storage classes mainly used in legacy API now have an async close method!
  • Fix: Converts commissioning.fabrics into dynamically generated property to ensure it is up to date when accessed

• @matter/nodejs-ble

  • Enhancement: Restructures BLE connection handling to improve reliability and eliminate hanging commissioning processes
  • Fix: Adds support for advanced manufacturer data on Windows (Noble update)
  • Fix: Added workaround for Noble on Windows to prevent discovery issues
  • Fix: Considers formerly discovered devices as outdated when new discovery is started

• @matter/protocol

  • Feature: Reworks Event server handling and optionally allow Non-Volatile event storage (currently mainly used in tests)
  • Enhancement: Adds a too-fast-resubmission guard for Unicast MDNS messages
  • Enhancement: Optimized Logging for messages in various places
  • Enhancement: Added support for concurrent and non-concurrent commissioning flows
  • Enhancement: Re-arms the failsafe timer in commissioning flows before steps that could take longer and during operative reconnection
  • Enhancement: Stores Matter relevant MDNS host information to faster reuse when new SRV announcements come in
  • Fix: Corrects some Batch invoke checks and logic
  • Fix: Fixes MDNS discovery duration for retransmission cases to be 5s
  • Fix: Processes all TXT/SRV records in MDNS messages and optimized the processing
  • Fix: Prevents multi message interactions from trying to continue on new exchange
  • Fix: Fixes the timed node polling during discovery
  • Fix: Fixes commissionable devices discovery with timeout
  • Fix: Restores the possibility to cancel a (continuous) discovery for commissionable devices
  • Fix: Fixes enablement of MDNS broadcasts when BLE commissioning is used

• @project-chip/matter.js

  • Feature: (Breaking) Added Fabric Label for Controller as required property to initialize the Controller
    including setting the Fabric Label when commissioning and validating and updating the Fabric Label on
    connection
  • Feature: Added autoConnect property to node connection options to allow to not automatically connect to a node when PairedNode instance is created. Also introduces a non-blocking PairedNode.connect() method to connect to a node
  • Feature: Added CommissioningController.getNode() method to get a PairedNode instance for a node by its node ID without a direct connection
  • Feature: Allows to update the Fabric Label during controller runtime using updateFabricLabel() on CommissioningController
  • Enhancement: Improves Reconnection Handling for devices that use persisted subscriptions
  • Enhancement: Use data type definitions from Model for Controller Device type definitions
  • Enhancement: Added remove*Listener() to ClusterClient objects to remove listeners added with add*Listener() or subscribe*() (The subscription is not cleared!)
  • Fix: When a paired node gets disconnected (or decommissioned) invalidate subscription handlers to prevent reconnection tries