fix(lint): Switch to json config for swagger-combine (#509)

* Removed temporarily as it's unfinished

* fix(swagger): Switched swagger-combine config to json

* Added override

* Renamed to match spectral

* Switched to codebase-wide temporarily

* Switched namings

* Switched to warn

* Merge state

.github/linters/.openapirc.yml

@@ -0,0 +1,11 @@
+---
+
+##########################
+##########################
+## OpenAPI Linter rules ##
+##########################
+##########################
+
+extends: spectral:oas
+rules:
+  oas2-schema: warn

api/docs/config.json

@@ -0,0 +1,44 @@
+{
+    "swagger": "2.0",
+    "info": {
+        "title": "cheqd Network - REST and gRPC Gateway Documentation",
+        "description": "Documentation describing REST and gRPC Gateway endpoints for cheqd network.",
+        "version": "v1.x",
+        "contact": {
+            "name": "Cheqd Foundation Limited",
+            "url": "https://cheqd.io"
+        },
+        "license": {
+            "name": "Apache 2.0",
+            "url": "https://github.com/cheqd/cheqd-node/blob/main/LICENSE"
+        }
+    },
+    "paths": {},
+    "apis": [
+        {
+            "url": "./api/docs/cheqd/did/v2/query.swagger.json"
+        },
+        {
+            "url": "./api/docs/cheqd/resource/v2/query.swagger.json"
+        }
+    ],
+    "basePath": "/swagger/",
+    "schemes": [
+        "http",
+        "https"
+    ],
+    "consumes": [
+        "application/json",
+        "application/json+ld",
+        "*/*"
+    ],
+    "produces": [
+        "application/json",
+        "application/json+ld",
+        "*/*"
+    ],
+    "externalDocs": {
+        "description": "cheqd Network Documentation",
+        "url": "https://docs.cheqd.io/node"
+    }
+}

scripts/protoc-swagger-gen.sh

@@ -30,7 +30,7 @@ cd ..
 # combine swagger files
 # uses nodejs package `swagger-combine`.
 # all the individual swagger files need to be configured in `config.yaml` for merging
-swagger-combine ${SWAGGER_DIR}/config.yaml -o ${SWAGGER_DIR}/swagger.yaml -f yaml --continueOnConflictingPaths true
+swagger-combine ${SWAGGER_DIR}/config.json -o ${SWAGGER_DIR}/swagger.yaml -f yaml --continueOnConflictingPaths true
 
 # Remove individual swagger files
 rm -rf ${SWAGGER_DIR}/cheqd