Add MAUI changelog, emit SyncStatus instead of SyncStatusOptions, changelog examples

Author: LucDeCaf

PowerSync/PowerSync.Common/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## 0.0.11-alpha.1
 
+- `StatusUpdated` and `StatusChanged` now both emit `SyncStatus` objects instead of just `StatusChanged`.
 - Converted most instances of a class inheriting from `EventStream<T>` into a class with an `EventManager` property called `Events`. This allows for subscribing to individual events instead of subscribing to all events and then filtering events manually.
 
 ```csharp
@@ -16,9 +17,28 @@ foreach (PowerSyncDBEvent update in listener)
     }
 }
 
+// Old (async)
+var listener = db.ListenAsync(cts.Token);
+await foreach (PowerSyncDBEvent update in listener)
+{
+    // Manually filter updates
+    if (update.StatusChanged != null)
+    {
+        Console.WriteLine("status changed: " + update.StatusChanged!);
+    }
+}
+
 // New
 var listener = db.Events.OnStatusChanged.Listen(cts.Token);
-foreach (PowerSyncDBEvents.StatusChangedEvent update in listener)
+await foreach (PowerSyncDBEvents.StatusChanged update in listener)
+{
+    // Events are filtered inherently
+    Console.WriteLine("status changed: " + update.Status);
+}
+
+// New (async) - recommended for most use cases
+var listener = db.Events.OnStatusChanged.ListenAsync(cts.Token);
+await foreach (PowerSyncDBEvents.StatusChanged update in listener)
 {
     // Events are filtered inherently
     Console.WriteLine("status changed: " + update.Status);

PowerSync/PowerSync.Common/Client/Sync/Stream/StreamingSyncImplementation.cs

@@ -93,9 +93,9 @@ public class StreamingSyncImplementationEvents : EventManager
 {
     public interface IStreamingSyncImplementationEvent;
 
-    public class StatusUpdatedEvent(SyncStatusOptions status) : IStreamingSyncImplementationEvent
+    public class StatusUpdatedEvent(SyncStatus status) : IStreamingSyncImplementationEvent
     {
-        public SyncStatusOptions Status { get; set; } = status;
+        public SyncStatus Status { get; set; } = status;
     }
     public class StatusChangedEvent(SyncStatus status) : IStreamingSyncImplementationEvent
     {
@@ -853,12 +853,20 @@ protected void UpdateSyncStatus(SyncStatusOptions options, UpdateSyncStatusOptio
             {
                 SyncStatus = updatedStatus;
                 logger.LogDebug("[Sync status changed]: {message}", updatedStatus.ToJSON());
+
+                // Emit events using new SyncStatus objects to prevent local modifications propagating to StreamingSyncImplementation
+
                 // Only trigger this if there was a change
-                Events.Emit(new StreamingSyncImplementationEvents.StatusChangedEvent(updatedStatus));
-            }
+                Events.Emit(new StreamingSyncImplementationEvents.StatusChangedEvent(new SyncStatus(updatedStatus.Options)));
 
-            // Trigger this for all updates
-            Events.Emit(new StreamingSyncImplementationEvents.StatusUpdatedEvent(options));
+                // Emit StatusUpdated event wrapping a new SyncStatus object (prevents race conditions)
+                Events.Emit(new StreamingSyncImplementationEvents.StatusUpdatedEvent(new SyncStatus(updatedStatus.Options)));
+            }
+            else
+            {
+                // Emit StatusUpdated event directly wrapping `updatedStatus` (not exposed elsewhere)
+                Events.Emit(new StreamingSyncImplementationEvents.StatusUpdatedEvent(updatedStatus));
+            }
         }
         catch (Exception ex)
         {

PowerSync/PowerSync.Maui/CHANGELOG.md

@@ -1,5 +1,9 @@
 # PowerSync.Maui Changelog
 
+## 0.0.9-alpha.1
+
+- Upstream PowerSync.Common version bump (See Powersync.Common changelog 0.0.11-alpha.1 for more information)
+
 ## 0.0.8-alpha.1
 
 - Upstream PowerSync.Common version bump (See Powersync.Common changelog 0.0.10-alpha.1 for more information)