package com.bitchat.android.mesh import android.bluetooth.BluetoothDevice import android.bluetooth.BluetoothGatt import android.bluetooth.BluetoothGattCharacteristic import android.bluetooth.BluetoothGattServer import android.util.Log import com.bitchat.android.protocol.SpecialRecipients import com.bitchat.android.model.RoutedPacket import com.bitchat.android.protocol.MessageType import com.bitchat.android.util.toHexString import kotlinx.coroutines.CoroutineScope import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.SupervisorJob import kotlinx.coroutines.cancel import kotlinx.coroutines.delay import kotlinx.coroutines.isActive import kotlinx.coroutines.launch import kotlinx.coroutines.channels.Channel import kotlinx.coroutines.channels.actor /** * Handles packet broadcasting to connected devices using actor pattern for serialization * * In Bluetooth Low Energy (BLE): * * Peripheral (server): * Advertises. * Accepts connections. * Hosts a GATT server. * Remote devices read/write/subscribe to characteristics. * * Central (client): * Scans. * Initiates connections. * Hosts a GATT client. * Reads/writes to the peripheral’s characteristics. */ class BluetoothPacketBroadcaster( private val connectionScope: CoroutineScope, private val connectionTracker: BluetoothConnectionTracker, private val fragmentManager: FragmentManager?, private val myPeerID: String ) { companion object { private const val TAG = "BluetoothPacketBroadcaster" private const val CLEANUP_DELAY = com.bitchat.android.util.AppConstants.Mesh.BROADCAST_CLEANUP_DELAY_MS } // Optional nickname resolver injected by higher layer (peerID -> nickname?) private var nicknameResolver: ((String) -> String?)? = null fun setNicknameResolver(resolver: (String) -> String?) { nicknameResolver = resolver } /** * Debug logging helper - can be easily removed/disabled for production */ private fun logPacketRelay( typeName: String, senderPeerID: String, senderNick: String?, incomingPeer: String?, incomingAddr: String?, toPeer: String?, toDeviceAddress: String, ttl: UByte, packetVersion: UByte = 1u, routeInfo: String? = null ) { try { val fromNick = incomingPeer?.let { nicknameResolver?.invoke(it) } val toNick = toPeer?.let { nicknameResolver?.invoke(it) } val manager = com.bitchat.android.ui.debug.DebugSettingsManager.getInstance() // Always log outgoing for the actual transmission target manager.logOutgoing( packetType = typeName, toPeerID = toPeer, toNickname = toNick, toDeviceAddress = toDeviceAddress, previousHopPeerID = incomingPeer, packetVersion = packetVersion, routeInfo = routeInfo ) // Keep the verbose relay message for human readability manager.logPacketRelayDetailed( packetType = typeName, senderPeerID = senderPeerID, senderNickname = senderNick, fromPeerID = incomingPeer, fromNickname = fromNick, fromDeviceAddress = incomingAddr, toPeerID = toPeer, toNickname = toNick, toDeviceAddress = toDeviceAddress, ttl = ttl, isRelay = true, packetVersion = packetVersion, routeInfo = routeInfo ) } catch (_: Exception) { // Silently ignore debug logging failures } } // Data class to hold broadcast request information private data class BroadcastRequest( val routed: RoutedPacket, val gattServer: BluetoothGattServer?, val characteristic: BluetoothGattCharacteristic? ) // Actor scope for the broadcaster private val broadcasterScope = CoroutineScope(Dispatchers.IO + SupervisorJob()) private val fragmentingSender = FragmentingPacketSender(connectionScope, fragmentManager, TAG) // SERIALIZATION: Actor to serialize all broadcast operations @OptIn(kotlinx.coroutines.ObsoleteCoroutinesApi::class) private val broadcasterActor = broadcasterScope.actor( capacity = Channel.UNLIMITED ) { Log.d(TAG, "🎭 Created packet broadcaster actor") try { for (request in channel) { broadcastSinglePacketInternal(request.routed, request.gattServer, request.characteristic) } } finally { Log.d(TAG, "🎭 Packet broadcaster actor terminated") } } fun broadcastPacket( routed: RoutedPacket, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ) { fragmentingSender.send(routed, "BLE broadcast") { packet -> broadcastSinglePacket(packet, gattServer, characteristic) true } } fun cancelTransfer(transferId: String): Boolean { return fragmentingSender.cancelTransfer(transferId) } /** * Send a packet to a specific peer only, without broadcasting. * Returns true if a direct path was found and used. */ fun sendPacketToPeer( routed: RoutedPacket, targetPeerID: String, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ): Boolean { if (!hasPeerConnection(targetPeerID)) return false return fragmentingSender.send(routed, "BLE peer ${targetPeerID.take(8)}") { packet -> sendSinglePacketToPeer(packet, targetPeerID, gattServer, characteristic) } } private fun sendSinglePacketToPeer( routed: RoutedPacket, targetPeerID: String, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ): Boolean { val packet = routed.packet // iOS-compatible: Use selective padding policy for BLE val padForBLE = BLEPacketPaddingPolicy.shouldPadForBLE(packet.type) val data = packet.toBinaryData(padding = padForBLE) ?: return false val isFile = packet.type == MessageType.FILE_TRANSFER.value if (isFile) { Log.d(TAG, "📤 Broadcasting FILE_TRANSFER: ${packet.payload.size} bytes") } val typeName = MessageType.fromValue(packet.type)?.name ?: packet.type.toString() val senderPeerID = routed.peerID ?: packet.senderID.toHexString() val incomingAddr = routed.relayAddress val incomingPeer = incomingAddr?.let { connectionTracker.addressPeerMap[it] } val senderNick = senderPeerID.let { pid -> nicknameResolver?.invoke(pid) } val route = packet.route val routeInfo = if (!route.isNullOrEmpty()) "routed: ${route.size} hops" else null // Prefer server-side subscriptions val serverTarget = connectionTracker.getSubscribedDevices() .firstOrNull { connectionTracker.addressPeerMap[it.address] == targetPeerID } if (serverTarget != null) { if (notifyDevice(serverTarget, data, gattServer, characteristic)) { logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, targetPeerID, serverTarget.address, packet.ttl, packet.version, routeInfo) return true } } // Then client connections val clientTarget = connectionTracker.getConnectedDevices().values .firstOrNull { connectionTracker.addressPeerMap[it.device.address] == targetPeerID } if (clientTarget != null) { if (writeToDeviceConn(clientTarget, data)) { logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, targetPeerID, clientTarget.device.address, packet.ttl, packet.version, routeInfo) return true } } return false } /** * Public entry point for broadcasting - submits request to actor for serialization */ fun broadcastSinglePacket( routed: RoutedPacket, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ) { // Submit broadcast request to actor for serialized processing broadcasterScope.launch { try { broadcasterActor.send(BroadcastRequest(routed, gattServer, characteristic)) } catch (e: Exception) { Log.w(TAG, "Failed to send broadcast request to actor: ${e.message}") // Fallback to direct processing if actor fails broadcastSinglePacketInternal(routed, gattServer, characteristic) } } } /** * Targeted send to a specific peer (by peerID) if directly connected. * Returns true if sent to at least one matching connection. */ fun sendToPeer( targetPeerID: String, routed: RoutedPacket, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ): Boolean { if (!hasPeerConnection(targetPeerID)) return false return fragmentingSender.send(routed, "BLE peer ${targetPeerID.take(8)}") { packet -> sendSinglePacketToPeer(packet, targetPeerID, gattServer, characteristic) } } private fun hasPeerConnection(targetPeerID: String): Boolean { val hasServerTarget = connectionTracker.getSubscribedDevices() .any { connectionTracker.addressPeerMap[it.address] == targetPeerID } if (hasServerTarget) return true return connectionTracker.getConnectedDevices().values .any { connectionTracker.addressPeerMap[it.device.address] == targetPeerID } } /** * Internal broadcast implementation - runs in serialized actor context */ private suspend fun broadcastSinglePacketInternal( routed: RoutedPacket, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ) { val packet = routed.packet // iOS-compatible: Use selective padding policy for BLE val padForBLE = BLEPacketPaddingPolicy.shouldPadForBLE(packet.type) val data = packet.toBinaryData(padding = padForBLE) ?: return val typeName = MessageType.fromValue(packet.type)?.name ?: packet.type.toString() val senderPeerID = routed.peerID ?: packet.senderID.toHexString() val incomingAddr = routed.relayAddress val incomingPeer = incomingAddr?.let { connectionTracker.addressPeerMap[it] } val senderNick = senderPeerID.let { pid -> nicknameResolver?.invoke(pid) } val route = packet.route val routeInfo = if (!route.isNullOrEmpty()) "routed: ${route.size} hops" else null // Source Routing for Originating Packets // If we are the sender and a source route is defined, we must send ONLY to the first hop. if (packet.senderID.toHexString() == myPeerID && !packet.route.isNullOrEmpty()) { val firstHop = packet.route!![0].toHexString() Log.d(TAG, "Source Routing: Packet has explicit route, attempting to send to first hop: $firstHop") var sent = false // Try to find first hop in server connections (subscribedDevices) val serverTarget = connectionTracker.getSubscribedDevices() .firstOrNull { connectionTracker.addressPeerMap[it.address] == firstHop } if (serverTarget != null) { Log.d(TAG, "Source Routing: sending directly to first hop (server conn) $firstHop: ${serverTarget.address}") if (notifyDevice(serverTarget, data, gattServer, characteristic)) { val toPeer = connectionTracker.addressPeerMap[serverTarget.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, serverTarget.address, packet.ttl, packet.version, routeInfo) sent = true } } // Try to find first hop in client connections if not sent yet if (!sent) { val clientTarget = connectionTracker.getConnectedDevices().values .firstOrNull { connectionTracker.addressPeerMap[it.device.address] == firstHop } if (clientTarget != null) { Log.d(TAG, "Source Routing: sending directly to first hop (client conn) $firstHop: ${clientTarget.device.address}") if (writeToDeviceConn(clientTarget, data)) { val toPeer = connectionTracker.addressPeerMap[clientTarget.device.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, clientTarget.device.address, packet.ttl, packet.version, routeInfo) sent = true } } } if (sent) return Log.w(TAG, "Source Routing: First hop $firstHop not connected. Falling back to standard broadcast logic.") } if (packet.recipientID != SpecialRecipients.BROADCAST) { val recipientID = packet.recipientID?.toHexString() ?: "" // Try to find the recipient in server connections (subscribedDevices) val targetDevice = connectionTracker.getSubscribedDevices() .firstOrNull { connectionTracker.addressPeerMap[it.address] == recipientID } // If found, send directly if (targetDevice != null) { Log.d(TAG, "Send packet type ${packet.type} directly to target device for recipient $recipientID: ${targetDevice.address}") if (notifyDevice(targetDevice, data, gattServer, characteristic)) { val toPeer = connectionTracker.addressPeerMap[targetDevice.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, targetDevice.address, packet.ttl, packet.version, routeInfo) return // Sent, no need to continue } } // Try to find the recipient in client connections (connectedDevices) val targetDeviceConn = connectionTracker.getConnectedDevices().values .firstOrNull { connectionTracker.addressPeerMap[it.device.address] == recipientID } // If found, send directly if (targetDeviceConn != null) { Log.d(TAG, "Send packet type ${packet.type} directly to target client connection for recipient $recipientID: ${targetDeviceConn.device.address}") if (writeToDeviceConn(targetDeviceConn, data)) { val toPeer = connectionTracker.addressPeerMap[targetDeviceConn.device.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, targetDeviceConn.device.address, packet.ttl, packet.version, routeInfo) return // Sent, no need to continue } } } // Else, continue with broadcasting to all devices val subscribedDevices = connectionTracker.getSubscribedDevices() val connectedDevices = connectionTracker.getConnectedDevices() Log.i(TAG, "Broadcasting packet v${packet.version} type ${packet.type} to ${subscribedDevices.size} server + ${connectedDevices.size} client connections") val senderID = packet.senderID.toHexString() // Send to server connections (devices connected to our GATT server) subscribedDevices.forEach { device -> if (device.address == routed.relayAddress) { Log.d(TAG, "Skipping broadcast to client back to relayer: ${device.address}") return@forEach } if (connectionTracker.addressPeerMap[device.address] == senderID) { Log.d(TAG, "Skipping broadcast to client back to sender: ${device.address}") return@forEach } val sent = notifyDevice(device, data, gattServer, characteristic) if (sent) { val toPeer = connectionTracker.addressPeerMap[device.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, device.address, packet.ttl, packet.version, routeInfo) } } // Send to client connections (GATT servers we are connected to) connectedDevices.values.forEach { deviceConn -> if (deviceConn.isClient && deviceConn.gatt != null && deviceConn.characteristic != null) { if (deviceConn.device.address == routed.relayAddress) { Log.d(TAG, "Skipping broadcast to server back to relayer: ${deviceConn.device.address}") return@forEach } if (connectionTracker.addressPeerMap[deviceConn.device.address] == senderID) { Log.d(TAG, "Skipping roadcast to server back to sender: ${deviceConn.device.address}") return@forEach } val sent = writeToDeviceConn(deviceConn, data) if (sent) { val toPeer = connectionTracker.addressPeerMap[deviceConn.device.address] logPacketRelay(typeName, senderPeerID, senderNick, incomingPeer, incomingAddr, toPeer, deviceConn.device.address, packet.ttl, packet.version, routeInfo) } } } } /** * Send data to a single device (server->client) */ private fun notifyDevice( device: BluetoothDevice, data: ByteArray, gattServer: BluetoothGattServer?, characteristic: BluetoothGattCharacteristic? ): Boolean { return try { characteristic?.let { char -> char.value = data val result = gattServer?.notifyCharacteristicChanged(device, char, false) ?: false result } ?: false } catch (e: Exception) { Log.w(TAG, "Error sending to server connection ${device.address}: ${e.message}") connectionScope.launch { delay(CLEANUP_DELAY) connectionTracker.removeSubscribedDevice(device) connectionTracker.addressPeerMap.remove(device.address) } false } } /** * Send data to a single device (client->server) */ private fun writeToDeviceConn( deviceConn: BluetoothConnectionTracker.DeviceConnection, data: ByteArray ): Boolean { return try { deviceConn.characteristic?.let { char -> char.value = data val result = deviceConn.gatt?.writeCharacteristic(char) ?: false result } ?: false } catch (e: Exception) { Log.w(TAG, "Error sending to client connection ${deviceConn.device.address}: ${e.message}") connectionScope.launch { delay(CLEANUP_DELAY) connectionTracker.cleanupDeviceConnection(deviceConn.device.address) } false } } /** * Get debug information */ fun getDebugInfo(): String { return buildString { appendLine("=== Packet Broadcaster Debug Info ===") appendLine("Broadcaster Scope Active: ${broadcasterScope.isActive}") appendLine("Actor Channel Closed: ${broadcasterActor.isClosedForSend}") appendLine("Connection Scope Active: ${connectionScope.isActive}") } } /** * Shutdown the broadcaster actor gracefully */ fun shutdown() { Log.d(TAG, "Shutting down BluetoothPacketBroadcaster actor") // Close the actor gracefully broadcasterActor.close() // Cancel the broadcaster scope broadcasterScope.cancel() Log.d(TAG, "BluetoothPacketBroadcaster shutdown complete") } }