Release Notes

Version Compatibility

Plugin Version	Bloomreach Experience Manager Version
5.5.0	16.7.0
5.4.0	16.7.0
5.3.x	16.7.0
5.2.0	16.7.0
5.1.0	16.6.5
5.0.1	16.6.5
5.0.0	16.0.0
4.x	15.x
3.x	14.x
2.1.2	13.4.x
2.0.0	13.1
1.x	12.x

Namespace pre-registration before applyNamespacesAndNodeTypes — prevents NamespaceException failures from addon module ordering
Missing supertype pre-stubbing — stubs supertypes referenced in CNDs but absent from the test classpath before type registration
Retry loops for namespace registration and config delta — auto-recovers from invalid supertype and "is not a mixin" errors
Unmapped mount patching — sets hst:ismapped=false on mounts with unresolvable site references, preventing errors in multi-tenant setups
RuntimeTypeStubber.registerStubMixinNodeType() — new method to register stub mixin types specifically
SpringComponentManager.getInternalApplicationContext() — exposes Spring context for test setup
AbstractPageModelTest registers a GenericWebApplicationContext on the test servlet context — fixes WebApplicationContextUtils.getWebApplicationContext() returning null
Bootstrap log noise reduction — noisy ConfigService loggers suppressed during bootstrap

FORGE-626 Addon HCM module auto-discovery: non-platform, non-project HCM modules on the test classpath are loaded automatically. Upgrade note: tests using loadProjectContent = true may pick up additional modules; use excludeDependencyHcmModules to opt out of specific ones.
New excludeDependencyHcmModules parameter on @BrxmJaxrsTest and @BrxmPageModelTest to opt out of specific addon modules
dependencyHcmModules repurposed as force-include override for modules that auto-discovery would miss
Ordering fix: addon modules now load before project modules to ensure node types are registered first

Page Model API v1.0 document resolution: documents and imagesets in the page section are now correctly parsed and resolved
resolveModelContent(component, modelName, type) and resolveModelContentList(component, modelName, type) — helper methods replacing manual stream pipelines for resolving $ref content
Diagnostics package: PageModelAssert, PageModelDiagnostics, and ConfigurationDiagnostics provide actionable failure output with YAML file references and fix recommendations
JCR repository shared across test classes with the same configuration fingerprint — Jackrabbit bootstraps once per fingerprint
ConfigurationModel cached by source file hash — repeated YAML/CND processing skipped for classes with identical HCM modules

Breaking: brXM 16.7.0 required — parent POM upgraded from 16.6.5
Breaking: commons-lang3 migration in internal Spring config (affects hst-manager.xml overrides)
Security: CVE-2025-48924 — CI credential hardening (heredoc quoting, Maven env syntax, fork PR skip)
Fork PR detection — CI skips build with notice instead of 401 failure
Log level normalization — operational messages downgraded from WARN to INFO/DEBUG
Javadoc scope warnings added to all test annotations

Quick Start Guides: Getting Started | Quick Reference | Common Patterns | Troubleshooting

FORGE-577 Annotation-based testing with zero-config setup
JUnit 5 parameter injection: Test harness via @Test method parameters (recommended)
Production-parity testing with ConfigServiceRepository
New annotations: @BrxmPageModelTest, @BrxmJaxrsTest, @BrxmComponentTest
Auto-detection of node types from @Node(jcrType="...") annotations in bean packages
One-liner ConfigService integration via loadProjectContent = true
Fluent request builder API with typed JSON responses
HTTP Session support in MockHstRequest
Enhanced error messages with actionable fix suggestions