Commonize

JuulLabs · Sep 2, 2024 · e4c74e9 · e4c74e9
1 parent 7c2f77d
commit e4c74e9
Show file tree

Hide file tree

Showing 102 changed files with 1,318 additions and 1,763 deletions.
diff --git a/README.md b/README.md
@@ -77,7 +77,7 @@ a [`WriteTransaction`] sharing that store.
 
 ```kotlin
 val bill = database.transaction("customers") {
-    objectStore("customers").get(Key("444-44-4444")) as Customer
+    objectStore("customers").get(IDBKey("444-44-4444")) as Customer
 }
 assertEquals("Bill", bill.name)
 ```

diff --git a/core/build.gradle.kts b/core/build.gradle.kts
@@ -1,4 +1,5 @@
 import org.jetbrains.kotlin.gradle.ExperimentalWasmDsl
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask
 
 plugins {
     kotlin("multiplatform")
@@ -23,28 +24,28 @@ kotlin {
 
     sourceSets {
         commonMain.dependencies {
+            api(project(":external"))
+
             api(libs.coroutines.core)
         }
 
         commonTest.dependencies {
-            implementation(kotlin("test-common"))
-            implementation(kotlin("test-annotations-common"))
-        }
-
-        jsMain.dependencies {
-            implementation(project(":external"))
+            implementation(kotlin("test"))
+            implementation(libs.coroutines.test)
         }
 
         jsTest.dependencies {
             implementation(kotlin("test-js"))
         }
 
-        wasmJsMain.dependencies {
-            implementation(project(":external"))
-        }
-
         wasmJsTest.dependencies {
             implementation(kotlin("test-wasm-js"))
         }
     }
 }
+
+tasks.withType<KotlinCompilationTask<*>>().configureEach {
+    compilerOptions {
+        freeCompilerArgs.add("-Xexpect-actual-classes")
+    }
+}
diff --git a/core/src/wasmJsMain/kotlin/Cursor.kt → core/src/commonMain/kotlin/Cursor.kt b/core/src/wasmJsMain/kotlin/Cursor.kt → core/src/commonMain/kotlin/Cursor.kt
@@ -1,17 +1,17 @@
-package com.juul.indexeddb
-
 import com.juul.indexeddb.external.IDBCursor
 import com.juul.indexeddb.external.IDBCursorWithValue
+import com.juul.indexeddb.external.IDBKey
+import com.juul.indexeddb.external.JsAny
 import kotlinx.coroutines.channels.SendChannel
 
 public open class Cursor internal constructor(
     internal open val cursor: IDBCursor,
     private val channel: SendChannel<*>,
 ) {
-    public val key: JsAny
+    public val key: IDBKey
         get() = cursor.key
 
-    public val primaryKey: JsAny
+    public val primaryKey: IDBKey
         get() = cursor.primaryKey
 
     public fun close() {
@@ -26,12 +26,12 @@ public open class Cursor internal constructor(
         cursor.advance(count)
     }
 
-    public fun `continue`(key: Key) {
-        cursor.`continue`(key.toJs())
+    public fun `continue`(key: IDBKey) {
+        cursor.`continue`(key)
     }
 
-    public fun continuePrimaryKey(key: Key, primaryKey: Key) {
-        cursor.continuePrimaryKey(key.toJs(), primaryKey.toJs())
+    public fun continuePrimaryKey(key: IDBKey, primaryKey: IDBKey) {
+        cursor.continuePrimaryKey(key, primaryKey)
     }
 
     public enum class Direction(

diff --git a/core/src/wasmJsMain/kotlin/CursorStart.kt → core/src/commonMain/kotlin/CursorStart.kt b/core/src/wasmJsMain/kotlin/CursorStart.kt → core/src/commonMain/kotlin/CursorStart.kt
@@ -1,6 +1,5 @@
-package com.juul.indexeddb
-
 import com.juul.indexeddb.external.IDBCursor
+import com.juul.indexeddb.external.IDBKey
 
 public sealed class CursorStart {
 
@@ -15,19 +14,19 @@ public sealed class CursorStart {
     }
 
     public data class Continue(
-        val key: Key,
+        val key: IDBKey,
     ) : CursorStart() {
         override fun apply(cursor: IDBCursor) {
-            cursor.`continue`(key.toJs())
+            cursor.`continue`(key)
         }
     }
 
     public data class ContinuePrimaryKey(
-        val key: Key,
-        val primaryKey: Key,
+        val key: IDBKey,
+        val primaryKey: IDBKey,
     ) : CursorStart() {
         override fun apply(cursor: IDBCursor) {
-            cursor.continuePrimaryKey(key.toJs(), primaryKey.toJs())
+            cursor.continuePrimaryKey(key, primaryKey)
         }
     }
 }
diff --git a/core/src/wasmJsMain/kotlin/Database.kt → core/src/commonMain/kotlin/Database.kt b/core/src/wasmJsMain/kotlin/Database.kt → core/src/commonMain/kotlin/Database.kt
@@ -1,12 +1,11 @@
-package com.juul.indexeddb
-
 import com.juul.indexeddb.external.IDBDatabase
 import com.juul.indexeddb.external.IDBFactory
 import com.juul.indexeddb.external.IDBTransactionDurability
 import com.juul.indexeddb.external.IDBTransactionOptions
 import com.juul.indexeddb.external.IDBVersionChangeEvent
 import com.juul.indexeddb.external.indexedDB
-import kotlinx.browser.window
+import com.juul.indexeddb.external.window
+import com.juul.indexeddb.selfIndexedDB
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 
@@ -81,23 +80,28 @@ public class Database internal constructor(
      * - `suspend` functions composed entirely of other legal functions
      */
     public suspend fun <T> transaction(
-        vararg store: String,
+        store: String,
+        vararg moreStores: String,
         durability: IDBTransactionDurability = IDBTransactionDurability.Default,
         action: suspend Transaction.() -> T,
     ): T = withContext(Dispatchers.Unconfined) {
-        check(store.isNotEmpty()) {
-            "At least one store needs to be passed to transaction"
-        }
+        val transaction = when {
+            moreStores.isEmpty() -> Transaction(
+                ensureDatabase().transaction(
+                    storeName = store,
+                    mode = "readonly",
+                    options = IDBTransactionOptions(durability),
+                ),
+            )
 
-        val transaction = Transaction(
-            ensureDatabase().transaction(
-                storeNames = ReadonlyArray(
-                    *store.map { it.toJsString() }.toTypedArray(),
+            else -> Transaction(
+                ensureDatabase().transaction(
+                    storeNames = toReadonlyArray(store, *moreStores),
+                    mode = "readonly",
+                    options = IDBTransactionOptions(durability),
                 ),
-                mode = "readonly",
-                options = IDBTransactionOptions(durability),
-            ),
-        )
+            )
+        }
         val result = transaction.action()
         transaction.awaitCompletion()
         result
@@ -110,28 +114,34 @@ public class Database internal constructor(
      * - `suspend` functions composed entirely of other legal functions
      */
     public suspend fun <T> writeTransaction(
-        vararg store: String,
+        store: String,
+        vararg moreStores: String,
         durability: IDBTransactionDurability = IDBTransactionDurability.Default,
         action: suspend WriteTransaction.() -> T,
     ): T = withContext(Dispatchers.Unconfined) {
-        check(store.isNotEmpty()) {
-            "At least one store needs to be passed to writeTransaction"
-        }
+        val transaction = when {
+            moreStores.isEmpty() -> WriteTransaction(
+                ensureDatabase()
+                    .transaction(
+                        storeName = store,
+                        mode = "readwrite",
+                        options = IDBTransactionOptions(durability),
+                    ),
+            )
 
-        val transaction = WriteTransaction(
-            ensureDatabase()
-                .transaction(
-                    storeNames = ReadonlyArray(
-                        *store.map { it.toJsString() }.toTypedArray(),
+            else -> WriteTransaction(
+                ensureDatabase()
+                    .transaction(
+                        storeNames = toReadonlyArray(store, *moreStores),
+                        mode = "readwrite",
+                        options = IDBTransactionOptions(durability),
                     ),
-                    mode = "readwrite",
-                    options = IDBTransactionOptions(durability),
-                ),
-        )
+            )
+        }
 
         with(transaction) {
             // Force overlapping transactions to not call `action` until prior transactions complete.
-            objectStore(store.first())
+            objectStore(store)
                 .openKeyCursor(autoContinue = false)
                 .collect { it.close() }
         }
@@ -145,6 +155,3 @@ public class Database internal constructor(
         database = null
     }
 }
-
-@Suppress("RedundantNullableReturnType")
-private val selfIndexedDB: IDBFactory? = js("self.indexedDB || self.webkitIndexedDB")
diff --git a/core/src/wasmJsMain/kotlin/Exceptions.kt → core/src/commonMain/kotlin/Exceptions.kt b/core/src/wasmJsMain/kotlin/Exceptions.kt → core/src/commonMain/kotlin/Exceptions.kt
@@ -1,6 +1,4 @@
-package com.juul.indexeddb
-
-import org.w3c.dom.events.Event
+import com.juul.indexeddb.external.Event
 
 public abstract class EventException(
     message: String?,

diff --git a/core/src/commonMain/kotlin/Index.kt b/core/src/commonMain/kotlin/Index.kt
@@ -0,0 +1,31 @@
+import com.juul.indexeddb.external.IDBCursor
+import com.juul.indexeddb.external.IDBCursorWithValue
+import com.juul.indexeddb.external.IDBIndex
+import com.juul.indexeddb.external.IDBKey
+import com.juul.indexeddb.external.JsNumber
+import com.juul.indexeddb.external.ReadonlyArray
+
+public class Index internal constructor(
+    internal val index: IDBIndex,
+) : Queryable() {
+    override fun requestGet(key: IDBKey): Request<*> =
+        Request(index.get(key))
+
+    override fun requestGetAll(query: IDBKey?): Request<ReadonlyArray<*>> =
+        Request(index.getAll(query))
+
+    override fun requestOpenCursor(
+        query: IDBKey?,
+        direction: Cursor.Direction,
+    ): Request<IDBCursorWithValue?> =
+        Request(index.openCursor(query, direction.constant))
+
+    override fun requestOpenKeyCursor(
+        query: IDBKey?,
+        direction: Cursor.Direction,
+    ): Request<IDBCursor?> =
+        Request(index.openKeyCursor(query, direction.constant))
+
+    override fun requestCount(query: IDBKey?): Request<JsNumber> =
+        Request(index.count(query))
+}
diff --git a/core/src/commonMain/kotlin/JsArray.kt b/core/src/commonMain/kotlin/JsArray.kt
@@ -0,0 +1,30 @@
+import com.juul.indexeddb.external.JsAny
+import com.juul.indexeddb.external.JsArray
+import com.juul.indexeddb.external.JsString
+import com.juul.indexeddb.external.ReadonlyArray
+import com.juul.indexeddb.external.set
+import com.juul.indexeddb.external.toJsString
+import com.juul.indexeddb.toReadonlyArray
+
+internal fun toReadonlyArray(value: String, vararg moreValues: String): ReadonlyArray<JsString> =
+    JsArray<JsString>()
+        .apply {
+            set(0, value.toJsString())
+            moreValues.forEachIndexed { index, s ->
+                set(index + 1, s.toJsString())
+            }
+        }.toReadonlyArray()
+
+internal fun Iterable<String?>.toJsArray(): JsArray<JsString?> =
+    JsArray<JsString?>().apply {
+        forEachIndexed { index, s ->
+            set(index, s?.toJsString())
+        }
+    }
+
+internal fun <T : JsAny?> JsArray(vararg values: T): JsArray<T> =
+    JsArray<T>().apply {
+        for (i in values.indices) {
+            set(i, values[i])
+        }
+    }
diff --git a/core/src/commonMain/kotlin/Jso.kt b/core/src/commonMain/kotlin/Jso.kt
@@ -0,0 +1,9 @@
+package com.juul.indexeddb
+
+import com.juul.indexeddb.external.JsAny
+
+// Copied from:
+// https://github.com/JetBrains/kotlin-wrappers/blob/91b2c1568ec6f779af5ec10d89b5e2cbdfe785ff/kotlin-extensions/src/main/kotlin/kotlinx/js/jso.kt
+
+internal expect fun <T : JsAny> jso(): T
+internal fun <T : JsAny> jso(block: T.() -> Unit): T = jso<T>().apply(block)
diff --git a/core/src/commonMain/kotlin/Key.kt b/core/src/commonMain/kotlin/Key.kt
@@ -0,0 +1,39 @@
+import com.juul.indexeddb.external.IDBKey
+import com.juul.indexeddb.external.IDBKeyRange
+import com.juul.indexeddb.external.JsAny
+import com.juul.indexeddb.external.toJsString
+
+public object AutoIncrement
+
+public class KeyPath private constructor(
+    private val paths: List<String?>,
+) {
+    init {
+        require(paths.isNotEmpty()) { "A key path must have at least one member." }
+    }
+
+    public constructor(path: String?, vararg morePaths: String?) : this(listOf(path, *morePaths))
+
+    internal fun toJs(): JsAny? = if (paths.size == 1) paths[0]?.toJsString() else paths.toJsArray()
+}
+
+public fun lowerBound(
+    x: JsAny?,
+    open: Boolean = false,
+): IDBKey = IDBKey(IDBKeyRange.lowerBound(x, open))
+
+public fun upperBound(
+    y: JsAny?,
+    open: Boolean = false,
+): IDBKey = IDBKey(IDBKeyRange.upperBound(y, open))
+
+public fun bound(
+    x: JsAny?,
+    y: JsAny?,
+    lowerOpen: Boolean = false,
+    upperOpen: Boolean = false,
+): IDBKey = IDBKey(IDBKeyRange.bound(x, y, lowerOpen, upperOpen))
+
+public fun only(
+    z: JsAny?,
+): IDBKey = IDBKey(IDBKeyRange.only(z))
diff --git a/core/src/commonMain/kotlin/ObjectStore.kt b/core/src/commonMain/kotlin/ObjectStore.kt
@@ -0,0 +1,25 @@
+import com.juul.indexeddb.external.IDBCursor
+import com.juul.indexeddb.external.IDBCursorWithValue
+import com.juul.indexeddb.external.IDBKey
+import com.juul.indexeddb.external.IDBObjectStore
+import com.juul.indexeddb.external.JsNumber
+import com.juul.indexeddb.external.ReadonlyArray
+
+public class ObjectStore internal constructor(
+    internal val objectStore: IDBObjectStore,
+) : Queryable() {
+    override fun requestGet(key: IDBKey): Request<*> =
+        Request(objectStore.get(key))
+
+    override fun requestGetAll(query: IDBKey?): Request<ReadonlyArray<*>> =
+        Request(objectStore.getAll(query))
+
+    override fun requestOpenCursor(query: IDBKey?, direction: Cursor.Direction): Request<IDBCursorWithValue?> =
+        Request(objectStore.openCursor(query, direction.constant))
+
+    override fun requestOpenKeyCursor(query: IDBKey?, direction: Cursor.Direction): Request<IDBCursor?> =
+        Request(objectStore.openKeyCursor(query, direction.constant))
+
+    override fun requestCount(query: IDBKey?): Request<JsNumber> =
+        Request(objectStore.count(query))
+}
diff --git a/core/src/wasmJsMain/kotlin/OnNextEvent.kt → core/src/commonMain/kotlin/OnNextEvent.kt b/core/src/wasmJsMain/kotlin/OnNextEvent.kt → core/src/commonMain/kotlin/OnNextEvent.kt
@@ -1,8 +1,6 @@
-package com.juul.indexeddb
-
+import com.juul.indexeddb.external.Event
+import com.juul.indexeddb.external.EventTarget
 import kotlinx.coroutines.suspendCancellableCoroutine
-import org.w3c.dom.events.Event
-import org.w3c.dom.events.EventTarget
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException