Return $metadata resource as odata + openapi spec

Returning odata and openapi specs in json format.
Specs are scoped to the request permissions.
Different users (roles) will receive different metadata endpoints
and resources.

Change-type: minor
Signed-off-by: Harald Fischer <[email protected]>
Signed-off-by: fisehara <[email protected]>

package.json

@@ -27,7 +27,9 @@
     "compose:postgres": "docker-compose -f docker-compose.test.yml up -d postgres",
     "compose:build": "docker-compose -f docker-compose.test.yml build",
     "compose:down": "docker-compose -f docker-compose.test.yml down",
-    "prettify": "balena-lint -e js -e ts --fix src build typings Gruntfile.ts"
+    "prettify": "balena-lint -e js -e ts --fix src build typings Gruntfile.ts",
+    "serve-openapi": "redoc-cli serve --ssr ./example-openapi.json",
+    "build-openapi": "redoc-cli build ./example-openapi.json"
   },
   "dependencies": {
     "@balena/abstract-sql-compiler": "^7.20.0",
@@ -61,6 +63,7 @@
     "express-session": "^1.17.3",
     "lodash": "^4.17.21",
     "memoizee": "^0.4.15",
+    "odata-openapi": "^0.18.1",
     "pinejs-client-core": "^6.10.2",
     "randomstring": "^1.2.2",
     "typed-error": "^3.2.1"
@@ -91,6 +94,7 @@
     "load-grunt-tasks": "^5.1.0",
     "mocha": "^9.2.2",
     "raw-loader": "^4.0.2",
+    "redoc-cli": "^0.13.18",
     "require-npm4-to-publish": "^1.0.0",
     "supertest": "^6.2.4",
     "terser-webpack-plugin": "^5.3.3",