Merge branch 'release/2.0.0' into main

Author: DirtyNative

.github/workflows/publish.yml

@@ -32,6 +32,26 @@ jobs:
       - name: Bootstrap
         run: melos bootstrap
 
+      - name: Set release train version
+        run: |
+          set -euo pipefail
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "Releasing version: $VERSION"
+
+          # Force every public workspace package to the exact same version.
+          # We intentionally avoid committing/tagging here; the tag already exists.
+          melos version --yes \
+            --no-changelog \
+            --no-git-commit-version \
+            --no-git-tag-version \
+            -V continuum:$VERSION \
+            -V continuum_generator:$VERSION \
+            -V continuum_store_hive:$VERSION \
+            -V continuum_store_memory:$VERSION
+
+      - name: Analyze
+        run: melos run analyze --no-select
+
       - name: Test
         run: melos run test --no-select
 
@@ -44,4 +64,7 @@ jobs:
           printf '%s' "$PUB_CREDENTIALS" > "$HOME/.config/dart/pub-credentials.json"
 
       - name: Publish packages
-        run: melos publish --no-dry-run --yes
+        run: |
+          # Publish in workspace dependency order (dependencies first).
+          # melos publish is dry-run by default; we explicitly publish.
+          melos publish --no-private --no-dry-run --yes

.gitignore

@@ -112,4 +112,7 @@ lib/generated_plugin_registrant.dart
 .history
 .ionide
 
-# End of https://www.toptal.com/developers/gitignore/api/dart,flutter,visualstudiocode
+# End of https://www.toptal.com/developers/gitignore/api/dart,flutter,visualstudiocode
+
+**/.idea/
+**/*.iml

README.md

@@ -53,8 +53,8 @@ class ShoppingCart with _$ShoppingCartEventHandlers {
 }
 
 // Creation event (first event in stream)
-@Event(ofAggregate: ShoppingCart, type: 'cart.created')
-class CartCreated extends DomainEvent {
+@AggregateEvent(of: ShoppingCart, type: 'cart.created')
+class CartCreated extends ContinuumEvent {
   final String cartId;
 
   CartCreated({
@@ -73,8 +73,8 @@ class CartCreated extends DomainEvent {
 }
 
 // Mutation event
-@Event(ofAggregate: ShoppingCart, type: 'item.added')
-class ItemAdded extends DomainEvent {
+@AggregateEvent(of: ShoppingCart, type: 'item.added')
+class ItemAdded extends ContinuumEvent {
   final String productId;
 
   ItemAdded({
@@ -138,7 +138,7 @@ await session.saveChangesAsync();
 ### continuum
 
 Core library providing:
-- `@Aggregate()` and `@Event()` annotations
+- `@Aggregate()` and `@AggregateEvent()` annotations
 - `DomainEvent` base class
 - `EventId` and `StreamId` strong types
 - `Session`, `EventStore`, `EventSourcingStore` abstractions

packages/continuum/CHANGELOG.md

@@ -1,3 +1,14 @@
+## 2.0.0 - 2026-01-08
+
+### Breaking Changes
+
+- **BREAKING**: Renamed `@Event` annotation to `@AggregateEvent` to avoid naming conflicts with user code.
+- **BREAKING**: Renamed `ofAggregate:` parameter to `of:` in `@AggregateEvent` annotation.
+- **BREAKING**: Renamed `DomainEvent` class to `ContinuumEvent` to avoid naming conflicts.
+- **BREAKING**: Renamed `Session` interface to `ContinuumSession` to avoid naming conflicts.
+- **BREAKING**: Renamed `StoredEvent.fromDomainEvent()` to `StoredEvent.fromContinuumEvent()`.
+- **BREAKING**: Updated all parameter names from `domainEvent` to `continuumEvent`.
+
 ## 1.0.0
 
 - Initial release with event sourcing core functionality.

packages/continuum/README.md

@@ -91,15 +91,15 @@ class User with _$UserEventHandlers {
 
 ```dart
 // For Mode 1 (no persistence):
-@Event(ofAggregate: User)
-class EmailChanged extends DomainEvent {
+@AggregateEvent(of: User)
+class EmailChanged extends ContinuumEvent {
   final String newEmail;
   EmailChanged(StreamId aggregateId, this.newEmail) : super(aggregateId);
 }
 
 // For Mode 2/3 (with persistence), add type strings:
-@Event(ofAggregate: User, type: 'user.email_changed')
-class EmailChanged extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.email_changed')
+class EmailChanged extends ContinuumEvent {
   final String newEmail;
   EmailChanged(StreamId aggregateId, this.newEmail) : super(aggregateId);
 
@@ -110,8 +110,8 @@ class EmailChanged extends DomainEvent {
   }
 }
 
-@Event(ofAggregate: User, type: 'user.registered')
-class UserRegistered extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.registered')
+class UserRegistered extends ContinuumEvent {
   final String name;
   final String email;
   
@@ -239,8 +239,8 @@ class Order with _$OrderEventHandlers {
 Events represent things that have happened. They are immutable and describe state changes.
 
 ```dart
-@Event(ofAggregate: Order, type: 'order.item_added') // type required for persistence
-class ItemAdded extends DomainEvent {
+@AggregateEvent(of: Order, type: 'order.item_added') // type required for persistence
+class ItemAdded extends ContinuumEvent {
   final String itemId;
   ItemAdded(StreamId aggregateId, this.itemId) : super(aggregateId);
 }
@@ -326,8 +326,8 @@ try {
 Events are serialized to JSON for storage. Implement `toJson()` and `fromJson()`:
 
 ```dart
-@Event(ofAggregate: User, type: 'user.email_changed')
-class EmailChanged extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.email_changed')
+class EmailChanged extends ContinuumEvent {
   final String newEmail;
   
   EmailChanged(StreamId aggregateId, this.newEmail) : super(aggregateId);

packages/continuum/example/lib/domain/events/email_changed.dart

@@ -3,8 +3,8 @@ import 'package:continuum/continuum.dart';
 import '../user.dart';
 
 /// Event fired when a user changes their email address.
-@Event(ofAggregate: User, type: 'user.email_changed')
-class EmailChanged extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.email_changed')
+class EmailChanged extends ContinuumEvent {
   final String newEmail;
 
   EmailChanged({required super.eventId, required this.newEmail, super.occurredOn, super.metadata});

packages/continuum/example/lib/domain/events/user_deactivated.dart

@@ -3,8 +3,8 @@ import 'package:continuum/continuum.dart';
 import '../user.dart';
 
 /// Event fired when a user account is deactivated.
-@Event(ofAggregate: User, type: 'user.deactivated')
-class UserDeactivated extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.deactivated')
+class UserDeactivated extends ContinuumEvent {
   final DateTime deactivatedAt;
   final String? reason;
 

packages/continuum/example/lib/domain/events/user_registered.dart

@@ -3,8 +3,8 @@ import 'package:continuum/continuum.dart';
 import '../user.dart';
 
 /// Event fired when a new user registers.
-@Event(ofAggregate: User, type: 'user.registered')
-class UserRegistered extends DomainEvent {
+@AggregateEvent(of: User, type: 'user.registered')
+class UserRegistered extends ContinuumEvent {
   final String userId;
   final String email;
   final String name;

packages/continuum/example/lib/domain/user.g.dart

@@ -21,7 +21,7 @@ void main() {
 
   // Simulate an event history (as if loaded from an event store)
   print('Event history:');
-  final events = <DomainEvent>[
+  final events = <ContinuumEvent>[
     UserRegistered(
       eventId: const EventId('evt-1'),
       userId: 'user-789',