Add Upgrade path to v3

[DanielBadura]

No description provided.

[github-actions]

Hello 👋

here is the most recent benchmark result:

SplitStreamBench
================

+-------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
|                         | time (kde mode)                                     | memory                                     |
+-------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| subject                 | Tag: <current>     | Tag: base          | time-diff | Tag: <current>  | Tag: base  | memory-diff |
+-------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| benchLoad10000Events () | 4.639ms (±0.00%)   | 4.633ms (±0.00%)   | +0.14%    | 37.570mb        | 37.578mb   | -0.02%      |
| benchSave10000Events () | 335.410ms (±0.00%) | 353.502ms (±0.00%) | -5.12%    | 37.572mb        | 37.580mb   | -0.02%      |
+-------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+

SimpleSetupBench
================

+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
|                                        | time (kde mode)                                     | memory                                     |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| subject                                | Tag: <current>     | Tag: base          | time-diff | Tag: <current>  | Tag: base  | memory-diff |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| benchLoad1Event ()                     | 982.500μs (±0.00%) | 971.300μs (±0.00%) | +1.15%    | 33.761mb        | 33.761mb   | 0.00%       |
| benchLoad10000Events ()                | 49.275ms (±0.00%)  | 51.032ms (±0.00%)  | -3.44%    | 33.761mb        | 33.761mb   | 0.00%       |
| benchSave1Event ()                     | 816.900μs (±0.00%) | 1.511ms (±0.00%)   | -45.95%   | 33.761mb        | 33.761mb   | 0.00%       |
| benchSave10000Events ()                | 213.736ms (±0.00%) | 217.677ms (±0.00%) | -1.81%    | 33.761mb        | 33.761mb   | 0.00%       |
| benchSave10000Aggregates ()            | 5.730s (±0.00%)    | 6.026s (±0.00%)    | -4.92%    | 33.761mb        | 33.761mb   | 0.00%       |
| benchSave10000AggregatesTransaction () | 4.636s (±0.00%)    | 4.662s (±0.00%)    | -0.57%    | 33.762mb        | 33.762mb   | 0.00%       |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+

SnapshotsBench
==============

+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
|                                        | time (kde mode)                                     | memory                                     |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| subject                                | Tag: <current>     | Tag: base          | time-diff | Tag: <current>  | Tag: base  | memory-diff |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| benchLoad10000EventsMissingSnapshot () | 49.503ms (±0.00%)  | 50.116ms (±0.00%)  | -1.22%    | 33.762mb        | 33.762mb   | 0.00%       |
| benchLoad10000Events ()                | 862.700μs (±0.00%) | 878.800μs (±0.00%) | -1.83%    | 33.762mb        | 33.762mb   | 0.00%       |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+

PersonalDataBench
=================

+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
|                                        | time (kde mode)                                     | memory                                     |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| subject                                | Tag: <current>     | Tag: base          | time-diff | Tag: <current>  | Tag: base  | memory-diff |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+
| benchLoad1Event ()                     | 890.900μs (±0.00%) | 1.015ms (±0.00%)   | -12.25%   | 34.891mb        | 34.891mb   | 0.00%       |
| benchLoad10000Events ()                | 81.936ms (±0.00%)  | 83.627ms (±0.00%)  | -2.02%    | 34.891mb        | 34.891mb   | 0.00%       |
| benchSave1Event ()                     | 1.281ms (±0.00%)   | 1.305ms (±0.00%)   | -1.79%    | 34.891mb        | 34.891mb   | 0.00%       |
| benchSave10000Events ()                | 236.824ms (±0.00%) | 238.036ms (±0.00%) | -0.51%    | 34.893mb        | 34.893mb   | 0.00%       |
| benchSave10000Aggregates ()            | 9.709s (±0.00%)    | 9.712s (±0.00%)    | -0.03%    | 34.891mb        | 34.891mb   | 0.00%       |
| benchSave10000AggregatesTransaction () | 8.609s (±0.00%)    | 8.639s (±0.00%)    | -0.35%    | 35.392mb        | 35.392mb   | 0.00%       |
+----------------------------------------+--------------------+--------------------+-----------+-----------------+------------+-------------+

SubscriptionEngineBench
=======================

+---------------------------+-----------------+-----------------+-----------+-----------------+------------+-------------+
|                           | time (kde mode)                               | memory                                     |
+---------------------------+-----------------+-----------------+-----------+-----------------+------------+-------------+
| subject                   | Tag: <current>  | Tag: base       | time-diff | Tag: <current>  | Tag: base  | memory-diff |
+---------------------------+-----------------+-----------------+-----------+-----------------+------------+-------------+
| benchHandle10000Events () | 3.067s (±0.00%) | 3.068s (±0.00%) | -0.05%    | 34.161mb        | 34.161mb   | 0.00%       |
+---------------------------+-----------------+-----------------+-----------+-----------------+------------+-------------+

This comment gets update everytime a new commit comes in!

[DavidBadura]

Nice work!