Device capability and deployment controls

enum class DeviceCapability {
  BARCODE, PRINTER, PHYSICAL_KEYS,
  MAGNETIC_STRIPE, CONTACT_CARD,
  CONTACTLESS_CARD, SECURE_MODULE,
}

data class DeviceBaseline(
  val model: String,
  val region: String,
  val android: String,
  val firmware: String,
  val sdk: String,
  val appBuild: String,
  val capabilities: Set<DeviceCapability>,
)

data class KeySnapshot(
  val keyCode: Int,
  val action: String?,
  val intercepted: Boolean,
)

interface DeviceCapabilityPort {
  fun readBaseline(): DeviceBaseline
  fun snapshotKey(keyCode: Int): KeySnapshot?
  fun applyKeyAction(keyCode: Int, action: String)
  fun restoreKey(snapshot: KeySnapshot)
}

class DeploymentInspector(
  private val device: DeviceCapabilityPort,
) {
  fun inspect(): DeviceBaseline = device.readBaseline()

  fun applyTemporaryKey(
    keyCode: Int,
    action: String,
  ) {
    val original = device.snapshotKey(keyCode)
      ?: error("key-mapping-unavailable")
    try {
      device.applyKeyAction(keyCode, action)
    } catch (error: Throwable) {
      device.restoreKey(original)
      throw error
    }
  }
}