@matter/main
TypeScript icon, indicating that this package has built-in type declarations

0.12.3 • Public • Published

@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

Package Sidebar

Install

npm i @matter/main

Weekly Downloads

5,092

Version

0.12.3

License

Apache-2.0

Unpacked Size

926 kB

Total Files

2760

Last publish

Collaborators

  • apollon77
  • sammachin