@capgo/capacitor-wifi 7.0.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,493 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+/**
+ * WiFi plugin for managing device WiFi connectivity
+ *
+ * @since 7.0.0
+ */
+export interface CapacitorWifiPlugin {
+    /**
+     * Show a system dialog to add a Wi-Fi network to the device.
+     * On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled.
+     * On iOS, this connects to the network directly.
+     *
+     * @param options - Network configuration options
+     * @returns Promise that resolves when the network is added
+     * @throws Error if adding the network fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * await CapacitorWifi.addNetwork({
+     *   ssid: 'MyNetwork',
+     *   password: 'mypassword',
+     *   isHiddenSsid: false,
+     *   securityType: NetworkSecurityType.WPA2_PSK
+     * });
+     * ```
+     */
+    addNetwork(options: AddNetworkOptions): Promise<void>;
+    /**
+     * Connect to a Wi-Fi network.
+     * On Android, this creates a temporary connection that doesn't route traffic through the network by default.
+     * For a persistent connection on Android, use addNetwork() instead.
+     * On iOS, this creates a persistent connection.
+     *
+     * @param options - Connection options
+     * @returns Promise that resolves when connected
+     * @throws Error if connection fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * await CapacitorWifi.connect({
+     *   ssid: 'MyNetwork',
+     *   password: 'mypassword'
+     * });
+     * ```
+     */
+    connect(options: ConnectOptions): Promise<void>;
+    /**
+     * Disconnect from the current Wi-Fi network.
+     * On iOS, only disconnects from networks that were added via this plugin.
+     *
+     * @param options - Optional disconnect options
+     * @returns Promise that resolves when disconnected
+     * @throws Error if disconnection fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * await CapacitorWifi.disconnect();
+     * ```
+     */
+    disconnect(options?: DisconnectOptions): Promise<void>;
+    /**
+     * Get a list of available Wi-Fi networks from the last scan.
+     * Only available on Android.
+     *
+     * @returns Promise that resolves with the list of networks
+     * @throws Error if getting networks fails or on unsupported platform
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { networks } = await CapacitorWifi.getAvailableNetworks();
+     * networks.forEach(network => {
+     *   console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
+     * });
+     * ```
+     */
+    getAvailableNetworks(): Promise<GetAvailableNetworksResult>;
+    /**
+     * Get the device's current IP address.
+     * Available on both Android and iOS.
+     *
+     * @returns Promise that resolves with the IP address
+     * @throws Error if getting IP address fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { ipAddress } = await CapacitorWifi.getIpAddress();
+     * console.log('IP Address:', ipAddress);
+     * ```
+     */
+    getIpAddress(): Promise<GetIpAddressResult>;
+    /**
+     * Get the received signal strength indicator (RSSI) of the current network in dBm.
+     * Only available on Android.
+     *
+     * @returns Promise that resolves with the RSSI value
+     * @throws Error if getting RSSI fails or on unsupported platform
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { rssi } = await CapacitorWifi.getRssi();
+     * console.log('Signal strength:', rssi, 'dBm');
+     * ```
+     */
+    getRssi(): Promise<GetRssiResult>;
+    /**
+     * Get the service set identifier (SSID) of the current network.
+     * Available on both Android and iOS.
+     *
+     * @returns Promise that resolves with the SSID
+     * @throws Error if getting SSID fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { ssid } = await CapacitorWifi.getSsid();
+     * console.log('Connected to:', ssid);
+     * ```
+     */
+    getSsid(): Promise<GetSsidResult>;
+    /**
+     * Check if Wi-Fi is enabled on the device.
+     * Only available on Android.
+     *
+     * @returns Promise that resolves with the Wi-Fi enabled status
+     * @throws Error if checking status fails or on unsupported platform
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { enabled } = await CapacitorWifi.isEnabled();
+     * console.log('WiFi is', enabled ? 'enabled' : 'disabled');
+     * ```
+     */
+    isEnabled(): Promise<IsEnabledResult>;
+    /**
+     * Start scanning for Wi-Fi networks.
+     * Only available on Android.
+     * Results are delivered via the 'networksScanned' event listener.
+     * Note: May fail due to system throttling or hardware issues.
+     *
+     * @returns Promise that resolves when scan starts
+     * @throws Error if scan fails or on unsupported platform
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * await CapacitorWifi.addListener('networksScanned', () => {
+     *   console.log('Scan completed');
+     * });
+     * await CapacitorWifi.startScan();
+     * ```
+     */
+    startScan(): Promise<void>;
+    /**
+     * Check the current permission status for location access.
+     * Location permission is required for Wi-Fi operations on both platforms.
+     *
+     * @returns Promise that resolves with the permission status
+     * @throws Error if checking permissions fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const status = await CapacitorWifi.checkPermissions();
+     * console.log('Location permission:', status.location);
+     * ```
+     */
+    checkPermissions(): Promise<PermissionStatus>;
+    /**
+     * Request location permissions from the user.
+     * Location permission is required for Wi-Fi operations on both platforms.
+     *
+     * @param options - Optional permission request options
+     * @returns Promise that resolves with the updated permission status
+     * @throws Error if requesting permissions fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const status = await CapacitorWifi.requestPermissions();
+     * if (status.location === 'granted') {
+     *   console.log('Permission granted');
+     * }
+     * ```
+     */
+    requestPermissions(options?: RequestPermissionsOptions): Promise<PermissionStatus>;
+    /**
+     * Add a listener for the 'networksScanned' event.
+     * Only available on Android.
+     * This event is fired when Wi-Fi scan results are available.
+     *
+     * @param eventName - The event name ('networksScanned')
+     * @param listenerFunc - The callback function to execute
+     * @returns Promise that resolves with a listener handle
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const listener = await CapacitorWifi.addListener('networksScanned', async () => {
+     *   const { networks } = await CapacitorWifi.getAvailableNetworks();
+     *   console.log('Found networks:', networks);
+     * });
+     * ```
+     */
+    addListener(eventName: 'networksScanned', listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     *
+     * @returns Promise that resolves when all listeners are removed
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * await CapacitorWifi.removeAllListeners();
+     * ```
+     */
+    removeAllListeners(): Promise<void>;
+    /**
+     * Get the native plugin version.
+     *
+     * @returns Promise that resolves with the plugin version
+     * @throws Error if getting the version fails
+     * @since 7.0.0
+     * @example
+     * ```typescript
+     * const { version } = await CapacitorWifi.getPluginVersion();
+     * console.log('Plugin version:', version);
+     * ```
+     */
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
+}
+/**
+ * Options for adding a network
+ *
+ * @since 7.0.0
+ */
+export interface AddNetworkOptions {
+    /**
+     * The SSID of the network to add
+     *
+     * @since 7.0.0
+     */
+    ssid: string;
+    /**
+     * The password for the network (optional for open networks)
+     *
+     * @since 7.0.0
+     */
+    password?: string;
+    /**
+     * Whether the network is hidden (Android only)
+     *
+     * @since 7.0.0
+     * @default false
+     */
+    isHiddenSsid?: boolean;
+    /**
+     * The security type of the network (Android only)
+     *
+     * @since 7.0.0
+     * @default NetworkSecurityType.WPA2_PSK
+     */
+    securityType?: NetworkSecurityType;
+}
+/**
+ * Options for connecting to a network
+ *
+ * @since 7.0.0
+ */
+export interface ConnectOptions {
+    /**
+     * The SSID of the network to connect to
+     *
+     * @since 7.0.0
+     */
+    ssid: string;
+    /**
+     * The password for the network (optional for open networks)
+     *
+     * @since 7.0.0
+     */
+    password?: string;
+    /**
+     * Whether the network is hidden (Android only)
+     *
+     * @since 7.0.0
+     * @default false
+     */
+    isHiddenSsid?: boolean;
+}
+/**
+ * Options for disconnecting from a network
+ *
+ * @since 7.0.0
+ */
+export interface DisconnectOptions {
+    /**
+     * The SSID of the network to disconnect from (optional)
+     *
+     * @since 7.0.0
+     */
+    ssid?: string;
+}
+/**
+ * Result from getAvailableNetworks()
+ *
+ * @since 7.0.0
+ */
+export interface GetAvailableNetworksResult {
+    /**
+     * List of available networks
+     *
+     * @since 7.0.0
+     */
+    networks: Network[];
+}
+/**
+ * Represents a Wi-Fi network
+ *
+ * @since 7.0.0
+ */
+export interface Network {
+    /**
+     * The SSID of the network
+     *
+     * @since 7.0.0
+     */
+    ssid: string;
+    /**
+     * The signal strength in dBm
+     *
+     * @since 7.0.0
+     */
+    rssi: number;
+    /**
+     * The security types supported by this network (Android SDK 33+ only)
+     *
+     * @since 7.0.0
+     */
+    securityTypes?: NetworkSecurityType[];
+}
+/**
+ * Result from getIpAddress()
+ *
+ * @since 7.0.0
+ */
+export interface GetIpAddressResult {
+    /**
+     * The device's IP address
+     *
+     * @since 7.0.0
+     */
+    ipAddress: string;
+}
+/**
+ * Result from getRssi()
+ *
+ * @since 7.0.0
+ */
+export interface GetRssiResult {
+    /**
+     * The signal strength in dBm
+     *
+     * @since 7.0.0
+     */
+    rssi: number;
+}
+/**
+ * Result from getSsid()
+ *
+ * @since 7.0.0
+ */
+export interface GetSsidResult {
+    /**
+     * The SSID of the current network
+     *
+     * @since 7.0.0
+     */
+    ssid: string;
+}
+/**
+ * Result from isEnabled()
+ *
+ * @since 7.0.0
+ */
+export interface IsEnabledResult {
+    /**
+     * Whether Wi-Fi is enabled
+     *
+     * @since 7.0.0
+     */
+    enabled: boolean;
+}
+/**
+ * Permission status
+ *
+ * @since 7.0.0
+ */
+export interface PermissionStatus {
+    /**
+     * Location permission state
+     *
+     * @since 7.0.0
+     */
+    location: PermissionState;
+}
+/**
+ * Possible permission states
+ *
+ * @since 7.0.0
+ */
+export type PermissionState = 'granted' | 'denied' | 'prompt';
+/**
+ * Options for requesting permissions
+ *
+ * @since 7.0.0
+ */
+export interface RequestPermissionsOptions {
+    /**
+     * Permissions to request
+     *
+     * @since 7.0.0
+     */
+    permissions?: 'location'[];
+}
+/**
+ * Network security types
+ *
+ * @since 7.0.0
+ */
+export declare enum NetworkSecurityType {
+    /**
+     * Open network with no security
+     *
+     * @since 7.0.0
+     */
+    OPEN = 0,
+    /**
+     * WEP security
+     *
+     * @since 7.0.0
+     */
+    WEP = 1,
+    /**
+     * WPA/WPA2 Personal (PSK)
+     *
+     * @since 7.0.0
+     */
+    WPA2_PSK = 2,
+    /**
+     * WPA/WPA2/WPA3 Enterprise (EAP)
+     *
+     * @since 7.0.0
+     */
+    EAP = 3,
+    /**
+     * WPA3 Personal (SAE)
+     *
+     * @since 7.0.0
+     */
+    SAE = 4,
+    /**
+     * WPA3 Enterprise
+     *
+     * @since 7.0.0
+     */
+    WPA3_ENTERPRISE = 5,
+    /**
+     * WPA3 Enterprise 192-bit mode
+     *
+     * @since 7.0.0
+     */
+    WPA3_ENTERPRISE_192_BIT = 6,
+    /**
+     * Passpoint network
+     *
+     * @since 7.0.0
+     */
+    PASSPOINT = 7,
+    /**
+     * Enhanced Open (OWE)
+     *
+     * @since 7.0.0
+     */
+    OWE = 8,
+    /**
+     * WAPI PSK
+     *
+     * @since 7.0.0
+     */
+    WAPI_PSK = 9,
+    /**
+     * WAPI Certificate
+     *
+     * @since 7.0.0
+     */
+    WAPI_CERT = 10
+}

package/dist/esm/definitions.js

@@ -0,0 +1,75 @@
+/**
+ * Network security types
+ *
+ * @since 7.0.0
+ */
+export var NetworkSecurityType;
+(function (NetworkSecurityType) {
+    /**
+     * Open network with no security
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["OPEN"] = 0] = "OPEN";
+    /**
+     * WEP security
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WEP"] = 1] = "WEP";
+    /**
+     * WPA/WPA2 Personal (PSK)
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WPA2_PSK"] = 2] = "WPA2_PSK";
+    /**
+     * WPA/WPA2/WPA3 Enterprise (EAP)
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["EAP"] = 3] = "EAP";
+    /**
+     * WPA3 Personal (SAE)
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["SAE"] = 4] = "SAE";
+    /**
+     * WPA3 Enterprise
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WPA3_ENTERPRISE"] = 5] = "WPA3_ENTERPRISE";
+    /**
+     * WPA3 Enterprise 192-bit mode
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WPA3_ENTERPRISE_192_BIT"] = 6] = "WPA3_ENTERPRISE_192_BIT";
+    /**
+     * Passpoint network
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["PASSPOINT"] = 7] = "PASSPOINT";
+    /**
+     * Enhanced Open (OWE)
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["OWE"] = 8] = "OWE";
+    /**
+     * WAPI PSK
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WAPI_PSK"] = 9] = "WAPI_PSK";
+    /**
+     * WAPI Certificate
+     *
+     * @since 7.0.0
+     */
+    NetworkSecurityType[NetworkSecurityType["WAPI_CERT"] = 10] = "WAPI_CERT";
+})(NetworkSecurityType || (NetworkSecurityType = {}));
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAocA;;;;GAIG;AACH,MAAM,CAAN,IAAY,mBA6EX;AA7ED,WAAY,mBAAmB;IAC7B;;;;OAIG;IACH,6DAAQ,CAAA;IAER;;;;OAIG;IACH,2DAAO,CAAA;IAEP;;;;OAIG;IACH,qEAAY,CAAA;IAEZ;;;;OAIG;IACH,2DAAO,CAAA;IAEP;;;;OAIG;IACH,2DAAO,CAAA;IAEP;;;;OAIG;IACH,mFAAmB,CAAA;IAEnB;;;;OAIG;IACH,mGAA2B,CAAA;IAE3B;;;;OAIG;IACH,uEAAa,CAAA;IAEb;;;;OAIG;IACH,2DAAO,CAAA;IAEP;;;;OAIG;IACH,qEAAY,CAAA;IAEZ;;;;OAIG;IACH,wEAAc,CAAA;AAChB,CAAC,EA7EW,mBAAmB,KAAnB,mBAAmB,QA6E9B","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * WiFi plugin for managing device WiFi connectivity\n *\n * @since 7.0.0\n */\nexport interface CapacitorWifiPlugin {\n  /**\n   * Show a system dialog to add a Wi-Fi network to the device.\n   * On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled.\n   * On iOS, this connects to the network directly.\n   *\n   * @param options - Network configuration options\n   * @returns Promise that resolves when the network is added\n   * @throws Error if adding the network fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * await CapacitorWifi.addNetwork({\n   *   ssid: 'MyNetwork',\n   *   password: 'mypassword',\n   *   isHiddenSsid: false,\n   *   securityType: NetworkSecurityType.WPA2_PSK\n   * });\n   * ```\n   */\n  addNetwork(options: AddNetworkOptions): Promise<void>;\n\n  /**\n   * Connect to a Wi-Fi network.\n   * On Android, this creates a temporary connection that doesn't route traffic through the network by default.\n   * For a persistent connection on Android, use addNetwork() instead.\n   * On iOS, this creates a persistent connection.\n   *\n   * @param options - Connection options\n   * @returns Promise that resolves when connected\n   * @throws Error if connection fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * await CapacitorWifi.connect({\n   *   ssid: 'MyNetwork',\n   *   password: 'mypassword'\n   * });\n   * ```\n   */\n  connect(options: ConnectOptions): Promise<void>;\n\n  /**\n   * Disconnect from the current Wi-Fi network.\n   * On iOS, only disconnects from networks that were added via this plugin.\n   *\n   * @param options - Optional disconnect options\n   * @returns Promise that resolves when disconnected\n   * @throws Error if disconnection fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * await CapacitorWifi.disconnect();\n   * ```\n   */\n  disconnect(options?: DisconnectOptions): Promise<void>;\n\n  /**\n   * Get a list of available Wi-Fi networks from the last scan.\n   * Only available on Android.\n   *\n   * @returns Promise that resolves with the list of networks\n   * @throws Error if getting networks fails or on unsupported platform\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { networks } = await CapacitorWifi.getAvailableNetworks();\n   * networks.forEach(network => {\n   *   console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);\n   * });\n   * ```\n   */\n  getAvailableNetworks(): Promise<GetAvailableNetworksResult>;\n\n  /**\n   * Get the device's current IP address.\n   * Available on both Android and iOS.\n   *\n   * @returns Promise that resolves with the IP address\n   * @throws Error if getting IP address fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { ipAddress } = await CapacitorWifi.getIpAddress();\n   * console.log('IP Address:', ipAddress);\n   * ```\n   */\n  getIpAddress(): Promise<GetIpAddressResult>;\n\n  /**\n   * Get the received signal strength indicator (RSSI) of the current network in dBm.\n   * Only available on Android.\n   *\n   * @returns Promise that resolves with the RSSI value\n   * @throws Error if getting RSSI fails or on unsupported platform\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { rssi } = await CapacitorWifi.getRssi();\n   * console.log('Signal strength:', rssi, 'dBm');\n   * ```\n   */\n  getRssi(): Promise<GetRssiResult>;\n\n  /**\n   * Get the service set identifier (SSID) of the current network.\n   * Available on both Android and iOS.\n   *\n   * @returns Promise that resolves with the SSID\n   * @throws Error if getting SSID fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { ssid } = await CapacitorWifi.getSsid();\n   * console.log('Connected to:', ssid);\n   * ```\n   */\n  getSsid(): Promise<GetSsidResult>;\n\n  /**\n   * Check if Wi-Fi is enabled on the device.\n   * Only available on Android.\n   *\n   * @returns Promise that resolves with the Wi-Fi enabled status\n   * @throws Error if checking status fails or on unsupported platform\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { enabled } = await CapacitorWifi.isEnabled();\n   * console.log('WiFi is', enabled ? 'enabled' : 'disabled');\n   * ```\n   */\n  isEnabled(): Promise<IsEnabledResult>;\n\n  /**\n   * Start scanning for Wi-Fi networks.\n   * Only available on Android.\n   * Results are delivered via the 'networksScanned' event listener.\n   * Note: May fail due to system throttling or hardware issues.\n   *\n   * @returns Promise that resolves when scan starts\n   * @throws Error if scan fails or on unsupported platform\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * await CapacitorWifi.addListener('networksScanned', () => {\n   *   console.log('Scan completed');\n   * });\n   * await CapacitorWifi.startScan();\n   * ```\n   */\n  startScan(): Promise<void>;\n\n  /**\n   * Check the current permission status for location access.\n   * Location permission is required for Wi-Fi operations on both platforms.\n   *\n   * @returns Promise that resolves with the permission status\n   * @throws Error if checking permissions fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const status = await CapacitorWifi.checkPermissions();\n   * console.log('Location permission:', status.location);\n   * ```\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request location permissions from the user.\n   * Location permission is required for Wi-Fi operations on both platforms.\n   *\n   * @param options - Optional permission request options\n   * @returns Promise that resolves with the updated permission status\n   * @throws Error if requesting permissions fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const status = await CapacitorWifi.requestPermissions();\n   * if (status.location === 'granted') {\n   *   console.log('Permission granted');\n   * }\n   * ```\n   */\n  requestPermissions(options?: RequestPermissionsOptions): Promise<PermissionStatus>;\n\n  /**\n   * Add a listener for the 'networksScanned' event.\n   * Only available on Android.\n   * This event is fired when Wi-Fi scan results are available.\n   *\n   * @param eventName - The event name ('networksScanned')\n   * @param listenerFunc - The callback function to execute\n   * @returns Promise that resolves with a listener handle\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const listener = await CapacitorWifi.addListener('networksScanned', async () => {\n   *   const { networks } = await CapacitorWifi.getAvailableNetworks();\n   *   console.log('Found networks:', networks);\n   * });\n   * ```\n   */\n  addListener(eventName: 'networksScanned', listenerFunc: () => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @returns Promise that resolves when all listeners are removed\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * await CapacitorWifi.removeAllListeners();\n   * ```\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Get the native plugin version.\n   *\n   * @returns Promise that resolves with the plugin version\n   * @throws Error if getting the version fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const { version } = await CapacitorWifi.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n\n/**\n * Options for adding a network\n *\n * @since 7.0.0\n */\nexport interface AddNetworkOptions {\n  /**\n   * The SSID of the network to add\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n\n  /**\n   * The password for the network (optional for open networks)\n   *\n   * @since 7.0.0\n   */\n  password?: string;\n\n  /**\n   * Whether the network is hidden (Android only)\n   *\n   * @since 7.0.0\n   * @default false\n   */\n  isHiddenSsid?: boolean;\n\n  /**\n   * The security type of the network (Android only)\n   *\n   * @since 7.0.0\n   * @default NetworkSecurityType.WPA2_PSK\n   */\n  securityType?: NetworkSecurityType;\n}\n\n/**\n * Options for connecting to a network\n *\n * @since 7.0.0\n */\nexport interface ConnectOptions {\n  /**\n   * The SSID of the network to connect to\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n\n  /**\n   * The password for the network (optional for open networks)\n   *\n   * @since 7.0.0\n   */\n  password?: string;\n\n  /**\n   * Whether the network is hidden (Android only)\n   *\n   * @since 7.0.0\n   * @default false\n   */\n  isHiddenSsid?: boolean;\n}\n\n/**\n * Options for disconnecting from a network\n *\n * @since 7.0.0\n */\nexport interface DisconnectOptions {\n  /**\n   * The SSID of the network to disconnect from (optional)\n   *\n   * @since 7.0.0\n   */\n  ssid?: string;\n}\n\n/**\n * Result from getAvailableNetworks()\n *\n * @since 7.0.0\n */\nexport interface GetAvailableNetworksResult {\n  /**\n   * List of available networks\n   *\n   * @since 7.0.0\n   */\n  networks: Network[];\n}\n\n/**\n * Represents a Wi-Fi network\n *\n * @since 7.0.0\n */\nexport interface Network {\n  /**\n   * The SSID of the network\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n\n  /**\n   * The signal strength in dBm\n   *\n   * @since 7.0.0\n   */\n  rssi: number;\n\n  /**\n   * The security types supported by this network (Android SDK 33+ only)\n   *\n   * @since 7.0.0\n   */\n  securityTypes?: NetworkSecurityType[];\n}\n\n/**\n * Result from getIpAddress()\n *\n * @since 7.0.0\n */\nexport interface GetIpAddressResult {\n  /**\n   * The device's IP address\n   *\n   * @since 7.0.0\n   */\n  ipAddress: string;\n}\n\n/**\n * Result from getRssi()\n *\n * @since 7.0.0\n */\nexport interface GetRssiResult {\n  /**\n   * The signal strength in dBm\n   *\n   * @since 7.0.0\n   */\n  rssi: number;\n}\n\n/**\n * Result from getSsid()\n *\n * @since 7.0.0\n */\nexport interface GetSsidResult {\n  /**\n   * The SSID of the current network\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n}\n\n/**\n * Result from isEnabled()\n *\n * @since 7.0.0\n */\nexport interface IsEnabledResult {\n  /**\n   * Whether Wi-Fi is enabled\n   *\n   * @since 7.0.0\n   */\n  enabled: boolean;\n}\n\n/**\n * Permission status\n *\n * @since 7.0.0\n */\nexport interface PermissionStatus {\n  /**\n   * Location permission state\n   *\n   * @since 7.0.0\n   */\n  location: PermissionState;\n}\n\n/**\n * Possible permission states\n *\n * @since 7.0.0\n */\nexport type PermissionState = 'granted' | 'denied' | 'prompt';\n\n/**\n * Options for requesting permissions\n *\n * @since 7.0.0\n */\nexport interface RequestPermissionsOptions {\n  /**\n   * Permissions to request\n   *\n   * @since 7.0.0\n   */\n  permissions?: 'location'[];\n}\n\n/**\n * Network security types\n *\n * @since 7.0.0\n */\nexport enum NetworkSecurityType {\n  /**\n   * Open network with no security\n   *\n   * @since 7.0.0\n   */\n  OPEN = 0,\n\n  /**\n   * WEP security\n   *\n   * @since 7.0.0\n   */\n  WEP = 1,\n\n  /**\n   * WPA/WPA2 Personal (PSK)\n   *\n   * @since 7.0.0\n   */\n  WPA2_PSK = 2,\n\n  /**\n   * WPA/WPA2/WPA3 Enterprise (EAP)\n   *\n   * @since 7.0.0\n   */\n  EAP = 3,\n\n  /**\n   * WPA3 Personal (SAE)\n   *\n   * @since 7.0.0\n   */\n  SAE = 4,\n\n  /**\n   * WPA3 Enterprise\n   *\n   * @since 7.0.0\n   */\n  WPA3_ENTERPRISE = 5,\n\n  /**\n   * WPA3 Enterprise 192-bit mode\n   *\n   * @since 7.0.0\n   */\n  WPA3_ENTERPRISE_192_BIT = 6,\n\n  /**\n   * Passpoint network\n   *\n   * @since 7.0.0\n   */\n  PASSPOINT = 7,\n\n  /**\n   * Enhanced Open (OWE)\n   *\n   * @since 7.0.0\n   */\n  OWE = 8,\n\n  /**\n   * WAPI PSK\n   *\n   * @since 7.0.0\n   */\n  WAPI_PSK = 9,\n\n  /**\n   * WAPI Certificate\n   *\n   * @since 7.0.0\n   */\n  WAPI_CERT = 10,\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { CapacitorWifiPlugin } from './definitions';
+declare const CapacitorWifi: CapacitorWifiPlugin;
+export * from './definitions';
+export { CapacitorWifi };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const CapacitorWifi = registerPlugin('CapacitorWifi', {
+    web: () => import('./web').then((m) => new m.CapacitorWifiWeb()),
+});
+export * from './definitions';
+export { CapacitorWifi };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,aAAa,GAAG,cAAc,CAAsB,eAAe,EAAE;IACzE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;CACjE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { CapacitorWifiPlugin } from './definitions';\n\nconst CapacitorWifi = registerPlugin<CapacitorWifiPlugin>('CapacitorWifi', {\n  web: () => import('./web').then((m) => new m.CapacitorWifiWeb()),\n});\n\nexport * from './definitions';\nexport { CapacitorWifi };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,18 @@
+import { WebPlugin } from '@capacitor/core';
+import type { AddNetworkOptions, CapacitorWifiPlugin, ConnectOptions, DisconnectOptions, GetAvailableNetworksResult, GetIpAddressResult, GetRssiResult, GetSsidResult, IsEnabledResult, PermissionStatus, RequestPermissionsOptions } from './definitions';
+export declare class CapacitorWifiWeb extends WebPlugin implements CapacitorWifiPlugin {
+    addNetwork(_options: AddNetworkOptions): Promise<void>;
+    connect(_options: ConnectOptions): Promise<void>;
+    disconnect(_options?: DisconnectOptions): Promise<void>;
+    getAvailableNetworks(): Promise<GetAvailableNetworksResult>;
+    getIpAddress(): Promise<GetIpAddressResult>;
+    getRssi(): Promise<GetRssiResult>;
+    getSsid(): Promise<GetSsidResult>;
+    isEnabled(): Promise<IsEnabledResult>;
+    startScan(): Promise<void>;
+    checkPermissions(): Promise<PermissionStatus>;
+    requestPermissions(_options?: RequestPermissionsOptions): Promise<PermissionStatus>;
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
+}

package/dist/esm/web.js

@@ -0,0 +1,40 @@
+import { WebPlugin } from '@capacitor/core';
+export class CapacitorWifiWeb extends WebPlugin {
+    async addNetwork(_options) {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async connect(_options) {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async disconnect(_options) {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getAvailableNetworks() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getIpAddress() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getRssi() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getSsid() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async isEnabled() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async startScan() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async checkPermissions() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async requestPermissions(_options) {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getPluginVersion() {
+        return { version: '1.0.0' };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAgB5C,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,KAAK,CAAC,UAAU,CAAC,QAA2B;QAC1C,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAwB;QACpC,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAA4B;QAC3C,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAoC;QAC3D,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  AddNetworkOptions,\n  CapacitorWifiPlugin,\n  ConnectOptions,\n  DisconnectOptions,\n  GetAvailableNetworksResult,\n  GetIpAddressResult,\n  GetRssiResult,\n  GetSsidResult,\n  IsEnabledResult,\n  PermissionStatus,\n  RequestPermissionsOptions,\n} from './definitions';\n\nexport class CapacitorWifiWeb extends WebPlugin implements CapacitorWifiPlugin {\n  async addNetwork(_options: AddNetworkOptions): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async connect(_options: ConnectOptions): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async disconnect(_options?: DisconnectOptions): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getAvailableNetworks(): Promise<GetAvailableNetworksResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getIpAddress(): Promise<GetIpAddressResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getRssi(): Promise<GetRssiResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getSsid(): Promise<GetSsidResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async isEnabled(): Promise<IsEnabledResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async startScan(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async checkPermissions(): Promise<PermissionStatus> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async requestPermissions(_options?: RequestPermissionsOptions): Promise<PermissionStatus> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: '1.0.0' };\n  }\n}\n"]}