Skip to content

2.2.0

Latest

Choose a tag to compare

@fatbobman fatbobman released this 07 Jul 05:52

PersistentHistoryTrackingKit 2.2.0

This release adds an observer-only processing mode for apps that want to use persistent history observation without letting the kit merge transactions into contexts.

What's New

  • Added TransactionMergeBehavior.
    • .automatic keeps the existing behavior: run Merge Hooks, then default merge when the hook pipeline continues.
    • .disabled skips the entire merge phase, including registered Merge Hooks and the default merge.
  • Added mergeBehavior to PersistentHistoryTrackingKit.init, defaulting to .automatic for source compatibility.
  • In .disabled mode, Observer Hooks still run, the current author's timestamp still advances, and cleanup still follows cleanStrategy.
  • Registering a Merge Hook while merge is disabled now emits a .notice log to make the inactive configuration visible.

Documentation

  • README, READMECN, and Hook Mechanism docs now describe observer-only mode.
  • Documentation clarifies that processed counts in .disabled mode mean transactions were observed and timestamped, not merged into contexts.
  • Cleanup guidance now calls out the extra responsibility when cleanup is enabled while merge is disabled.

Compatibility

  • Existing initializers continue to compile because mergeBehavior defaults to .automatic.
  • No changes to .automatic merge behavior are intended.