Add Room encryption docs for Kotlin SDK

README.md

@@ -11,19 +11,13 @@ Welcome to the PowerSync documentation repository! Our docs are powered by [Mint
    git clone https://github.com/YOUR-USERNAME/powersync-docs.git
    cd powersync-docs
    ```
-2. **Install Mintlify CLI:**
+2. **Install dependencies:**
    ```
-   npx mintlify install
+   pnpm install
    ```
 3. **Start the local docs server:**
-   - Run the following command at the root of the repo (where docs.json is):
    ```
-   npx mintlify dev
-   ```
-
-   - If you see the error `✖ Must be run in a directory where a mint.json file exists.`, update Mintlify:
-   ```
-   npx mintlify@latest dev
+   npm run dev
    ```
 
 ## Contributing
@@ -83,5 +77,5 @@ We use the following icons for supported backend databases and SDKs:
 
 ## Troubleshooting
 
-- **Mintlify dev isn't running:** Run `npx mintlify install` to re-install dependencies.
+- **Mintlify dev isn't running:** Run `pnpm install` to re-install dependencies.
 - **Page loads as a 404:** Make sure you are running in a folder with `docs.json`.

client-sdks/advanced/data-encryption.mdx

@@ -15,7 +15,7 @@
 The PowerSync SDK supports [SQLite3MultipleCiphers](https://utelle.github.io/SQLite3MultipleCiphers)
 on all native platforms and the web, which can be used to encrypt databases.
 
 <Note>Setting up encryption has changed in version 2.0 of the PowerSync SDK. When upgrading, follow these steps and remove dependencies on `powersync_sqlcipher`.</Note>
 
 To enable encryption, pass an instance of `EncryptionOptions` to a `PowerSyncDatabase` constructor:
 
@@ -87,7 +87,7 @@
 
 2. Add a dependency on `com.powersync:sqlite3multipleciphers`.
 
 3. Since `:core` includes a Ktor client implementation, you'll need to [add one manually](https://ktor.io/docs/client-engines.html) if you're not already using Ktor:
    - Android/JVM: `io.ktor:ktor-client-okhttp`
    - Apple targets (Kotlin/Native): `io.ktor:ktor-client-darwin`
 
@@ -128,6 +128,36 @@
 </Note>
 
 For more details, see the [`sqlite3multipleciphers` README](https://github.com/powersync-ja/powersync-kotlin/tree/main/sqlite3multipleciphers) in the PowerSync Kotlin SDK repository.
+
+**Using encryption with Room:**
+
+When using PowerSync [with Room](/client-sdks/orms/kotlin/room), PowerSync wraps the Room database instead of opening its own connection. To use an encrypted database with Room, wrap an encrypted `PersistentConnectionFactory` in a `SQLiteDriver` and pass it to `RoomDatabase.Builder.setDriver`:
+
+```kotlin
+class PowerSyncConnectionFactoryAsSqliteDriver(
+    private val powersyncFactory: PersistentConnectionFactory
+) : SQLiteDriver {
+    override fun open(fileName: String): SQLiteConnection {
+        if (fileName == ":memory:") {
+            return powersyncFactory.openInMemoryConnection()
+        }
+
+        return powersyncFactory.openConnection(fileName, null, false)
+    }
+}
+```
+
+Depending on your target platform, pass an `AndroidEncryptedDatabaseFactory`, `JavaEncryptedDatabaseFactory`, or `NativeEncryptedDatabaseFactory` to the wrapper. The factory automatically installs the SQLite3MultipleCiphers extension — no manual setup required.
+
+```kotlin
+val driver = PowerSyncConnectionFactoryAsSqliteDriver(
+    AndroidEncryptedDatabaseFactory(context, Key.Passphrase("your encryption key"))
+)
+
+val roomDb = Room.databaseBuilder<MyDatabase>(context, "your_database")
+    .setDriver(driver)
+    .build()
+```
 </Accordion>
 
 <Accordion title="Swift" icon="swift">
@@ -138,9 +168,9 @@
 The PowerSync Swift SDK depends on [CSQLite](https://github.com/powersync-ja/CSQLite) to build and link SQLite.
 That package can be configured to optionally link SQLite3 Multiple Ciphers by enabling the `Encryption` trait. Due to SwiftPM limitations, we can't directly expose that trait on the Swift SDK.
 
 Instead, we recommend directly depending on CSQLite with the encryption trait, which will enable the same for the SDK (since each package can only appear in a build once). Since Xcode doesn't support specifying package traits when adding dependencies, you first need to add a local Swift package as a workaround.
 
 1. Create a local `Package.swift` in your project that depends on CSQLite with the `Encryption` trait:
 
 ```swift
 // swift-tools-version: 6.2

package.json

@@ -0,0 +1,10 @@
+{
+  "name": "powersync-docs",
+  "version": "1.0.0",
+  "scripts": {
+    "dev": "mintlify dev"
+  },
+  "devDependencies": {
+    "mintlify": "^4.2.520"
+  }
+}