iotagent-node-lib 4.8.0 → 4.10.0

package/test/unit/ngsi-ld/examples/contextRequests/updateContextValueType1.json

@@ -0,0 +1,51 @@
+[
+    {
+        "@context": "http://context.json-ld",
+        "id": "urn:ngsi-ld:Light:ws1",
+        "type": "Light",
+        "consumption": {
+            "type": "Property",
+            "value": 1,
+            "valueType": "Number"
+        },
+        "alive": {
+            "type": "Property",
+            "value": "foo"
+        },
+        "updated": {
+            "type": "Property",
+            "value": false,
+            "valueType": "Boolean"
+        },
+        "manufacturer": {
+            "type": "Property",
+            "value": {
+                "hello": "world"
+            },
+            "valueType": "Object"
+        },
+        "revisions": {
+            "type": "Property",
+            "value": [
+                1,
+                2
+            ],
+            "valueType": "Array"
+        },
+        "date": {
+            "type": "Property",
+            "value": "2025-07-18",
+            "valueType": "Date"
+        },
+        "time": {
+            "type": "Property",
+            "value": "14:22:11",
+            "valueType": "Time"
+        },
+        "datetime": {
+            "type": "Property",
+            "value": "2025-07-18T14:22:11.000Z",
+            "valueType": "DateTime"
+        }
+    }
+]

package/test/unit/ngsi-ld/examples/contextRequests/updateContextValueType2.json

@@ -0,0 +1,65 @@
+[
+        {
+            "@context": "http://context.json-ld",
+            "id": "urn:ngsi-ld:Light:ws1",
+            "type": "Light",
+            "consumption": {
+                "type": "Property",
+                "value": {
+                    "@type": "Number",
+                    "@value": 1
+                }
+            },
+            "alive": {
+                "type": "Property",
+                "value": "foo"
+            },
+            "updated": {
+                "type": "Property",
+                "value": {
+                    "@type": "Boolean",
+                    "@value": false
+                }
+            },
+            "manufacturer": {
+                "type": "Property",
+                "value": {
+                    "@type": "Object",
+                    "@value": {
+                        "hello": "world"
+                    }
+                }
+            },
+            "revisions": {
+                "type": "Property",
+                "value": {
+                    "@type": "Array",
+                    "@value": [
+                        1,
+                        2
+                    ]
+                }
+            },
+            "date": {
+                "type": "Property",
+                "value": {
+                    "@type": "Date",
+                    "@value": "2025-07-18"
+                }
+            },
+            "time": {
+                "type": "Property",
+                "value": {
+                    "@type": "Time",
+                    "@value": "14:22:11"
+                }
+            },
+            "datetime": {
+                "type": "Property",
+                "value": {
+                    "@type": "DateTime",
+                    "@value": "2025-07-18T14:22:11.000Z"
+                }
+            }
+        }
+    ]

package/test/unit/ngsi-ld/examples/contextRequests/updateContextVocabProperty.json

@@ -0,0 +1,11 @@
+[
+  {
+    "@context": "http://context.json-ld",
+    "category": {
+        "type": "VocabProperty",
+        "vocab": "actuator"
+    },
+    "id": "urn:ngsi-ld:Light:light1",
+    "type": "Light"
+  }
+]

package/test/unit/ngsi-ld/examples/contextRequests/updateProvisionCommands1.json

@@ -4,17 +4,11 @@
         "id": "urn:ngsi-ld:Light:light1",
         "move_info": {
             "type": "Property",
-            "value": {
-                "@type": "commandResult",
-                "@value": " "
-            }
+            "value": " "
         },
         "move_status": {
             "type": "Property",
-            "value": {
-                "@type": "commandStatus",
-                "@value": "UNKNOWN"
-            }
+            "value":  "UNKNOWN"
         },
         "type": "Light"
     }

package/test/unit/ngsi-ld/examples/contextRequests/updateProvisionDeviceStatic.json

@@ -18,10 +18,7 @@
         },
         "serverURL": {
             "type": "Property",
-            "value": {
-                "@type": "URL",
-                "@value": "http://fakeserver.com"
-            }
+            "value": "http://fakeserver.com"
         },
         "type": "MicroLights"
     }

package/test/unit/ngsi-ld/general/contextBrokerOAuthSecurityAccess-test.js

@@ -309,7 +309,7 @@ describe('NGSI-LD - Secured access to the Context Broker with OAuth2 provider',
 
         it('subscribe requests use auth header', function (done) {
             iotAgentLib.getDevice('Light1', null, 'smartgondor', 'electricity', function (error, device) {
-                iotAgentLib.subscribe(device, ['dimming'], null, function (error) {
+                iotAgentLib.subscribe(device, ['dimming'], null, 'normalized', function (error) {
                     should.not.exist(error);
 
                     contextBrokerMock.done();
@@ -330,7 +330,7 @@ describe('NGSI-LD - Secured access to the Context Broker with OAuth2 provider',
             contextBrokerMock.delete('/ngsi-ld/v1/subscriptions/51c0ac9ed714fb3b37d7d5a8', '').reply(204);
 
             iotAgentLib.getDevice('Light1', null, 'smartgondor', 'electricity', function (error, device) {
-                iotAgentLib.subscribe(device, ['dimming'], null, function (error) {
+                iotAgentLib.subscribe(device, ['dimming'], null, 'normalized', function (error) {
                     iotAgentLib.unsubscribe(device, '51c0ac9ed714fb3b37d7d5a8', function (error) {
                         contextBrokerMock.done();
                         done();

package/test/unit/ngsi-ld/general/https-support-test.js

@@ -214,7 +214,7 @@ describe('NGSI-LD - HTTPS support tests', function () {
 
         it('should send the appropriate request to the Context Broker', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     should.not.exist(error);
 
                     contextBrokerMock.done();

package/test/unit/ngsi-ld/general/startup-test.js

@@ -89,6 +89,7 @@ describe('NGSI-LD - Startup tests', function () {
             process.env.IOTA_FALLBACK_PATH = 'smartgondor';
             process.env.IOTA_LD_SUPPORT_NULL = 'false';
             process.env.IOTA_LD_SUPPORT_DATASET_ID = 'false';
+            process.env.IOTA_LD_SUPPORT_DATA_TYPE = 'valueType';
 
             nock.cleanAll();
 
@@ -125,6 +126,7 @@ describe('NGSI-LD - Startup tests', function () {
             delete process.env.IOTA_FALLBACK_PATH;
             delete process.env.IOTA_LD_SUPPORT_NULL;
             delete process.env.IOTA_LD_SUPPORT_DATASET_ID;
+            delete process.env.IOTA_LD_SUPPORT_DATA_TYPE;
         });
 
         afterEach(function (done) {
@@ -155,6 +157,7 @@ describe('NGSI-LD - Startup tests', function () {
                 config.getConfig().mongodb.port.should.equal('5555');
                 config.getConfig().mongodb.db.should.equal('themongodb');
                 config.getConfig().mongodb.replicaSet.should.equal('customReplica');
+                config.getConfig().server.ldSupport.dataType.should.equal('valueType');
                 done();
             });
         });

package/test/unit/ngsi-ld/lazyAndCommands/command-test.js

@@ -1187,7 +1187,7 @@ describe('NGSI-LD - Command functionalities', function () {
         });
 
         it('should update its value and status in the Context Broker', function (done) {
-            iotAgentLib.setCommandResult('r2d2', 'Robot', '', 'position', '[72, 368, 1]', 'FINISHED', function (error) {
+            iotAgentLib.setCommandResult('r2d2', 'Robot', '', 'position', [72, 368, 1], 'FINISHED', function (error) {
                 should.not.exist(error);
                 statusAttributeMock.done();
                 done();

package/test/unit/ngsi-ld/lazyAndCommands/lazy-devices-test.js

@@ -226,7 +226,7 @@ describe('NGSI-LD - IoT Agent Lazy Devices', function () {
         it('should call the device handler for each of the contexts');
     });
 
-    describe('When a context query arrives to the IoT Agent', function () {
+    describe('When a context query arrives to the IoT Agent using retrieveEntity', function () {
         const options = {
             url:
                 'http://localhost:' +
@@ -294,6 +294,76 @@ describe('NGSI-LD - IoT Agent Lazy Devices', function () {
         });
     });
 
+    describe('When a context query arrives to the IoT Agent using queryEntities', function () {
+        const options = {
+            url:
+                'http://localhost:' +
+                iotAgentConfig.server.port +
+                '/ngsi-ld/v1/entities/?id=urn:ngsi-ld:Light:light1&attrs=dimming',
+            method: 'GET',
+            headers: {
+                'fiware-service': 'smartgondor',
+                'fiware-servicepath': 'gardens'
+            }
+        };
+        const sensorData = [
+            {
+                id: 'Light:light1',
+                type: 'Light',
+                dimming: {
+                    type: 'Percentage',
+                    value: 19
+                }
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/csourceRegistrations/',
+                    utils.readExampleFile(
+                        './test/unit/ngsi-ld/examples/contextAvailabilityRequests/registerIoTAgent1.json'
+                    )
+                )
+                .reply(201, null, { Location: '/ngsi-ld/v1/csourceRegistrations/6319a7f5254b05844116584d' });
+
+            contextBrokerMock
+                .matchHeader('fiware-service', 'smartgondor')
+                .post('/ngsi-ld/v1/entityOperations/upsert/')
+                .reply(204);
+
+            async.series([apply(iotAgentLib.activate, iotAgentConfig), apply(iotAgentLib.register, device1)], done);
+        });
+
+        it('should return the information querying the underlying devices', function (done) {
+            const expectedResponse = [
+                utils.readExampleFile(
+                    './test/unit/ngsi-ld/examples/contextProviderResponses/queryInformationResponse.json'
+                )
+            ];
+
+            iotAgentLib.setDataUpdateHandler(function (id, type, service, subservice, attributes, callback) {
+                callback(null);
+            });
+
+            iotAgentLib.setDataQueryHandler(function (id, type, service, subservice, attributes, callback) {
+                id.should.equal('urn:ngsi-ld:' + device1.type + ':' + device1.id);
+                type.should.equal(device1.type);
+                attributes[0].should.equal('dimming');
+                callback(null, sensorData[0]);
+            });
+
+            request(options, function (error, response, body) {
+                should.not.exist(error);
+                body.should.eql(expectedResponse);
+                done();
+            });
+        });
+    });
+
     describe('When a context query arrives to the IoT Agent and no handler is set', function () {
         const options = {
             url:

package/test/unit/ngsi-ld/ngsiService/attributeTypes-test.js

@@ -0,0 +1,293 @@
+/*
+ * Copyright 2022 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::[contacto@tid.es]
+ *
+ * Modified by: Daniel Calvo - ATOS Research & Innovation
+ */
+
+/* eslint-disable no-unused-vars */
+
+const iotAgentLib = require('../../../../lib/fiware-iotagent-lib');
+const utils = require('../../../tools/utils');
+const request = utils.request;
+const should = require('should');
+const logger = require('logops');
+const nock = require('nock');
+let contextBrokerMock;
+const iotAgentConfig = {
+    contextBroker: {
+        host: '192.168.1.1',
+        port: '1026',
+        ngsiVersion: 'ld',
+        jsonLdContext: 'http://context.json-ld'
+    },
+    server: {
+        port: 4041,
+        host: 'localhost'
+    },
+    types: {
+        Light: {
+            commands: [],
+            type: 'Light',
+            active: [
+                {
+                    name: 'name',
+                    type: 'LanguageProperty'
+                },
+                {
+                    name: 'locatedIn',
+                    type: 'Relationship'
+                },
+                {
+                    name: 'lightValues',
+                    type: 'ListProperty'
+                },
+                {
+                    name: 'placedIn',
+                    type: 'ListRelationship'
+                },
+                {
+                    name: 'categories',
+                    type: 'VocabProperty'
+                },
+                {
+                    name: 'config',
+                    type: 'JsonProperty'
+                }
+            ]
+        }
+    },
+    service: 'smartgondor',
+    subservice: 'gardens',
+    providerUrl: 'http://smartgondor.com'
+};
+
+describe('NGSI-LD: Attribute types test', function () {
+    beforeEach(function () {
+        logger.setLevel('FATAL');
+    });
+
+    afterEach(function (done) {
+        iotAgentLib.deactivate(done);
+    });
+
+    describe('When the IoT Agent receives new exonym from a device name with LanguageProperty type and a JSON object', function () {
+        const values = [
+            {
+                name: 'name',
+                type: 'LanguageProperty',
+                value: {
+                    el: 'Κωνσταντινούπολις',
+                    en: 'Constantinople',
+                    tr: 'İstanbul'
+                }
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile(
+                        './test/unit/ngsi-ld/examples/contextRequests/updateContextLanguageProperty.json'
+                    )
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the LanguageMap of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+
+    describe('When the IoT Agent receives new list from a device  with ListProperty type', function () {
+        const values = [
+            {
+                name: 'lightValues',
+                type: 'ListProperty',
+                value: [0, 1]
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile('./test/unit/ngsi-ld/examples/contextRequests/updateContextListProperty.json')
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the listValue of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+
+    describe('When the IoT Agent receives new list from a device with ListRelationship type', function () {
+        const values = [
+            {
+                name: 'placedIn',
+                type: 'ListRelationship',
+                value: ['unr:ngsi-ld:xxx', 'unr:ngsi-ld:yyyy']
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile(
+                        './test/unit/ngsi-ld/examples/contextRequests/updateContextListRelationship.json'
+                    )
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the listObject of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+
+    describe('When the IoT Agent receives new list from a device with JsonProperty type', function () {
+        const values = [
+            {
+                name: 'config',
+                type: 'JsonProperty',
+                value: { foo: 'bar' }
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile('./test/unit/ngsi-ld/examples/contextRequests/updateContextJsonProperty.json')
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the json of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+
+    describe('When the IoT Agent receives new list from a device with VocabProperty type', function () {
+        const values = [
+            {
+                name: 'category',
+                type: 'VocabProperty',
+                value: 'actuator'
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile(
+                        './test/unit/ngsi-ld/examples/contextRequests/updateContextVocabProperty.json'
+                    )
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the vocab of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+
+    describe('When the IoT Agent receives new urn from a device with Relationship type', function () {
+        const values = [
+            {
+                name: 'locatedIn',
+                type: 'Relationship',
+                value: 'urn:ngsi-ld:XXX'
+            }
+        ];
+
+        beforeEach(function (done) {
+            nock.cleanAll();
+
+            contextBrokerMock = nock('http://192.168.1.1:1026')
+                .matchHeader('fiware-service', 'smartgondor')
+                .post(
+                    '/ngsi-ld/v1/entityOperations/upsert/?options=update',
+                    utils.readExampleFile('./test/unit/ngsi-ld/examples/contextRequests/updateContextRelationship.json')
+                )
+                .reply(204);
+
+            iotAgentLib.activate(iotAgentConfig, done);
+        });
+
+        it('should change the vocab of the corresponding attribute in the context broker', function (done) {
+            iotAgentLib.update('light1', 'Light', '', values, function (error) {
+                should.not.exist(error);
+                contextBrokerMock.done();
+                done();
+            });
+        });
+    });
+});

package/test/unit/ngsi-ld/ngsiService/subscriptions-test.js

@@ -94,7 +94,7 @@ describe('NGSI-LD - Subscription tests', function () {
     describe('When a client invokes the subscribe() function for device', function () {
         it('should send the appropriate request to the Context Broker', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     should.not.exist(error);
 
                     contextBrokerMock.done();
@@ -105,7 +105,7 @@ describe('NGSI-LD - Subscription tests', function () {
         });
         it('should store the subscription ID in the Device Registry', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
                         should.not.exist(error);
                         should.exist(device);
@@ -131,7 +131,7 @@ describe('NGSI-LD - Subscription tests', function () {
 
         it('should delete the subscription from the CB', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     iotAgentLib.unsubscribe(device, '51c0ac9ed714fb3b37d7d5a8', function (error) {
                         iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
                             contextBrokerMock.done();
@@ -143,7 +143,7 @@ describe('NGSI-LD - Subscription tests', function () {
         });
         it('should remove the id from the subscriptions array', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     iotAgentLib.unsubscribe(device, '51c0ac9ed714fb3b37d7d5a8', function (error) {
                         iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
                             should.not.exist(error);
@@ -169,7 +169,7 @@ describe('NGSI-LD - Subscription tests', function () {
 
         it('should delete the subscription from the CB', function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     iotAgentLib.unregister(device.id, null, 'smartgondor', '/gardens', function (error) {
                         contextBrokerMock.done();
                         done();
@@ -181,7 +181,7 @@ describe('NGSI-LD - Subscription tests', function () {
     describe('When a new notification comes to the IoTAgent', function () {
         beforeEach(function (done) {
             iotAgentLib.getDevice('MicroLight1', null, 'smartgondor', '/gardens', function (error, device) {
-                iotAgentLib.subscribe(device, ['attr_name'], null, function (error) {
+                iotAgentLib.subscribe(device, ['attr_name'], null, 'normalized', function (error) {
                     done();
                 });
             });

package/test/unit/ngsi-ld/ngsiService/unsupported-endpoints-test.js

@@ -108,16 +108,6 @@ describe('NGSI-LD - Unsupported Endpoints', function () {
     });
 
     describe('When accessing an Unsupported Endpoint', function () {
-        it('GET /entities should return a valid NSGI-LD error message', function (done) {
-            const options = {
-                url: 'http://localhost:' + iotAgentConfig.server.port + '/ngsi-ld/v1/entities',
-                method: 'GET'
-            };
-            request(options, function (error, response, body) {
-                response.statusCode.should.equal(501);
-                done();
-            });
-        });
         it('POST /entities should return a valid NSGI-LD error message', function (done) {
             const options = {
                 url: 'http://localhost:' + iotAgentConfig.server.port + '/ngsi-ld/v1/entities',