A MHub client working by the FIRST LEGO League TMS Module Standard.
This module was meant to serve as an extendable messenger which already works by the Module Standard and allows you to easily listen to and send messages. It gives you all the functionality needed for a Mhub messenger running in node or in browser.
The messenger givven in node is fully correlated and logged using ms-logger. It also has a client-id which recognizes it against other clients, and is sent in the headers for recognition.
In broswer many of these feature are not required or needed. So the client only has a client-id, and isn't correlated or logged.
All messengers have the ability to be authenticated using MHub credentials.
All messengers have the ignoreNextMessageOfTopic method, which tells them to ignore the next message of a givven topic.
All messengers have a failsafe mechanism that makes sure they restart when they get disconnected.
const { createMessenger } = require('@first-lego-league/ms-messenger')
// Create a new object
const messenger = createMessenger({/* options... */})
messenger.listen('some:topic', (messageData, message) => {
// do something
})
messenger.send('some:topic', { data: {/* data... */} })| option | meaning | options | default |
|--|--|--|
| mhubURI | The URI of the MHub server | Any valid WebSockets URI | process.env.MHUB_URI |
| node | The node to which the messenger is connected | String | 'default' |
| clientId | An ID for the client | String | Random base64 string |
| reconnectTimeout | Time between connection attempts | Any number | 10 seconds |
| credentials | An object of the pattern { username, password } to be used to login to the node. If none is specified, no login will be performed | Object with fields username and password | undefined |
To contribute to this repository, simply create a PR and set one of the Code Owners to be a reviewer. Please notice the linting and UT, because they block merge. Keep the package lightweight and easy to use. Thank you for contributing!