fix(core): resolve navigation-only nodes in template fragments

[zantvoort]

Fixes #364.

A navigation-only node (a path that navigates beyond a Ref foreign key) interpolated into a query builder template fragment was not resolved to a column. It fell through to parameter compilation, so the raw metamodel object reached the JDBC driver (Type NavigableSiteMetamodel$7 not supported type on MariaDB, NotSerializableException on H2). The predicate form and full select templates already handled the same path.

Changes

• QueryModelImpl.resolveElements now resolves Navigable column nodes the same way TemplatePreparation.resolveElements does: full metamodels pass through, navigation-only nodes are rebuilt into resolvable runtime metamodels via Metamodel.of(root, fieldPath). Table-level paths get the same error message as the main template path.
• The nested TemplateString value walker in TemplatePreparation.collectReferencedTablePaths records the referenced path for Navigable column nodes, so the joins beyond the reference are derived for template fragments. Without this, the resolved column failed with Alias for table not found.
• RefGraphTraversalIntegrationTest.testFilterThroughRefInWhereTemplate compares the template fragment form against the predicate form; it reproduced both failure layers before the fix.

Verification

./mvnw -pl storm-foundation,storm-core test: 2501 tests, 0 failures.

[Copilot]

Pull request overview

This PR fixes query builder template fragments so that “navigation-only” paths (i.e., Navigable nodes produced when traversing beyond a Ref) are resolved to column references instead of falling through to bind-parameter compilation, aligning fragment behavior with full templates and predicate-style filters.

Changes:

• Updated QueryModelImpl.resolveElements to treat Navigable column nodes like columns by rebuilding navigation-only nodes into resolvable runtime Metamodel instances via Metamodel.of(root, fieldPath).
• Updated TemplatePreparation.collectReferencedTablePaths to record referenced paths for Navigable column nodes in template fragment values so join derivation works beyond Ref.
• Added an integration test ensuring where(raw(...)) fragment behavior matches the predicate form for a beyond-Ref column path.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
storm-core/src/main/java/st/orm/core/template/impl/QueryModelImpl.java	Resolves Navigable column nodes in template fragment values into Elements.Column via a rebuilt runtime Metamodel.
storm-core/src/main/java/st/orm/core/template/impl/TemplatePreparation.java	Collects referenced table paths for Navigable column nodes inside template fragment values to derive required joins.
storm-core/src/test/java/st/orm/core/RefGraphTraversalIntegrationTest.java	Adds regression coverage comparing fragment-style where(raw(...)) against predicate-style filtering across a Ref.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.