Review feedback

Author: simolus3

common/README.md

@@ -18,6 +18,9 @@ structure:
 - `androidMain` - Android-specific code for loading the core extension.
 - `jvmMain` - Java-specific code for loading the core extension.
 - `nativeMain` - A SQLite driver implemented with cinterop calls to sqlite3.
+- `appleMain`: Utilities for finding a suitable database location on Apple platforms.
+- `appleNonWatchOsMain` and `watchosMain`: Loads the PowerSync core extension (which is linked statically on watchOS
+   and dynamically on other platforms).
 
 ## Attachment Helpers
 

common/build.gradle.kts

@@ -119,6 +119,8 @@ kotlin {
             }
 
             cinterops.create("sqlite3") {
+                // We're not linking SQLite here (to allow using this package with e.g. SQLCipher or
+                // SQLite3MultipleCiphers), :core depends on this package and is responsible for bundling SQLite.
                 packageName("com.powersync.internal.sqlite3")
                 includeDirs.allHeaders("src/nativeMain/interop/")
                 definitionFile.set(project.file("src/nativeMain/interop/sqlite3.def"))

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

@@ -98,7 +98,6 @@ public interface PowerSyncDatabase : Queries {
      *      params = params
      *  )
      *  ```
-     *  TODO: Internal Team - Status changes are reported on [statusStream].
      */
     @Throws(PowerSyncException::class, CancellationException::class)
     public suspend fun connect(