Harmony 0.10: Transform logging, configuration validation, and array handling
This release adds debug logging for JOLT transforms, environment variable validation, sensitive field patterns for log redaction, and fixes critical issues with array transformations and query parameter handling.
- Engineering
We've released Harmony 0.10, a focused update addressing transform visibility, configuration safety, and data handling reliability.
Features
Debug logging for JOLT transforms
Enable detailed logging for JOLT transformations by setting debug = true in the transform middleware. This logs transform input and output, helping diagnose issues in complex transformation pipelines without modifying transformation rules.
Environment variable validation
Use proxy.required_env_vars to declare required environment variables. Harmony now enforces these at startup with clear error messages, catching configuration issues before deployment rather than at runtime.
Sensitive field patterns for log redaction
The new proxy.sensitive_field_patterns setting lets you define patterns for fields that should be redacted from logs, protecting sensitive data in structured logging output.
JWT backward compatibility
JWT configuration now supports the deprecated leeway_seconds field as a fallback to leeway_secs, easing upgrades from configurations using the older field name.
Improvements
Transform pipeline behaviour
Nested array structures are now handled more reliably throughout the transform pipeline, addressing edge cases that could cause unexpected data representation issues.
Query parameter handling
Query parameters set by middleware are now preserved correctly through the request lifecycle and cleared when required, preventing stale values from leaking between requests.
Earlier target details availability
Target details are now available earlier in the request processing pipeline, making them easier to use in middleware and transforms.
Test suite stability
Various tests have been updated for improved reliability and clearer failure diagnostics.
Fixes
Transform arrays
Arrays are now correctly processed via the harmony-jolt 0.7 update, fixing issues with nested array transformation.
Query parameter clearing
Middleware-provided query parameters are correctly cleared when specified, ensuring clean request handling.
Target details in transforms
Target details can now be set directly in transforms without requiring a pre-existing entry.
Configuration error handling
Configuration errors now produce clearer messages and stricter validation, making misconfigurations easier to identify.
Dependencies
- harmony-jolt updated to 0.7.0 for improved array transformation handling
- runbeam-sdk confirmed at 0.9.1
This release prioritises operational reliability and debugging transparency for teams managing complex integration pipelines.
Get Started
Download Harmony 0.10.0 from GitHub Releases, or refer to the installation guide for pre-built binaries and setup instructions.