@onlineapps/service-wrapper 3.4.1 → 3.4.3

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this package. Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format and semantic versioning within the internal-monorepo convention (all biz-service consumers ship matching changes in the same session).
 
+## [3.4.3] — 2026-08-17
+
+**Ajv config: `allowUnionTypes: true`.**
+
+Every biz `operations.json` in `api_biz/*` uses `type: [X, "null"]` union types for nullable fields — a widely-accepted JSON Schema idiom. Ajv `strict: true` without `allowUnionTypes` rejects them and blocks service boot at `SchemaValidator.precompile` with:
+
+    strict mode: use allowUnionTypes to allow union type keyword ...
+
+3.4.3 keeps strict mode (still rejects unknown keywords etc.) but explicitly allows union types. No other behaviour change.
+
+Discovered during Fáze F5 live-rollout: property, converter, ingest, meta all have nullable output-schema fields using unions. Blocked their boot after F3 bump. Fix here is server-side (validator config).
+
+## [3.4.2] — 2026-08-17
+
+**Hot-fix: dangling `serviceUrl` reference at line 2649** left by 3.4.1's guard-removal pass. `_ensureValidationProof` still passed `serviceUrl` to `ValidationOrchestrator` after the `const serviceUrl = ...` declaration was deleted. Result: every biz that force-recreated to 3.4.1 hit `Phase 0.2 Tier 1 Validation - FAILED: serviceUrl is not defined` and stalled.
+
+Fix: reintroduce `const serviceUrl = this.config.service?.url || ''` — kept as local so downstream still gets the value (empty string when config omits URL; used only for telemetry/log annotation by ValidationOrchestrator).
+
+Verified: property/meta/converter recreated post-3.4.2 pass Phase 0.2.
+
 ## [3.4.1] — 2026-08-17
 
 **Patch: drop stale port/url/specificationEndpoint guards left over from A2.2.**

package/package.json

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

package/src/SchemaValidator.js

@@ -27,7 +27,16 @@ const { ValidationError } = require('./ErrorMapper');
 function _buildDefaultAjv() {
   const Ajv = require('ajv');
   const addFormats = require('ajv-formats');
-  const ajv = new Ajv({ strict: true, allErrors: true, removeAdditional: false });
+  // allowUnionTypes: `type: [X, "null"]` is a widely-used JSON Schema idiom
+  // for nullable fields; every biz operations.json in api_biz/* uses it.
+  // Strict mode without this flag rejects union types outright and blocks
+  // service boot (SchemaValidator.precompile throws).
+  const ajv = new Ajv({
+    strict: true,
+    allowUnionTypes: true,
+    allErrors: true,
+    removeAdditional: false
+  });
   addFormats(ajv);
   return ajv;
 }

package/src/ServiceWrapper.js

@@ -2618,7 +2618,10 @@ class ServiceWrapper {
 
     // ADR 0005: biz services have no HTTP surface — no port to bind, no
     // URL to advertise. Prior versions of this method required both;
-    // dropped in 3.4.1 because they had no consumer post-A2.
+    // dropped in 3.4.1 because they had no consumer post-A2. Kept as a
+    // local var so downstream ValidationOrchestrator can still receive it
+    // (accepts empty string; only used for telemetry / log annotation).
+    const serviceUrl = this.config.service?.url || '';
 
     // Phase 5: Check restart-aware failure tracking
     const failureData = this._readValidationFailureFile();