iobroker.rest-api 1.0.4 → 1.1.0

package/README.md

@@ -9,11 +9,11 @@
 
 **This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.** For more details and for information how to disable the error reporting see [Sentry-Plugin Documentation](https://github.com/ioBroker/plugin-sentry#plugin-sentry)! Sentry reporting is used starting with js-controller 3.0.
 
-This is RESTFul interface to read the objects and states from ioBroker and to write/control the states over HTTP Get/Post requests.
+This is a RESTFul interface to read the objects and states from ioBroker and to write/control the states over HTTP Get/Post requests.
 
 The purpose of this adapter is similar to simple-api. But this adapter supports long-polling and URL hooks for subscribes.
 
-It has very useful web interface to play with the requests:
+It has a very useful web interface to play with the requests:
 
 ![Screenshot](img/screen.png)
 
@@ -24,22 +24,22 @@ Some request examples:
 - `http://ipaddress:8093/v1/state/system.adapter.rest-api.0.memHeapTotal` - read state as JSON
 - `http://ipaddress:8093/v1/state/system.adapter.rest-api.0.memHeapTotal/plain` - read state as string (only value)
 - `http://ipaddress:8093/v1/state/system.adapter.rest-api.0.memHeapTotal?value=5` - write state with GET (only for back compatibility with simple-api)
-- `http://ipaddress:8093/v1/sendto/javascript.0?message=toScript&data={"message":"MESSAGE","data":"FROM REST-API"}` - send message to javascript.0 in script `scriptName`
+- `http://ipaddress:8093/v1/sendto/javascript.0?message=toScript&data={"message":"MESSAGE","data":"FROM REST-API"}` - send a message to javascript.0 in script `scriptName`
 
-## Subscribe on state or object changes
+## Subscribe to the state's or object's changes
 Your application could get notifications by every change of the state or object.
 
-For that your application must provide an HTTP(S) end-point to accept the updates.
+For that, your application must provide an HTTP(S) end-point to accept the updates.
 
 Example in node.js see here [demoNodeClient.js](examples/demoNodeClient.js)
 
 ## Long polling
-This adapter supports subscribe on data changes via long polling. 
+This adapter supports a subscribing on data changes via long polling. 
 
 Example for browser could be found here: [demoNodeClient.js](examples/demoBrowserClient.html)  
 
 ## Web extension
-This adapter can run as web-extension. In this case the path is available under http://iipaddress:8082/rest
+This adapter can run as a web extension. In this case, the path is available under http://iipaddress:8082/rest
 
 ## Notice
 - `POST` is always for creating a resource (does not matter if it was duplicated)
@@ -73,6 +73,7 @@ You cannot send POST request to commands via GUI.
 <!-- START -->
 ### States
 - `getStates(pattern)` - get the list of states for pattern (e.g. for system.adapter.admin.0.*). GUI can have problems by visualization of answer.
+- `getForeignStates(pattern)` - same as getStates
 - `getState(id)` - get state value by ID
 - `setState(id, state)` - set state value with JSON object (e.g. `{"val": 1, "ack": true}`)
 - `getBinaryState(id)` - get binary state by ID
@@ -126,7 +127,6 @@ You cannot send POST request to commands via GUI.
 - `getAllObjects()` - read all objects as list. GUI can have problems by visualization of answer.
 - `extendObject(id, obj)` - modify object by ID with JSON. (.e.g. `{"common":{"enabled": true}}`) 
 - `getForeignObjects(pattern, type)` - same as getObjects
-- `getForeignStates(pattern)` - same as getStates
 - `delObjects(id, options)` - delete objects by pattern
 
 ### Others
@@ -142,15 +142,19 @@ You cannot send POST request to commands via GUI.
 
 <!-- END -->
 
-## Todo
-- [ ] Implement GET,PATCH,POST,DELETE file operations
-
 <!--
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
 
 ## Changelog
+### 1.1.0 (2023-05-03)
+* (bluefox) Converting of the setState values to the according type
+* (bluefox) Implemented file operations
+
+### 1.0.5 (2023-03-27)
+* (Apollon77) Prepare for future js-controller versions
+
 ### 1.0.4 (2022-08-31)
 * (bluefox) Check if the port is occupied only on defined interface
 
@@ -190,4 +194,4 @@ You cannot send POST request to commands via GUI.
 ## License
 Apache 2.0
 
-Copyright (c) 2017-2022 bluefox <dogafox@gmail.com>
+Copyright (c) 2017-2023 bluefox <dogafox@gmail.com>

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "rest-api",
-    "version": "1.0.4",
+    "version": "1.1.0",
     "news": {
+      "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",
+        "ru": "Преобразование значений setState в согласно типу\nРеализованные файловые операции",
+        "pt": "Convertendo dos valores setState para o tipo de acordo\nOperações de arquivo implementadas",
+        "nl": "Omkeren van de setstate waarden naar het type\nGeïmplementeerde bestand operaties",
+        "fr": "Conversion des valeurs déterminées de l'état dans le type suivant\nOpérations de fichiers mises en œuvre",
+        "it": "Convertizione dei valori setState secondo il tipo\nOperazioni di file implementate",
+        "es": "Convertir los valores establecidos en el tipo\nOperaciones de archivo aplicadas",
+        "pl": "Przetłumaczył wartości zbioru zgodnie z typem\nImplementacja",
+        "uk": "Перетворення значень setState до за типом\nРеалізовані операції файлів",
+        "zh-cn": "避免按类型划分国家数值\n执行档案业务"
+      },
+      "1.0.5": {
+        "en": "Prepare for future js-controller versions",
+        "de": "Bereiten Sie sich auf zukünftige js-Controller-Versionen",
+        "ru": "Подготовьтесь к будущим версиям js-controller",
+        "pt": "Prepare-se para futuras versões js-controller",
+        "nl": "Bereid je voor op toekomstige Js-controller versie",
+        "fr": "Préparez-vous pour les versions futures de js-controller",
+        "it": "Prepararsi per le future versioni js-controller",
+        "es": "Prepararse para futuras versiones js-controller",
+        "pl": "Prepare for future js-controller version",
+        "uk": "Підготовка до майбутніх версій js-controller",
+        "zh-cn": "今后防污版本的编制"
+      },
       "1.0.4": {
         "en": "Check if the port is occupied only on defined interface",
         "de": "Überprüfen Sie, ob der Port nur auf definierter Schnittstelle besetzt ist",
@@ -62,30 +88,6 @@
         "es": "Ruta de envío agregada",
         "pl": "Dodano ścieżkę sendTo",
         "zh-cn": "添加了 sendTo 路径"
-      },
-      "0.5.0": {
-        "en": "Some access errors were corrected",
-        "de": "Einige Zugriffsfehler wurden behoben",
-        "ru": "Исправлены некоторые ошибки доступа",
-        "pt": "Alguns erros de acesso foram corrigidos",
-        "nl": "Sommige toegangsfouten zijn gecorrigeerd",
-        "fr": "Certaines erreurs d'accès ont été corrigées",
-        "it": "Alcuni errori di accesso sono stati corretti",
-        "es": "Se corrigieron algunos errores de acceso",
-        "pl": "Poprawiono niektóre błędy dostępu",
-        "zh-cn": "一些访问错误已得到纠正"
-      },
-      "0.4.0": {
-        "en": "Added socket commands",
-        "de": "Socket-Befehle hinzugefügt",
-        "ru": "Добавлены команды сокета",
-        "pt": "Comandos de soquete adicionados",
-        "nl": "Socket-opdrachten toegevoegd",
-        "fr": "Commandes de socket ajoutées",
-        "it": "Aggiunti comandi socket",
-        "es": "Comandos de socket agregados",
-        "pl": "Dodano polecenia dotyczące gniazd",
-        "zh-cn": "添加了套接字命令"
       }
     },
     "title": "REST API",

package/lib/api/controllers/file.js

@@ -0,0 +1,74 @@
+'use strict';
+const commonLib = require('./common.js');
+
+module.exports = {
+    readFile: function (req, res) {
+        commonLib.checkPermissions(req._adapter, req._user, [{type: 'file', 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);
+                try {
+                    const data = await req._adapter.readFileAsync(params.objectId, params.fileName, {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
+                    if (data && data.mimeType) {
+                        res.set('Content-Type', data.mimeType);
+                        res.send(data.file);
+                    } else {
+                        res.status(404).send(Buffer.from(''));
+                    }
+                } catch (error) {
+                    commonLib.errorResponse(req, res, error);
+                }
+            }
+        });
+    },
+    deleteFile: function (req, res) {
+        commonLib.checkPermissions(req._adapter, req._user, [{type: 'file', operation: 'delete'}],  async error => {
+                if (error) {
+                    commonLib.errorResponse(req, res, error);
+                } else {
+                    const params = commonLib.parseUrl(req.url, req.swagger, req._adapter.WEB_EXTENSION_PREFIX);
+                    try {
+                        await req._adapter.delFileAsync(params.objectId, params.fileName, {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
+                        res.json({success: true});
+                    } catch (err) {
+                        if (err.toString().includes('Not exists')) {
+                            res.status(404).json({error: err.toString()});
+                        } else {
+                            commonLib.errorResponse(req, res, err);
+                        }
+                    }
+                }
+        });
+    },
+    writeFile: function (req, res) {
+        commonLib.checkPermissions(req._adapter, req._user, [{type: 'file', operation: 'write'}],  async error => {
+            if (error) {
+                commonLib.errorResponse(req, res, error);
+            } else {
+                const params = commonLib.parseUrl(req.url, req.swagger, req._adapter.WEB_EXTENSION_PREFIX);
+                try {
+                    await req._adapter.writeFileAsync(params.objectId, params.fileName, req.files.file[0].buffer, {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
+                    res.json({success: true});
+                } catch (err) {
+                    commonLib.errorResponse(req, res, err);
+                }
+            }
+        });
+    },
+    readDir: function (req, res) {
+        commonLib.checkPermissions(req._adapter, req._user, [{type: 'file', operation: 'list'}],  async error => {
+            if (error) {
+                commonLib.errorResponse(req, res, error);
+            } else {
+                const params = commonLib.parseUrl(req.url, req.swagger, req._adapter.WEB_EXTENSION_PREFIX);
+                try {
+                    const response = await req._adapter.readDirAsync(params.objectId, params.dirName || '', {user: req._user, limitToOwnerRights: req._adapter.config.onlyAllowWhenUserIsOwner});
+                    res.json(response);
+                } catch (err) {
+                    commonLib.errorResponse(req, res, err);
+                }
+            }
+        });
+    },
+};

package/lib/api/swagger/swagger.yaml

@@ -2,7 +2,7 @@
 swagger: "2.0"
 info:
   description: "This is a REST server for ioBroker."
-  version: "1.0.4"
+  version: "1.1.0"
   title: "ioBroker Swagger UI"
   contact:
     email: "admin@iobroker.net"
@@ -28,6 +28,8 @@ tags:
     description: "Socket commands"
   - name: "sendTo"
     description: "Send message to instance"
+  - name: "file"
+    description: "Read/Write files and directories"
 securityDefinitions:
   basicAuth:
     type: basic
@@ -625,9 +627,7 @@ paths:
         200:
           description: "successful operation"
           schema:
-            type: array
-            items:
-              $ref: "#/definitions/Object"
+            $ref: "#/definitions/ObjectArray"
         404:
           description: "URL or session not found"
         422:
@@ -997,8 +997,136 @@ paths:
           description: "Invalid state ID supplied"
         500:
           description: "instance is offline"
+  /file/{objectId}/{fileName}:
+    x-swagger-router-controller: file
+    get:
+      tags:
+        - "file"
+      summary: "Reads file"
+      operationId: "readFile"
+      produces:
+        - "application/octet-stream"
+      parameters:
+        - name: "objectId"
+          in: "path"
+          description: "Object ID, like vis.0"
+          type: "string"
+          required: true
+        - name: "fileName"
+          in: "path"
+          description: "File name, like main/vis-views.json"
+          type: "string"
+          required: true
+      responses:
+        200:
+          description: "successful operation"
+        404:
+          description: "File not found"
+    post:
+      tags:
+        - "file"
+      summary: "Writes file"
+      operationId: "writeFile"
+      produces:
+        - "application/json"
+      consumes:
+        - "multipart/form-data"
+      parameters:
+        - name: "objectId"
+          in: "path"
+          description: "Object ID, like vis.0"
+          type: "string"
+          required: true
+        - name: "fileName"
+          in: "path"
+          description: "File name, like main/vis-views.json"
+          type: "string"
+          required: true
+        - name: "file"
+          in: "formData"
+          description: "File content"
+          required: true
+          type: "file"
+      responses:
+        200:
+          description: "successful operation"
+        404:
+          description: "File not found"
+    delete:
+      tags:
+        - "file"
+      summary: "deletes file"
+      operationId: "deleteFile"
+      produces:
+        - "application/json"
+      parameters:
+        - name: "objectId"
+          in: "path"
+          description: "Object ID, like vis.0"
+          type: "string"
+          required: true
+        - name: "fileName"
+          in: "path"
+          description: "File name, like main/vis-views.json"
+          type: "string"
+          required: true
+      responses:
+        200:
+          description: "successful operation"
+        404:
+          description: "File not found"
+  /dir/{objectId}/{dirName}:
+    x-swagger-router-controller: file
+    get:
+      tags:
+        - "file"
+      summary: "List directory"
+      operationId: "readDir"
+      produces:
+        - "application/json"
+      parameters:
+        - name: "objectId"
+          in: "path"
+          description: "Object ID, like vis.0"
+          type: "string"
+          required: true
+        - name: "dirName"
+          in: "path"
+          description: "File name, like main/vis-views.json"
+          type: "string"
+          required: true
+      responses:
+        200:
+          description: "successful operation"
+          schema:
+            $ref: "#/definitions/DirResponse"
+        404:
+          description: "File not found"
+  /dir/{objectId}:
+    x-swagger-router-controller: file
+    get:
+      tags:
+        - "file"
+      summary: "List directory"
+      operationId: "readDir"
+      produces:
+        - "application/json"
+      parameters:
+        - name: "objectId"
+          in: "path"
+          description: "Object ID, like vis.0"
+          type: "string"
+          required: true
+      responses:
+        200:
+          description: "successful operation"
+          schema:
+            $ref: "#/definitions/DirResponse"
+        404:
+          description: "File not found"
 
-# commands start
+
+  # commands start
   /command/getStates:
     get:
       tags:
@@ -1016,6 +1144,23 @@ paths:
       responses:
         200:
           description: "successful operation"
+  /command/getForeignStates:
+    get:
+      tags:
+        - "commands"
+      summary: "same as getStates"
+      produces:
+        - "application/json"
+      parameters:
+
+        - name: "pattern"            
+          in: "query"
+          description: ""
+          type: "string"
+          required: true        
+      responses:
+        200:
+          description: "successful operation"
   /command/getState:
     get:
       tags:
@@ -1959,23 +2104,6 @@ paths:
       responses:
         200:
           description: "successful operation"
-  /command/getForeignStates:
-    get:
-      tags:
-        - "commands"
-      summary: "same as getStates"
-      produces:
-        - "application/json"
-      parameters:
-
-        - name: "pattern"            
-          in: "query"
-          description: ""
-          type: "string"
-          required: true        
-      responses:
-        200:
-          description: "successful operation"
   /command/delObjects:
     get:
       tags:
@@ -2231,6 +2359,10 @@ definitions:
       native:
         type: "object"
         description: "Native state description"
+  ObjectArray:
+    type: "object"
+    additionalProperties:
+      $ref: "#/definitions/Object"
   UrlHook:
     type: "object"
     properties:
@@ -2408,6 +2540,33 @@ definitions:
     type: "array"
     items:
       $ref: "#/definitions/EnumEntry"
+  FileEntry:
+    type: "object"
+    properties:
+      file:
+        type: "string"
+        description: "File name"
+      stats:
+        type: "object"
+        description: "File size"
+        properties:
+          size:
+            type: "number"
+            description: "File size in bytes"
+      isDir:
+        type: "boolean"
+        description: "Is directory"
+      modifiedAt:
+        type: "number"
+        description: "Modification time in ms"
+      createdAt:
+        type: "number"
+        description: "Creation time in ms"
+  DirResponse:
+    type: "array"
+    items:
+      $ref: "#/definitions/FileEntry"
+
   SendToData:
     type: "object"
     properties:

package/lib/rest-api.js

@@ -13,8 +13,9 @@ const axios         = require('axios');
 const cors          = require('cors');
 const fs            = require('fs');
 const path          = require('path');
+const multer = require('multer');
 const utils         = require('@iobroker/adapter-core'); // Get common adapter utils
-const tools         = require(utils.controllerDir + '/lib/tools');
+const pattern2RegEx = utils.commonTools.pattern2RegEx;
 const CommandsAdmin = require('@iobroker/socket-classes').SocketCommandsAdmin;
 const CommandsCommon = require('@iobroker/socket-classes').SocketCommands;
 const common        = require('./common');
@@ -23,6 +24,26 @@ process.env.SUPPRESS_NO_CONFIG_WARNING = 'true';
 
 const WEB_EXTENSION_PREFIX = 'rest-api/';
 
+/*const memStore = { };
+
+// Writable memory stream
+class WMStrm extends Writable {
+    constructor(key, options) {
+        super(options); // init super
+        this.key = key; // save key
+        this.data = Buffer.from(''); // empty
+    }
+
+    _write(chunk, enc, cb) {
+        // our memory store stores things in buffers
+        const buffer = (Buffer.isBuffer(chunk)) ? chunk : Buffer.from(chunk, enc);
+
+        // concat to the buffer already there
+        this.data = Buffer.concat([this.data, buffer]);
+        cb();
+    }
+}
+*/
 function parseQuery(_url) {
     let url = decodeURI(_url);
     const pos = url.indexOf('?');
@@ -286,17 +307,17 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
     };
 
     // prepare yaml
-    _options.swaggerFile = __dirname + '/api/swagger/swagger.yaml';
+    _options.swaggerFile = `${__dirname}/api/swagger/swagger.yaml`;
     if (this.adapter.config.noCommands) {
         const newText = removeTextFromFile(_options.swaggerFile, '# commands start', '# commands stop');
 
-        _options.swaggerFile = __dirname + '/api/swagger/swaggerEdited.yaml';
+        _options.swaggerFile = `${__dirname}/api/swagger/swaggerEdited.yaml`;
         if (!fs.existsSync(_options.swaggerFile) || fs.readFileSync(_options.swaggerFile).toString('utf8') !== newText) {
             fs.writeFileSync(_options.swaggerFile, newText);
         }
     } else if (this.adapter.config.noAdminCommands) {
         const newText = removeTextFromFile(_options.swaggerFile, '# admin commands start', '# admin commands end');
-        _options.swaggerFile = __dirname + '/api/swagger/swaggerEdited.yaml';
+        _options.swaggerFile = `${__dirname}/api/swagger/swaggerEdited.yaml`;
         if (!fs.existsSync(_options.swaggerFile) || fs.readFileSync(_options.swaggerFile).toString('utf8') !== newText) {
             fs.writeFileSync(_options.swaggerFile, newText);
         }
@@ -307,7 +328,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         let file = fs.readFileSync(_options.swaggerFile).toString('utf8')
         file = file.replace('basePath: "/v1"', `basePath: "/${WEB_EXTENSION_PREFIX}v1"`);
 
-        _options.swaggerFile = __dirname + '/api/swagger/swagger_extension.yaml';
+        _options.swaggerFile = `${__dirname}/api/swagger/swagger_extension.yaml`;
 
         if (!fs.existsSync(_options.swaggerFile) || fs.readFileSync(_options.swaggerFile).toString('utf8') !== file) {
             fs.writeFileSync(_options.swaggerFile, file);
@@ -322,16 +343,16 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
 
 
     if (!this.config.noUI) {
-        this.app.get(this.routerPrefix + 'api-docs/swagger.json', (req, res) =>
+        this.app.get(`${this.routerPrefix}api-docs/swagger.json`, (req, res) =>
             res.json(swaggerDocument));
 
         const options = {
             customCss: '.swagger-ui .topbar { background-color: #4dabf5; }',
         };
         // show WEB CSS and so on
-        this.app.use(this.routerPrefix + 'api-doc/', swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
+        this.app.use(`${this.routerPrefix}api-doc/`, swaggerUi.serve, swaggerUi.setup(swaggerDocument, options));
         this.app.get(this.routerPrefix, (req, res) =>
-            res.redirect(this.routerPrefix + 'api-doc/'));
+            res.redirect(`${this.routerPrefix}api-doc/`));
     }
 
     function isAuthenticated(req, res, callback) {
@@ -354,7 +375,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
                 }
             }
             if (!values.user.match(/^system\.user\./)) {
-                values.user = 'system.user.' + values.user;
+                values.user = `system.user.${values.user}`;
             }
 
             that.adapter.checkPassword(values.user, values.pass, result => {
@@ -533,7 +554,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
             const item = {id, delta: options.delta, onchange: options.onchange};
             this.subscribes[urlHash][type].push(item);
             if (item.id.includes('*')) {
-                item.regEx = new RegExp(tools.pattern2RegEx(item.id));
+                item.regEx = new RegExp(pattern2RegEx(item.id));
             }
 
             if (type === 'state') {
@@ -686,7 +707,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         }
 
         task.timer = setTimeout(_task => {
-            // remove this task from list
+            // remove this task from the list
             const pos = this._waitFor.indexOf(_task);
             if (pos !== -1) {
                 this._waitFor.splice(pos, 1);
@@ -702,11 +723,11 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
 
     this.app.get('/favicon.ico', (req, res) => {
         res.set('Content-Type', 'image/x-icon');
-        res.send(fs.readFileSync(__dirname + '/../img/favicon.ico'));
+        res.send(fs.readFileSync(`${__dirname}/../img/favicon.ico`));
     });
 
     // authenticate
-    this.app.use(this.routerPrefix + 'v1/*', (req, res, next) => {
+    this.app.use(`${this.routerPrefix}v1/*`, (req, res, next) => {
         isAuthenticated(req, res, () => {
             req._adapter = this.adapter;
             req._swaggerObject = this;
@@ -714,7 +735,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         });
     });
 
-    this.app.get(this.routerPrefix + 'v1/polling', (req, res, next) => {
+    this.app.get(`${this.routerPrefix}v1/polling`, (req, res, next) => {
         res.writeHead(200, {'Content-Type': 'text/plain'});
         const ip = req.query.sid || req.headers['x-forwarded-for'] || req.socket.remoteAddress;
         const urlHash = crypto.createHash('md5').update(ip).digest('hex');
@@ -799,13 +820,13 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         });
     });
 
-    this.app.use(this.routerPrefix + 'v1/command/*', (req, res) => {
+    this.app.use(`${this.routerPrefix}v1/command/*`, async (req, res) => {
         if (this.adapter.config.noCommands) {
             res.status(404).json({error: `Commands are disabled`});
             return;
         }
 
-        let command = req.originalUrl.startsWith('/' + WEB_EXTENSION_PREFIX) ? req.originalUrl.split('/')[4] : req.originalUrl.split('/')[3];
+        let command = req.originalUrl.startsWith(`/${WEB_EXTENSION_PREFIX}`) ? req.originalUrl.split('/')[4] : req.originalUrl.split('/')[3];
         command = command.split('?')[0];
 
         const handler = this.commands.getCommandHandler(command);
@@ -813,7 +834,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
             const args = common.getParamNames(handler).map(item => item[0] === '_' ? item.substring(1) : item);
 
             args.shift(); // remove socket
-            // try to parse query or body
+            // try to parse a query or body
             let params = parseQuery(req.originalUrl);
             if (req.body) {
                 Object.assign(params, req.body);
@@ -837,7 +858,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
             }
 
             const _acl = {
-                user: req._user
+                user: req._user,
             };
 
             const _arguments = [{_acl}];
@@ -846,7 +867,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
                 if (name !== 'callback') {
                     if (name === 'options' || name === 'params' || name === 'obj' || name === 'message') {
                         // try to convert
-                        if (typeof params[name] == 'string' && params[name].startsWith('{') && params[name].endsWith('}')) {
+                        if (typeof params[name] === 'string' && params[name].startsWith('{') && params[name].endsWith('}')) {
                             try {
                                 params[name] = JSON.parse(params[name]);
                             } catch (_error) {
@@ -869,6 +890,26 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
                 }
             });
 
+            // try to convert arguments for setState and setForeignState
+            if (command === 'setState' || command === 'setForeignState') {
+                // read object
+                try {
+                    const obj = await adapter.getForeignObjectAsync(_arguments[1], {user: req._user});
+                    if (obj && obj.common && obj.common.type) {
+                        if (obj.common.type === 'number') {
+                            _arguments[2] = parseFloat(_arguments[2]);
+                        } else if (obj.common.type === 'boolean') {
+                            _arguments[2] = _arguments[2] === 'true' || _arguments[2] === true || _arguments[2] === 1 || _arguments[2] === '1' || _arguments[2] === 'on' || _arguments[2] === 'ON';
+                        } else if (obj.common.type === 'string') {
+                            _arguments[2] = _arguments[2].toString();
+                        }
+                    }
+                } catch (error) {
+                    res.status(501).json({error});
+                    return;
+                }
+            }
+
             if (!error) {
                 if (args[args.length - 1] === 'callback') {
                     _arguments.push((error, ...args) => {
@@ -910,9 +951,9 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         }
     });
 
-    this.app.get(this.routerPrefix + 'log/*',(req, res) => {
+    this.app.get(`${this.routerPrefix}log/*`,(req, res) => {
         let parts = decodeURIComponent(req.url).split('/');
-        if (req.originalUrl.startsWith('/' + WEB_EXTENSION_PREFIX)) {
+        if (req.originalUrl.startsWith(`/${WEB_EXTENSION_PREFIX}`)) {
             parts.shift();
         }
 
@@ -922,7 +963,7 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
             const [host, transport] = parts;
             parts = parts.splice(2);
             let filename = parts.join('/');
-            this.adapter.sendToHost('system.host.' + host, 'getLogFile', {filename, transport}, result => {
+            this.adapter.sendToHost(`system.host.${host}`, 'getLogFile', {filename, transport}, result => {
                 if (!result || result.error) {
                     res.status(404).send(`File ${escapeHtml(filename)} not found`);
                 } else {
@@ -969,9 +1010,9 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
                     }
 
                     if (logFolder[0] !== '/' && logFolder[0] !== '\\' && !logFolder.match(/^[a-zA-Z]:/)) {
-                        const _logFolder = path.normalize(path.join(__dirname + '/../../../', logFolder).replace(/\\/g, '/')).replace(/\\/g, '/');
+                        const _logFolder = path.normalize(path.join(`${__dirname}/../../../`, logFolder).replace(/\\/g, '/')).replace(/\\/g, '/');
                         if (!fs.existsSync(_logFolder)) {
-                            logFolder = path.normalize(path.join(__dirname + '/../../', logFolder).replace(/\\/g, '/')).replace(/\\/g, '/');
+                            logFolder = path.normalize(path.join(`${__dirname}/../../`, logFolder).replace(/\\/g, '/')).replace(/\\/g, '/');
                         } else {
                             logFolder = _logFolder;
                         }
@@ -1013,9 +1054,12 @@ function SwaggerUI(_ignore, webSettings, adapter, instanceSettings, app, callbac
         }
     });
 
+    // parse binary files
+    this.app.post(`${this.routerPrefix}v1/file/*`, multer().fields([{ name: 'file', maxCount: 1 }]), (req, res, next) => next());
+
     this.unload = async () => {
         if (this.config.webInstance) {
-            await this.adapter.setForeignStateAsync(this.namespace + '.info.extension', false, true);
+            await this.adapter.setForeignStateAsync(`${this.namespace}.info.extension`, false, true);
         }
         this.checkInterval && clearInterval(this.checkInterval);
         this.checkInterval = null;

package/main.js

@@ -4,7 +4,7 @@
 'use strict';
 
 const utils       = require('@iobroker/adapter-core'); // Get common adapter utils
-const LE          = require(utils.controllerDir + '/lib/letsencrypt.js');
+const LE          = utils.commonTools.letsEncrypt;
 const RestAPI     = require('./lib/rest-api.js');
 const adapterName = require('./package.json').name.split('.').pop();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.rest-api",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "RESTful interface for ioBroker with GUI.",
   "author": {
     "name": "bluefox",
@@ -19,27 +19,29 @@
     "url": "https://github.com/ioBroker/ioBroker.rest-api"
   },
   "dependencies": {
-    "@iobroker/adapter-core": "^2.6.0",
-    "@iobroker/socket-classes": "^0.5.3",
-    "axios": "^0.27.2",
-    "body-parser": "^1.20.0",
+    "@iobroker/adapter-core": "^2.6.8",
+    "@iobroker/socket-classes": "^1.1.5",
+    "axios": "^1.4.0",
+    "body-parser": "^1.20.2",
     "cors": "^2.8.5",
-    "express": "^4.18.1",
+    "express": "^4.18.2",
     "swagger-node-runner-fork": "^0.8.0",
-    "swagger-ui-express": "^4.5.0",
-    "yamljs": "^0.3.0"
+    "swagger-ui-express": "^4.6.2",
+    "yamljs": "^0.3.0",
+    "multer": "^1.4.5-lts.1"
   },
   "devDependencies": {
     "@alcalzone/release-script": "^3.5.9",
     "@alcalzone/release-script-plugin-iobroker": "^3.5.9",
     "@alcalzone/release-script-plugin-license": "^3.5.9",
+    "@iobroker/adapter-dev": "^1.2.0",
     "@iobroker/testing": "^4.1.0",
-    "chai": "^4.3.6",
+    "chai": "^4.3.7",
     "eslint-plugin-eqeqeq-fix": "^1.0.3",
-    "eslint-plugin-only-warn": "^1.0.3",
-    "eslint-plugin-react": "^7.31.1",
+    "eslint-plugin-only-warn": "^1.1.0",
+    "eslint-plugin-react": "^7.32.2",
     "gulp": "^4.0.2",
-    "mocha": "^9.2.2"
+    "mocha": "^10.2.0"
   },
   "bugs": {
     "url": "https://github.com/ioBroker/ioBroker.rest-api/issues"
@@ -60,7 +62,9 @@
     "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"
+    "release-major": "release-script major --yes --no-update-lockfile",
+    "translate": "translate-adapter",
+    "update-packages": "ncu --upgrade"
   },
   "license": "Apache-2.0"
 }