Skip to content

Feature/axoniq/137/docs message transformation#4629

Open
laura-devriendt-lemon wants to merge 5 commits into
feature/axoniq/137/feature-message-transformatorfrom
feature/axoniq/137/docs-message-transformation
Open

Feature/axoniq/137/docs message transformation#4629
laura-devriendt-lemon wants to merge 5 commits into
feature/axoniq/137/feature-message-transformatorfrom
feature/axoniq/137/docs-message-transformation

Conversation

@laura-devriendt-lemon

@laura-devriendt-lemon laura-devriendt-lemon commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds end-to-end user documentation for Event Transformation (the AF5
successor to single-event upcasters) => REVIEW FIRST #4624 then you don't see that many changes anymore when i have merged the other one

What's included

Reference guide: new message-transformation module

  • index: what a transformation is, conversion-vs-transformation guidance, and how to add the module.
  • defining-transformations: the from/to/transform API, generic payloads via TypeReference, and predicate-based version-range matching.
  • configuring-transformations: assembling/registering an EventTransformerChain (Configuration API and Spring Boot), ordering and last-match-wins, the iteration safety bound, writing pure mappers, and testing a transformation in isolation.
  • demo: a walkthrough of the course-catalog example ref to the demo.
  • Nav wiring under Events; gated behind advanced-framework.

Migration guide

  • New Upcaster Migration path page mapping AF4 SingleEventUpcaster to an AF5 EventTransformation, with a before/after and a concept-mapping table. Nav entry added (gated behind advanced-framework).

@laura-devriendt-lemon laura-devriendt-lemon self-assigned this Jun 3, 2026
@laura-devriendt-lemon laura-devriendt-lemon added Priority 1: Must Highest priority. A release cannot be made if this issue isn’t resolved. Type: Documentation Use to signal issues that describe documentation work. Type: Feature Use to signal an issue is completely new to the project. labels Jun 3, 2026
@laura-devriendt-lemon laura-devriendt-lemon added this to the Release 5.2.0 milestone Jun 3, 2026
@laura-devriendt-lemon laura-devriendt-lemon marked this pull request as ready for review June 3, 2026 12:56
@laura-devriendt-lemon laura-devriendt-lemon requested a review from a team as a code owner June 3, 2026 12:56
@laura-devriendt-lemon laura-devriendt-lemon requested review from MateuszNaKodach, hatzlj and jangalinski and removed request for a team June 3, 2026 12:56
@laura-devriendt-lemon laura-devriendt-lemon force-pushed the feature/axoniq/137/docs-message-transformation branch from 0477928 to ff7a06c Compare June 12, 2026 07:53
laura-devriendt-lemon and others added 3 commits June 12, 2026 15:58
Update the message-transformation reference guide and the upcasters
migration page to call EventTransformer.from(...), reflecting the DSL
move from EventTransformation onto the EventTransformer interface.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@laura-devriendt-lemon laura-devriendt-lemon force-pushed the feature/axoniq/137/docs-message-transformation branch from ff7a06c to da53841 Compare June 12, 2026 14:02
The chain's register-after-build guard message changed from 'locked' to
'register() must be called before build()' in axoniq-framework #153; update
the demo assertion to match.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority 1: Must Highest priority. A release cannot be made if this issue isn’t resolved. Type: Documentation Use to signal issues that describe documentation work. Type: Feature Use to signal an issue is completely new to the project.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant