iotagent-node-lib 2.15.1 → 2.19.0

package/doc/getting-started.md

@@ -25,7 +25,6 @@ config = {
     service: "openiot",
     subservice: "/",
     providerUrl: "http://iot-agent:4041",
-    deviceRegistrationDuration: "P1M",
     defaultType: "Thing",
 };
 ```

package/doc/howto.md

@@ -315,8 +315,8 @@ var iotAgentLib = require("iotagent-node-lib"),
 #### QueryContext implementation
 
 The main step to complete in order to implement the Lazy attributes mechanism in the IoT Agent is to provide handlers
-for the context provisioning requests. At this point, we should provide two handlers: the `updateContext` and the
-`queryContext` handlers. To do so, we must first define the handlers themselves:
+for the context provisioning requests. At this point, we should provide two handlers: the `/v2/op/update` and the
+`/v2/op/query` handlers. To do so, we must first define the handlers themselves:
 
 ```javascript
 function queryContextHandler(id, type, service, subservice, attributes, callback) {
@@ -338,7 +338,7 @@ function queryContextHandler(id, type, service, subservice, attributes, callback
 }
 ```
 
-The `queryContext` handler is called whenever a `queryContext` request arrives at the North port of the IoT Agent. It is
+The queryContext handler is called whenever a `/v2/op/query` request arrives at the North port of the IoT Agent. It is
 invoked once for each entity requested, passing the entity ID and Type as the parameters, as well as a list of the
 attributes that are requested. In our case, the handler uses this parameters to compose a request to the device. Once
 the results of the device are returned, the values are returned to the caller, in the NGSI attribute format.
@@ -395,7 +395,7 @@ function updateContextHandler(id, type, service, subservice, attributes, callbac
 }
 ```
 
-The updateContext handler deals with the modification requests that arrive at the North Port of the IoT Agent. It is
+The updateContext handler deals with the modification requests that arrive at the North Port of the IoT Agent via `/v2/op/update`. It is
 invoked once for each entity requested (note that a single request can contain multiple entity updates), with the same
 parameters used in the queryContext handler. The only difference is the value of the attributes array, now containing a
 list of attribute objects, each containing name, type and value. The handler must also make use of the callback to
@@ -491,35 +491,31 @@ Postman-Token: 993ac66b-72da-9e96-ab46-779677a5896a
 }
 ```
 
-2. Execute a queryContext or updateContext against one of the entity attributes (use a NGSI client of curl command).
+2. Execute a `/v2/op/query` or `/v2/op/update` against one of the entity attributes (use a NGSI client of curl command).
 
 ```text
-POST /v1/queryContext HTTP/1.1
+POST /v2/op/query HTTP/1.1
 Host: localhost:1026
 Content-Type: application/json
 Accept: application/json
 Fiware-Service: howtoserv
 Fiware-ServicePath: /test
 Cache-Control: no-cache
-Postman-Token: 1dc568a1-5588-059c-fa9b-ff217a7d7aa2
 
 {
-    "entities": [
-        {
-            "isPattern": "true",
-            "id": ".*",
-            "type": "BasicULSensor"
-        }
-    ],
-    "attributes" : [
-    	"l"]
+  entities: [
+    {
+      id: 'Light:light1'
+    }
+  ],
+  attrs: ['dimming']
 }
 ```
 
 3. Check the received request in the nc console is the expected one.
 
 4. (In case you use netcat). Answer the request with an appropriate HTTP response and check the result of the
-   `queryContext` or `updateContext` request is the expected one. An example of HTTP response, for a query to the `t`
+   `/v2/op/query` or `/v2/op/update` request is the expected one. An example of HTTP response, for a query to the `t`
    and `l` attributes would be:
 
 ```text

package/doc/installationguide.md

@@ -56,9 +56,10 @@ allowing the computer to interpret the rest of the data with more clarity and de
 }
 ```
 
-Under mixed mode, **NGSI v2** payloads are used for context broker communications by default, but this payload may also be switched
-to **NGSI LD** at service group or device provisioning time using the `ngsiVersion` field in the provisioning API.
-The `ngsiVersion` field switch may be added at either group or device level, with the device level overriding the group setting.
+Under mixed mode, **NGSI v2** payloads are used for context broker communications by default, but this payload may also
+be switched to **NGSI LD** at service group or device provisioning time using the `ngsiVersion` field in the
+provisioning API. The `ngsiVersion` field switch may be added at either group or device level, with the device level
+overriding the group setting.
 
 -   **server**: configuration used to create the Context Server (port where the IoT Agent will be listening as a Context
     Provider and base root to prefix all the paths). The `port` attribute is required. If no `baseRoot` attribute is
@@ -159,7 +160,7 @@ used for the same purpose. For instance:
 
 ```javascript
 {
-    type: "mongodb";
+    type: 'mongodb';
 }
 ```
 
@@ -230,10 +231,6 @@ used for the same purpose. For instance:
 -   **providerUrl**: URL to send in the Context Provider registration requests. Should represent the external IP of the
     deployed IoT Agent (the IP where the Context Broker will redirect the NGSI requests). E.g.:
     'http://192.168.56.1:4041'.
--   **deviceRegistrationDuration**: duration of the registrations as Context Providers and the subscriptions done by
-    bidirectional plugin, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) standard format. E.g.: 'P1M'. Only used
-    if agent is configured in NGSI v1 mode. In NGSI v2 mode the setting is ignored (registrations and subscriptions are
-    non-expirable and the IOTA manages its removal explicitely).
 -   **iotaVersion**: indicates the version of the IoTA that will be displayed in the about method (it should be filled
     automatically by each IoTA).
 -   **appendMode**: if this flag is activated, the update requests to the Context Broker will be performed always with
@@ -245,8 +242,8 @@ used for the same purpose. For instance:
 -   **singleConfigurationMode**: enables the Single Configuration mode for backwards compatibility (see description in
     the Overview). Default to false.
 -   **timestamp**: if this flag is activated:
-    -   For NGSIv1/NGSIv2, the IoT Agent will add a `TimeInstant` metadata attribute to all the attributes updated from
-        device information. This flag is overwritten by `timestamp` flag in group or device
+    -   For NGSI-v2, the IoT Agent will add a `TimeInstant` metadata attribute to all the attributes updated from device
+        information. This flag is overwritten by `timestamp` flag in group or device
     -   With NGSI-LD, the standard `observedAt` property-of-a-property is created instead.
 -   **defaultResource**: default string to use as resource for the registration of new Configurations (if no resource is
     provided).
@@ -277,10 +274,11 @@ used for the same purpose. For instance:
     NGSILD-Path has not yet been included in the NGSI-LD standard (it has been proposed for the next update of the
     standard, but the final decision has yet been confirmed), take into account it could change
 -   **explicitAttrs**: if this flag is activated, only provisioned attributes will be processed to Context Broker. This
-    flag is overwritten by `explicitAttrs` flag in group or device provision.
--   **defaultEntityNameConjunction**: the default conjunction string used to compose a default `entity_name` when is not 
-    provided at device provisioning time; in that case `entity_name` is composed by `type` + `:` + `device_id`. 
-    Default value is `:`. This value is overwritten by `defaultEntityNameConjunction` in group provision.
+    flag is overwritten by `explicitAttrs` flag in group or device provision. Additionally `explicitAttrs` can be used
+    to define which meassures defined in JSON/JEXL array will be propagated to NGSI interface.
+-   **defaultEntityNameConjunction**: the default conjunction string used to compose a default `entity_name` when is not
+    provided at device provisioning time; in that case `entity_name` is composed by `type` + `:` + `device_id`. Default
+    value is `:`. This value is overwritten by `defaultEntityNameConjunction` in group provision.
 -   **relaxTemplateValidation**: if this flag is activated, `objectId` attributes for incoming devices are not
     validated, and may exceptionally include characters (such as semi-colons) which are
     [forbidden](https://fiware-orion.readthedocs.io/en/master/user/forbidden_characters/index.html) according to the
@@ -295,61 +293,61 @@ with container-based technologies, like Docker, Heroku, etc...
 The following table shows the accepted environment variables, as well as the configuration parameter the variable
 overrides.
 
-| Environment variable             | Configuration attribute         |
-| :------------------------------- | :------------------------------ |
-| IOTA_CB_URL                      | `contextBroker.url`             |
-| IOTA_CB_HOST                     | `contextBroker.host`            |
-| IOTA_CB_PORT                     | `contextBroker.port`            |
-| IOTA_CB_NGSI_VERSION             | `contextBroker.ngsiVersion`     |
-| IOTA_NORTH_HOST                  | `server.host`                   |
-| IOTA_NORTH_PORT                  | `server.port`                   |
-| IOTA_PROVIDER_URL                | `providerUrl`                   |
-| IOTA_AUTH_ENABLED                | `authentication.enabled`        |
-| IOTA_AUTH_TYPE                   | `authentication.type`           |
-| IOTA_AUTH_HEADER                 | `authentication.header`         |
-| IOTA_AUTH_URL                    | `authentication.url`            |
-| IOTA_AUTH_HOST                   | `authentication.host`           |
-| IOTA_AUTH_PORT                   | `authentication.port`           |
-| IOTA_AUTH_USER                   | `authentication.user`           |
-| IOTA_AUTH_PASSWORD               | `authentication.password`       |
-| IOTA_AUTH_CLIENT_ID              | `authentication.clientId`       |
-| IOTA_AUTH_CLIENT_SECRET          | `authentication.clientSecret`   |
-| IOTA_AUTH_TOKEN_PATH             | `authentication.tokenPath`      |
-| IOTA_AUTH_PERMANENT_TOKEN        | `authentication.permanentToken` |
-| IOTA_REGISTRY_TYPE               | `deviceRegistry.type`           |
-| IOTA_LOG_LEVEL                   | `logLevel`                      |
-| IOTA_TIMESTAMP                   | `timestamp`                     |
-| IOTA_IOTAM_URL                   | `iotManager.url`                |
-| IOTA_IOTAM_HOST                  | `iotManager.host`               |
-| IOTA_IOTAM_PORT                  | `iotManager.port`               |
-| IOTA_IOTAM_PATH                  | `iotManager.path`               |
-| IOTA_IOTAM_AGENTPATH             | `iotManager.agentPath`          |
-| IOTA_IOTAM_PROTOCOL              | `iotManager.protocol`           |
-| IOTA_IOTAM_DESCRIPTION           | `iotManager.description`        |
-| IOTA_MONGO_HOST                  | `mongodb.host`                  |
-| IOTA_MONGO_PORT                  | `mongodb.port`                  |
-| IOTA_MONGO_DB                    | `mongodb.db`                    |
-| IOTA_MONGO_REPLICASET            | `mongodb.replicaSet`            |
-| IOTA_MONGO_USER                  | `mongodb.user`                  |
-| IOTA_MONGO_PASSWORD              | `mongodb.password`              |
-| IOTA_MONGO_AUTH_SOURCE           | `mongodb.authSource`            |
-| IOTA_MONGO_RETRIES               | `mongodb.retries`               |
-| IOTA_MONGO_RETRY_TIME            | `mongodb.retryTime`             |
-| IOTA_MONGO_SSL                   | `mongodb.ssl`                   |
-| IOTA_MONGO_EXTRAARGS             | `mongodb.extraArgs`             |
-| IOTA_SINGLE_MODE                 | `singleConfigurationMode`       |
-| IOTA_APPEND_MODE                 | `appendMode`                    |
-| IOTA_POLLING_EXPIRATION          | `pollingExpiration`             |
-| IOTA_POLLING_DAEMON_FREQ         | `pollingDaemonFrequency`        |
-| IOTA_AUTOCAST                    | `autocast`                      |
-| IOTA_MULTI_CORE                  | `multiCore`                     |
-| IOTA_JSON_LD_CONTEXT             | `jsonLdContext`                 |
-| IOTA_FALLBACK_TENANT             | `fallbackTenant`                |
-| IOTA_FALLBACK_PATH               | `fallbackPath`                  |
-| IOTA_DEFAULT_EXPRESSION_LANGUAGE | `defaultExpressionLanguage`     |
-| IOTA_EXPLICIT_ATTRS              | `explicitAttrs`                 |
-| IOTA_DEFAULT_ENTITY_NAME_CONJUNCTION | `defaultEntityNameConjunction` |
-| IOTA_RELAX_TEMPLATE_VALIDATION   | `relaxTemplateValidation`       |
+| Environment variable                 | Configuration attribute         |
+| :----------------------------------- | :------------------------------ |
+| IOTA_CB_URL                          | `contextBroker.url`             |
+| IOTA_CB_HOST                         | `contextBroker.host`            |
+| IOTA_CB_PORT                         | `contextBroker.port`            |
+| IOTA_CB_NGSI_VERSION                 | `contextBroker.ngsiVersion`     |
+| IOTA_NORTH_HOST                      | `server.host`                   |
+| IOTA_NORTH_PORT                      | `server.port`                   |
+| IOTA_PROVIDER_URL                    | `providerUrl`                   |
+| IOTA_AUTH_ENABLED                    | `authentication.enabled`        |
+| IOTA_AUTH_TYPE                       | `authentication.type`           |
+| IOTA_AUTH_HEADER                     | `authentication.header`         |
+| IOTA_AUTH_URL                        | `authentication.url`            |
+| IOTA_AUTH_HOST                       | `authentication.host`           |
+| IOTA_AUTH_PORT                       | `authentication.port`           |
+| IOTA_AUTH_USER                       | `authentication.user`           |
+| IOTA_AUTH_PASSWORD                   | `authentication.password`       |
+| IOTA_AUTH_CLIENT_ID                  | `authentication.clientId`       |
+| IOTA_AUTH_CLIENT_SECRET              | `authentication.clientSecret`   |
+| IOTA_AUTH_TOKEN_PATH                 | `authentication.tokenPath`      |
+| IOTA_AUTH_PERMANENT_TOKEN            | `authentication.permanentToken` |
+| IOTA_REGISTRY_TYPE                   | `deviceRegistry.type`           |
+| IOTA_LOG_LEVEL                       | `logLevel`                      |
+| IOTA_TIMESTAMP                       | `timestamp`                     |
+| IOTA_IOTAM_URL                       | `iotManager.url`                |
+| IOTA_IOTAM_HOST                      | `iotManager.host`               |
+| IOTA_IOTAM_PORT                      | `iotManager.port`               |
+| IOTA_IOTAM_PATH                      | `iotManager.path`               |
+| IOTA_IOTAM_AGENTPATH                 | `iotManager.agentPath`          |
+| IOTA_IOTAM_PROTOCOL                  | `iotManager.protocol`           |
+| IOTA_IOTAM_DESCRIPTION               | `iotManager.description`        |
+| IOTA_MONGO_HOST                      | `mongodb.host`                  |
+| IOTA_MONGO_PORT                      | `mongodb.port`                  |
+| IOTA_MONGO_DB                        | `mongodb.db`                    |
+| IOTA_MONGO_REPLICASET                | `mongodb.replicaSet`            |
+| IOTA_MONGO_USER                      | `mongodb.user`                  |
+| IOTA_MONGO_PASSWORD                  | `mongodb.password`              |
+| IOTA_MONGO_AUTH_SOURCE               | `mongodb.authSource`            |
+| IOTA_MONGO_RETRIES                   | `mongodb.retries`               |
+| IOTA_MONGO_RETRY_TIME                | `mongodb.retryTime`             |
+| IOTA_MONGO_SSL                       | `mongodb.ssl`                   |
+| IOTA_MONGO_EXTRAARGS                 | `mongodb.extraArgs`             |
+| IOTA_SINGLE_MODE                     | `singleConfigurationMode`       |
+| IOTA_APPEND_MODE                     | `appendMode`                    |
+| IOTA_POLLING_EXPIRATION              | `pollingExpiration`             |
+| IOTA_POLLING_DAEMON_FREQ             | `pollingDaemonFrequency`        |
+| IOTA_AUTOCAST                        | `autocast`                      |
+| IOTA_MULTI_CORE                      | `multiCore`                     |
+| IOTA_JSON_LD_CONTEXT                 | `jsonLdContext`                 |
+| IOTA_FALLBACK_TENANT                 | `fallbackTenant`                |
+| IOTA_FALLBACK_PATH                   | `fallbackPath`                  |
+| IOTA_DEFAULT_EXPRESSION_LANGUAGE     | `defaultExpressionLanguage`     |
+| IOTA_EXPLICIT_ATTRS                  | `explicitAttrs`                 |
+| IOTA_DEFAULT_ENTITY_NAME_CONJUNCTION | `defaultEntityNameConjunction`  |
+| IOTA_RELAX_TEMPLATE_VALIDATION       | `relaxTemplateValidation`       |
 
 Note:
 

package/doc/usermanual.md

@@ -25,7 +25,7 @@ More values will be added in the future to the library. The applications using t
 Registry just by using the following function:
 
 ```javascript
-iotagentLib.statsRegistry.add("statName", statIncrementalValue, callback);
+iotagentLib.statsRegistry.add('statName', statIncrementalValue, callback);
 ```
 
 The first time this function is invoked, it will add the new stat to the registry. Subsequent calls will add the value
@@ -80,7 +80,7 @@ In order to use the library, add the following dependency to your package.json f
 In order to use this library, first you must require it:
 
 ```javascript
-var iotagentLib = require("iotagent-node-lib");
+var iotagentLib = require('iotagent-node-lib');
 ```
 
 The library supports four groups of features, one for each direction of the communication: client-to-server and
@@ -265,16 +265,16 @@ Once all the updates have taken place, the callback must be invoked with the upd
 
 ```javascript
 callback(null, {
-    type: "TheType",
+    type: 'TheType',
     isPattern: false,
-    id: "EntityID",
+    id: 'EntityID',
     attributes: [
         {
-            name: "lumniscence",
-            type: "Lumens",
-            value: "432",
-        },
-    ],
+            name: 'lumniscence',
+            type: 'Lumens',
+            value: '432'
+        }
+    ]
 });
 ```
 
@@ -303,16 +303,16 @@ The callback must be invoked with the updated Context Element, using the informa
 
 ```javascript
 callback(null, {
-    type: "TheType",
+    type: 'TheType',
     isPattern: false,
-    id: "EntityID",
+    id: 'EntityID',
     attributes: [
         {
-            name: "lumniscence",
-            type: "Lumens",
-            value: "432",
-        },
-    ],
+            name: 'lumniscence',
+            type: 'Lumens',
+            value: '432'
+        }
+    ]
 });
 ```
 
@@ -686,6 +686,38 @@ unexpectedly dead, a new process is created automatically to keep always the max
 -   iotAgent: The IoT Agent Objects, used to start the agent.
 -   callback: The callback function.
 
+##### iotagentLib.request()
+
+###### Signature
+
+```javascript
+function request(options, callback)
+```
+
+###### Description
+
+Make a direct HTTP request using the underlying request library (currently [got](https://github.com/sindresorhus/got)),
+this is useful when creating agents which use an HTTP transport for their southbound commands, and removes the need for
+the custom IoT Agent to import its own additional request library
+
+###### Params
+
+-   options: definition of the request (see
+    [got options](https://github.com/sindresorhus/got/blob/main/documentation/2-options.md) for more details). The
+    following attributes are currently exposed.
+    -   `method` - HTTP Method
+    -   `searchParams` - query string params
+    -   `qs` - alias for query string params
+    -   `headers`
+    -   `responseType` - either `text` or `json`. `json` is the default
+    -   `json` - a supplied JSON object as the request body
+    -   `body` - any ASCII text as the request body. It takes precedence over `json` if both are provided at the same
+        time (not recommended).
+    -   `url` - the request URL
+    -   `uri` - alternative alias for the request URL.
+-   callback: The callback currently returns an `error` Object, the `response` and `body`. The `body` is parsed to a
+    JSON object if the `responseType` is JSON.
+
 #### Generic middlewares
 
 This collection of utility middlewares is aimed to be used to north of the IoT Agent Library, as well as in other

package/docker/Mosquitto/Dockerfile

@@ -3,24 +3,19 @@ FROM centos:7.9.2009
 COPY aclfile /root/
 COPY startMosquitto.sh /bin
 
+ENV CONGIF_FROM_ENV true
+
 RUN yum update -y && yum install -y wget \
   && yum install -y epel-release \
   && yum update -y epel-release \
   && yum install -y mosquitto \
+  && cp /etc/mosquitto/mosquitto.conf /etc/mosquitto/mosquitto.conf.orig \
   && chmod 755 /bin/startMosquitto.sh \
   && mkdir /var/log/mosquitto \
   && chown mosquitto:mosquitto /var/log/mosquitto \
-  && touch /etc/mosquitto/pwfile \
-  && sed -i '$ i acl_file /etc/mosquitto/aclfile\npassword_file /etc/mosquitto/pwfile' /etc/mosquitto/mosquitto.conf \
-  && echo "log_timestamp true" >> /etc/mosquitto/mosquitto.conf \
-  && echo "log_timestamp_format %Y-%m-%dT%H:%M:%S" >> /etc/mosquitto/mosquitto.conf \
-  && echo 'listener 9001' >> /etc/mosquitto/mosquitto.conf \
-  && echo 'protocol websockets' >> /etc/mosquitto/mosquitto.conf \
-  && echo 'listener 1883' >> /etc/mosquitto/mosquitto.conf \
-  && echo 'protocol mqtt' >> /etc/mosquitto/mosquitto.conf \
-  && mv /root/aclfile /etc/mosquitto/aclfile \
   && yum clean all
 
+
 EXPOSE 1883
 EXPOSE 9001
 

package/docker/Mosquitto/README.md

@@ -2,6 +2,8 @@ Thi directory containts the Dockerfile (and associated files) for a container of
 This container is provide as a help for users to test with MQTT, but it is just an auxiliary material in this repository.
 
 The following releases matches with eclipse-mosquitto version:
+- 1.6.0 uses mosquitto-1.6.10-1.el7.x86_64
+- 1.5.0 uses mosquitto-1.6.10-1.el7.x86_64
 - 1.4.0 uses mosquitto-1.6.10-1.el7.x86_64
 - 1.3.0 uses mosquitto-1.6.8-1.el7.x86_64
 - 1.2.0 uses mosquitto-1.6.7-1.el7.x86_64

package/docker/Mosquitto/startMosquitto.sh

@@ -1,4 +1,21 @@
 #!/usr/bin/env bash
 
-mosquitto_passwd -b /etc/mosquitto/pwfile iota ${IOTA_PASS}
+if [ "${CONGIF_FROM_ENV}" = true ] ; then
+    cp /etc/mosquitto/mosquitto.conf.orig /etc/mosquitto/mosquitto.conf
+    echo "log_timestamp true" >> /etc/mosquitto/mosquitto.conf
+    echo "log_timestamp_format %Y-%m-%dT%H:%M:%S" >> /etc/mosquitto/mosquitto.conf
+    echo 'listener 9001' >> /etc/mosquitto/mosquitto.conf
+    echo 'protocol websockets' >> /etc/mosquitto/mosquitto.conf
+    echo 'listener 1883' >> /etc/mosquitto/mosquitto.conf
+    echo 'protocol mqtt' >> /etc/mosquitto/mosquitto.conf
+    if ! [ -z "${IOTA_PASS}" ] ; then
+      # Only if IOTA_PASS is set and not empty MQTT user/pass authentication is used
+      touch /etc/mosquitto/pwfile
+      sed -i '$ i acl_file /etc/mosquitto/aclfile\npassword_file /etc/mosquitto/pwfile' /etc/mosquitto/mosquitto.conf
+      cp -f /root/aclfile /etc/mosquitto/aclfile
+      sed -i 's/user iota/user '${IOTA_USER}'/g' /etc/mosquitto/aclfile
+      mosquitto_passwd -b /etc/mosquitto/pwfile ${IOTA_USER} ${IOTA_PASS}
+    fi
+fi
+
 /usr/sbin/mosquitto -c /etc/mosquitto/mosquitto.conf

package/lib/command/commandLine.js

@@ -25,7 +25,7 @@ const fs = require('fs');
 const clUtils = require('command-shell-lib');
 const migrationLib = require('./migration');
 const constants = require('../constants');
-const request = require('request');
+const request = require('../request-shim');
 const async = require('async');
 const mu = require('mu2');
 let config;

package/lib/commonConfig.js

@@ -243,6 +243,10 @@ function processEnvironmentVariables() {
         config.contextBroker.jsonLdContext = process.env.IOTA_JSON_LD_CONTEXT.split(',').map((ctx) => ctx.trim());
     }
 
+   if (Array.isArray(config.contextBroker.jsonLdContext) && config.contextBroker.jsonLdContext.length === 1){
+        config.contextBroker.jsonLdContext = config.contextBroker.jsonLdContext[0];
+   }
+
     config.contextBroker.fallbackTenant =
         process.env.IOTA_FALLBACK_TENANT || config.contextBroker.service || 'iotagent';
     config.contextBroker.fallbackPath = process.env.IOTA_FALLBACK_PATH || config.contextBroker.subservice || '/';
@@ -521,19 +525,7 @@ function ngsiVersion() {
     return 'unknown';
 }
 
-/**
- * It checks if the configuration file states a non-legacy format,
- * either v2, LD or mixed.
- *
- * @return     {boolean}  Result of the checking
- */
-function isCurrentNgsi() {
-    if (config.contextBroker && config.contextBroker.ngsiVersion) {
-        const version = config.contextBroker.ngsiVersion.toLowerCase();
-        return version === 'v2' || version === 'ld' || version === 'mixed';
-    }
-    return false;
-}
+
 /**
  * It checks if a combination of typeInformation or common Config is LD
  *
@@ -562,7 +554,6 @@ exports.setCommandRegistry = setCommandRegistry;
 exports.getCommandRegistry = getCommandRegistry;
 exports.ngsiVersion = ngsiVersion;
 exports.checkNgsiLD = checkNgsiLD;
-exports.isCurrentNgsi = isCurrentNgsi;
 exports.setSecurityService = setSecurityService;
 exports.getSecurityService = getSecurityService;
 exports.getSecretData = getSecretData;

package/lib/errors.js

@@ -96,13 +96,6 @@ class DeviceNotFound {
         this.code = 404;
     }
 }
-class AttributeNotFound {
-    constructor() {
-        this.name = 'ATTRIBUTE_NOT_FOUND';
-        this.message = 'Some of the attributes does not exist';
-        this.code = 404;
-    }
-}
 class DuplicateDeviceId {
     constructor(id) {
         this.name = 'DUPLICATE_DEVICE_ID';
@@ -190,13 +183,6 @@ class MissingConfigParams {
         this.code = 400;
     }
 }
-class NotificationError {
-    constructor(code) {
-        this.name = 'NOTIFICATION_ERROR';
-        this.message = 'Incoming notification with non-200 status code: ' + code;
-        this.code = 400;
-    }
-}
 class DeviceGroupNotFound {
     constructor(fields, values) {
         this.name = 'DEVICE_GROUP_NOT_FOUND';
@@ -269,7 +255,6 @@ module.exports = {
     TypeNotFound,
     MissingAttributes,
     DeviceNotFound,
-    AttributeNotFound,
     DuplicateDeviceId,
     DuplicateGroup,
     SecurityInformationMissing,
@@ -282,7 +267,6 @@ module.exports = {
     WrongSyntax,
     CommandNotFound,
     MissingConfigParams,
-    NotificationError,
     DeviceGroupNotFound,
     GroupNotFound,
     WrongExpressionType,

package/lib/fiware-iotagent-lib.js

@@ -37,6 +37,7 @@ const iotManager = require('./services/common/iotManagerService');
 const contextServer = require('./services/northBound/northboundServer');
 const errors = require('./errors');
 const constants = require('./constants');
+const request = require('./request-shim');
 const logger = require('logops');
 const config = require('./commonConfig');
 const cluster = require('cluster');
@@ -317,6 +318,7 @@ exports.getDevicesByAttribute = deviceService.getDevicesByAttribute;
 exports.mergeDeviceWithConfiguration = deviceService.mergeDeviceWithConfiguration;
 exports.retrieveDevice = deviceService.retrieveDevice;
 exports.getConfiguration = groupConfig.get;
+exports.getConfigurationSilently = groupConfig.getSilently;
 exports.findConfiguration = groupConfig.find;
 exports.setDataUpdateHandler = contextServer.setUpdateHandler;
 exports.setCommandHandler = contextServer.setCommandHandler;
@@ -324,6 +326,7 @@ exports.setDataQueryHandler = contextServer.setQueryHandler;
 exports.setConfigurationHandler = contextServer.setConfigurationHandler;
 exports.setRemoveConfigurationHandler = contextServer.setRemoveConfigurationHandler;
 exports.setProvisioningHandler = contextServer.setProvisioningHandler;
+exports.setUpdatingHandler = contextServer.setUpdatingHandler;
 exports.setRemoveDeviceHandler = contextServer.setRemoveDeviceHandler;
 exports.setNotificationHandler = contextServer.setNotificationHandler;
 exports.addUpdateMiddleware = ngsi.addUpdateMiddleware;
@@ -348,6 +351,7 @@ exports.ensureSouthboundDomain = domainUtils.ensureSouthboundDomain;
 exports.finishSouthBoundTransaction = domainUtils.finishSouthBoundTransaction;
 exports.requestDomain = domainUtils.requestDomain;
 exports.regenerateTransid = domainUtils.regenerateTransid;
+exports.fillService = domainUtils.fillService;
 
 exports.middlewares = middlewares;
 
@@ -370,3 +374,4 @@ exports.constants = constants;
 exports.logModule = logger;
 exports.configModule = config;
 exports.startServer = startServer;
+exports.request = request;

package/lib/jexlTranformsMap.js

@@ -0,0 +1,71 @@
+/*
+ * Copyright 2014 Telefonica Investigación y Desarrollo, S.A.U
+ *
+ * This file is part of fiware-iotagent-lib
+ *
+ * fiware-iotagent-lib is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the License,
+ * or (at your option) any later version.
+ *
+ * fiware-iotagent-lib is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public
+ * License along with fiware-iotagent-lib.
+ * If not, see http://www.gnu.org/licenses/.
+ *
+ * For those usages not covered by the GNU Affero General Public License
+ * please contact with::daniel.moranjimenez@telefonica.com
+ *
+ */
+
+/*This file is intended to contain the whole transformartion map defining  
+JEXL avaliable transformations*/
+
+const map = {
+    jsonparse: (str) => JSON.parse(str),
+    jsonstringify: (obj) => JSON.stringify(obj),
+    indexOf: (val, char) => String(val).indexOf(char),
+    length: (val) => String(val).length,
+    trim: (val) => String(val).trim(),
+    substr: (val, int1, int2) => String(val).substr(int1, int2),
+    addreduce: (arr) => arr.reduce((i, v) => i + v),
+    lengtharray: (arr) => arr.length,
+    typeof: (val) => typeof val,
+    isarray: (arr) => Array.isArray(arr),
+    isnan: (val) => isNaN(val),
+    parseint: (val) => parseInt(val),
+    parsefloat: (val) => parseFloat(val),
+    toisodate: (val) => new Date(val).toISOString(),
+    timeoffset: (isostr) => new Date(isostr).getTimezoneOffset(),
+    tostring: (val) => val.toString(),
+    urlencode: (val) => encodeURI(val),
+    urldecode: (val) => decodeURI(val),
+    replacestr: (str, from, to) => str.replace(from, to),
+    replaceregexp: (str, reg, to) => str.replace(new RegExp(reg), to),
+    replaceallstr: (str, from, to) => str.replaceAll(from, to),
+    replaceallregexp: (str, reg, to) => str.replaceAll(new RegExp(reg, 'g'), to),
+    split: (str, ch) => str.split(ch),
+    mapper: (val, values, choices) => choices[values.findIndex((target) => target === val)],
+    thmapper: (val, values, choices) =>
+        choices[
+            values.reduce((acc, curr, i) => (acc === 0 || acc ? acc : val <= curr ? (acc = i) : (acc = null)), null)
+        ],
+    bitwisemask: (i, mask, op, shf) =>
+        (op === '&' ? parseInt(i) & mask : op === '|' ? parseInt(i) | mask : op === '^' ? parseInt(i) ^ mask : i) >>
+        shf,
+    slice: (arr, init, end) => arr.slice(init, end),
+    addset: (arr, x) => {
+        return Array.from(new Set(arr).add(x));
+    },
+    removeset: (arr, x) => {
+        let s = new Set(arr);
+        s.delete(x);
+        return Array.from(s);
+    }
+};
+
+exports.map = map;

package/lib/model/Command.js

@@ -29,7 +29,7 @@ const Command = new Schema({
     type: String,
     name: String,
     value: Object,
-    service: String,
+    service: { type: String, lowercase: true },
     subservice: String,
     creationDate: { type: Date, default: Date.now }
 });