""" Discovery request/response handling helper for pyMC Repeater. This module handles the processing and response to discovery requests, allowing other nodes to discover repeaters on the mesh network. """ import asyncio import logging from pymc_core.node.handlers.control import ControlHandler logger = logging.getLogger("DiscoveryHelper") class DiscoveryHelper: """Helper class for processing discovery requests in the repeater.""" def __init__( self, local_identity, packet_injector=None, node_type: int = 2, log_fn=None, debug_log_fn=None, ): """ Initialize the discovery helper. Args: local_identity: The LocalIdentity instance for this repeater packet_injector: Callable to inject new packets into the router for sending node_type: Node type identifier (2 = Repeater) log_fn: Optional logging function for ControlHandler debug_log_fn: Optional logging for verbose ControlHandler messages (e.g. callback presence). Pass logger.debug to avoid INFO noise when forwarding to companions. """ self.local_identity = local_identity self.packet_injector = packet_injector # Function to inject packets into router self.node_type = node_type # Create ControlHandler internally as a parsing utility self.control_handler = ControlHandler( log_fn=log_fn or logger.info, debug_log_fn=debug_log_fn, ) # Set up the request callback self.control_handler.set_request_callback(self._on_discovery_request) logger.debug("Discovery handler initialized") def _on_discovery_request(self, request_data: dict) -> None: """ Handle incoming discovery request. Args: request_data: Dictionary containing the parsed discovery request """ try: tag = request_data.get("tag", 0) filter_byte = request_data.get("filter", 0) prefix_only = request_data.get("prefix_only", False) snr = request_data.get("snr", 0.0) rssi = request_data.get("rssi", 0) logger.info( f"Request: tag=0x{tag:08X}, filter=0x{filter_byte:02X}, " f"SNR={snr:+.1f}dB, RSSI={rssi}dBm" ) # Check if filter matches our node type (repeater = 2, filter_mask = 0x04) filter_mask = 1 << self.node_type # 1 << 2 = 0x04 if (filter_byte & filter_mask) == 0: logger.debug("Filter doesn't match, ignoring") return logger.info("Sending response...") if self.local_identity: self._send_discovery_response(tag, self.node_type, snr, prefix_only) else: logger.warning("No local identity available for response") except Exception as e: logger.error(f"Error handling request: {e}") def _send_discovery_response( self, tag: int, node_type: int, inbound_snr: float, prefix_only: bool, ) -> None: """ Create and send a discovery response packet. Args: tag: The tag from the discovery request node_type: Node type identifier inbound_snr: SNR of the received request prefix_only: Whether to use prefix-only mode """ try: our_pub_key = self.local_identity.get_public_key() from pymc_core.protocol.packet_builder import PacketBuilder response_packet = PacketBuilder.create_discovery_response( tag=tag, node_type=node_type, inbound_snr=inbound_snr, pub_key=our_pub_key, prefix_only=prefix_only, ) # Send response via router injection if self.packet_injector: asyncio.create_task(self._send_packet_async(response_packet, tag)) else: logger.warning("No packet injector available - discovery response not sent") except Exception as e: logger.error(f"Error creating discovery response: {e}") async def _send_packet_async(self, packet, tag: int) -> None: """ Send a discovery response packet via router injection. Args: packet: The packet to send tag: The tag for logging purposes """ try: success = await self.packet_injector(packet, wait_for_ack=False) if success: logger.info(f"Response sent for tag 0x{tag:08X}") else: logger.warning(f"Failed to send response for tag 0x{tag:08X}") except Exception as e: logger.error(f"Error sending response: {e}")