Merge branch 'main' into offload-queries

Author: LucDeCaf

.github/workflows/release.yml

@@ -18,24 +18,25 @@ jobs:
       - name: Setup .NET SDK
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: '8.0.x'
+          dotnet-version: "8.0.x"
 
       - name: Install MAUI Workloads
         run: dotnet workload restore
 
       - name: Download PowerSync extension
-        run: dotnet run --project Tools/Setup    
+        run: dotnet run --project Tools/Setup
 
       - name: Restore dependencies
         run: dotnet restore
-      
+
       - name: Extract Common Package Version from CHANGELOG.md
         id: extract_version
         shell: bash
         run: |
-          VERSION=$(awk '/^## [0-9]+\.[0-9]+\.[0-9]+/ {print $2; exit}' PowerSync/PowerSync.Common/CHANGELOG.md)
-          echo "Detected Version: $VERSION"
-          echo "VERSION=$VERSION" >> $GITHUB_ENV 
+          COMMON_VERSION=$(awk '/^## [0-9]+\.[0-9]+\.[0-9]+/ {print $2; exit}' PowerSync/PowerSync.Common/CHANGELOG.md)
+          echo "Detected Version: $COMMON_VERSION"
+          echo "VERSION=$COMMON_VERSION" >> $GITHUB_ENV
+          echo "COMMON_VERSION=$COMMON_VERSION" >> $GITHUB_ENV
 
       - name: Run Pack for Common
         run: dotnet pack PowerSync/PowerSync.Common -c Release -o ${{ github.workspace }}/output
@@ -51,7 +52,8 @@ jobs:
           MAUI_VERSION=$(awk '/^## [0-9]+\.[0-9]+\.[0-9]+/ {print $2; exit}' PowerSync/PowerSync.Maui/CHANGELOG.md)
           echo "Detected Version: $MAUI_VERSION"
           echo "VERSION=$MAUI_VERSION" >> $GITHUB_ENV
-          
+          echo "MAUI_VERSION=$MAUI_VERSION" >> $GITHUB_ENV
+
       - name: Build MAUI Project
         run: dotnet build PowerSync/PowerSync.Maui -c Release
 
@@ -60,4 +62,21 @@ jobs:
 
       - name: Run Push For MAUI
         continue-on-error: true
-        run: dotnet nuget push ${{ github.workspace }}/output/PowerSync.Maui*.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NUGET_API_KEY }}
+        run: dotnet nuget push ${{ github.workspace }}/output/PowerSync.Maui*.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NUGET_API_KEY }}
+
+      - name: Create GitHub Releases
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "PowerSync.Common@${{ env.COMMON_VERSION }}" \
+            --prerelease \
+            --title "PowerSync.Common@${{ env.COMMON_VERSION }}" \
+            --target main \
+            --generate-notes \
+            ${{ github.workspace }}/output/PowerSync.Common*.nupkg
+          gh release create "PowerSync.Maui@${{ env.MAUI_VERSION }}" \
+            --prerelease \
+            --title "PowerSync.Maui@${{ env.MAUI_VERSION }}" \
+            --target main \
+            --generate-notes \
+            ${{ github.workspace }}/output/PowerSync.Maui*.nupkg

PowerSync/PowerSync.Common/CHANGELOG.md

@@ -1,5 +1,34 @@
 # PowerSync.Common Changelog
 
+## 0.0.11-alpha.1
+
+- Removed the `RunListener` and `RunListenerAsync` APIs from `IEventStream`. Users are encouraged to use the `Listen` or `ListenAsync` APIs instead (`RunListener` itself was implemented using the `Listen` API).
+- Changed the `PowerSyncDatabase.Watch` syntax to return an IAsyncEnumerable instead of accepting a callback. This allows users to handle database changes when they are ready instead of us eagerly running the callback as soon as a change is detected.
+
+```csharp
+// Optional cancellation token
+var cts = new CancellationTokenSource();
+
+// Register listener synchronously on the calling thread...
+var listener = db.Watch<Todo>(
+    "SELECT * FROM todos",
+    [],
+    new SQLWatchOptions { Signal = cts.Token }
+);
+
+// ...then listen to changes on another thread
+_ = Task.Run(async () =>
+{
+    await foreach (var result in listener)
+    {
+        Console.WriteLine($"Number of todos: {result.Length}");
+    }
+}, cts.Token);
+
+// Stop watching by cancelling token
+cts.Cancel();
+```
+
 ## 0.0.10-alpha.1
 
 - Fixed watched queries sometimes resolving to the wrong underlying tables after a schema change.