munim-wifi 0.1.0

package/nitrogen/generated/shared/c++/WifiFingerprint.hpp

@@ -0,0 +1,97 @@
+///
+/// WifiFingerprint.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `WifiNetwork` to properly resolve imports.
+namespace margelo::nitro::munimwifi { struct WifiNetwork; }
+// Forward declaration of `Location` to properly resolve imports.
+namespace margelo::nitro::munimwifi { struct Location; }
+
+#include "WifiNetwork.hpp"
+#include <vector>
+#include "Location.hpp"
+#include <optional>
+
+namespace margelo::nitro::munimwifi {
+
+  /**
+   * A struct which can be represented as a JavaScript object (WifiFingerprint).
+   */
+  struct WifiFingerprint final {
+  public:
+    std::vector<WifiNetwork> networks     SWIFT_PRIVATE;
+    double timestamp     SWIFT_PRIVATE;
+    std::optional<Location> location     SWIFT_PRIVATE;
+
+  public:
+    WifiFingerprint() = default;
+    explicit WifiFingerprint(std::vector<WifiNetwork> networks, double timestamp, std::optional<Location> location): networks(networks), timestamp(timestamp), location(location) {}
+
+  public:
+    friend bool operator==(const WifiFingerprint& lhs, const WifiFingerprint& rhs) = default;
+  };
+
+} // namespace margelo::nitro::munimwifi
+
+namespace margelo::nitro {
+
+  // C++ WifiFingerprint <> JS WifiFingerprint (object)
+  template <>
+  struct JSIConverter<margelo::nitro::munimwifi::WifiFingerprint> final {
+    static inline margelo::nitro::munimwifi::WifiFingerprint fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::munimwifi::WifiFingerprint(
+        JSIConverter<std::vector<margelo::nitro::munimwifi::WifiNetwork>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "networks"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "timestamp"))),
+        JSIConverter<std::optional<margelo::nitro::munimwifi::Location>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "location")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::munimwifi::WifiFingerprint& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "networks"), JSIConverter<std::vector<margelo::nitro::munimwifi::WifiNetwork>>::toJSI(runtime, arg.networks));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "timestamp"), JSIConverter<double>::toJSI(runtime, arg.timestamp));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "location"), JSIConverter<std::optional<margelo::nitro::munimwifi::Location>>::toJSI(runtime, arg.location));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::vector<margelo::nitro::munimwifi::WifiNetwork>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "networks")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "timestamp")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::munimwifi::Location>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "location")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/WifiNetwork.hpp

@@ -0,0 +1,112 @@
+///
+/// WifiNetwork.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::munimwifi {
+
+  /**
+   * A struct which can be represented as a JavaScript object (WifiNetwork).
+   */
+  struct WifiNetwork final {
+  public:
+    std::string ssid     SWIFT_PRIVATE;
+    std::string bssid     SWIFT_PRIVATE;
+    double rssi     SWIFT_PRIVATE;
+    double frequency     SWIFT_PRIVATE;
+    std::optional<double> channel     SWIFT_PRIVATE;
+    std::optional<std::string> capabilities     SWIFT_PRIVATE;
+    std::optional<bool> isSecure     SWIFT_PRIVATE;
+    std::optional<double> timestamp     SWIFT_PRIVATE;
+
+  public:
+    WifiNetwork() = default;
+    explicit WifiNetwork(std::string ssid, std::string bssid, double rssi, double frequency, std::optional<double> channel, std::optional<std::string> capabilities, std::optional<bool> isSecure, std::optional<double> timestamp): ssid(ssid), bssid(bssid), rssi(rssi), frequency(frequency), channel(channel), capabilities(capabilities), isSecure(isSecure), timestamp(timestamp) {}
+
+  public:
+    friend bool operator==(const WifiNetwork& lhs, const WifiNetwork& rhs) = default;
+  };
+
+} // namespace margelo::nitro::munimwifi
+
+namespace margelo::nitro {
+
+  // C++ WifiNetwork <> JS WifiNetwork (object)
+  template <>
+  struct JSIConverter<margelo::nitro::munimwifi::WifiNetwork> final {
+    static inline margelo::nitro::munimwifi::WifiNetwork fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::munimwifi::WifiNetwork(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "ssid"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bssid"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "rssi"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "frequency"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "channel"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "capabilities"))),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isSecure"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "timestamp")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::munimwifi::WifiNetwork& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "ssid"), JSIConverter<std::string>::toJSI(runtime, arg.ssid));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "bssid"), JSIConverter<std::string>::toJSI(runtime, arg.bssid));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "rssi"), JSIConverter<double>::toJSI(runtime, arg.rssi));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "frequency"), JSIConverter<double>::toJSI(runtime, arg.frequency));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "channel"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.channel));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "capabilities"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.capabilities));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "isSecure"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.isSecure));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "timestamp"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.timestamp));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "ssid")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bssid")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "rssi")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "frequency")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "channel")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "capabilities")))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "isSecure")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "timestamp")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "munim-wifi",
+  "version": "0.1.0",
+  "description": "munim-wifi is a react native package built with Nitro",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "git clean -dfX",
+    "release": "semantic-release",
+    "build": "npm run typecheck && bob build",
+    "codegen": "nitrogen --logLevel=\"debug\" && npm run build && node post-script.js"
+  },
+  "keywords": [
+    "react-native",
+    "munim-wifi"
+  ],
+  "files": [
+    "src",
+    "react-native.config.js",
+    "lib",
+    "nitrogen",
+    "cpp",
+    "nitro.json",
+    "android/build.gradle",
+    "android/fix-prefab.gradle",
+    "android/gradle.properties",
+    "android/CMakeLists.txt",
+    "android/src",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "app.plugin.js",
+    "*.podspec",
+    "README.md"
+  ],
+  "workspaces": [
+    "example"
+  ],
+  "repository": "https://github.com/munimtechnologies/munim-wifi.git",
+  "author": "sheehanmunim",
+  "license": "MIT",
+  "bugs": "https://github.com/munimtechnologies/munim-wifi/issues",
+  "homepage": "https://github.com/munimtechnologies/munim-wifi#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/react": "19.2.0",
+    "nitrogen": "0.33.2",
+    "react": "19.2.0",
+    "react-native": "0.83",
+    "react-native-builder-bob": "^0.40.17",
+    "react-native-nitro-modules": "0.33.2",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "semantic-release": "^25.0.2",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*"
+  },
+  "eslintConfig": {
+    "root": true,
+    "extends": [
+      "@react-native",
+      "prettier"
+    ],
+    "plugins": [
+      "prettier"
+    ],
+    "rules": {
+      "prettier/prettier": [
+        "warn",
+        {
+          "quoteProps": "consistent",
+          "singleQuote": true,
+          "tabWidth": 2,
+          "trailingComma": "es5",
+          "useTabs": false
+        }
+      ]
+    }
+  },
+  "eslintIgnore": [
+    "node_modules/",
+    "lib/"
+  ],
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false,
+    "semi": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  }
+}

package/src/index.ts

@@ -0,0 +1,221 @@
+import { NitroModules } from 'react-native-nitro-modules'
+import { NativeEventEmitter, NativeModules } from 'react-native'
+import type {
+  MunimWifi as MunimWifiSpec,
+  WifiNetwork,
+  WifiFingerprint,
+  ScanOptions,
+  ChannelInfo,
+  Location,
+} from './specs/munim-wifi.nitro'
+
+const MunimWifi =
+  NitroModules.createHybridObject<MunimWifiSpec>('MunimWifi')
+
+// Event Emitter for Wi-Fi events
+const { MunimWifiEventEmitter } = NativeModules
+
+let eventEmitter: NativeEventEmitter | null = 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(): Promise<boolean> {
+  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(): Promise<boolean> {
+  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?: ScanOptions): Promise<WifiNetwork[]> {
+  return MunimWifi.scanNetworks(options)
+}
+
+/**
+ * Start continuous Wi-Fi scanning. Results will be emitted via events.
+ *
+ * @param options - Optional scan configuration.
+ */
+export function startScan(options?: ScanOptions): void {
+  return MunimWifi.startScan(options)
+}
+
+/**
+ * Stop continuous Wi-Fi scanning.
+ */
+export function stopScan(): void {
+  return MunimWifi.stopScan()
+}
+
+/**
+ * Get list of SSIDs (network names) from the last scan.
+ *
+ * @returns Promise resolving to array of SSID strings.
+ */
+export function getSSIDs(): Promise<string[]> {
+  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(): Promise<WifiFingerprint> {
+  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: string): Promise<number | null> {
+  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: string): Promise<string | null> {
+  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: string): Promise<ChannelInfo | null> {
+  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: string): Promise<WifiNetwork | null> {
+  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: (network: WifiNetwork) => void
+): () => void {
+  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: string,
+  callback: (data: any) => void
+): () => void {
+  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: string): void {
+  return MunimWifi.addListener(eventName)
+}
+
+/**
+ * Remove event listeners.
+ *
+ * @param count - Number of listeners to remove.
+ */
+export function removeListeners(count: number): void {
+  return MunimWifi.removeListeners(count)
+}
+
+// ========== Type Exports ==========
+
+export type { WifiNetwork, WifiFingerprint, ScanOptions, ChannelInfo, Location }
+
+// Default export for convenience
+export default {
+  isWifiEnabled,
+  requestWifiPermission,
+  scanNetworks,
+  startScan,
+  stopScan,
+  getSSIDs,
+  getWifiFingerprint,
+  getRSSI,
+  getBSSID,
+  getChannelInfo,
+  getNetworkInfo,
+  addNetworkFoundListener,
+  addEventListener,
+  addListener,
+  removeListeners,
+}

package/src/specs/munim-wifi.nitro.ts

@@ -0,0 +1,140 @@
+import { type HybridObject } from 'react-native-nitro-modules'
+
+// Location information
+export interface Location {
+  latitude?: number
+  longitude?: number
+}
+
+// Channel information
+export interface ChannelInfo {
+  channel: number
+  frequency: number
+}
+
+// Wi-Fi Network information
+export interface WifiNetwork {
+  ssid: string
+  bssid: string
+  rssi: number
+  frequency: number
+  channel?: number
+  capabilities?: string
+  isSecure?: boolean
+  timestamp?: number
+}
+
+// Wi-Fi Fingerprint data
+export interface WifiFingerprint {
+  networks: WifiNetwork[]
+  timestamp: number
+  location?: Location
+}
+
+// Scan options
+export interface ScanOptions {
+  maxResults?: number
+  timeout?: number
+}
+
+export interface MunimWifi
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /**
+   * Check if Wi-Fi is enabled on the device.
+   *
+   * @returns Promise resolving to true if Wi-Fi is enabled, false otherwise.
+   */
+  isWifiEnabled(): Promise<boolean>
+
+  /**
+   * 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.
+   */
+  requestWifiPermission(): Promise<boolean>
+
+  /**
+   * 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.
+   */
+  scanNetworks(options?: ScanOptions): Promise<WifiNetwork[]>
+
+  /**
+   * Start continuous Wi-Fi scanning. Results will be emitted via events.
+   *
+   * @param options - Optional scan configuration.
+   */
+  startScan(options?: ScanOptions): void
+
+  /**
+   * Stop continuous Wi-Fi scanning.
+   */
+  stopScan(): void
+
+  /**
+   * Get list of SSIDs (network names) from the last scan.
+   *
+   * @returns Promise resolving to array of SSID strings.
+   */
+  getSSIDs(): Promise<string[]>
+
+  /**
+   * Get Wi-Fi fingerprint containing all network information.
+   * This includes SSIDs, BSSIDs, RSSI, channels, and frequencies.
+   *
+   * @returns Promise resolving to Wi-Fi fingerprint data.
+   */
+  getWifiFingerprint(): Promise<WifiFingerprint>
+
+  /**
+   * 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.
+   */
+  getRSSI(ssid: string): Promise<number | null>
+
+  /**
+   * 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.
+   */
+  getBSSID(ssid: string): Promise<string | null>
+
+  /**
+   * 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.
+   */
+  getChannelInfo(ssid: string): Promise<ChannelInfo | null>
+
+  /**
+   * 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.
+   */
+  getNetworkInfo(ssid: string): Promise<WifiNetwork | null>
+
+  // ========== Event Management ==========
+
+  /**
+   * Add an event listener for network found events (when using startScan).
+   *
+   * @param eventName - The name of the event to listen for.
+   */
+  addListener(eventName: string): void
+
+  /**
+   * Remove event listeners.
+   *
+   * @param count - Number of listeners to remove.
+   */
+  removeListeners(count: number): void
+}