npm - iotagent-node-lib - Versions diffs - 4.10.0 → 4.12.0 - Mend

iotagent-node-lib 4.10.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/CHANGES_NEXT_RELEASE +0 -1
package/Changelog +13 -0
package/doc/admin.md +10 -25
package/doc/api.md +62 -55
package/doc/deprecated.md +33 -14
package/doc/devel/northboundinteractions.md +35 -23
package/lib/commonConfig.js +13 -0
package/lib/jexlTranformsMap.js +15 -0
package/lib/model/dbConn.js +57 -58
package/lib/services/devices/registrationUtils.js +1 -1
package/lib/services/ngsi/ngsiService.js +15 -1
package/lib/services/northBound/contextServer-NGSI-v2.js +4 -2
package/package.json +1 -1
package/test/functional/testCases.js +73 -0
package/test/unit/expressions/jexlExpression-test.js +30 -0
package/test/unit/memoryRegistry/deviceRegistryMemory_test.js +1 -1
package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands.json +1 -1
package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands2.json +1 -1
package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands3.json +1 -1
package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands4.json +1 -1

package/CHANGES_NEXT_RELEASE CHANGED Viewed

	@@ -1 +0,0 @@
1	-

package/Changelog CHANGED Viewed

@@ -1,3 +1,16 @@
+4.12.0 (Jan 28th, 2026)
+- Fix: set default value for defaultTransport to allow set polling and transport for autoprovisioned devices when no IOTA_DEFAULT_TRANSPORT en var is used (#1751)
+- Fix: allow match auto-provisioned devices and groups when the same type is used by several groups (which always uses different apikeys) (#1713)
+4.11.0 (Oct 23th, 2025)
+- Add: IOTA_MONGO_URI env var
+- Add: locale string number jexl function (#1737)
+- Deprecated: IOTA_MONGO_ different from IOTA_MONGO_URI (use IOTA_MONGO_URI instead)
+- Fix: broken notification command mode (it was not working without providing targetEntityId and targetEntityType in the notification, which belongs to another command mode: advancedNotification)
+- Fix: use normalized in attrsFormat for commands subscriptions (#1743)
 4.10.0 (Oct 6th, 2025)
 - Add: command modes (new field cmdMode): legacy, notification and advancedNotification (#1732)

package/doc/admin.md CHANGED Viewed

@@ -248,15 +248,8 @@ the `mongob` section (as described bellow). E.g.:
 #### `mongodb`
-It configures the MongoDB driver for those repositories with 'mongodb' type. If the `host` parameter is a list of
-comma-separated IPs, they will be considered to be part of a Replica Set. In that case, the optional property
-`replicaSet` should contain the Replica Set name. If the database requires authentication, username (`user`), password
-(`password`) and authSource (`authSource`) can be set. If the database requires TLS/SSL connection but any validation of
-the certificate chain is not mandatory, all you need is to set the ssl (`ssl`) option as `true` to connect the database.
-If you need to add more complex option(s) such as `retryWrites=true` or `w=majority` when connection database, extraArgs
-(`extraArgs`) can be used to perform it. For The MongoBD driver will retry the connection at startup time `retries`
-times, waiting `retryTime` seconds between attempts, if those attributes are present (default values are 5 and 5
-respectively). E.g.:
+It configures the MongoDB driver for those repositories with 'mongodb' type, using the `uri` parameter (which format is
+available in [this reference](http://mongodb.github.io/node-mongodb-native/driver-articles/mongoclient.html)).
 ```javascript
 {
@@ -454,12 +447,14 @@ This flag is overwritten by `useCBflowControl` flag in group or device. This fla
 #### `cmdMode`
-Set command mode for the IoTAgent instance (it can be overriden by the `cmdMode` at group or device level). Possible values are:
+Set command mode for the IoTAgent instance (it can be overriden by the `cmdMode` at group or device level). Possible
+values are:
-* `legacy` (used as default if this setting is not defined): IoTAgent commands will use Context Broker registers
-mechanims.
-* `notification`:  IoTAgent commands will use subscriptions to be notified for Context Broker commands.
-* `advancedNotification`: IoTAgent commands will use subscriptions to be notified for Context Broker commands (but in a different way as in `notification` mode)
+-   `legacy` (used as default if this setting is not defined): IoTAgent commands will use Context Broker registers
+    mechanims.
+-   `notification`: IoTAgent commands will use subscriptions to be notified for Context Broker commands.
+-   `advancedNotification`: IoTAgent commands will use subscriptions to be notified for Context Broker commands (but in
+    a different way as in `notification` mode)
 Have a look to [this document](devel/northboundinteractions.md) for more detail on how this modes work.
@@ -505,17 +500,7 @@ overrides.
 | 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_MONGO_URI                       | `mongodb.uri`                   |
 | IOTA_POLLING_EXPIRATION              | `pollingExpiration`             |
 | IOTA_POLLING_DAEMON_FREQ             | `pollingDaemonFrequency`        |
 | IOTA_MULTI_CORE                      | `multiCore`                     |

package/doc/api.md CHANGED Viewed

@@ -279,12 +279,16 @@ IOTAgent, you can create it in advance using the Context Broker
 ## Entity creation when `cmdMode` is `notification`
-Even when an entity should not be created (see [above section](#device-autoprovision-and-entity-creation)), when the device uses `cmdMode` set to `notification` an entity is created. In particular:
+Even when an entity should not be created (see [above section](#device-autoprovision-and-entity-creation)), when the
+device uses `cmdMode` set to `notification` an entity is created. In particular:
-* An entity is created at device provision time
-* That entity is created with an attribute corresponding to each commands. The value of that attribute at creation time is `null` (specifying in some way that the command has not been triggered yet). Note that if the attribute doesn't have any command, the entity is not created (even if `cmdMode` is `notification`).
+-   An entity is created at device provision time
+-   That entity is created with an attribute corresponding to each commands. The value of that attribute at creation
+    time is `null` (specifying in some way that the command has not been triggered yet). Note that if the attribute
+    doesn't have any command, the entity is not created (even if `cmdMode` is `notification`).
-For instance, if device has commands `ping` and `switch` the entity corresponding to that device will be created at provising time with the following attributes:
+For instance, if device has commands `ping` and `switch` the entity corresponding to that device will be created at
+provising time with the following attributes:
 ```
 ...
@@ -300,7 +304,8 @@ For instance, if device has commands `ping` and `switch` the entity correspondin
 }
 ```
-**NOTE:** `command` is the usual type for attributes associated to commands, but the one used at provisioning time (`"command": [ ...]` field) will be actually used.
+**NOTE:** `command` is the usual type for attributes associated to commands, but the one used at provisioning time
+(`"command": [ ...]` field) will be actually used.
 ## Entity Name expression support
@@ -708,52 +713,53 @@ to incorporate new transformations from the IoT Agent configuration file in a fa
 Current common transformation set:
-| JEXL Transformation                  | Equivalent JavaScript Function                                                                                           |
-| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
-| 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)                     | <code>arr.reduce((i, v) &vert; i + v));</code>                                                                           |
-| 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);`                                                                                                         |
-| joinarrtostr: (arr, ch)              | `arr.join(ch);`                                                                                                          |
-| concatarr: (arr, arr2)               | `arr.concat(arr2);`                                                                                                      |
-| mapper: (val, values, choices)       | <code>choices[values.findIndex((target) &vert; target == val)]);</code>                                                  |
-| thmapper: (val, values, choices)     | <code>choices[values.reduce((acc,curr,i,arr) &vert; (acc==0)&vert;&vert;acc?acc:val<=curr?acc=i:acc=null,null)];</code>  |
-| bitwisemask: (i,mask,op,shf)         | <code>(op==="&"?parseInt(i)&mask: op==="&vert;"?parseInt(i)&vert;mask: op==="^"?parseInt(i)^mask:i)>>shf;</code>         |
-| slice: (arr, init, end)              | `arr.slice(init,end);`                                                                                                   |
-| addset: (arr, x)                     | <code>{ return Array.from((new Set(arr)).add(x)) }</code>                                                                |
-| removeset: (arr, x)                  | <code>{ let s = new Set(arr); s.delete(x); return Array.from(s) }</code>                                                 |
-| touppercase: (val)                   | `String(val).toUpperCase()`                                                                                              |
-| tolowercase: (val)                   | `String(val).toLowerCase()`                                                                                              |
-| round: (val)                         | `Math.round(val)`                                                                                                        |
-| floor: (val)                         | `Math.floor(val)`                                                                                                        |
-| ceil: (val)                          | `Math.ceil(val)`                                                                                                         |
-| tofixed: (val, decimals)             | `Number.parseFloat(val).toFixed(decimals)`                                                                               |
-| gettime: (d)                         | `new Date(d).getTime()`                                                                                                  |
-| toisostring: (d)                     | `new Date(d).toISOString()`                                                                                              |
-| localestring: (d, timezone, options) | `new Date(d).toLocaleString(timezone, options)`                                                                          |
-| now: ()                              | `Date.now()`                                                                                                             |
-| hextostring: (val)                   | `new TextDecoder().decode(new Uint8Array(val.match(/.{1,2}/g).map(byte => parseInt(byte, 16))))`                         |
-| valuePicker: (val,pick)              | <code>valuePicker: (val,pick) => Object.entries(val).filter(([_, v]) => v === pick).map(([k, _]) => k)</code>            |
-| valuePickerMulti: (val,pick)         | <code>valuePickerMulti: (val,pick) => Object.entries(val).filter(([_, v]) => pick.includes(v)).map(([k, _]) => k)</code> |
+| JEXL Transformation                      | Equivalent JavaScript Function                                                                                           |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| 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)                         | <code>arr.reduce((i, v) &vert; i + v));</code>                                                                           |
+| 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);`                                                                                                         |
+| joinarrtostr: (arr, ch)                  | `arr.join(ch);`                                                                                                          |
+| concatarr: (arr, arr2)                   | `arr.concat(arr2);`                                                                                                      |
+| mapper: (val, values, choices)           | <code>choices[values.findIndex((target) &vert; target == val)]);</code>                                                  |
+| thmapper: (val, values, choices)         | <code>choices[values.reduce((acc,curr,i,arr) &vert; (acc==0)&vert;&vert;acc?acc:val<=curr?acc=i:acc=null,null)];</code>  |
+| bitwisemask: (i,mask,op,shf)             | <code>(op==="&"?parseInt(i)&mask: op==="&vert;"?parseInt(i)&vert;mask: op==="^"?parseInt(i)^mask:i)>>shf;</code>         |
+| slice: (arr, init, end)                  | `arr.slice(init,end);`                                                                                                   |
+| addset: (arr, x)                         | <code>{ return Array.from((new Set(arr)).add(x)) }</code>                                                                |
+| removeset: (arr, x)                      | <code>{ let s = new Set(arr); s.delete(x); return Array.from(s) }</code>                                                 |
+| touppercase: (val)                       | `String(val).toUpperCase()`                                                                                              |
+| tolowercase: (val)                       | `String(val).toLowerCase()`                                                                                              |
+| round: (val)                             | `Math.round(val)`                                                                                                        |
+| floor: (val)                             | `Math.floor(val)`                                                                                                        |
+| ceil: (val)                              | `Math.ceil(val)`                                                                                                         |
+| tofixed: (val, decimals)                 | `Number.parseFloat(val).toFixed(decimals)`                                                                               |
+| gettime: (d)                             | `new Date(d).getTime()`                                                                                                  |
+| toisostring: (d)                         | `new Date(d).toISOString()`                                                                                              |
+| localestring: (d, timezone, options)     | `new Date(d).toLocaleString(timezone, options)`                                                                          |
+| localestringnumber: (n, locale, options) | `n.toLocaleStringNumber(locale, options)`                                                                                |
+| now: ()                                  | `Date.now()`                                                                                                             |
+| hextostring: (val)                       | `new TextDecoder().decode(new Uint8Array(val.match(/.{1,2}/g).map(byte => parseInt(byte, 16))))`                         |
+| valuePicker: (val,pick)                  | <code>valuePicker: (val,pick) => Object.entries(val).filter(([_, v]) => v === pick).map(([k, _]) => k)</code>            |
+| valuePickerMulti: (val,pick)             | <code>valuePickerMulti: (val,pick) => Object.entries(val).filter(([_, v]) => pick.includes(v)).map(([k, _]) => k)</code> |
 You have available this [JEXL interactive playground][99] with all the transformations already loaded, in which you can
 test all the functions described above.
@@ -1349,7 +1355,8 @@ as `command` in the [config group](#config-group-datamodel) or in the [device pr
 attributes are created using `command` as attribute type. Also, you can define the protocol you want the commands to be
 sent (HTTP/MQTT) with the `transport` parameter at the provisioning process.
-**NOTE**: in `advancedNotification` mode the command is not triggered updating an attribute, but creating a command execution entity. However, this mode has not been implemented yet so details are to be clarified.
+**NOTE**: in `advancedNotification` mode the command is not triggered updating an attribute, but creating a command
+execution entity. However, this mode has not been implemented yet so details are to be clarified.
 For a given device provisioned with a `ping` command defined, any update on this attribute "ping" at the NGSI entity in
 the Context Broker will send a command to your device. For instance, to send the `ping` command with value
@@ -1812,7 +1819,7 @@ Config group is represented by a JSON object with the following fields:
 | `endpoint`                     | ✓        | `string`       |            | Endpoint where the group of device is going to receive commands, if any.                                                                                                                                                                                                                                                                                                                                                            |
 | `storeLastMeasure`             | ✓        | `boolean`      |            | Store in device last measure received. See more info [in this section](admin.md#storelastmeasure). False by default                                                                                                                                                                                                                                                                                                                 |
 | `useCBflowControl`             | ✓        | `boolean`      |            | Use Context Broker flow control. See more info [in this section](admin.md#useCBflowControl). False by default                                                                                                                                                                                                                                                                                                                       |
-| `cmdMode`                      | ✓        | `string`       |            | Command mode that will use iotagent with CB: **legacy**, **notification** and **advancedNotification**. **Legacy** is based on registers. **notification** based on simplified schema of subscriptions. **Legacy** by default. More information on how the different modes work can be found in [the northbound interactions documents](devel/northboundinteractions.md).                                                                                                                                                                                                       |
+| `cmdMode`                      | ✓        | `string`       |            | Command mode that will use iotagent with CB: **legacy**, **notification** and **advancedNotification**. **Legacy** is based on registers. **notification** based on simplified schema of subscriptions. **Legacy** by default. More information on how the different modes work can be found in [the northbound interactions documents](devel/northboundinteractions.md).                                                           |
 ### Config group operations
@@ -2036,7 +2043,7 @@ the API resource fields and the same fields in the database model.
 | `storeLastMeasure`    | ✓        | `boolean` |            | Store in device last measure received. Useful just for debugging purpose. See more info [in this section](admin.md#storelastmeasure). False by default.                                                                                                                                                                                                                                                                    |
 | `lastMeasure`         | ✓        | `object`  |            | last measure stored on device when `storeLastMeasure` is enabled. See more info [in this section](admin.md#storelastmeasure). This field can be cleared using `{}` in a device update request. In that case, `lastMeasure` is removed from device (until a next measure is received and `lastMesuare` gets created again).                                                                                                 |
 | `useCBflowControl`    | ✓        | `boolean` |            | Use Context Broker flow control. See more info [in this section](admin.md#useCBflowControl). False by default.                                                                                                                                                                                                                                                                                                             |
-| `cmdMode`             | ✓        | `string`  |            | Command mode that will use iotagent with CB: **legacy**, **notification** and **advancedNotification**. **Legacy** is based on registers. **notification** based on simplified schema of subscriptions. **Legacy** by default. More information on how the different modes work can be found in [the northbound interactions documents](devel/northboundinteractions.md).                                                                                                                                                                                              |
+| `cmdMode`             | ✓        | `string`  |            | Command mode that will use iotagent with CB: **legacy**, **notification** and **advancedNotification**. **Legacy** is based on registers. **notification** based on simplified schema of subscriptions. **Legacy** by default. More information on how the different modes work can be found in [the northbound interactions documents](devel/northboundinteractions.md).                                                  |
 ### Device operations
@@ -2493,4 +2500,4 @@ updateEntityRequestsError 5
 [18]:
     https://czosel.github.io/jexl-playground/#/?context=%7B%0A%20%20%22value%22%20%3A%206%2C%0A%20%20%22ts%22%3A%201637245214901%2C%0A%20%22name%22%3A%20%22DevId629%22%2C%0A%20%22object%22%3A%7Bname%3A%20%22John%22%2C%20surname%3A%20%22Doe%22%7D%2C%0A%20%20%22array%22%3A%5B1%2C3%5D%0A%7D&input=name%7Csubstr(0%2Cname%7CindexOf(%22e%22)%2B1)&transforms=%7B%0A%20%20%20%20jsonparse%3A%20(str)%20%3D%3E%20JSON.parse(str)%2C%0A%20%20%20%20jsonstringify%3A%20(obj)%20%3D%3E%20JSON.stringify(obj)%2C%0A%20%20%20%20indexOf%3A%20(val%2C%20char)%20%3D%3E%20String(val).indexOf(char)%2C%0A%20%20%20%20length%3A%20(val)%20%3D%3E%20String(val).length%2C%0A%20%20%20%20trim%3A%20(val)%20%3D%3E%20String(val).trim()%2C%0A%20%20%20%20substr%3A%20(val%2C%20int1%2C%20int2)%20%3D%3E%20String(val).substr(int1%2C%20int2)%2C%0A%20%20%20%20addreduce%3A%20(arr)%20%3D%3E%20arr.reduce((i%2C%20v)%20%3D%3E%20i%20%2B%20v)%2C%0A%20%20%20%20lengtharray%3A%20(arr)%20%3D%3E%20arr.length%2C%0A%20%20%20%20typeof%3A%20(val)%20%3D%3E%20typeof%20val%2C%0A%20%20%20%20isarray%3A%20(arr)%20%3D%3E%20Array.isArray(arr)%2C%0A%20%20%20%20isnan%3A%20(val)%20%3D%3E%20isNaN(val)%2C%0A%20%20%20%20parseint%3A%20(val)%20%3D%3E%20parseInt(val)%2C%0A%20%20%20%20parsefloat%3A%20(val)%20%3D%3E%20parseFloat(val)%2C%0A%20%20%20%20toisodate%3A%20(val)%20%3D%3E%20new%20Date(val).toISOString()%2C%0A%20%20%20%20timeoffset%3A%20(isostr)%20%3D%3E%20new%20Date(isostr).getTimezoneOffset()%2C%0A%20%20%20%20tostring%3A%20(val)%20%3D%3E%20val.toString()%2C%0A%20%20%20%20urlencode%3A%20(val)%20%3D%3E%20encodeURI(val)%2C%0A%20%20%20%20urldecode%3A%20(val)%20%3D%3E%20decodeURI(val)%2C%0A%20%20%20%20replacestr%3A%20(str%2C%20from%2C%20to)%20%3D%3E%20str.replace(from%2C%20to)%2C%0A%20%20%20%20replaceregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20str.replace(new%20RegExp(reg)%2C%20to)%2C%0A%20%20%20%20replaceallstr%3A%20(str%2C%20from%2C%20to)%20%3D%3E%20str.replaceAll(from%2C%20to)%2C%0A%20%20%20%20replaceallregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20str.replaceAll(new%20RegExp(reg%2C%20'g')%2C%20to)%2C%0A%20%20%20%20split%3A%20(str%2C%20ch)%20%3D%3E%20str.split(ch)%2C%0A%20%20%20%20mapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%20choices%5Bvalues.findIndex((target)%20%3D%3E%20target%20%3D%3D%3D%20val)%5D%2C%0A%20%20%20%20thmapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%0A%20%20%20%20%20%20%20%20choices%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20values.reduce((acc%2C%20curr%2C%20i)%20%3D%3E%20(acc%20%3D%3D%3D%200%20%7C%7C%20acc%20%3F%20acc%20%3A%20val%20%3C%3D%20curr%20%3F%20(acc%20%3D%20i)%20%3A%20(acc%20%3D%20null))%2C%20null)%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20bitwisemask%3A%20(i%2C%20mask%2C%20op%2C%20shf)%20%3D%3E%0A%20%20%20%20%20%20%20%20(op%20%3D%3D%3D%20'%26'%20%3F%20parseInt(i)%20%26%20mask%20%3A%20op%20%3D%3D%3D%20'%7C'%20%3F%20parseInt(i)%20%7C%20mask%20%3A%20op%20%3D%3D%3D%20'%5E'%20%3F%20parseInt(i)%20%5E%20mask%20%3A%20i)%20%3E%3E%0A%20%20%20%20%20%20%20%20shf%2C%0A%20%20%20%20slice%3A%20(arr%2C%20init%2C%20end)%20%3D%3E%20arr.slice(init%2C%20end)%0A%7D
 [99]:
-    https://czosel.github.io/jexl-playground/#/?context=%7B%0A%20%20%22text%22%20%3A%20%22%20%20foobar%7B%7D%20%20%22%0A%7D&input=text%20%7C%20replacestr(%22foo%22%2C%22FOO%22)%7Ctrim%7Curlencode&transforms=%20%7B%0A%20%20%20%20jsonparse%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(JSON.parse)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20jsonstringify%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(JSON.stringify)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20indexOf%3A%20(val%2C%20char)%20%3D%3E%20String(val).indexOf(char)%2C%0A%20%20%20%20length%3A%20(val)%20%3D%3E%20String(val).length%2C%0A%20%20%20%20trim%3A%20(val)%20%3D%3E%20String(val).trim()%2C%0A%20%20%20%20substr%3A%20(val%2C%20int1%2C%20int2)%20%3D%3E%20String(val).substr(int1%2C%20int2)%2C%0A%20%20%20%20addreduce%3A%20(arr)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((arr)%20%3D%3E%20arr.reduce((i%2C%20v)%20%3D%3E%20i%20%2B%20v))(arr)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20lengtharray%3A%20(arr)%20%3D%3E%20arr.length%2C%0A%20%20%20%20typeof%3A%20(val)%20%3D%3E%20typeof%20val%2C%0A%20%20%20%20isarray%3A%20Array.isArray%2C%0A%20%20%20%20isnan%3A%20isNaN%2C%0A%20%20%20%20parseint%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeParseNumber%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20result%20%3D%20fn(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(result)%20%3F%20null%20%3A%20result%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeParseNumber((val)%20%3D%3E%20parseInt(val%2C%2010))(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20parsefloat%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeParseNumber%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20result%20%3D%20fn(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(result)%20%3F%20null%20%3A%20result%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeParseNumber(parseFloat)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20toisodate%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.toISOString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20timeoffset%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.getTimezoneOffset())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20tostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((val)%20%3D%3E%20val.toString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20urlencode%3A%20encodeURI%2C%0A%20%20%20%20urldecode%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(decodeURI)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20replacestr%3A%20(str%2C%20from%2C%20to)%20%3D%3E%20str.replace(from%2C%20to)%2C%0A%20%20%20%20replaceregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((str%2C%20reg%2C%20to)%20%3D%3E%20str.replace(new%20RegExp(reg)%2C%20to))(str%2C%20reg%2C%20to)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20replaceallregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((str%2C%20reg%2C%20to)%20%3D%3E%20str.replace(new%20RegExp(reg%2C%20'g')%2C%20to))(str%2C%20reg%2C%20to)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20split%3A%20(str%2C%20ch)%20%3D%3E%20str.split(ch)%2C%0A%20%20%20%20joinarrtostr%3A%20(arr%2C%20ch)%20%3D%3E%20arr.join(ch)%2C%0A%20%20%20%20concatarr%3A%20(arr%2C%20arr2)%20%3D%3E%20arr.concat(arr2)%2C%0A%20%20%20%20mapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%20choices%5Bvalues.findIndex((target)%20%3D%3E%20target%20%3D%3D%3D%20val)%5D%2C%0A%20%20%20%20thmapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%0A%20%20%20%20%20%20%20%20choices%5Bvalues.reduce((acc%2C%20curr%2C%20i)%20%3D%3E%20(acc%20!%3D%3D%20null%20%3F%20acc%20%3A%20val%20%3C%3D%20curr%20%3F%20i%20%3A%20null)%2C%20null)%5D%2C%0A%20%20%20%20bitwisemask%3A%20(i%2C%20mask%2C%20op%2C%20shf)%20%3D%3E%0A%20%20%20%20%20%20%20%20(op%20%3D%3D%3D%20'%26'%20%3F%20parseInt(i)%20%26%20mask%20%3A%20op%20%3D%3D%3D%20'%7C'%20%3F%20parseInt(i)%20%7C%20mask%20%3A%20op%20%3D%3D%3D%20'%5E'%20%3F%20parseInt(i)%20%5E%20mask%20%3A%20i)%20%3E%3E%0A%20%20%20%20%20%20%20%20shf%2C%0A%20%20%20%20slice%3A%20(arr%2C%20init%2C%20end)%20%3D%3E%20arr.slice(init%2C%20end)%2C%0A%20%20%20%20addset%3A%20(arr%2C%20x)%20%3D%3E%20Array.from(new%20Set(arr).add(x))%2C%0A%20%20%20%20removeset%3A%20(arr%2C%20x)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20s%20%3D%20new%20Set(arr)%3B%0A%20%20%20%20%20%20%20%20s.delete(x)%3B%0A%20%20%20%20%20%20%20%20return%20Array.from(s)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20touppercase%3A%20(val)%20%3D%3E%20String(val).toUpperCase()%2C%0A%20%20%20%20tolowercase%3A%20(val)%20%3D%3E%20String(val).toLowerCase()%2C%0A%20%20%20%20floor%3A%20Math.floor%2C%0A%20%20%20%20ceil%3A%20Math.ceil%2C%0A%20%20%20%20round%3A%20Math.round%2C%0A%20%20%20%20tofixed%3A%20(val%2C%20decimals)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20num%20%3D%20Number.parseFloat(val)%3B%0A%20%20%20%20%20%20%20%20const%20dec%20%3D%20Number.parseInt(decimals)%3B%0A%20%20%20%20%20%20%20%20return%20isNaN(num)%20%7C%7C%20isNaN(dec)%20%3F%20null%20%3A%20num.toFixed(dec)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20gettime%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.getTime())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20toisostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.toISOString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20localestring%3A%20(d%2C%20timezone%2C%20options)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((d%2C%20timezone%2C%20options)%20%3D%3E%20new%20Date(d).toLocaleString(timezone%2C%20options))(d%2C%20timezone%2C%20options)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20now%3A%20Date.now%2C%0A%20%20%20%20hextostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20(typeof%20val%20!%3D%3D%20'string'%20%7C%7C%20!%2F%5E%5B0-9a-fA-F%5D%2B%24%2F.test(val)%20%7C%7C%20val.length%20%25%202%20!%3D%3D%200)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20new%20TextDecoder().decode(new%20Uint8Array(val.match(%2F.%7B1%2C2%7D%2Fg).map((byte)%20%3D%3E%20parseInt(byte%2C%2016))))%3B%0A%20%20%20%20%20%20%20%20%7D)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20valuePicker%3A%20(val%2C%20pick)%20%3D%3E%0A%20%20%20%20%20%20%20%20Object.entries(val)%0A%20%20%20%20%20%20%20%20%20%20%20%20.filter((%5B%2C%20v%5D)%20%3D%3E%20v%20%3D%3D%3D%20pick)%0A%20%20%20%20%20%20%20%20%20%20%20%20.map((%5Bk%5D)%20%3D%3E%20k)%2C%0A%20%20%20%20valuePickerMulti%3A%20(val%2C%20pick)%20%3D%3E%0A%20%20%20%20%20%20%20%20Object.entries(val)%0A%20%20%20%20%20%20%20%20%20%20%20%20.filter((%5B%2C%20v%5D)%20%3D%3E%20pick.includes(v))%0A%20%20%20%20%20%20%20%20%20%20%20%20.map((%5Bk%5D)%20%3D%3E%20k)%0A%7D
+    https://czosel.github.io/jexl-playground/#/?context=%7B%0A%20%20%22text%22%20%3A%20%22%20%20foobar%7B%7D%20%20%22%0A%7D&input=text%20%7C%20replacestr(%22foo%22%2C%22FOO%22)%7Ctrim%7Curlencode&transforms=%20%7B%0A%20%20%20%20jsonparse%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(JSON.parse)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20jsonstringify%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(JSON.stringify)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20indexOf%3A%20(val%2C%20char)%20%3D%3E%20String(val).indexOf(char)%2C%0A%20%20%20%20length%3A%20(val)%20%3D%3E%20String(val).length%2C%0A%20%20%20%20trim%3A%20(val)%20%3D%3E%20String(val).trim()%2C%0A%20%20%20%20substr%3A%20(val%2C%20int1%2C%20int2)%20%3D%3E%20String(val).substr(int1%2C%20int2)%2C%0A%20%20%20%20addreduce%3A%20(arr)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((arr)%20%3D%3E%20arr.reduce((i%2C%20v)%20%3D%3E%20i%20%2B%20v))(arr)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20lengtharray%3A%20(arr)%20%3D%3E%20arr.length%2C%0A%20%20%20%20typeof%3A%20(val)%20%3D%3E%20typeof%20val%2C%0A%20%20%20%20isarray%3A%20Array.isArray%2C%0A%20%20%20%20isnan%3A%20isNaN%2C%0A%20%20%20%20parseint%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeParseNumber%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20result%20%3D%20fn(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(result)%20%3F%20null%20%3A%20result%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeParseNumber((val)%20%3D%3E%20parseInt(val%2C%2010))(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20parsefloat%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeParseNumber%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20result%20%3D%20fn(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(result)%20%3F%20null%20%3A%20result%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeParseNumber(parseFloat)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20toisodate%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.toISOString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20timeoffset%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.getTimezoneOffset())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20tostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((val)%20%3D%3E%20val.toString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20urlencode%3A%20encodeURI%2C%0A%20%20%20%20urldecode%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation(decodeURI)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20replacestr%3A%20(str%2C%20from%2C%20to)%20%3D%3E%20str.replace(from%2C%20to)%2C%0A%20%20%20%20replaceregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((str%2C%20reg%2C%20to)%20%3D%3E%20str.replace(new%20RegExp(reg)%2C%20to))(str%2C%20reg%2C%20to)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20replaceallregexp%3A%20(str%2C%20reg%2C%20to)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((str%2C%20reg%2C%20to)%20%3D%3E%20str.replace(new%20RegExp(reg%2C%20'g')%2C%20to))(str%2C%20reg%2C%20to)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20split%3A%20(str%2C%20ch)%20%3D%3E%20str.split(ch)%2C%0A%20%20%20%20joinarrtostr%3A%20(arr%2C%20ch)%20%3D%3E%20arr.join(ch)%2C%0A%20%20%20%20concatarr%3A%20(arr%2C%20arr2)%20%3D%3E%20arr.concat(arr2)%2C%0A%20%20%20%20mapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%20choices%5Bvalues.findIndex((target)%20%3D%3E%20target%20%3D%3D%3D%20val)%5D%2C%0A%20%20%20%20thmapper%3A%20(val%2C%20values%2C%20choices)%20%3D%3E%0A%20%20%20%20%20%20%20%20choices%5Bvalues.reduce((acc%2C%20curr%2C%20i)%20%3D%3E%20(acc%20!%3D%3D%20null%20%3F%20acc%20%3A%20val%20%3C%3D%20curr%20%3F%20i%20%3A%20null)%2C%20null)%5D%2C%0A%20%20%20%20bitwisemask%3A%20(i%2C%20mask%2C%20op%2C%20shf)%20%3D%3E%0A%20%20%20%20%20%20%20%20(op%20%3D%3D%3D%20'%26'%20%3F%20parseInt(i)%20%26%20mask%20%3A%20op%20%3D%3D%3D%20'%7C'%20%3F%20parseInt(i)%20%7C%20mask%20%3A%20op%20%3D%3D%3D%20'%5E'%20%3F%20parseInt(i)%20%5E%20mask%20%3A%20i)%20%3E%3E%0A%20%20%20%20%20%20%20%20shf%2C%0A%20%20%20%20slice%3A%20(arr%2C%20init%2C%20end)%20%3D%3E%20arr.slice(init%2C%20end)%2C%0A%20%20%20%20addset%3A%20(arr%2C%20x)%20%3D%3E%20Array.from(new%20Set(arr).add(x))%2C%0A%20%20%20%20removeset%3A%20(arr%2C%20x)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20s%20%3D%20new%20Set(arr)%3B%0A%20%20%20%20%20%20%20%20s.delete(x)%3B%0A%20%20%20%20%20%20%20%20return%20Array.from(s)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20touppercase%3A%20(val)%20%3D%3E%20String(val).toUpperCase()%2C%0A%20%20%20%20tolowercase%3A%20(val)%20%3D%3E%20String(val).toLowerCase()%2C%0A%20%20%20%20floor%3A%20Math.floor%2C%0A%20%20%20%20ceil%3A%20Math.ceil%2C%0A%20%20%20%20round%3A%20Math.round%2C%0A%20%20%20%20tofixed%3A%20(val%2C%20decimals)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20num%20%3D%20Number.parseFloat(val)%3B%0A%20%20%20%20%20%20%20%20const%20dec%20%3D%20Number.parseInt(decimals)%3B%0A%20%20%20%20%20%20%20%20return%20isNaN(num)%20%7C%7C%20isNaN(dec)%20%3F%20null%20%3A%20num.toFixed(dec)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20gettime%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.getTime())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20toisostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeDateOperation%20%3D%20(fn)%20%3D%3E%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20const%20date%20%3D%20new%20Date(val)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20isNaN(date.getTime())%20%3F%20null%20%3A%20fn(date)%3B%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeDateOperation((date)%20%3D%3E%20date.toISOString())(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20localestring%3A%20(d%2C%20timezone%2C%20options)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((d%2C%20timezone%2C%20options)%20%3D%3E%20new%20Date(d).toLocaleString(timezone%2C%20options))(d%2C%20timezone%2C%20options)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20localestringnumber%3A%20(n%2C%20locale%2C%20options)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%0A%20%20%20%20%20%20%20%20%20%20%20%20(fn)%20%3D%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((n%2C%20locale%2C%20options)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20(typeof%20n%20!%3D%3D%20'number'%20%7C%7C%20isNaN(n))%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20n.toLocaleString(locale%2C%20options)%3B%0A%20%20%20%20%20%20%20%20%7D)(n%2C%20locale%2C%20options)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20now%3A%20Date.now%2C%0A%20%20%20%20hextostring%3A%20(val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20const%20safeOperation%20%3D%20(fn)%20%3D%3E%20(...args)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20try%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20fn(...args)%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%20catch%20(e)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%3B%0A%20%20%20%20%20%20%20%20return%20safeOperation((val)%20%3D%3E%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20(typeof%20val%20!%3D%3D%20'string'%20%7C%7C%20!%2F%5E%5B0-9a-fA-F%5D%2B%24%2F.test(val)%20%7C%7C%20val.length%20%25%202%20!%3D%3D%200)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20null%3B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20new%20TextDecoder().decode(new%20Uint8Array(val.match(%2F.%7B1%2C2%7D%2Fg).map((byte)%20%3D%3E%20parseInt(byte%2C%2016))))%3B%0A%20%20%20%20%20%20%20%20%7D)(val)%3B%0A%20%20%20%20%7D%2C%0A%20%20%20%20valuePicker%3A%20(val%2C%20pick)%20%3D%3E%0A%20%20%20%20%20%20%20%20Object.entries(val)%0A%20%20%20%20%20%20%20%20%20%20%20%20.filter((%5B%2C%20v%5D)%20%3D%3E%20v%20%3D%3D%3D%20pick)%0A%20%20%20%20%20%20%20%20%20%20%20%20.map((%5Bk%5D)%20%3D%3E%20k)%2C%0A%20%20%20%20valuePickerMulti%3A%20(val%2C%20pick)%20%3D%3E%0A%20%20%20%20%20%20%20%20Object.entries(val)%0A%20%20%20%20%20%20%20%20%20%20%20%20.filter((%5B%2C%20v%5D)%20%3D%3E%20pick.includes(v))%0A%20%20%20%20%20%20%20%20%20%20%20%20.map((%5Bk%5D)%20%3D%3E%20k)%0A%7D

package/doc/deprecated.md CHANGED Viewed

@@ -12,12 +12,17 @@ longer. In particular:
 A list of deprecated features and the version in which they were deprecated follows:
+-   Config `mongodb.*` different from `mongodb.uri` (and associated env vars `IOTA_MONGO_*` except `IOTA_MONGO_URI`) in
+    4.11.0
 -   Support to NGSI v1 (finally removed in 2.18.0)
 -   Support to Node.js v4 in iotagent-node-lib 2.8.1 (finally removed in 2.9.0)
 -   Support to Node.js v6 in iotagent-node-lib 2.9.0 (finally removed in 2.10.0)
 -   Support to Node.js v8 in iotagent-node-lib 2.12.0 (finally removed in 2.13.0)
 -   Support to Node.js v10 in iotagent-node-lib 2.15.0 (finally removed in 2.16.0)
 -   Support to Node.js v12 in iotagent-node-lib 2.24.0 (finally removed in 2.25.0)
+-   Support to Node.js v14 in iotagent-node-lib 3.0.0 (finally removed in 3.1.0)
+-   Support to Node.js v16 in iotagent-node-lib 4.9.0 (finally removed in 4.10.0)
+-   Support to Node.js v18 in iotagent-node-lib 4.9.0 (finally removed in 4.10.0)
 -   Support to NGSI-LD v1.3 in iotagent-node-lib 2.25.0 (finally removed in 2.26.0)
 -   Support groups (provision) statically defined by configuration
 -   Support to in-memory registry (i.e.`deviceRegistry.type=memory`)
@@ -47,17 +52,31 @@ information in the case you want to use old versions:
 The following table provides information about the last iotagent-node-lib version supporting currently removed features:
-| **Removed feature**                                   | **Last iotagent-node-lib version supporting feature** | **That version release date** |
-| ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------- |
-| NGSI v1 API                                           | 2.17.0                                                | August 30th, 2021             |
-| Support to Node.js v4                                 | 2.8.1                                                 | December 19th, 2018           |
-| Support to Node.js v6                                 | 2.9.0                                                 | May 22nd, 2019                |
-| Support to Node.js v8                                 | 2.12.0                                                | April 7th, 2020               |
-| Support to Node.js v10                                | 2.15.0                                                | February 18th, 2021           |
-| Support to Node.js v12                                | 2.24.0                                                | September 2nd, 2022           |
-| Support to NGSI-LD 1.3                                | 2.25.0                                                | January 24th, 2023            |
-| eventType configuration                               | 2.26.0                                                | March 15th, 2023              |
-| Support to Legacy Expressions                         | 3.1.0                                                 | April 25th, 2023              |
-| bidirectional plugin                                  | 3.3.0                                                 | August 24th, 2023             |
-| appendMode configuration (`IOTA_APPEND_MODE` env var) | 3.3.0                                                 | August 24th, 2023             |
-| push-mode stats                                       | 4.5.0                                                 | June 11th, 2024               |
+| **Removed feature**                                            | **Last iotagent-node-lib version supporting feature** | **That version release date** |
+| -------------------------------------------------------------- | ----------------------------------------------------- | ----------------------------- |
+| NGSI v1 API                                                    | 2.17.0                                                | August 30th, 2021             |
+| Support to Node.js v4                                          | 2.8.1                                                 | December 19th, 2018           |
+| Support to Node.js v6                                          | 2.9.0                                                 | May 22nd, 2019                |
+| Support to Node.js v8                                          | 2.12.0                                                | April 7th, 2020               |
+| Support to Node.js v10                                         | 2.15.0                                                | February 18th, 2021           |
+| Support to Node.js v12                                         | 2.24.0                                                | September 2nd, 2022           |
+| Support to Node.js v14                                         | 3.0.0                                                 | March 30th, 2023              |
+| Support to Node.js v16                                         | 4.9.0                                                 | August 22nd, 2025             |
+| Support to Node.js v18                                         | 4.9.0                                                 | August 22nd, 2025             |
+| Support to NGSI-LD 1.3                                         | 2.25.0                                                | January 24th, 2023            |
+| eventType configuration                                        | 2.26.0                                                | March 15th, 2023              |
+| Support to Legacy Expressions                                  | 3.1.0                                                 | April 25th, 2023              |
+| bidirectional plugin                                           | 3.3.0                                                 | August 24th, 2023             |
+| appendMode configuration (`IOTA_APPEND_MODE` env var)          | 3.3.0                                                 | August 24th, 2023             |
+| push-mode stats                                                | 4.5.0                                                 | June 11th, 2024               |
+| config `mongodb.host` (env var `IOTA_MONGO_HOST`)              | Not yet                                               | Not yet                       |
+| config `mongodb.port` (env var `IOTA_MONGO_PORT`)              | Not yet                                               | Not yet                       |
+| config `mongodb.db` (env var `IOTA_MONGO_DB`)                  | Not yet                                               | Not yet                       |
+| config `mongodb.replicaSet` (env var `IOTA_MONGO_REPLICASET`)  | Not yet                                               | Not yet                       |
+| config `mongodb.user` (env var `IOTA_MONGO_USER`)              | Not yet                                               | Not yet                       |
+| config `mongodb.password` (env var `IOTA_MONGO_PASSWORD`)      | Not yet                                               | Not yet                       |
+| config `mongodb.authSource` (env var `IOTA_MONGO_AUTH_SOURCE`) | Not yet                                               | Not yet                       |
+| config `mongodb.retries` (env var `IOTA_MONGO_RETRIES`)        | Not yet                                               | Not yet                       |
+| config `mongodb.retryTime` (env var `IOTA_MONGO_RETRY_TIME`)   | Not yet                                               | Not yet                       |
+| config `mongodb.ssl` (env var `IOTA_MONGO_SSL`)                | Not yet                                               | Not yet                       |
+| config `mongodb.extraArgs` (env var `IOTA_MONGO_EXTRAARGS`)    | Not yet                                               | Not yet                       |

package/doc/devel/northboundinteractions.md CHANGED Viewed

@@ -346,7 +346,8 @@ queries (and thus P2 and R2 payloads).
 ![General ](./img/scenario3.png 'Scenario 3: commands')
-**FIXME:** this scenario describes the registration-based commanding mechanism, which is currently deprecated. It should be reworked
+**FIXME:** this scenario describes the registration-based commanding mechanism, which is currently deprecated. It should
+be reworked
 This scenario requires that the attributes that are going to be requested are marked as provided by the IoT Agent,
 through a registration process (NGSIv9). Examples of this registration process will be provided in the practical section
@@ -733,11 +734,14 @@ error, that error must follow the NGSI payloads described in the Scenario 1 erro
 The interactions depend on the command mode (`cmdMode`):
-* `legacy`
-* `notification`
-* `advancedNotification`
+-   `legacy`
+-   `notification`
+-   `advancedNotification`
-The way of setting up Context Broker to IotAgent communication and the interaction between Context Broker and IoTAgent when the command is executed depends on the mode (thus specific subsections about it are provided next for the three modes). However, the way in which the command result is provided is the same to all modes (so it is described in a [common section](#result-reporting)).
+The way of setting up Context Broker to IotAgent communication and the interaction between Context Broker and IoTAgent
+when the command is executed depends on the mode (thus specific subsections about it are provided next for the three
+modes). However, the way in which the command result is provided is the same to all modes (so it is described in a
+[common section](#result-reporting)).
 #### `legacy` mode
@@ -766,7 +770,8 @@ curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -
 }' "https://<platform-ip>:1026/v2/registrations"
 ```
-If everything has gone OK, the Context Broker will return 201 Created with the ID of the registration in the `Location` header:
+If everything has gone OK, the Context Broker will return 201 Created with the ID of the registration in the `Location`
+header:
 ```
 HTTP/1.1 201 Created
@@ -831,8 +836,8 @@ Fiware-Correlator: 9cae9496-8ec7-11e6-80fc-fa163e734aab
 }
 ```
-The IoT Agent detects the selected attribute is a command, and replies to the Context Broker with a 204 No Content (without
-payload).
+The IoT Agent detects the selected attribute is a command, and replies to the Context Broker with a 204 No Content
+(without payload).
 This response just indicates that the IoT Agent has received the command successfully, and gives no information about
 the requested information or command execution.
@@ -867,13 +872,14 @@ curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -
         "http": {
             "url": "<value of the IOTA_PROVIDER_URL>/notify"
         },
-        "attrsFormat": "simplifiedNormalized",
+        "attrsFormat": "normalized",
         "attrs": [ "switch" ]
     }
 }' "https://<platform-ip>:1026/v2/subscriptions"
 ```
-If everything has gone OK, the Context Broker will return 201 Created with the ID of the subscription in the `Location` header:
+If everything has gone OK, the Context Broker will return 201 Created with the ID of the subscription in the `Location`
+header:
 ```
 HTTP/1.1 201 Created
@@ -908,8 +914,8 @@ curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -
 } ' "https://<platform-ip>:1026/v2/op/update"
 ```
-The Context Broker receives this update and detects that it triggers the subscription, so it
-notifies to the IoT Agent, as follows:
+The Context Broker receives this update and detects that it triggers the subscription, so it notifies to the IoT Agent,
+as follows:
 ```bash
 POST /notify HTTP/1.1
@@ -919,17 +925,20 @@ Fiware-ServicePath: /iota2ngsi
 Accept: application/json
 Content-length: ...
 Content-type: application/json; charset=utf-8
-Ngsiv2-Attrsformat: simplifiedNormalized
+Ngsiv2-Attrsformat: normalized
 Fiware-Correlator: 9cae9496-8ec7-11e6-80fc-fa163e734aab
 {
-    "id": "Dev0001",
-    "type": "device",
-    "switch": {
-        "type": "command",
-        "value": "54, 12",
-        "metadata": {}
-    }
+    "subscriptionId": "60b0cedd497e8b681d40b58e",
+    "data": [{
+      "id": "Dev0001",
+      "type": "device",
+      "switch": {
+          "type": "command",
+          "value": "54, 12",
+          "metadata": {}
+      }
+    }]
 }
 ```
@@ -946,7 +955,8 @@ request will be.
 ##### Set up ContextBroker to IOTA comunication mechanism
-The communication mechanism will be based on subscriptions, although a different one than the one used in `notification` mode. Note this mode has not been implemented yet, so following should be taken as a draft:
+The communication mechanism will be based on subscriptions, although a different one than the one used in `notification`
+mode. Note this mode has not been implemented yet, so following should be taken as a draft:
 ```bash
 curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Fiware-Service: workshop" \
@@ -974,7 +984,8 @@ curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -
 ##### Command Execution
-Command execution involves to create a *command execution entity* (details are yet to be implemented), which in sequence triggers a notification to IoTAgent as this one (draft)
+Command execution involves to create a _command execution entity_ (details are yet to be implemented), which in sequence
+triggers a notification to IoTAgent as this one (draft)
 ```bash
 POST /notify HTTP/1.1
@@ -1072,7 +1083,8 @@ the requested information or command execution.
 At this point, the command has been issued to the IoTAgent and the User doesn't still know what the result of its
 request will be.
-As mentioned before, advanced notification mode has not been yet implemented. The following considerations are gap in the current implementation at IoT Agent side that should be addressed:
+As mentioned before, advanced notification mode has not been yet implemented. The following considerations are gap in
+the current implementation at IoT Agent side that should be addressed:
 -   Fields others than `targetEntityId`, `targetEntityType`, `cmd` and `params` (i.e. `execTs`, `status`, `info`,
     `onDelivered`, `onOk`, `onError`, `onInfo`, `cmdExecution` and `dataExpiration`), are not actually used. By the

package/lib/commonConfig.js CHANGED Viewed

@@ -173,6 +173,9 @@ function processEnvironmentVariables() {
         'IOTA_IOTAM_AGENTPATH'
     ];
     const mongoVariables = [
+        'IOTA_MONGO_URI',
+        // FIXME: the following IOTA_MONGO_ env vars are deprecated and will
+        // be eventually removed (use IOTA_MONGO_URI)
         'IOTA_MONGO_HOST',
         'IOTA_MONGO_PORT',
         'IOTA_MONGO_DB',
@@ -365,6 +368,12 @@ function processEnvironmentVariables() {
     // Default transport
     if (process.env.IOTA_DEFAULT_TRANSPORT !== undefined) {
         config.defaultTransport = process.env.IOTA_DEFAULT_TRANSPORT;
+    } else {
+        // defaultTransport is "MQTT" by default even when no ENV VAR is used
+        // and should be available in iotagent-library to allow
+        // set polling and transport for autoprovisioned devices
+        // at lib/services/devices/deviceService.js#L302
+        config.defaultTransport = 'MQTT';
     }
     // Default explicitAttrs
@@ -409,6 +418,10 @@ function processEnvironmentVariables() {
         config.mongodb = {};
     }
+    if (process.env.IOTA_MONGO_URI) {
+        config.mongodb.uri = process.env.IOTA_MONGO_URI;
+    }
     if (process.env.IOTA_MONGO_HOST) {
         config.mongodb.host = process.env.IOTA_MONGO_HOST;
     }

package/lib/jexlTranformsMap.js CHANGED Viewed

@@ -204,6 +204,21 @@ const map = {
             options
         );
     },
+    localestringnumber: (n, locale, options) => {
+        const safeOperation =
+            (fn) =>
+            (...args) => {
+                try {
+                    return fn(...args);
+                } catch (e) {
+                    return null;
+                }
+            };
+        return safeOperation((n, locale, options) => {
+            if (typeof n !== 'number' || isNaN(n)) return null;
+            return n.toLocaleString(locale, options);
+        })(n, locale, options);
+    },
     now: Date.now,
     hextostring: (val) => {
         const safeOperation =

package/lib/model/dbConn.js CHANGED Viewed

@@ -21,7 +21,7 @@
  * please contact with::daniel.moranjimenez@telefonica.com
  */
-/**
+/*
  * This module sets up the connection with the mongodb through mongoose. This connection will be used
  * in mongoose schemas to persist objects.
  */
@@ -49,8 +49,7 @@ function loadModels() {
  *
  * @this Reference to the dbConn module itself.
  */
-function init(host, db, port, options, callback) {
+function init(host, db, port, options, callback, fullUri = null) {
     let url;
     let retries = 0;
     let lastError;
@@ -60,21 +59,25 @@ function init(host, db, port, options, callback) {
         return `${item}:${port}`;
     }
-    url = 'mongodb://';
+    if (fullUri) {
+        url = fullUri;
+    } else {
+        url = 'mongodb://';
-    if (options.auth) {
-        url += `${encodeURIComponent(options.auth.user)}:${encodeURIComponent(options.auth.password)}@`;
-    }
+        if (options.auth) {
+            url += `${encodeURIComponent(options.auth.user)}:${encodeURIComponent(options.auth.password)}@`;
+        }
-    const hosts = host.split(',').map(addPort).join(',');
-    url += `${hosts}/${db}`;
+        const hosts = host.split(',').map(addPort).join(',');
+        url += `${hosts}/${db}`;
-    if (options.extraArgs) {
-        const query = new URLSearchParams(options.extraArgs).toString();
-        if (query) {
-            url += `?${query}`;
+        if (options.extraArgs) {
+            const query = new URLSearchParams(options.extraArgs).toString();
+            if (query) {
+                url += `?${query}`;
+            }
+            delete options.extraArgs;
         }
-        delete options.extraArgs;
     }
     function connectionAttempt(callback) {
@@ -91,32 +94,17 @@ function init(host, db, port, options, callback) {
                     lastError = error;
                     alarms.raise(constants.MONGO_ALARM, error);
                 });
-                /* eslint-disable-next-line no-unused-vars */
-                defaultDb.on('connecting', function (error) {
-                    logger.debug(context, 'Mongo Driver connecting');
-                });
-                defaultDb.on('connected', function () {
-                    logger.debug(context, 'Mongo Driver connected');
-                });
-                defaultDb.on('reconnected', function () {
-                    logger.debug(context, 'Mongo Driver reconnected');
-                });
-                defaultDb.on('disconnected', function () {
-                    logger.debug(context, 'Mongo Driver disconnected');
-                });
-                defaultDb.on('reconnectFailed', function () {
+                defaultDb.on('connecting', () => logger.debug(context, 'Mongo Driver connecting'));
+                defaultDb.on('connected', () => logger.debug(context, 'Mongo Driver connected'));
+                defaultDb.on('reconnected', () => logger.debug(context, 'Mongo Driver reconnected'));
+                defaultDb.on('disconnected', () => logger.debug(context, 'Mongo Driver disconnected'));
+                defaultDb.on('reconnectFailed', () => {
                     logger.error(context, 'MONGODB-004: MongoDB connection was lost');
                     process.exit(1);
                 });
-                defaultDb.on('disconnecting', function () {
-                    logger.debug(context, 'Mongo Driver disconnecting');
-                });
-                defaultDb.on('open', function () {
-                    logger.debug(context, 'Mongo Driver open');
-                });
-                defaultDb.on('close', function () {
-                    logger.debug(context, 'Mongo Driver close');
-                });
+                defaultDb.on('disconnecting', () => logger.debug(context, 'Mongo Driver disconnecting'));
+                defaultDb.on('open', () => logger.debug(context, 'Mongo Driver open'));
+                defaultDb.on('close', () => logger.debug(context, 'Mongo Driver close'));
                 callback();
             })
             .catch((err) => {
@@ -144,34 +132,45 @@ function init(host, db, port, options, callback) {
 function configureDb(callback) {
     const currentConfig = config.getConfig();
     if (currentConfig.deviceRegistry?.type === 'mongodb') {
-        if (!currentConfig.mongodb?.host) {
-            logger.fatal(context, 'MONGODB-003: No host found for MongoDB driver.');
-            callback(new errors.BadConfiguration('No host found for MongoDB driver'));
-        } else {
-            const dbName = currentConfig.mongodb.db || DEFAULT_DB_NAME;
-            const port = currentConfig.mongodb.port || 27017;
+        const mongoCfg = currentConfig.mongodb;
+        if (mongoCfg?.uri) {
             const options = {};
+            logger.info(context, `Using full MongoDB URI from configuration`);
+            init(null, null, null, options, callback, mongoCfg.uri);
+            return;
+        }
-            if (currentConfig.mongodb.replicaSet) options.replicaSet = currentConfig.mongodb.replicaSet;
-            if (currentConfig.mongodb.ssl) options.ssl = currentConfig.mongodb.ssl;
-            if (currentConfig.mongodb.extraArgs) options.extraArgs = currentConfig.mongodb.extraArgs;
+        if (!mongoCfg?.host) {
+            logger.fatal(context, 'MONGODB-003: No host found for MongoDB driver.');
+            callback(new errors.BadConfiguration('No host found for MongoDB driver'));
+            return;
+        }
-            if (currentConfig.mongodb.user && currentConfig.mongodb.password) {
-                options.auth = {
-                    user: currentConfig.mongodb.user,
-                    password: currentConfig.mongodb.password
+        const dbName = mongoCfg.db || DEFAULT_DB_NAME;
+        const port = mongoCfg.port || 27017;
+        const options = {};
+        if (mongoCfg.replicaSet) options.replicaSet = mongoCfg.replicaSet;
+        if (mongoCfg.ssl) options.ssl = mongoCfg.ssl;
+        if (mongoCfg.extraArgs) options.extraArgs = mongoCfg.extraArgs;
+        if (mongoCfg.user && mongoCfg.password) {
+            options.auth = {
+                user: mongoCfg.user,
+                password: mongoCfg.password
+            };
+            if (mongoCfg.authSource) {
+                options.extraArgs = {
+                    ...options.extraArgs,
+                    authSource: mongoCfg.authSource
                 };
-                if (currentConfig.mongodb.authSource) {
-                    options.extraArgs = {
-                        ...options.extraArgs,
-                        authSource: currentConfig.mongodb.authSource
-                    };
-                }
             }
-            init(currentConfig.mongodb.host, dbName, port, options, callback);
         }
+        init(mongoCfg.host, dbName, port, options, callback);
     } else {
         callback();
     }

package/lib/services/devices/registrationUtils.js CHANGED Viewed

@@ -341,7 +341,7 @@ function sendSubscriptionsNgsi2(unregister, deviceData, callback) {
     }
     const trigger = attrs; // one subscription for all commands
     const content = attrs;
-    const attrsFormat = 'simplifiedNormalized';
+    const attrsFormat = 'normalized';
     logger.debug(
         context,

package/lib/services/ngsi/ngsiService.js CHANGED Viewed

@@ -168,7 +168,21 @@ function executeWithDeviceInformation(operationFunction) {
             deviceInformation
         );
         const currentType = type ? type : deviceInformation.type;
-        config.getGroupRegistry().getTypeSilently(currentType, function (error, deviceGroup) {
+        function getConfiguration(currentType, deviceInformation, callback) {
+            config
+                .getGroupRegistry()
+                .getSilently(deviceInformation.resource, deviceInformation.apikey, function (error, deviceGroup) {
+                    if (error) {
+                        config.getGroupRegistry().getTypeSilently(currentType, function (error, deviceGroup) {
+                            callback(error, deviceGroup);
+                        });
+                    } else {
+                        callback(null, deviceGroup);
+                    }
+                });
+        }
+        getConfiguration(currentType, deviceInformation, function (error, deviceGroup) {
             let typeInformation;
             const configDeviceInfo = config.getConfig().types[currentType];
             if (error) {

package/lib/services/northBound/contextServer-NGSI-v2.js CHANGED Viewed

@@ -293,8 +293,10 @@ function handleNotificationNgsi2(req, res, next) {
             }
         }
         logger.debug(context, 'extracted atts %j from dataElement %j', atts, dataElement);
-        var id = null;
-        var type = null;
+        // FIXME: command execution entity for advancedNotification is still not implemented
+        var id = dataElement.id;
+        var type = dataElement.type;
         if (dataElement.targetEntityId && dataElement.targetEntityId.value) {
             id = dataElement.targetEntityId.value;
         }

package/package.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "name": "iotagent-node-lib",
   "license": "AGPL-3.0-only",
   "description": "IoT Agent library to interface with NGSI Context Broker",
-  "version": "4.10.0",
+  "version": "4.12.0",
   "homepage": "https://github.com/telefonicaid/iotagent-node-lib",
   "keywords": [
     "fiware",

package/test/functional/testCases.js CHANGED Viewed

@@ -2235,6 +2235,79 @@ const testCases = [
             }
         ]
     },
+    {
+        describeName: '0201 - Simple groups with commands',
+        provision: {
+            url: 'http://localhost:' + config.iota.server.port + '/iot/services',
+            method: 'POST',
+            json: {
+                services: [
+                    {
+                        resource: '/iot/json',
+                        apikey: globalEnv.apikey,
+                        entity_type: globalEnv.entity_type,
+                        commands: [
+                            {
+                                name: 'cmd1',
+                                type: 'command'
+                            }
+                        ],
+                        endpoint: 'http://myendpoint.com',
+                        transport: 'http',
+                        lazy: [],
+                        attributes: [],
+                        static_attributes: []
+                    },
+                    {
+                        resource: '/iot/json',
+                        apikey: globalEnv.apikey + 'OTHER',
+                        entity_type: globalEnv.entity_type,
+                        commands: [
+                            {
+                                name: 'cmd1',
+                                type: 'command'
+                            }
+                        ],
+                        transport: 'mqtt',
+                        lazy: [],
+                        attributes: [],
+                        static_attributes: []
+                    }
+                ]
+            },
+            headers: {
+                'fiware-service': globalEnv.service,
+                'fiware-servicepath': globalEnv.servicePath
+            }
+        },
+        should: [
+            {
+                shouldName:
+                    'A - WHEN sending not provisioned object_ids (measures) through http IT should store commands into Context Broker',
+                type: 'single',
+                skip: '!lib', // there is not CB registration mock
+                measure: {
+                    url: 'http://localhost:' + config.http.port + '/iot/json',
+                    method: 'POST',
+                    qs: {
+                        i: globalEnv.deviceId,
+                        k: globalEnv.apikey
+                    },
+                    json: {
+                        b: 10
+                    }
+                },
+                expectation: {
+                    id: globalEnv.entity_name,
+                    type: globalEnv.entity_type,
+                    b: {
+                        value: 10,
+                        type: 'Text'
+                    }
+                }
+            }
+        ]
+    },
     // 0300 - STATIC ATTRIBUTES TESTS
     {
         describeName:

package/test/unit/expressions/jexlExpression-test.js CHANGED Viewed

@@ -398,6 +398,36 @@ describe('Jexl expression interpreter', function () {
         });
     });
+    describe('When number localization functions are executed', function () {
+        it('should return the localized string representation of the number', function (done) {
+            const scope = {
+                theNumber: 1234567.89,
+                locale: 'es-ES',
+                options: { minimumFractionDigits: 2, maximumFractionDigits: 2 }
+            };
+            expressionParser.parse('theNumber|localestringnumber(locale, options)', scope, function (error, result) {
+                should.not.exist(error);
+                result.should.equal('1.234.567,89');
+                done();
+            });
+        });
+        it('should return null for invalid number input', function (done) {
+            const scope = {
+                theNumber: 'not_a_number',
+                locale: 'en-US',
+                options: {}
+            };
+            expressionParser.parse('theNumber|localestringnumber(locale, options)', scope, function (error, result) {
+                should.not.exist(error);
+                should.equal(result, null);
+                done();
+            });
+        });
+    });
     // Check errors
     describe('When invalid inputs are used', function () {
         describe('When an invalid JSON string is parsed', function () {

package/test/unit/memoryRegistry/deviceRegistryMemory_test.js CHANGED Viewed

@@ -243,7 +243,7 @@ describe('NGSI-v2 - In memory device registry', function () {
                 should.exist(device.type);
                 device.name.should.equal('name5');
                 device.type.should.equal('Light5');
-                Object.keys(device).length.should.equal(13);
+                Object.keys(device).length.should.equal(14);
                 done();
             });
         });

package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands.json CHANGED Viewed

@@ -15,7 +15,7 @@
             "url":"http://smartgondor.com/notify"
         },
         "attrs":["position"],
-        "attrsFormat":"simplifiedNormalized",
+        "attrsFormat":"normalized",
         "onlyChangedAttrs":true
     }
 }

package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands2.json CHANGED Viewed

@@ -15,7 +15,7 @@
             "url":"http://smartgondor.com/notify"
         },
         "attrs":["position"],
-        "attrsFormat":"simplifiedNormalized",
+        "attrsFormat":"normalized",
         "onlyChangedAttrs":true
     }
 }

package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands3.json CHANGED Viewed

@@ -15,7 +15,7 @@
             "url":"http://smartgondor.com/notify"
         },
         "attrs":["position"],
-        "attrsFormat":"simplifiedNormalized",
+        "attrsFormat":"normalized",
         "onlyChangedAttrs":true
     }
 }

package/test/unit/ngsiv2/examples/contextAvailabilityRequests/subscribeIoTAgentCommands4.json CHANGED Viewed

@@ -15,7 +15,7 @@
             "url":"http://smartgondor.com/notify"
         },
         "attrs":["reset"],
-        "attrsFormat":"simplifiedNormalized",
+        "attrsFormat":"normalized",
         "onlyChangedAttrs":true
     }
 }