@matter/main

@matter/main

Implementation of Matter protocol in typescript with no native dependencies (and very limited dependencies).

This is a convenient single-dependency for applications build on matter.js and have automatic registrations for Node.js and react-native as platforms.

This package supports all Node.js LTS versions starting with 18.x (when Node.js is used).

The following features are abstracted away to allow to be implemented environment specific:

• Network (UDP/MDNS)
• Crypto
• Storage
• Date/Timer
• Logger (Default uses "console")
• Environment (Process and Configuration handling)

Exported functionality

[!IMPORTANT] All exports here are for the current API. Legacy Cluster implementations are only exported via @project-chip/matter.js!

This library exports the Matter protocol functionality as well as some helper functions as named exports:

Export	Description
@matter/main	Re-Exports all functionality from @matter/general, @matter/node, Environment class, Matter model class and the datatypes from @matter/types
@matter/main/behaviors	Exports Behavior classes as framework to implement all relevant Logic for clusters and internal logic. Contains auto-generated class structures and also Cluster default implementations.
@matter/main/behaviors/*	Exports Behavior classes as framework to implement all relevant Logic for clusters and internal logic. Contains auto-generated class structures and also Cluster default implementations as cluster-name export
@matter/main/clusters	Exports all Matter Cluster definitions
@matter/main/clusters/*	Exports Matter Cluster definitions as cluster-name export
@matter/main/devices	Exports Matter Device type classes
@matter/main/devices/*	Exports Matter Device type classes as cluster-name export
@matter/main/endpoints	Exports Matter Endpoint structure classes
@matter/main/endpoints/*	Exports Matter Endpoint structure classes as cluster-name export
@matter/main/model	Exports a JavaScript version of the Matter data model. Re-exports @matter/model package.
@matter/main/node	Exports the matter node specific classes. Re-exports @matter/node package.
@matter/main/protocol	Exports Basic Matter protocol functionality. Re-exports @matter/protocol package.
@matter/main/types	Exports all Types (includes Clusters and Matter datatypes and matter.js own datatypes. Re-exports @matter/types package.

Both exports and the typings are exported as CommonJS and ES6 modules.

For more details please refer to the API Documentation.

Typescript note

To have Typescript and your IDE know all the relevant exported functionality you need to use the following in your tsconfig.json:

{
    compilerOptions: {
        "target": "es2022", // Matter.js most likely won't work with older versions of ES
        moduleResolution: "node16", // Required to support package.json exports
        module: "node16", // Required to make sure all imports are js
    },
}

Additionally, we recommend using "strictNullChecks": true or better for code quality "strict": true to make sure that all types are correctly determined.

Building

• npm run build: Build all code and create CommonJS and ES6 variants in dist directory. This will built incrementally and only build the changed files.
• npm run build-clean: Clean the dist directory and build all code from scratch

Tests

• npm run test-node: Run tests in node.js
• npm run test-web: Run tests in the browser
• npm run test: Run all tests

test-web will create a /coverage directory containing the test code coverage

Changelog

0.15.6 (2025-10-16)

• @matter/general

  • Fix: Ensures services are not removed from parents when they are removed locally

• @matter/node

  • Fix: Ensures OccurrenceManager is closed on node shutdown

• @matter/protocol

  • Enhancement: Removes exchanges earlier when closing to prevent double session closures
  • Enhancement: Ignores invoke responses that should be suppressed but delivered
  • Fix: Fixes Fabric scoped event reads to ensure the filtering is applied correctly

• @project-chip/matter.js

  • Fix: Initializes controller into an own environment instead using the provided environment
  • Fix: Ensure that the PairedNode meta-data are updated and stored when changed