#ifndef WIFI_SCAN_H
#define WIFI_SCAN_H

#include <stdint.h>

/**
 * @brief Perform WiFi network scan (dual-band)
 * 
 * Scans both 2.4GHz and 5GHz bands for available networks.
 * Results are stored internally and can be retrieved via wifi_scan_get_results_json()
 * 
 * @return 0 on success, negative error code on failure
 */
int wifi_scan_networks(void);

/**
 * @brief Get scan results as JSON string
 * 
 * Returns the last scan results in JSON format.
 * The returned string is valid until the next scan is performed.
 * 
 * @return JSON string with network information, or NULL on error
 */
const char* wifi_scan_get_results_json(void);

/**
 * @brief Get number of networks found in last scan
 * 
 * @return Number of networks found
 */
int wifi_scan_get_count(void);

#endif /* WIFI_SCAN_H */