Support creating Peripheral from Identifier

Author: twyatt

kable-core/src/jsMain/kotlin/Peripheral.kt

@@ -1,6 +1,12 @@
 package com.juul.kable
 
 import com.juul.kable.external.BluetoothDevice
+import js.errors.JsError
+import kotlinx.coroutines.await
+import kotlinx.coroutines.ensureActive
+import web.errors.DOMException
+import web.errors.DOMException.Companion.SecurityError
+import kotlin.coroutines.coroutineContext
 
 public actual fun Peripheral(
     advertisement: Advertisement,
@@ -10,6 +16,32 @@ public actual fun Peripheral(
     return Peripheral(advertisement.bluetoothDevice, builderAction)
 }
 
+@Suppress("FunctionName") // Builder function.
+public suspend fun Peripheral(
+    identifier: Identifier,
+    builderAction: PeripheralBuilderAction,
+): WebBluetoothPeripheral? {
+    val bluetooth = bluetoothOrThrow()
+    val devices = try {
+        bluetooth.getDevices().await()
+    } catch (e: JsError) {
+        coroutineContext.ensureActive()
+        throw when {
+            // The Web Bluetooth API can only be used in a secure context.
+            // https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API#security_considerations
+            e is DOMException && e.name == SecurityError ->
+                IllegalStateException("Operation is not permitted in this context due to security concerns", e)
+
+            else -> InternalError("Failed to invoke getDevices request", e)
+        }
+    }
+    return devices.singleOrNull { bluetoothDevice ->
+        bluetoothDevice.id == identifier
+    }?.let { bluetoothDevice ->
+        Peripheral(bluetoothDevice, builderAction)
+    }
+}
+
 @Suppress("FunctionName") // Builder function.
 internal fun Peripheral(
     bluetoothDevice: BluetoothDevice,

kable-core/src/jsMain/kotlin/external/Bluetooth.kt

@@ -8,4 +8,5 @@ internal abstract external class Bluetooth : EventTarget {
     fun getAvailability(): Promise<Boolean>
     fun requestDevice(options: RequestDeviceOptions): Promise<BluetoothDevice>
     fun requestLEScan(options: BluetoothLEScanOptions): Promise<BluetoothScan>
+    fun getDevices(): Promise<Array<BluetoothDevice>>
 }