Skip to main content

Module forward

Module forward 

Source
Expand description

Forward compatibility support for loading future/unknown versions.

This module provides types and utilities for handling data from versions that don’t exist in the current codebase yet.

§⚠️ Requirements

Forward compatibility assumes additive-only schema changes:

  • ✅ Field additions (V2 has fields V1 doesn’t) → OK
  • ❌ Field deletions (V1 has fields V2 doesn’t) → Deserialization error
  • ❌ Field type changes → Data corruption
  • ❌ Field semantic changes (same name, different meaning) → Logic bugs

If your schema has breaking changes, define a proper migration path instead.

Structs§

ForwardContext
Context for forward compatibility operations.
Forwardable
A wrapper that holds domain data along with forward compatibility context.