munim-wifi 0.1.0

package/ios/HybridMunimWifi.swift

@@ -0,0 +1,222 @@
+//
+//  HybridMunimWifi.swift
+//  Pods
+//
+//  Created by sheehanmunim on 1/26/2026.
+//
+
+import Foundation
+import CoreWLAN
+import CoreLocation
+import NetworkExtension
+
+class HybridMunimWifi: HybridMunimWifiSpec {
+    private let wifiClient = CWWiFiClient.shared()
+    private var locationManager: CLLocationManager?
+    private var scanResults: [CWNetwork] = []
+    private var isScanning = false
+    
+    private func getFrequencyChannel(frequency: Int) -> Int {
+        // Convert frequency (MHz) to channel number
+        if frequency >= 2412 && frequency <= 2484 {
+            // 2.4 GHz band
+            return ((frequency - 2412) / 5) + 1
+        } else if frequency >= 5170 && frequency <= 5825 {
+            // 5 GHz band
+            return ((frequency - 5170) / 5) + 36
+        }
+        return 0
+    }
+    
+    private func convertNetwork(_ network: CWNetwork) -> WifiNetwork {
+        guard let channel = network.wlanChannel else {
+            return WifiNetwork(
+                ssid: network.ssid ?? "",
+                bssid: network.bssid ?? "",
+                rssi: Int(network.rssiValue),
+                frequency: 0,
+                channel: 0,
+                capabilities: network.ies?.description ?? "",
+                isSecure: false,
+                timestamp: Int64(Date().timeIntervalSince1970 * 1000)
+            )
+        }
+        
+        let channelNumber = Int(channel.channelNumber)
+        let frequency: Int
+        if channel.channelBand == .band2GHz {
+            frequency = 2412 + (channelNumber - 1) * 5
+        } else {
+            frequency = 5170 + (channelNumber - 36) * 5
+        }
+        
+        let isSecure = network.supportsSecurity(.WPA2Personal) || 
+                      network.supportsSecurity(.WPA3Personal) ||
+                      network.supportsSecurity(.WPAEnterprise) ||
+                      network.supportsSecurity(.WPA3Enterprise)
+        
+        return WifiNetwork(
+            ssid: network.ssid ?? "",
+            bssid: network.bssid ?? "",
+            rssi: Int(network.rssiValue),
+            frequency: frequency,
+            channel: channelNumber,
+            capabilities: network.ies?.description ?? "",
+            isSecure: isSecure,
+            timestamp: Int64(Date().timeIntervalSince1970 * 1000)
+        )
+    }
+    
+    func isWifiEnabled() throws -> Bool {
+        return wifiClient.interface()?.powerOn() ?? false
+    }
+    
+    func requestWifiPermission() throws -> Bool {
+        // On iOS, Wi-Fi scanning requires location permission
+        let locationManager = CLLocationManager()
+        self.locationManager = locationManager
+        
+        let status = locationManager.authorizationStatus
+        return status == .authorizedWhenInUse || status == .authorizedAlways
+    }
+    
+    func scanNetworks(maxResults: Double?, timeout: Double?) throws -> [WifiNetwork] {
+        guard let interface = wifiClient.interface() else {
+            throw NSError(domain: "MunimWifi", code: 1, userInfo: [NSLocalizedDescriptionKey: "Wi-Fi interface not available"])
+        }
+        
+        guard interface.powerOn() else {
+            throw NSError(domain: "MunimWifi", code: 2, userInfo: [NSLocalizedDescriptionKey: "Wi-Fi is not enabled"])
+        }
+        
+        // Check location permission
+        let locationManager = CLLocationManager()
+        let status = locationManager.authorizationStatus
+        guard status == .authorizedWhenInUse || status == .authorizedAlways else {
+            throw NSError(domain: "MunimWifi", code: 3, userInfo: [NSLocalizedDescriptionKey: "Location permission not granted"])
+        }
+        
+        do {
+            let networks = try interface.scanForNetworks(withName: nil)
+            scanResults = networks
+            
+            let wifiNetworks = networks.map { convertNetwork($0) }
+            let max = maxResults.map { Int($0) } ?? wifiNetworks.count
+            return Array(wifiNetworks.prefix(max))
+        } catch {
+            throw error
+        }
+    }
+    
+    func startScan(maxResults: Double?, timeout: Double?) throws {
+        isScanning = true
+        
+        guard let interface = wifiClient.interface() else {
+            isScanning = false
+            return
+        }
+        
+        guard interface.powerOn() else {
+            isScanning = false
+            return
+        }
+        
+        // Check location permission
+        let locationManager = CLLocationManager()
+        let status = locationManager.authorizationStatus
+        guard status == .authorizedWhenInUse || status == .authorizedAlways else {
+            isScanning = false
+            return
+        }
+        
+        // Start scanning in background
+        DispatchQueue.global(qos: .background).async { [weak self] in
+            guard let self = self else { return }
+            
+            do {
+                let networks = try interface.scanForNetworks(withName: nil)
+                self.scanResults = networks
+                self.isScanning = false
+            } catch {
+                self.isScanning = false
+            }
+        }
+    }
+    
+    func stopScan() throws {
+        isScanning = false
+    }
+    
+    func getSSIDs() throws -> [String] {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        return networks.compactMap { $0.ssid }.unique()
+    }
+    
+    func getWifiFingerprint() throws -> WifiFingerprint {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        let wifiNetworks = networks.map { convertNetwork($0) }
+        
+        return WifiFingerprint(
+            networks: wifiNetworks,
+            timestamp: Int64(Date().timeIntervalSince1970 * 1000)
+        )
+    }
+    
+    func getRSSI(ssid: String) throws -> Double? {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        let network = networks.first { $0.ssid == ssid }
+        return network.map { Double($0.rssiValue) }
+    }
+    
+    func getBSSID(ssid: String) throws -> String? {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        let network = networks.first { $0.ssid == ssid }
+        return network?.bssid
+    }
+    
+    func getChannelInfo(ssid: String) throws -> ChannelInfo? {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        guard let network = networks.first(where: { $0.ssid == ssid }),
+              let channel = network.wlanChannel else {
+            return nil
+        }
+        
+        let channelNumber = Int(channel.channelNumber)
+        let frequency: Int
+        if channel.channelBand == .band2GHz {
+            frequency = 2412 + (channelNumber - 1) * 5
+        } else {
+            frequency = 5170 + (channelNumber - 36) * 5
+        }
+        
+        return ChannelInfo(
+            channel: channelNumber,
+            frequency: frequency
+        )
+    }
+    
+    func getNetworkInfo(ssid: String) throws -> WifiNetwork? {
+        let networks = scanResults.isEmpty ? (try? wifiClient.interface()?.scanForNetworks(withName: nil)) ?? [] : scanResults
+        guard let network = networks.first(where: { $0.ssid == ssid }) else {
+            return nil
+        }
+        return convertNetwork(network)
+    }
+    
+    func addListener(eventName: String) throws {
+        // Event listener implementation can be added here if needed
+        print("[MunimWifi] Adding listener for event: \(eventName)")
+    }
+    
+    func removeListeners(count: Double) throws {
+        // Event listener removal implementation can be added here if needed
+        print("[MunimWifi] Removing \(count) listeners")
+    }
+}
+
+extension Array where Element: Hashable {
+    func unique() -> [Element] {
+        var seen = Set<Element>()
+        return filter { seen.insert($0).inserted }
+    }
+}

package/lib/commonjs/index.js

@@ -0,0 +1,216 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addEventListener = addEventListener;
+exports.addListener = addListener;
+exports.addNetworkFoundListener = addNetworkFoundListener;
+exports.default = void 0;
+exports.getBSSID = getBSSID;
+exports.getChannelInfo = getChannelInfo;
+exports.getNetworkInfo = getNetworkInfo;
+exports.getRSSI = getRSSI;
+exports.getSSIDs = getSSIDs;
+exports.getWifiFingerprint = getWifiFingerprint;
+exports.isWifiEnabled = isWifiEnabled;
+exports.removeListeners = removeListeners;
+exports.requestWifiPermission = requestWifiPermission;
+exports.scanNetworks = scanNetworks;
+exports.startScan = startScan;
+exports.stopScan = stopScan;
+var _reactNativeNitroModules = require("react-native-nitro-modules");
+var _reactNative = require("react-native");
+const MunimWifi = _reactNativeNitroModules.NitroModules.createHybridObject('MunimWifi');
+
+// Event Emitter for Wi-Fi events
+const {
+  MunimWifiEventEmitter
+} = _reactNative.NativeModules;
+let eventEmitter = null;
+if (MunimWifiEventEmitter) {
+  try {
+    eventEmitter = new _reactNative.NativeEventEmitter(MunimWifiEventEmitter);
+  } catch (error) {
+    console.error('[munim-wifi] Failed to initialize event emitter:', error);
+  }
+}
+
+// ========== Wi-Fi Functions ==========
+
+/**
+ * Check if Wi-Fi is enabled on the device.
+ *
+ * @returns Promise resolving to true if Wi-Fi is enabled, false otherwise.
+ */
+function isWifiEnabled() {
+  return MunimWifi.isWifiEnabled();
+}
+
+/**
+ * Request Wi-Fi permissions (Android) or check authorization status (iOS).
+ * On Android, this requests location permission which is required for Wi-Fi scanning.
+ * On iOS, this checks location authorization status.
+ *
+ * @returns Promise resolving to true if permissions are granted, false otherwise.
+ */
+function requestWifiPermission() {
+  return MunimWifi.requestWifiPermission();
+}
+
+/**
+ * Scan for nearby Wi-Fi networks.
+ *
+ * @param options - Optional scan configuration including max results and timeout.
+ * @returns Promise resolving to array of discovered Wi-Fi networks.
+ */
+function scanNetworks(options) {
+  return MunimWifi.scanNetworks(options);
+}
+
+/**
+ * Start continuous Wi-Fi scanning. Results will be emitted via events.
+ *
+ * @param options - Optional scan configuration.
+ */
+function startScan(options) {
+  return MunimWifi.startScan(options);
+}
+
+/**
+ * Stop continuous Wi-Fi scanning.
+ */
+function stopScan() {
+  return MunimWifi.stopScan();
+}
+
+/**
+ * Get list of SSIDs (network names) from the last scan.
+ *
+ * @returns Promise resolving to array of SSID strings.
+ */
+function getSSIDs() {
+  return MunimWifi.getSSIDs();
+}
+
+/**
+ * Get Wi-Fi fingerprint containing all network information.
+ * This includes SSIDs, BSSIDs, RSSI, channels, and frequencies.
+ *
+ * @returns Promise resolving to Wi-Fi fingerprint data.
+ */
+function getWifiFingerprint() {
+  return MunimWifi.getWifiFingerprint();
+}
+
+/**
+ * Get RSSI (signal strength) for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to RSSI value in dBm, or null if network not found.
+ */
+function getRSSI(ssid) {
+  return MunimWifi.getRSSI(ssid);
+}
+
+/**
+ * Get BSSID (MAC address) for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to BSSID string, or null if network not found.
+ */
+function getBSSID(ssid) {
+  return MunimWifi.getBSSID(ssid);
+}
+
+/**
+ * Get channel and frequency information for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to object with channel and frequency, or null if network not found.
+ */
+function getChannelInfo(ssid) {
+  return MunimWifi.getChannelInfo(ssid);
+}
+
+/**
+ * Get all available information for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to WifiNetwork object, or null if network not found.
+ */
+function getNetworkInfo(ssid) {
+  return MunimWifi.getNetworkInfo(ssid);
+}
+
+// ========== Event Management ==========
+
+/**
+ * Add a network found event listener (for continuous scanning).
+ *
+ * @param callback - Function to call when a network is found
+ * @returns A function to remove the listener
+ */
+function addNetworkFoundListener(callback) {
+  if (!eventEmitter) {
+    console.warn('[munim-wifi] Cannot add listener - event emitter not available');
+    return () => {};
+  }
+  const subscription = eventEmitter.addListener('networkFound', callback);
+  return () => subscription.remove();
+}
+
+/**
+ * Add an event listener.
+ *
+ * @param eventName - The name of the event to listen for.
+ * @param callback - The callback to invoke when the event occurs.
+ * @returns A function to remove the listener
+ */
+function addEventListener(eventName, callback) {
+  if (!eventEmitter) {
+    console.warn('[munim-wifi] Cannot add listener - event emitter not available');
+    return () => {};
+  }
+  const subscription = eventEmitter.addListener(eventName, callback);
+  return () => subscription.remove();
+}
+
+/**
+ * Add an event listener (legacy method).
+ *
+ * @param eventName - The name of the event to listen for.
+ */
+function addListener(eventName) {
+  return MunimWifi.addListener(eventName);
+}
+
+/**
+ * Remove event listeners.
+ *
+ * @param count - Number of listeners to remove.
+ */
+function removeListeners(count) {
+  return MunimWifi.removeListeners(count);
+}
+
+// ========== Type Exports ==========
+// Default export for convenience
+var _default = exports.default = {
+  isWifiEnabled,
+  requestWifiPermission,
+  scanNetworks,
+  startScan,
+  stopScan,
+  getSSIDs,
+  getWifiFingerprint,
+  getRSSI,
+  getBSSID,
+  getChannelInfo,
+  getNetworkInfo,
+  addNetworkFoundListener,
+  addEventListener,
+  addListener,
+  removeListeners
+};
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeNitroModules","require","_reactNative","MunimWifi","NitroModules","createHybridObject","MunimWifiEventEmitter","NativeModules","eventEmitter","NativeEventEmitter","error","console","isWifiEnabled","requestWifiPermission","scanNetworks","options","startScan","stopScan","getSSIDs","getWifiFingerprint","getRSSI","ssid","getBSSID","getChannelInfo","getNetworkInfo","addNetworkFoundListener","callback","warn","subscription","addListener","remove","addEventListener","eventName","removeListeners","count","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/specs/munim-wifi.nitro.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=munim-wifi.nitro.js.map

package/lib/commonjs/specs/munim-wifi.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["specs/munim-wifi.nitro.ts"],"mappings":"","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,198 @@
+"use strict";
+
+import { NitroModules } from 'react-native-nitro-modules';
+import { NativeEventEmitter, NativeModules } from 'react-native';
+const MunimWifi = NitroModules.createHybridObject('MunimWifi');
+
+// Event Emitter for Wi-Fi events
+const {
+  MunimWifiEventEmitter
+} = NativeModules;
+let eventEmitter = null;
+if (MunimWifiEventEmitter) {
+  try {
+    eventEmitter = new NativeEventEmitter(MunimWifiEventEmitter);
+  } catch (error) {
+    console.error('[munim-wifi] Failed to initialize event emitter:', error);
+  }
+}
+
+// ========== Wi-Fi Functions ==========
+
+/**
+ * Check if Wi-Fi is enabled on the device.
+ *
+ * @returns Promise resolving to true if Wi-Fi is enabled, false otherwise.
+ */
+export function isWifiEnabled() {
+  return MunimWifi.isWifiEnabled();
+}
+
+/**
+ * Request Wi-Fi permissions (Android) or check authorization status (iOS).
+ * On Android, this requests location permission which is required for Wi-Fi scanning.
+ * On iOS, this checks location authorization status.
+ *
+ * @returns Promise resolving to true if permissions are granted, false otherwise.
+ */
+export function requestWifiPermission() {
+  return MunimWifi.requestWifiPermission();
+}
+
+/**
+ * Scan for nearby Wi-Fi networks.
+ *
+ * @param options - Optional scan configuration including max results and timeout.
+ * @returns Promise resolving to array of discovered Wi-Fi networks.
+ */
+export function scanNetworks(options) {
+  return MunimWifi.scanNetworks(options);
+}
+
+/**
+ * Start continuous Wi-Fi scanning. Results will be emitted via events.
+ *
+ * @param options - Optional scan configuration.
+ */
+export function startScan(options) {
+  return MunimWifi.startScan(options);
+}
+
+/**
+ * Stop continuous Wi-Fi scanning.
+ */
+export function stopScan() {
+  return MunimWifi.stopScan();
+}
+
+/**
+ * Get list of SSIDs (network names) from the last scan.
+ *
+ * @returns Promise resolving to array of SSID strings.
+ */
+export function getSSIDs() {
+  return MunimWifi.getSSIDs();
+}
+
+/**
+ * Get Wi-Fi fingerprint containing all network information.
+ * This includes SSIDs, BSSIDs, RSSI, channels, and frequencies.
+ *
+ * @returns Promise resolving to Wi-Fi fingerprint data.
+ */
+export function getWifiFingerprint() {
+  return MunimWifi.getWifiFingerprint();
+}
+
+/**
+ * Get RSSI (signal strength) for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to RSSI value in dBm, or null if network not found.
+ */
+export function getRSSI(ssid) {
+  return MunimWifi.getRSSI(ssid);
+}
+
+/**
+ * Get BSSID (MAC address) for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to BSSID string, or null if network not found.
+ */
+export function getBSSID(ssid) {
+  return MunimWifi.getBSSID(ssid);
+}
+
+/**
+ * Get channel and frequency information for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to object with channel and frequency, or null if network not found.
+ */
+export function getChannelInfo(ssid) {
+  return MunimWifi.getChannelInfo(ssid);
+}
+
+/**
+ * Get all available information for a specific network by SSID.
+ *
+ * @param ssid - The SSID of the network.
+ * @returns Promise resolving to WifiNetwork object, or null if network not found.
+ */
+export function getNetworkInfo(ssid) {
+  return MunimWifi.getNetworkInfo(ssid);
+}
+
+// ========== Event Management ==========
+
+/**
+ * Add a network found event listener (for continuous scanning).
+ *
+ * @param callback - Function to call when a network is found
+ * @returns A function to remove the listener
+ */
+export function addNetworkFoundListener(callback) {
+  if (!eventEmitter) {
+    console.warn('[munim-wifi] Cannot add listener - event emitter not available');
+    return () => {};
+  }
+  const subscription = eventEmitter.addListener('networkFound', callback);
+  return () => subscription.remove();
+}
+
+/**
+ * Add an event listener.
+ *
+ * @param eventName - The name of the event to listen for.
+ * @param callback - The callback to invoke when the event occurs.
+ * @returns A function to remove the listener
+ */
+export function addEventListener(eventName, callback) {
+  if (!eventEmitter) {
+    console.warn('[munim-wifi] Cannot add listener - event emitter not available');
+    return () => {};
+  }
+  const subscription = eventEmitter.addListener(eventName, callback);
+  return () => subscription.remove();
+}
+
+/**
+ * Add an event listener (legacy method).
+ *
+ * @param eventName - The name of the event to listen for.
+ */
+export function addListener(eventName) {
+  return MunimWifi.addListener(eventName);
+}
+
+/**
+ * Remove event listeners.
+ *
+ * @param count - Number of listeners to remove.
+ */
+export function removeListeners(count) {
+  return MunimWifi.removeListeners(count);
+}
+
+// ========== Type Exports ==========
+
+// Default export for convenience
+export default {
+  isWifiEnabled,
+  requestWifiPermission,
+  scanNetworks,
+  startScan,
+  stopScan,
+  getSSIDs,
+  getWifiFingerprint,
+  getRSSI,
+  getBSSID,
+  getChannelInfo,
+  getNetworkInfo,
+  addNetworkFoundListener,
+  addEventListener,
+  addListener,
+  removeListeners
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NitroModules","NativeEventEmitter","NativeModules","MunimWifi","createHybridObject","MunimWifiEventEmitter","eventEmitter","error","console","isWifiEnabled","requestWifiPermission","scanNetworks","options","startScan","stopScan","getSSIDs","getWifiFingerprint","getRSSI","ssid","getBSSID","getChannelInfo","getNetworkInfo","addNetworkFoundListener","callback","warn","subscription","addListener","remove","addEventListener","eventName","removeListeners","count"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/specs/munim-wifi.nitro.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=munim-wifi.nitro.js.map

package/lib/module/specs/munim-wifi.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["specs/munim-wifi.nitro.ts"],"mappings":"","ignoreList":[]}