@project-chip/matter-node.js / Modules
Matter protocol for node.js with no native dependencies (and very limited dependencies).
This package requires Node 16+ for the required Crypto primitives
This package is meant to be used as library as basis for Node.js based implementation of Matter Device and controller functionality
A basic CLI reference implementation of a Matter Device and Controller (might be split in own package soon) is available in the matter-node.js-examples package.
For questions on how to use or pair Matter devices or controllers please refer to the base package Readme! Especially for Google special steps are needed and mostly Hub devices are needed.
This library enhances Matter.js and implements the needed native functionality using Node.js 16+ as platform. The library exports the added Node.js specific implementations as named exports. Ideally you only need to import the main functionality as very first import of your application using
import "@project-chip/matter-node.js";
to automatically register all needed Node.js specific features for the Environment and initialize the default environment.
Most other functions should be imported from the @project-chip/matter.js package (unless it's Node.js specific functionality).
For more details please refer to the API Documentation.
Export | Description |
---|---|
@project-chip/matter-node.js/crypto |
Exports Crypto base functionality and Node.js specific implementation |
@project-chip/matter-node.js/environment |
Exports Node.js specific environment implementation which includes Process management, CLI-, Env- and Configfile support and Tracing File support |
@project-chip/matter-node.js/net |
Exports network base functionality and Node.js specific implementation |
@project-chip/matter-node.js/storage |
Exports storage base functionality and Node.js specific implementation of a directory based storage |
@project-chip/matter-node.js/time |
Exports Time/Timer base functionality and Node.js specific implementation |
@project-chip/matter-node.js/util |
Exports Basic Utility functionality and enhance it by adding some Node.js specific functionality |
The re-exports are deprecated as of 0.8+ release of matter.js. Please change your code to use these imports from matter.js directly and make sure to sync the versions of both packages (matter-node.js and matter.js) in your dependencies to not point to different versions!
Export | Description |
---|---|
@project-chip/matter-node.js |
Re-Exports the API to implement a Device or a Controller. |
@project-chip/matter-node.js/certificate |
Re-Exports Certificate (Root-/PAA/PAI/IAC/DA-Certificates) related functionality |
@project-chip/matter-node.js/cluster |
Re-Exports Matter CLuster definitions and Default Cluster-Handlers |
@project-chip/matter-node.js/codec |
Re-Exports Codecs for e.g. Matter-Messages |
@project-chip/matter-node.js/common |
Re-Exports certain common functionalities |
@project-chip/matter-node.js/datatype |
Re-Exports Matter Data types |
@project-chip/matter-node.js/fabric |
Re-Exports Matter-Fabric functionality |
@project-chip/matter-node.js/interaction |
Re-Exports Matter Interaction protocol functionality |
@project-chip/matter-node.js/log |
Re-Exports Logging functionality (based on "console") |
@project-chip/matter-node.js/math |
Re-Exports Math functionality used by Matter |
@project-chip/matter-node.js/mdns |
Re-Exports Basic MDNS functionality (uses Network implementation) |
@project-chip/matter-node.js/model |
Re-Exports a JavaScript version of the Matter data model |
@project-chip/matter-node.js/protocol |
Re-Exports Basic Matter protocol functionality |
@project-chip/matter-node.js/schema |
Re-Exports Schema definitions and functionality |
@project-chip/matter-node.js/securechannel |
Re-Exports Secure Channel functionality |
@project-chip/matter-node.js/session |
Re-Exports Session and Secure-Session functionality |
@project-chip/matter-node.js/spec |
Re-Exports Matter Specification References |
@project-chip/matter-node.js/tlv |
Re-Exports Matter TLV type definitions |
Both exports and the typings are exported as CommonJS only!. |
To have Typescript and your IDE know all the relevant exported functionality you need to use the following in your tsconfig.json:
{
"compilerOptions": {
"moduleResolution": "node16", // Required to support package.json exports
"module": "node16" // Required to make sure all imports are js
}
}
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
npm run test
: Run all code-side tests
To make sure that matter.js is compliant to the Matter specifications we implemented automated testing options by using the test suites included in chip-tool. These tests are not part of the standard test run describe above because they need prerequisites and also a lot of resources.
Please refer to the ../chip-testing folder for prerequisites and details.