@onlineapps/service-wrapper 2.2.9 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/service-wrapper",
-  "version": "2.2.9",
+  "version": "2.3.0",
   "description": "Thin orchestration layer for microservices - delegates all infrastructure concerns to specialized connectors",
   "main": "src/index.js",
   "scripts": {

package/src/ServiceWrapper.js

@@ -1814,6 +1814,28 @@ class ServiceWrapper {
       }
     }
 
+    // Extension 1: specificationEndpoint must match an Express route
+    // See: docs/standards/api-versioning-contract.md
+    const specEndpoint = this.config.service?.specificationEndpoint;
+    if (specEndpoint && !routeSet.has(`GET:${specEndpoint}`)) {
+      errors.push(
+        `specificationEndpoint '${specEndpoint}' not found in Express routes — ` +
+        `config claims this path but no GET route is registered`
+      );
+    }
+
+    // Extension 3: operations.json endpoints under /api/ must be versioned
+    // See: docs/standards/api-versioning-contract.md
+    const versionPattern = /^\/api\/v\d+\//;
+    for (const [opName, opDef] of Object.entries(ops)) {
+      if (opDef.endpoint?.startsWith('/api') && !versionPattern.test(opDef.endpoint)) {
+        errors.push(
+          `Operation '${opName}' endpoint '${opDef.endpoint}' missing version — ` +
+          `expected /api/v{N}/... (see docs/standards/api-versioning-contract.md)`
+        );
+      }
+    }
+
     if (errors.length > 0) {
       throw new Error(
         `[ServiceWrapper] Operations-Routes alignment failed (${errors.length} issue${errors.length > 1 ? 's' : ''}):\n` +