add exception helper

Author: stevensJourney

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 * Fixed `CrudBatch` `hasMore` always returning false.
 * Added `triggerImmediately` to `onChange` method.
+* [Internal] Added helper method for Swift `PowerSyncException` throwing.
 
 ## 1.0.0-BETA32
 

core/src/commonMain/kotlin/com/powersync/PowerSyncException.kt

@@ -4,3 +4,16 @@ public class PowerSyncException(
     message: String,
     cause: Throwable,
 ) : Exception(message, cause)
+
+
+/**
+ * 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