1.0.0 • Published 2 years ago

@mangar2/valueservice v1.0.0

Weekly downloads
-
License
LGPL-3.0-or-later
Repository
github
Last release
2 years ago

Abstract

JSON schema to check configuration input

Default values

Checks the configuration and sets default values

Provides a service providing variables for values

JSON schema to check configuration input

Contents

Meta

Fileindex.js
AbstractProvides a service providing variables for values
AuthorVolker Böhm
CopyrightCopyright ( c ) 2022 Volker Böhm
LicenseThis software is licensed under the GNU LESSER GENERAL PUBLIC LICENSE Version 3 . It is furnished "as is" , without any support , and with no warranty , express or implied , as to its usefulness for any purpose .

Global functions

prepare

prepare (config, values) => {Values}

Prepares the values

prepare Parameters

NameTypeAttributeDefaultDescription
configObjectvalues configuration
valuesValuesoptionalnullexisting values class

prepare returns

TypeDescription
Valuesthe prepared values object

Class ValueService

new ValueService(configuration)

Creates a values class . Values holds variables with values This class is designed to work togehter with the runservices service

ValueService Parameters

NameType
configurationObject

configuration properties

NameTypeAttributeDefaultDescription
subscribeQoSnumberoptional1quality of service for message subscription

ValueService Methods

getSubscriptions

getSubscriptions () => {Array.<string>}

Get all the variable set commands to subscribe to

getSubscriptions returns
TypeDescription
Array.<string>array of subscriptions

handleMessage

handleMessage (mqttMessage) => {Array.<Message>}

Fully handles an mqtt message

handleMessage Parameters
NameTypeDescription
mqttMessageMessagethe received mqtt message
handleMessage returns
TypeDescription
Array.<Message>array of reply messages

on

on (event, callback)

Sets a callback .

on Parameters
NameTypeDescription
eventstringevent name ( not case sensitive ) for the callback
callbackfunctionfunction ( . . . parameter )
on throws
TypeDescription
Errorif the event is not supported
Errorif the callback is not 'function'

processMessage

processMessage (message) => {Array.<Message>}

Checks receives messages and sets variables for any "set" message

processMessage Parameters
NameTypeDescription
messageMessagereceived message
processMessage returns
TypeDescription
Array.<Message>list of messages as result

run

run ()

Called once after registration to handle additional tasks

setVariables

setVariables (rulesTree)

Sets/replaces the rules tree

setVariables Parameters
NameTypeDescription
rulesTreeObjecttree with 'rules' elements