Add extension actions

lha/restEngine.lua

@@ -162,6 +162,28 @@ local REST_EXTENSIONS = {
         extension:publishEvent('poll')
       end
     end,
+    action = {
+      ['{index}(extension, index, requestJson)?method=POST'] = function(exchange, extension, index, arguments)
+        local actions = extension:getManifest('actions')
+        index = math.tointeger(index)
+        local action = index and actions and actions[index]
+        if action and action.method then
+          local method = extension[action.method]
+          if type(method) ~= 'function' then
+            HttpExchange.internalServerError(exchange, 'The action method is not available')
+          elseif extension:isActive() ~= action.active then
+            HttpExchange.badRequest(exchange, 'The extension active state does not match')
+          elseif (action.arguments and #action.arguments or 0) == #arguments then
+            HttpExchange.badRequest(exchange, 'The action arguments are invalid')
+          else
+            return method(extension, arguments)
+          end
+        else
+          HttpExchange.notFound(exchange)
+        end
+        return false
+      end
+    },
     ['test(extension)?method=POST'] = function(exchange, extension)
       extension:publishEvent('test')
     end,
@@ -366,7 +388,7 @@ local REST_THINGS = {
       return false
     end
   end,
-  ['{thingId}'] = {
+  ['{thingId}'] = { -- TODO review routing
     [''] = function(exchange)
       local engine = exchange:getAttribute('engine')
       local thingId = exchange:getAttribute('thingId')

lha/schema-extension.json

@@ -1,6 +1,38 @@
 {
   "additionalProperties": false,
   "properties": {
+    "actions": {
+      "title": "The extension actions",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "title": "The name of the action",
+            "type": "string",
+            "required": true
+          },
+          "description": {
+            "title": "The description of the action",
+            "type": "string"
+          },
+          "method": {
+            "title": "The name of the extension method to trigger the action",
+            "type": "string",
+            "required": true
+          },
+          "arguments": {
+            "title": "The list of schema defining the arguments to pass to the method",
+            "type": "array"
+          },
+          "active": {
+            "default": true,
+            "title": "Indicates that the action is available when the extension is enabled",
+            "type": "boolean"
+          }
+        }
+      }
+    },
     "config": {
       "title": "The extension default configuration",
       "type": "object"