feat: expose close method

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

@@ -120,4 +120,12 @@ public interface PowerSyncDatabase : Queries {
      * To preserve data in local-only tables, set clearLocal to false.
      */
     public suspend fun disconnectAndClear(clearLocal: Boolean = true)
+
+    /**
+     * Close the database, releasing resources.
+     * Also disconnects any active connection.
+     *
+     * Once close is called, this database cannot be used again - a new one must be constructed.
+     */
+    public suspend fun close()
 }

core/src/commonMain/kotlin/com/powersync/db/PowerSyncDatabaseImpl.kt

@@ -314,6 +314,11 @@ internal class PowerSyncDatabaseImpl(
         }
     }
 
+    override suspend fun close() {
+        disconnect()
+        internalDb.close()
+    }
+
     /**
      * Check that a supported version of the powersync extension is loaded.
      */

core/src/commonMain/kotlin/com/powersync/db/internal/InternalDatabase.kt

@@ -14,4 +14,6 @@ internal interface InternalDatabase : Queries {
     fun getExistingTableNames(tableGlob: String): List<String>
 
     fun updatesOnTable(tableName: String): Flow<Unit>
+
+    fun close()
 }

core/src/commonMain/kotlin/com/powersync/db/internal/InternalDatabaseImpl.kt

@@ -261,6 +261,10 @@ internal class InternalDatabaseImpl(
         return existingTableNames
     }
 
+    override fun close() {
+        this.driver.close()
+    }
+
     internal data class ExplainQueryResult(
         val addr: String,
         val opcode: String,