Support for web specification source in Specmatic (SchemaStore#5569)

Co-authored-by: joelrosario <joelrosario@users.noreply.github.com>

Author: joelrosario

src/negative_test/specmatic/v2-web-url-wrong-type.json

@@ -0,0 +1,10 @@
+{
+  "contracts": [
+    {
+      "web": {
+        "url": 123
+      }
+    }
+  ],
+  "version": 2
+}

src/negative_test/specmatic/v3-source-web-missing-url.json

@@ -0,0 +1,10 @@
+{
+  "components": {
+    "sources": {
+      "remoteSpecs": {
+        "web": {}
+      }
+    }
+  },
+  "version": 3
+}

src/schemas/json/specmatic.json

@@ -251,6 +251,18 @@
           },
           "required": []
         },
+        "web": {
+          "type": "object",
+          "description": "Web contract source details.",
+          "additionalProperties": false,
+          "required": ["url"],
+          "properties": {
+            "url": {
+              "type": "string",
+              "description": "Base URL for web-hosted contract files."
+            }
+          }
+        },
         "provides": {
           "type": ["array", "null"],
           "description": "List of specs provided for testing. Each entry can be a string or an object.",
@@ -1292,6 +1304,9 @@
         },
         {
           "$ref": "#/definitions/FileSystemSourceSchema"
+        },
+        {
+          "$ref": "#/definitions/WebSourceSchema"
         }
       ]
     },
@@ -1386,6 +1401,26 @@
         }
       }
     },
+    "WebSourceSchema": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["web"],
+      "properties": {
+        "web": {
+          "$ref": "#/definitions/WebSourceOptions"
+        }
+      }
+    },
+    "WebSourceOptions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url"],
+      "properties": {
+        "url": {
+          "$ref": "#/definitions/SubstitutableString"
+        }
+      }
+    },
     "RunOptions": {
       "type": "object",
       "additionalProperties": false,

src/test/specmatic/specmatic-v2-web-source.json

@@ -0,0 +1,11 @@
+{
+  "contracts": [
+    {
+      "provides": ["api/order.yaml"],
+      "web": {
+        "url": "https://contracts.example.com"
+      }
+    }
+  ],
+  "version": 2
+}

src/test/specmatic/specmatic-v3-web-source.json

@@ -0,0 +1,37 @@
+{
+  "components": {
+    "services": {
+      "orderApiService": {
+        "definitions": [
+          {
+            "definition": {
+              "source": {
+                "$ref": "#/components/sources/remoteSpecs"
+              },
+              "specs": ["openapi/order-api.yaml"]
+            }
+          }
+        ]
+      }
+    },
+    "sources": {
+      "remoteSpecs": {
+        "web": {
+          "url": "https://contracts.example.com"
+        }
+      }
+    }
+  },
+  "systemUnderTest": {
+    "service": {
+      "$ref": "#/components/services/orderApiService",
+      "runOptions": {
+        "openapi": {
+          "baseUrl": "http://localhost:8080",
+          "type": "test"
+        }
+      }
+    }
+  },
+  "version": 3
+}