@glassly/bluetooth-sdk 0.1.0-dev.26

package/android/src/main/java/com/glassly/bluetoothsdk/ReleaseChangelog.kt

@@ -0,0 +1,61 @@
+package com.glassly.bluetoothsdk
+
+/** One coordinated Glassly release note authored in /changelogs/<version>.md. */
+data class ReleaseChangelog(
+    val version: String,
+    val markdown: String,
+)
+
+internal object ReleaseChangelogCatalog {
+    private val baseVersionPattern = Regex("^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:[-+].*)?$")
+
+    fun select(
+        fromVersion: String?,
+        toVersion: String?,
+    ): List<ReleaseChangelog> {
+        val fallbackTarget =
+            GeneratedReleaseMetadata.FAMILY_BASE_VERSION.ifBlank {
+                GENERATED_RELEASE_CHANGELOGS.firstOrNull()?.version.orEmpty()
+            }
+        if (fallbackTarget.isBlank() && toVersion == null) return emptyList()
+        val target = baseVersion(toVersion ?: fallbackTarget, "toVersion")
+        if (GENERATED_RELEASE_CHANGELOGS.none { it.version == target }) {
+            throw BluetoothSdkException("missing_changelog", "No changelog is bundled for target version $target.")
+        }
+        if (fromVersion == null) return GENERATED_RELEASE_CHANGELOGS.filter { it.version == target }
+
+        val source = baseVersion(fromVersion, "fromVersion")
+        val direction = compareVersions(target, source)
+        return GENERATED_RELEASE_CHANGELOGS.filter { entry ->
+            when {
+                direction == 0 -> entry.version == target
+                direction > 0 -> compareVersions(entry.version, source) > 0 && compareVersions(entry.version, target) <= 0
+                else -> compareVersions(entry.version, source) < 0 && compareVersions(entry.version, target) >= 0
+            }
+        }
+    }
+
+    private fun baseVersion(
+        version: String,
+        label: String,
+    ): String {
+        val match = baseVersionPattern.matchEntire(version.trim())
+            ?: throw BluetoothSdkException(
+                "invalid_changelog_version",
+                "$label must be a semantic version such as 3.1.0, 3.1.0-dev.4, or 3.1.0-beta.2.",
+            )
+        return "${match.groupValues[1]}.${match.groupValues[2]}.${match.groupValues[3]}"
+    }
+
+    private fun compareVersions(
+        left: String,
+        right: String,
+    ): Int {
+        val a = left.split(".").map(String::toInt)
+        val b = right.split(".").map(String::toInt)
+        for (index in 0..2) {
+            if (a[index] != b[index]) return a[index] - b[index]
+        }
+        return 0
+    }
+}

package/android/src/main/java/com/glassly/bluetoothsdk/ScopedNetworkReadiness.kt

@@ -0,0 +1,17 @@
+package com.glassly.bluetoothsdk
+
+internal class ScopedNetworkReadiness<T> {
+    private var candidate: T? = null
+
+    fun onAvailable(network: T) {
+        candidate = network
+    }
+
+    fun isReady(network: T, isForeground: Boolean): Boolean = candidate == network && isForeground
+
+    fun contains(network: T): Boolean = candidate == network
+
+    fun clear() {
+        candidate = null
+    }
+}

package/android/src/main/java/com/glassly/bluetoothsdk/audio/AudioModels.kt

@@ -0,0 +1,144 @@
+package com.glassly.bluetoothsdk
+
+enum class MicPreference(val value: String) {
+    AUTO("auto"),
+    PHONE("phone"),
+    GLASSES("glasses"),
+    BLUETOOTH("bluetooth"),
+}
+
+data class MicPcmEvent(
+    val pcm: ByteArray,
+    val sampleRate: Int,
+    val bitsPerSample: Int,
+    val channels: Int,
+    val encoding: String,
+    val voiceActivityDetectionEnabled: Boolean,
+) {
+    constructor(values: Map<String, Any>) : this(
+        pcm = values["pcm"] as? ByteArray ?: ByteArray(0),
+        sampleRate = numberValue(values, "sampleRate") ?: SAMPLE_RATE,
+        bitsPerSample = numberValue(values, "bitsPerSample") ?: BITS_PER_SAMPLE,
+        channels = numberValue(values, "channels") ?: CHANNELS,
+        encoding = stringValue(values, "encoding") ?: ENCODING,
+        voiceActivityDetectionEnabled =
+            boolValue(values, "voiceActivityDetectionEnabled")
+                ?: BluetoothSdkDefaults.VOICE_ACTIVITY_DETECTION_ENABLED,
+    )
+
+    fun toMap(): Map<String, Any> =
+        mapOf(
+            "type" to "mic_pcm",
+            "pcm" to pcm,
+            "sampleRate" to sampleRate,
+            "bitsPerSample" to bitsPerSample,
+            "channels" to channels,
+            "encoding" to encoding,
+            "voiceActivityDetectionEnabled" to voiceActivityDetectionEnabled,
+        )
+
+    companion object {
+        const val SAMPLE_RATE = 16_000
+        const val BITS_PER_SAMPLE = 16
+        const val CHANNELS = 1
+        const val ENCODING = "pcm_s16le"
+    }
+}
+
+data class MicLc3Event(
+    val lc3: ByteArray,
+    val sampleRate: Int,
+    val channels: Int,
+    val encoding: String,
+    val frameDurationMs: Int,
+    val frameSizeBytes: Int,
+    val bitrate: Int,
+    val packetizedFromGlasses: Boolean,
+    val voiceActivityDetectionEnabled: Boolean,
+) {
+    constructor(values: Map<String, Any>) : this(
+        lc3 = values["lc3"] as? ByteArray ?: ByteArray(0),
+        sampleRate = numberValue(values, "sampleRate") ?: SAMPLE_RATE,
+        channels = numberValue(values, "channels") ?: CHANNELS,
+        encoding = stringValue(values, "encoding") ?: ENCODING,
+        frameDurationMs = numberValue(values, "frameDurationMs") ?: FRAME_DURATION_MS,
+        frameSizeBytes = numberValue(values, "frameSizeBytes") ?: DEFAULT_FRAME_SIZE_BYTES,
+        bitrate = numberValue(values, "bitrate") ?: DEFAULT_BITRATE,
+        packetizedFromGlasses = boolValue(values, "packetizedFromGlasses") ?: false,
+        voiceActivityDetectionEnabled =
+            boolValue(values, "voiceActivityDetectionEnabled")
+                ?: BluetoothSdkDefaults.VOICE_ACTIVITY_DETECTION_ENABLED,
+    )
+
+    fun toMap(): Map<String, Any> =
+        mapOf(
+            "type" to "mic_lc3",
+            "lc3" to lc3,
+            "sampleRate" to sampleRate,
+            "channels" to channels,
+            "encoding" to encoding,
+            "frameDurationMs" to frameDurationMs,
+            "frameSizeBytes" to frameSizeBytes,
+            "bitrate" to bitrate,
+            "packetizedFromGlasses" to packetizedFromGlasses,
+            "voiceActivityDetectionEnabled" to voiceActivityDetectionEnabled,
+        )
+
+    companion object {
+        const val SAMPLE_RATE = 16_000
+        const val CHANNELS = 1
+        const val ENCODING = "lc3"
+        const val FRAME_DURATION_MS = 10
+        const val DEFAULT_FRAME_SIZE_BYTES = 60
+        const val DEFAULT_BITRATE = DEFAULT_FRAME_SIZE_BYTES * 8 * (1000 / FRAME_DURATION_MS)
+    }
+}
+
+internal data class MicHealth(
+    val sequenceGapEvents: Long,
+    val decodeFailures: Long,
+    val lastLc3ReceivedAt: Long?,
+    val lastPcmProducedAt: Long?,
+) {
+    fun toMap(): Map<String, Any> =
+        buildMap {
+            put("sequenceGapEvents", sequenceGapEvents)
+            put("decodeFailures", decodeFailures)
+            lastLc3ReceivedAt?.let { put("lastLc3ReceivedAt", it) }
+            lastPcmProducedAt?.let { put("lastPcmProducedAt", it) }
+        }
+}
+
+data class LocalTranscriptionEvent(
+    val text: String,
+    val isFinal: Boolean,
+    val values: Map<String, Any>,
+)
+
+data class GlassesMediaVolumeGetResult(
+    val level: Int?,
+    val statusCode: Int?,
+    val values: Map<String, Any>,
+) {
+    companion object {
+        fun fromMap(values: Map<String, Any>): GlassesMediaVolumeGetResult =
+            GlassesMediaVolumeGetResult(
+                level = numberValue(values, "level"),
+                statusCode = (values["statusCode"] as? Number)?.toInt(),
+                values = values,
+            )
+    }
+}
+
+data class GlassesMediaVolumeSetResult(
+    val statusCode: Int?,
+    val values: Map<String, Any>,
+) {
+    companion object {
+        fun fromMap(values: Map<String, Any>): GlassesMediaVolumeSetResult =
+            GlassesMediaVolumeSetResult(
+                statusCode = (values["statusCode"] as? Number)?.toInt(),
+                values = values,
+            )
+    }
+}