iobroker.rest-api 2.0.2 → 3.0.0

package/examples/longPolling.js

@@ -25,7 +25,7 @@ class LongPolling {
         this.subscriptions = {
             objects: {},
             states: {},
-            patterns: {}
+            patterns: {},
         };
         this.sid = Date.now() + '_' + Math.round(Math.random() * 10000);
         if (this.options.autoConnect) {
@@ -41,27 +41,30 @@ class LongPolling {
                 setTimeout(() => {
                     Object.keys(this.subscriptions.objects).forEach(id =>
                         fetch(`${IOBROKER_SWAGGER}v1/object/${id}/subscribe?sid=${this.sid}&method=polling`, {
-                            headers: this._getAuthorization()
+                            headers: this._getAuthorization(),
                         })
                             .then(response => response.json())
-                            .catch(error => console.error('Cannot resubscribe: ' + error)));
+                            .catch(error => console.error('Cannot resubscribe: ' + error)),
+                    );
 
                     Object.keys(this.subscriptions.states).forEach(id =>
                         fetch(`${IOBROKER_SWAGGER}v1/state/${id}/subscribe?sid=${this.sid}&method=polling`, {
-                            headers: this._getAuthorization()
+                            headers: this._getAuthorization(),
                         })
                             .then(response => response.json())
-                            .catch(error => console.error('Cannot resubscribe: ' + error)));
+                            .catch(error => console.error('Cannot resubscribe: ' + error)),
+                    );
 
                     Object.keys(this.subscriptions.patterns).forEach(pattern =>
                         fetch(`${IOBROKER_SWAGGER}v1/states/subscribe?sid=${this.sid}&method=polling`, {
                             method: 'POST',
                             cache: 'no-cache',
                             headers: this._getAuthorization('application/json'),
-                            body: JSON.stringify({method: 'polling', pattern})
+                            body: JSON.stringify({ method: 'polling', pattern }),
                         })
                             .then(response => response.json())
-                            .catch(error => console.log('Error: ' + error)));
+                            .catch(error => console.log('Error: ' + error)),
+                    );
 
                     this.options.onConnection && this.options.onConnection(this.isConnected);
                 }, 0);
@@ -74,14 +77,14 @@ class LongPolling {
     _getAuthorization(contentType) {
         if (this.options.user) {
             const headers = {
-                Authorization: 'Basic ' + btoa(this.options.user + ':' + this.options.password)
+                Authorization: 'Basic ' + btoa(this.options.user + ':' + this.options.password),
             };
             if (contentType) {
-                headers['Content-Type'] =  'application/json';
+                headers['Content-Type'] = 'application/json';
             }
             return headers;
         } else if (contentType) {
-            return {'Content-Type': 'application/json'};
+            return { 'Content-Type': 'application/json' };
         } else {
             return undefined;
         }
@@ -93,13 +96,16 @@ class LongPolling {
             // in real the re-connect interval will be added the timeout for fetch which depends on browser.
             this.options.onConnectionAttempt && this.options.onConnectionAttempt(this.options.reconnectInterval);
         }
-        const controller = new AbortController()
+        const controller = new AbortController();
         let timeoutId = setTimeout(() => controller.abort(), this.options.pollingInterval + 1000);
 
-        fetch(`${this.host}v1/polling?sid=${this.sid}${isStart ? `&connect&timeout=${this.options.pollingInterval}` : ''}`, {
-            signal: controller.signal,
-            headers: this._getAuthorization(),
-        })
+        fetch(
+            `${this.host}v1/polling?sid=${this.sid}${isStart ? `&connect&timeout=${this.options.pollingInterval}` : ''}`,
+            {
+                signal: controller.signal,
+                headers: this._getAuthorization(),
+            },
+        )
             .then(response => {
                 timeoutId && clearTimeout(timeoutId);
                 timeoutId = null;
@@ -147,7 +153,7 @@ class LongPolling {
                                             console.log('Cannot call handler: ' + error);
                                         }
                                     });
-                                })
+                                });
                             }
                         } else if (data.id && data.obj) {
                             if (this.subscriptions.objects[data.id]) {
@@ -159,7 +165,7 @@ class LongPolling {
                                             console.log('Cannot call handler: ' + error);
                                         }
                                     });
-                                })
+                                });
                             }
                         } else if (data.id) {
                             // state and object where deleted
@@ -172,7 +178,7 @@ class LongPolling {
                                             console.log('Cannot call handler: ' + error);
                                         }
                                     });
-                                })
+                                });
                             } else if (this.subscriptions.state[data.id]) {
                                 setTimeout(() => {
                                     this.subscriptions.state[data.id].forEach(cb => {
@@ -182,7 +188,7 @@ class LongPolling {
                                             console.log('Cannot call handler: ' + error);
                                         }
                                     });
-                                })
+                                });
                             }
                         }
                     }
@@ -202,26 +208,26 @@ class LongPolling {
                 this._sendConnectedEvent(false);
 
                 if (!this.terminate) {
-                    this.connecTimeout = this.connecTimeout || setTimeout(() => {
-                        this.connecTimeout = null;
-                        this._longPolling(true);
-                    }, this.options.reconnectInterval);
+                    this.connecTimeout =
+                        this.connecTimeout ||
+                        setTimeout(() => {
+                            this.connecTimeout = null;
+                            this._longPolling(true);
+                        }, this.options.reconnectInterval);
                 }
             });
     }
 
     getState(id) {
         return fetch(`${IOBROKER_SWAGGER}v1/state/${id}`, {
-            headers: this._getAuthorization()
-        })
-            .then(response => response.json())
+            headers: this._getAuthorization(),
+        }).then(response => response.json());
     }
 
     getObject(id) {
         return fetch(`${IOBROKER_SWAGGER}v1/object/${id}`, {
-            headers: this._getAuthorization()
-        })
-            .then(response => response.json())
+            headers: this._getAuthorization(),
+        }).then(response => response.json());
     }
 
     subscribeState(id, cb) {
@@ -229,9 +235,8 @@ class LongPolling {
             this.subscriptions.states[id] = [];
             this.subscriptions.states[id].push(cb);
             return fetch(`${IOBROKER_SWAGGER}v1/state/${id}/subscribe?sid=${this.sid}&method=polling`, {
-                headers: this._getAuthorization()
-            })
-                .then(response => response.json());
+                headers: this._getAuthorization(),
+            }).then(response => response.json());
         } else {
             this.subscriptions.states[id].push(cb);
             return Promise.resolve();
@@ -246,7 +251,7 @@ class LongPolling {
                 method: 'POST',
                 cache: 'no-cache',
                 headers: this._getAuthorization('application/json'),
-                body: JSON.stringify({method: 'polling', pattern})
+                body: JSON.stringify({ method: 'polling', pattern }),
             })
                 .then(response => response.json())
                 .catch(error => console.log('Error: ' + error));
@@ -275,9 +280,8 @@ class LongPolling {
                     method: 'POST',
                     cache: 'no-cache',
                     headers: this._getAuthorization('application/json'),
-                    body: JSON.stringify({method: 'polling', pattern})
-                })
-                    .then(response => response.json());
+                    body: JSON.stringify({ method: 'polling', pattern }),
+                }).then(response => response.json());
             }
         } else {
             return Promise.resolve();
@@ -300,9 +304,8 @@ class LongPolling {
                     delete this.subscriptions.states[id];
                 }
                 return fetch(`${IOBROKER_SWAGGER}v1/state/${id}/unsubscribe?sid=${this.sid}&method=polling`, {
-                    headers: this._getAuthorization()
-                })
-                    .then(response => response.json());
+                    headers: this._getAuthorization(),
+                }).then(response => response.json());
             }
         } else {
             return Promise.resolve();
@@ -314,9 +317,8 @@ class LongPolling {
             this.subscriptions.objects[id] = [];
             this.subscriptions.objects[id].push(cb);
             return fetch(`${IOBROKER_SWAGGER}v1/object/${id}/subscribe?sid=${this.sid}&method=polling`, {
-                headers: this._getAuthorization()
-            })
-                .then(response => response.json());
+                headers: this._getAuthorization(),
+            }).then(response => response.json());
         } else {
             this.subscriptions.objects[id].push(cb);
             return Promise.resolve();
@@ -339,9 +341,8 @@ class LongPolling {
                     delete this.subscriptions.objects[id];
                 }
                 return fetch(`${IOBROKER_SWAGGER}v1/object/${id}/unsubscribe?sid=${this.sid}&method=polling`, {
-                    headers: this._getAuthorization()
-                })
-                    .then(response => response.json());
+                    headers: this._getAuthorization(),
+                }).then(response => response.json());
             }
         } else {
             return Promise.resolve();

package/io-package.json

@@ -1,9 +1,22 @@
 {
   "common": {
     "name": "rest-api",
-    "version": "2.0.2",
+    "version": "3.0.0",
     "news": {
-      "2.0.2": {
+      "3.0.0": {
+        "en": "Rewritten in TypeScript\nRemoved binary states",
+        "de": "Neu geschrieben in TypeScript\nEntfernte binäre Zustände",
+        "ru": "Переписано в TypeScript\nУдаленные бинарные состояния",
+        "pt": "Reescrito em TypeScript\nEstados binários removidos",
+        "nl": "Herschreven in TypeScript\nBinaire toestanden verwijderd",
+        "fr": "Réécrit dans TypeScript\nÉtats binaires supprimés",
+        "it": "Rescritto in TypeScript\nStati binari rimossi",
+        "es": "Reescrito en TipoScript\nEstados binarios eliminados",
+        "pl": "Przepisane w TypeScript\nUsunięte stany binarne",
+        "uk": "Записатися в TypeScript\nВилучені бінарні штати",
+        "zh-cn": "在类型脚本中重写\n删除二进制状态"
+      },
+      "2.0.3": {
         "en": "Changed response for the endpoint get states to the dictionary in swagger",
         "de": "Geänderte Antwort für den Endpunkt erhalten Zustände zum Wörterbuch in Swagger",
         "ru": "Измененный ответ для конечной точки получить состояния в словарь в swagger",
@@ -29,19 +42,6 @@
         "uk": "сайт: www.iobroker.com й\nВиправлені запити історії\nМінімальний необхідний вузол.js версія 16",
         "zh-cn": "移植到 xqio 经纪人/网络服务器 `\n固定历史请求\n最低要求的节点.js版本为16"
       },
-      "2.0.0": {
-        "en": "Fixed history requests\nMinimum required node.js version is 16",
-        "de": "Geschichtsanfragen behoben\nMinimum erforderlich node.js Version ist 16",
-        "ru": "Исправленные просьбы об истории\nМинимальная требуемая версия node.js - 16",
-        "pt": "Pedidos de histórico fixo\nA versão mínima necessária do node.js é 16",
-        "nl": "Vaste historische verzoeken\nMinimum vereiste node.js versie is 16",
-        "fr": "Demande d'historique fixe\nLa version minimum requise node.js est 16",
-        "it": "Risolte richieste di storia\nVersione minima richiesta node.js è 16",
-        "es": "Solicitudes de historia fija\nLa versión mínima requerida node.js es 16",
-        "pl": "Poprawione żądania dotyczące historii\nMinimalna wymagana node.js wersja jest 16",
-        "uk": "Виправлені запити історії\nМінімальний необхідний вузол.js версія 16",
-        "zh-cn": "固定历史请求\n最低要求的节点.js版本为16"
-      },
       "1.1.0": {
         "en": "Converting of the setState values to the according type\nImplemented file operations",
         "de": "Umrechnung der setState-Werte in den entsprechenden Typ\nImplementierung von Dateioperationen",
@@ -78,24 +78,22 @@
         "it": "Controllare se la porta è occupata solo su interfaccia definita",
         "es": "Compruebe si el puerto está ocupado sólo en la interfaz definida",
         "pl": "Jeśli port jest zajęty tylko na określonym interfejsie",
+        "uk": "Перевірте, чи порт зайнятий лише на визначеному інтерфейсі",
         "zh-cn": "如果港口只在界定的界线上被占有,则该港口将被扣押。"
-      },
-      "1.0.2": {
-        "en": "Implemented binary read/write operations",
-        "de": "Implementierung binärer Schreib-/Lesevorgänge",
-        "ru": "Внедренные бинарные чтения / записи операции",
-        "pt": "Operações de leitura/escrita binárias implementadas",
-        "nl": "Geïmplementeerde binaire las/schrijf operaties",
-        "fr": "Opérations de lecture/écriture binaires mises en œuvre",
-        "it": "Operazioni di lettura/scrittura binarie implementate",
-        "es": "Operaciones de lectura y escritura binarias aplicadas",
-        "pl": "Poprawianie binarnego odczytu/pisania operacji",
-        "zh-cn": "执行本文的文字/仪式作业"
       }
     },
-    "title": "REST API",
     "titleLang": {
-      "en": "REST API"
+      "en": "REST API",
+      "de": "REST API",
+      "ru": "REST API",
+      "pt": "REST API",
+      "nl": "REST API",
+      "fr": "REST API",
+      "it": "REST API",
+      "es": "REST API",
+      "pl": "REST API",
+      "uk": "REST API",
+      "zh-cn": "REST API"
     },
     "desc": {
       "en": "This adapter allows to read and write ioBroker objects and state with web RESTful API and Swagger UI",
@@ -107,6 +105,7 @@
       "it": "Questo adattatore consente di leggere e scrivere oggetti ioBroker e lo stato con l'API RESTful Web e l'interfaccia utente di Swagger",
       "es": "Este adaptador permite leer y escribir objetos y estados ioBroker con la API RESTful web y la interfaz de usuario Swagger",
       "pl": "Ten adapter pozwala na odczyt i zapis obiektów ioBroker oraz ich stan za pomocą web RESTful API i Swagger UI",
+      "uk": "Цей адаптер дозволяє читати та записувати об'єкти ioBroker та стан з веб RESTful API та Swagger UI",
       "zh-cn": "该适配器允许使用Web RESTful API和Swagger UI读写ioBroker对象和状态"
     },
     "authors": [
@@ -117,9 +116,8 @@
     "connectionType": "local",
     "dataSource": "push",
     "loglevel": "info",
-    "icon": "rest-api.png",
+    "icon": "rest-api.svg",
     "compact": true,
-    "materialize": true,
     "webExtension": "lib/rest-api.js",
     "readme": "https://github.com/ioBroker/ioBroker.rest-api/blob/master/README.md",
     "keywords": [
@@ -130,10 +128,15 @@
       "communication"
     ],
     "enabled": true,
-    "extIcon": "https://raw.githubusercontent.com/ioBroker/ioBroker.rest-api/master/admin/rest-api.png",
+    "extIcon": "https://raw.githubusercontent.com/ioBroker/ioBroker.rest-api/master/admin/rest-api.svg",
     "type": "communication",
     "stopBeforeUpdate": true,
-    "localLink": "%protocol%://%ip%:%port%/",
+    "localLinks": {
+      "_default": {
+        "link": "%protocol%://%ip%:%port%/",
+        "intro": true
+      }
+    },
     "adminUI": {
       "config": "json"
     },
@@ -142,9 +145,14 @@
       "license": "Apache-2.0"
     },
     "tier": 3,
+    "globalDependencies": [
+      {
+        "admin": ">=7.4.10"
+      }
+    ],
     "dependencies": [
       {
-        "js-controller": ">=4.0.0"
+        "js-controller": ">=5.0.19"
       }
     ],
     "plugins": {
@@ -162,6 +170,7 @@
     "certPrivate": "",
     "certChained": "",
     "defaultUser": "admin",
+    "ttl": 3600,
     "onlyAllowWhenUserIsOwner": false,
     "webInstance": "",
     "leEnabled": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.rest-api",
-  "version": "2.0.2",
+  "version": "3.0.0",
   "description": "RESTful interface for ioBroker with GUI.",
   "author": {
     "name": "bluefox",
@@ -15,60 +15,72 @@
     "web"
   ],
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/ioBroker/ioBroker.rest-api"
   },
   "dependencies": {
-    "@iobroker/adapter-core": "^3.1.6",
-    "@iobroker/socket-classes": "^1.5.6",
-    "@iobroker/webserver": "^1.0.3",
-    "axios": "^1.7.2",
-    "body-parser": "^1.20.2",
+    "@iobroker/adapter-core": "^3.2.3",
+    "@iobroker/socket-classes": "^2.2.16",
+    "@iobroker/webserver": "^1.2.7",
+    "@iobroker/ws-server": "^4.3.7",
+    "@iobroker/js-controller-common-db": "^7.0.7",
+    "axios": "^1.9.0",
+    "body-parser": "^2.2.0",
+    "cookie-parser": "^1.4.7",
     "cors": "^2.8.5",
-    "express": "^4.19.2",
-    "multer": "^1.4.5-lts.1",
+    "express": "^4.21.2",
+    "multer": "^1.4.5-lts.2",
     "swagger-node-runner-fork": "^0.8.0",
     "swagger-ui-express": "^5.0.1",
     "yamljs": "^0.3.0"
   },
   "devDependencies": {
-    "@alcalzone/release-script": "^3.7.3",
+    "@alcalzone/release-script": "^3.8.0",
     "@alcalzone/release-script-plugin-iobroker": "^3.7.2",
     "@alcalzone/release-script-plugin-license": "^3.7.0",
-    "@iobroker/adapter-dev": "^1.3.0",
-    "@iobroker/testing": "^4.1.3",
-    "chai": "^4.4.1",
-    "eslint-plugin-eqeqeq-fix": "^1.0.3",
-    "eslint-plugin-only-warn": "^1.1.0",
-    "eslint-plugin-react": "^7.34.3",
-    "gulp": "^4.0.2",
-    "mocha": "^10.6.0"
+    "@iobroker/adapter-dev": "^1.4.0",
+    "@iobroker/eslint-config": "^2.0.1",
+    "@iobroker/testing": "^5.0.4",
+    "@iobroker/types": "^7.0.7",
+    "@types/body-parser": "^1.19.5",
+    "@types/cookie-parser": "^1.4.8",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/multer": "^1.4.12",
+    "@types/node": "^22.15.2",
+    "@types/swagger-node-runner": "^0.6.6",
+    "@types/swagger-ui-express": "^4.1.8",
+    "@types/yamljs": "^0.2.34",
+    "typescript": "^5.8.3"
   },
   "bugs": {
     "url": "https://github.com/ioBroker/ioBroker.rest-api/issues"
   },
-  "main": "main.js",
+  "main": "dist/main.js",
   "files": [
     "admin/",
     "img/",
-    "lib/",
+    "dist/",
     "examples/",
     "LICENSE",
-    "main.js",
     "io-package.json"
   ],
   "scripts": {
-    "build": "gulp",
-    "test": "node node_modules/mocha/bin/mocha --exit",
+    "build": "npm run build:ts && node tasks --copy-yaml",
+    "build:all": "npm run build:ts && node tasks",
+    "build:ts": "tsc -p tsconfig.build.json",
+    "test": "mocha --exit",
     "release": "release-script",
     "release-patch": "release-script patch --yes --no-update-lockfile",
     "release-minor": "release-script minor --yes --no-update-lockfile",
     "release-major": "release-script major --yes --no-update-lockfile",
     "translate": "translate-adapter",
-    "update-packages": "ncu --upgrade"
+    "update-packages": "npx -y npm-check-updates --upgrade",
+    "npm": "npm i",
+    "lint": "eslint -c eslint.config.mjs"
   },
   "license": "Apache-2.0"
 }

package/lib/api/controllers/common.js

@@ -1,150 +0,0 @@
-const ERROR_PERMISSION = 'permissionError';
-
-function checkPermissions(adapter, user, requiredRights, callback) {
-    adapter.calculatePermissions(user, requiredRights, acl => {
-        if (user !== 'system.user.admin') {
-            // type: file, object, state, other
-            // operation: create, read, write, list, delete, sendto, execute, sendto
-            if (requiredRights && requiredRights[0] && acl) {
-                // If permission required
-                if (requiredRights[0].type) {
-                    if (acl[requiredRights[0].type] &&
-                        acl[requiredRights[0].type][requiredRights[0].operation]) {
-                        return callback(null);
-                    }
-                } else {
-                    return callback(null);
-                }
-            }
-
-            adapter.log.warn(`No permission for "${user}" to call ${JSON.stringify(requiredRights)}`);
-
-            callback(ERROR_PERMISSION);
-        } else {
-            return callback(null);
-        }
-    });
-}
-
-function findState(adapter, idOrName, user, type, callback) {
-    if (typeof type === 'function') {
-        callback = type;
-        type = null;
-    }
-    adapter.findForeignObject(idOrName, type, {user, checked: true, limitToOwnerRights: adapter.config.onlyAllowWhenUserIsOwner}, callback);
-}
-
-function getState(adapter, idOrName, user, type, callback) {
-    if (typeof type === 'function') {
-        callback = type;
-        type = null;
-    }
-    findState(adapter, idOrName, user, type, (err, id, originId) => {
-        if (err && (!err.message || !err.message.includes('permissionError'))) {
-            callback && callback(err, undefined, null, originId);
-        } else {
-            if (err && err.message.includes('permissionError')) {
-                // assume it is ID
-                id = idOrName;
-            }
-            if (id) {
-                adapter.getForeignState(id, {user, limitToOwnerRights: adapter.config.onlyAllowWhenUserIsOwner}, (err, state) => {
-                    if (err || !state) {
-                        state = undefined;
-                    }
-                    callback && callback (err, state, id, originId);
-                });
-            } else {
-                callback && callback(null, undefined, null, originId);
-            }
-        }
-    });
-}
-
-function getBinaryState(adapter, idOrName, user, type, callback) {
-    if (typeof type === 'function') {
-        callback = type;
-        type = null;
-    }
-    findState(adapter, idOrName, user, type, (err, id, originId) => {
-        if (err && (!err.message || !err.message.includes('permissionError'))) {
-            callback && callback(err, undefined, null, originId);
-        } else {
-            if (err && err.message.includes('permissionError')) {
-                // assume it is ID
-                id = idOrName;
-            }
-            if (id) {
-                if (adapter.getForeignBinaryState) {
-                    adapter.getForeignBinaryState(id, {user, limitToOwnerRights: adapter.config.onlyAllowWhenUserIsOwner}, (err, binary) => {
-                        if (err) {
-                            binary = undefined;
-                        }
-                        callback && callback (err, binary, id, originId);
-                    });
-                } else {
-                    adapter.getBinaryState(id, {user, limitToOwnerRights: adapter.config.onlyAllowWhenUserIsOwner}, (err, binary) => {
-                        if (err) {
-                            binary = undefined;
-                        }
-                        callback && callback (err, binary, id, originId);
-                    });
-                }
-            } else {
-                callback && callback(null, undefined, null, originId);
-            }
-        }
-    });
-}
-
-function parseUrl(url, swagger, webExtensionPrefix) {
-    // "/v1/object/adapter.system.admin.0.alive"
-    const parts = url.split('?')[0].split('/');
-    if (parts[1] === webExtensionPrefix) {
-        parts.shift(); // /
-        parts.shift(); // remove swagger
-        parts.shift(); // remove v1
-        parts.shift(); // remove objects or states
-    } else {
-        parts.shift(); // /
-        parts.shift(); // remove v1
-        parts.shift(); // remove objects or states
-    }
-    const result = {};
-    if (swagger && swagger.operation && swagger.operation.parameters) {
-        let i = 0;
-        swagger.operation.parameters.forEach(param => {
-            if (param.in === 'path') {
-                result[param.name] = parts[i] !== undefined ? decodeURIComponent(parts[i]) : '';
-                i++;
-            }
-        });
-    } else {
-        parts.forEach((param, i) =>
-            result['arg' + i] = decodeURIComponent(param));
-    }
-
-    return result;
-}
-
-function errorResponse(req, res, error, response) {
-    error = error.toString();
-    if (error === 'Error: permissionError') {
-        error = 'permissionError';
-    }
-
-    req._adapter.log.warn(`Warning by "${req.url}": ${error}`);
-
-    res
-        .status(error.toString().includes('permissionError') ? 403 : 500)
-        .json(Object.assign(response || {}, {error: error}));
-}
-
-module.exports = {
-    checkPermissions,
-    findState,
-    getState,
-    getBinaryState,
-    parseUrl,
-    errorResponse,
-};

package/lib/api/controllers/enum.js

@@ -1,44 +0,0 @@
-'use strict';
-const commonLib = require('./common.js');
-
-module.exports = {
-    readMainEnums: function (req, res) {
-        commonLib.checkPermissions(req._adapter, req._user, [{type: 'object', operation: 'read'}],  async error => {
-            if (error) {
-                commonLib.errorResponse(req, res, error);
-            } else {
-                // check if instance is alive
-                try {
-                    const enums = await req._adapter.getEnumsAsync('', {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
-                    res.json(enums);
-                } catch (error) {
-                    req._adapter.log.warn(`Cannot read enums: ${error}`);
-                    commonLib.errorResponse(req, res, error);
-                }
-            }
-        });
-    },
-    readEnums: function (req, res) {
-        commonLib.checkPermissions(req._adapter, req._user, [{type: 'object', operation: 'read'}],  async error => {
-            if (error) {
-                commonLib.errorResponse(req, res, error);
-            } else {
-                const params = commonLib.parseUrl(req.url, req.swagger, req._adapter.WEB_EXTENSION_PREFIX);
-                // check if instance is alive
-                try {
-                    const enums = await req._adapter.getEnumAsync(params.enumId, {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
-                    if (enums && enums.result) {
-                        res.json(Object.keys(enums.result).filter(id => id.split('.').length > 2).map(id => ({
-                            _id: id,
-                            common: enums.result[id].common
-                        })));
-                    } else {
-                        res.json([]);
-                    }
-                } catch (error) {
-                    commonLib.errorResponse(req, res, error);
-                }
-            }
-        });
-    },
-};