Add SQLDelight driver

# Conflicts:
#	gradle/libs.versions.toml

Author: simolus3

compose/build.gradle.kts

@@ -8,6 +8,7 @@ plugins {
     alias(libs.plugins.compose.compiler)
     alias(libs.plugins.kotlinter)
     id("com.powersync.plugins.sonatype")
+    id("com.powersync.plugins.sharedbuild")
     id("dokka-convention")
 }
 

gradle/libs.versions.toml

@@ -33,6 +33,7 @@ compose-lifecycle = "2.9.2"
 androidxSqlite = "2.6.0-rc02"
 androidxSplashscreen = "1.0.1"
 room = "2.8.0-rc02"
+sqldelight = "2.1.0"
 
 # plugins
 android-gradle-plugin = "8.12.1"
@@ -103,6 +104,9 @@ androidx-sqlite-sqlite = { module = "androidx.sqlite:sqlite", version.ref = "and
 androidx-sqlite-bundled = { module = "androidx.sqlite:sqlite-bundled", version.ref = "androidxSqlite" }
 androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "room" }
 androidx-room-compiler = { module = "androidx.room:room-compiler", version.ref = "room" }
+sqldelight-coroutines = { module = "app.cash.sqldelight:coroutines-extensions", version.ref = "sqldelight" }
+sqldelight-runtime = { module = "app.cash.sqldelight:runtime", version.ref = "sqldelight" }
+sqldelight-dialect-sqlite38 = { module = "app.cash.sqldelight:sqlite-3-38-dialect", version.ref = "sqldelight" }
 
 # Sample - Android
 androidx-core = { group = "androidx.core", name = "core-ktx", version.ref = "androidx-core" }
@@ -151,3 +155,4 @@ kotlin-atomicfu = { id = "org.jetbrains.kotlinx.atomicfu", version.ref = "atomic
 buildKonfig = { id = "com.codingfeline.buildkonfig", version.ref = "buildKonfig" }
 ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
 androidx-room = { id = "androidx.room", version.ref = "room" }
+sqldelight = { id = "app.cash.sqldelight", version.ref = "sqldelight" }

integrations/sqldelight-test-database/build.gradle.kts

@@ -0,0 +1,46 @@
+import com.powersync.plugins.utils.powersyncTargets
+import org.jmailen.gradle.kotlinter.tasks.FormatTask
+import org.jmailen.gradle.kotlinter.tasks.LintTask
+
+plugins {
+    alias(libs.plugins.kotlinMultiplatform)
+    alias(libs.plugins.kotlinter)
+    alias(libs.plugins.sqldelight)
+    id("com.powersync.plugins.sharedbuild")
+}
+
+kotlin {
+    // We don't test on Android devices, JVM tests are enough for the SQLDelight test package since
+    // it doesn't contain Android-specific code.
+    powersyncTargets(android = false)
+
+    explicitApi()
+    applyDefaultHierarchyTemplate()
+
+    sourceSets {
+        commonMain.dependencies {
+            api(libs.sqldelight.runtime)
+        }
+    }
+}
+
+sqldelight {
+    databases {
+        linkSqlite.set(false)
+
+        create("TestDatabase") {
+            packageName.set("com.powersync.integrations.sqldelight")
+            generateAsync.set(true)
+            deriveSchemaFromMigrations.set(false)
+            dialect(libs.sqldelight.dialect.sqlite38)
+        }
+    }
+}
+
+tasks.withType<LintTask> {
+    exclude { it.file.path.contains("build/generated") }
+}
+
+tasks.withType<FormatTask> {
+    exclude { it.file.path.contains("build/generated") }
+}

integrations/sqldelight-test-database/src/commonMain/sqldelight/com/powersync/integrations/sqldelight/todos.sq

@@ -0,0 +1,11 @@
+CREATE TABLE todos (
+    id TEXT NOT NULL DEFAULT '',
+    title TEXT,
+    content TEXT
+);
+
+all:
+SELECT * FROM todos;
+
+create:
+INSERT INTO todos (id, title, content) VALUES (uuid(), ?, ?);

integrations/sqldelight/README.md

@@ -0,0 +1,62 @@
+## PowerSync SQLDelight driver
+
+This library provides the `PowerSyncDriver` class, which implements an `SqlDriver` for `SQLDelight`
+backed by PowerSync.
+
+## Setup
+
+Add a dependency on `com.powersync:integration-sqldelight`, using the same version you use for the
+PowerSync SDK.
+
+## Usage
+
+To get started, ensure that SQLDelight is not linking sqlite3 (the PowerSync SDK takes care of that,
+and you don't want to link it twice). Also, ensure the async generator is active because the
+PowerSync driver does not support synchronous reads:
+
+```kotlin
+sqldelight {
+    databases {
+        linkSqlite.set(false)
+
+        create("MyAppDatabase") {
+            generateAsync.set(true)
+            deriveSchemaFromMigrations.set(false)
+
+            dialect("app.cash.sqldelight:sqlite-3-38-dialect")
+        }
+    }
+}
+```
+
+Next, define your tables in `.sq` files (but note that the `CREATE TABLE` statement won't be used,
+PowerSync creates JSON-backed views for tables instead).
+Open a PowerSync database [in the usual way](https://docs.powersync.com/client-sdk-references/kotlin-multiplatform#getting-started)
+and finally pass it to the constructor of your generated SQLDelight database:
+
+```kotlin
+val db: PowerSyncDatabase = openPowerSyncDatabase()
+val yourSqlDelightDatabase = YourDatabase(PowerSyncDriver(db))
+```
+
+Afterwards, writes on both databases (the original `PowerSyncDatabase` instance and the SQLDelight
+database) will be visible to each other, update each other's query flows and will get synced
+properly.
+
+## Limitations
+
+Please note that this library is currently in alpha. It is tested, but API changes are still
+possible.
+
+There are also some limitations to be aware of:
+
+1. Due to historical reasons, the PowerSync SDK migrates all databases to `user_version` 1 when
+   created (but it will never downgrade a database).
+   So if you want to use SQLDelight's schema tools, the first version would have to be `2`.
+2. While you can write `CREATE TABLE` statements in your `.sq` files, note that these aren't
+   actually used - you still have to define your PowerSync schema and the SDK will auto-create the
+   tables from there.
+   If you want to use the schema managed by SQLDelight, configure PowerSync to use
+   [raw tables](https://docs.powersync.com/usage/use-case-examples/raw-tables).
+3. Functions and tables contributed by the PowerSync core extension are not visible to `.sq` files
+   at the moment. We might revisit this with a custom dialect in the future.

integrations/sqldelight/build.gradle.kts

@@ -0,0 +1,57 @@
+import com.powersync.plugins.utils.powersyncTargets
+
+plugins {
+    alias(libs.plugins.kotlinMultiplatform)
+    alias(libs.plugins.android.library)
+    alias(libs.plugins.kotlinter)
+    alias(libs.plugins.kotlin.atomicfu)
+    id("com.powersync.plugins.sonatype")
+    id("dokka-convention")
+}
+
+kotlin {
+    powersyncTargets()
+    explicitApi()
+    applyDefaultHierarchyTemplate()
+
+    sourceSets {
+        commonMain.dependencies {
+            api(projects.core)
+            api(libs.sqldelight.runtime)
+            implementation(libs.kotlinx.coroutines.core)
+        }
+
+        jvmTest.dependencies {
+            // Separate project because SQLDelight can't generate code in test source sets.
+            implementation(projects.integrations.sqldelightTestDatabase)
+
+            implementation(libs.kotlin.test)
+            implementation(libs.test.turbine)
+            implementation(libs.test.coroutines)
+            implementation(libs.test.kotest.assertions)
+
+            implementation(libs.sqldelight.coroutines)
+        }
+    }
+}
+
+android {
+    namespace = "com.powersync.drivers.common"
+    compileSdk =
+        libs.versions.android.compileSdk
+            .get()
+            .toInt()
+    defaultConfig {
+        minSdk =
+            libs.versions.android.minSdk
+                .get()
+                .toInt()
+    }
+    kotlin {
+        jvmToolchain(17)
+    }
+}
+
+dokka {
+    moduleName.set("PowerSync for SQLDelight")
+}

integrations/sqldelight/gradle.properties

@@ -0,0 +1,3 @@
+POM_ARTIFACT_ID=integration-sqldelight
+POM_NAME=PowerSync SQLDelight driver
+POM_DESCRIPTION=Use a PowerSync database for your SQLDelight database.