Merge branch 'main' into v1

Author: stevensJourney

CHANGELOG.md

@@ -7,6 +7,7 @@
 * Added `triggerImmediately` to `onChange` method.
 * Report real-time progress information about downloads through `SyncStatus.downloadProgress`.
 * Compose: Add `composeState()` extension method on `SyncStatus`.
+* [Internal] Added helper method for Swift `PowerSyncException` throwing.
 
 ## 1.0.0-BETA32
 

PowerSyncKotlin/src/appleMain/kotlin/com/powersync/SDK.kt

@@ -1,5 +1,15 @@
-@file:Suppress("ktlint:standard:no-empty-file")
-
 // This is required to build the iOS framework
 
 package com.powersync
+
+/**
+ * Helper class designed to bridge SKIEE methods and allow them to throw
+ * `PowerSyncException`. This is necessary because these exceptions cannot
+ * be thrown directly in Swift.
+ *
+ * The class provides a mechanism to handle exceptions in a way that is
+ * compatible with the Swift environment, ensuring proper error propagation
+ * and handling.
+ */
+@Throws(PowerSyncException::class)
+public fun throwPowerSyncException(exception: PowerSyncException): Unit = throw exception