npm - @capgo/capacitor-wifi - Versions diffs - 8.0.6 → 8.1.2 - Mend

@capgo/capacitor-wifi 8.0.6 → 8.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +7 -5
package/android/src/main/java/ee/forgr/plugin/capacitor_wifi/CapacitorWifiPlugin.java +80 -18
package/dist/docs.json +18 -2
package/dist/esm/definitions.d.ts +12 -1
package/dist/esm/definitions.js.map +1 -1
package/ios/Sources/CapacitorWifiPlugin/CapacitorWifiPlugin.swift +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -92,6 +92,7 @@ connect(options: ConnectOptions) => 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.
+Set autoRouteTraffic to true to bind app traffic to the connected network (useful for local/device-hosted APs).
 For a persistent connection on Android, use addNetwork() instead.
 On iOS, this creates a persistent connection.
@@ -323,11 +324,12 @@ Options for adding a network
 Options for connecting to a network
-| Prop               | Type                 | Description                                               | Default            | Since |
-| ------------------ | -------------------- | --------------------------------------------------------- | ------------------ | ----- |
-| **`ssid`**         | <code>string</code>  | The SSID of the network to connect to                     |                    | 7.0.0 |
-| **`password`**     | <code>string</code>  | The password for the network (optional for open networks) |                    | 7.0.0 |
-| **`isHiddenSsid`** | <code>boolean</code> | Whether the network is hidden (Android only)              | <code>false</code> | 7.0.0 |
+| Prop                   | Type                 | Description                                                                                                                                                                                                                                                                                                                         | Default            | Since |
+| ---------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`ssid`**             | <code>string</code>  | The SSID of the network to connect to                                                                                                                                                                                                                                                                                               |                    | 7.0.0 |
+| **`password`**         | <code>string</code>  | The password for the network (optional for open networks)                                                                                                                                                                                                                                                                           |                    | 7.0.0 |
+| **`isHiddenSsid`**     | <code>boolean</code> | Whether the network is hidden (Android only)                                                                                                                                                                                                                                                                                        | <code>false</code> | 7.0.0 |
+| **`autoRouteTraffic`** | <code>boolean</code> | Whether to automatically route app traffic through the connected Wi-Fi network (Android only) When enabled, it binds the app process to the connected network using ConnectivityManager.bindProcessToNetwork() This is useful for connecting to local/device-hosted APs (e.g., ESP32, IoT devices) that don't have internet access. | <code>false</code> | 7.0.0 |
 #### DisconnectOptions

package/android/src/main/java/ee/forgr/plugin/capacitor_wifi/CapacitorWifiPlugin.java CHANGED Viewed

@@ -44,12 +44,14 @@ import java.util.List;
 )
 public class CapacitorWifiPlugin extends Plugin {
-    private final String pluginVersion = "8.0.6";
+    private final String pluginVersion = "8.1.2";
     private WifiManager wifiManager;
     private ConnectivityManager connectivityManager;
     private BroadcastReceiver scanResultsReceiver;
     private ConnectivityManager.NetworkCallback networkCallback;
+    private Network boundNetwork; // Store the network we bound to for unbinding
+    private final Object boundNetworkLock = new Object(); // Lock for thread-safe access to boundNetwork
     @Override
     public void load() {
@@ -201,6 +203,7 @@ public class CapacitorWifiPlugin extends Plugin {
         String password = call.getString("password");
         Boolean isHiddenSsid = call.getBoolean("isHiddenSsid", false);
+        Boolean autoRouteTraffic = call.getBoolean("autoRouteTraffic", false);
         try {
             WifiNetworkSpecifier.Builder specifierBuilder = new WifiNetworkSpecifier.Builder().setSsid(ssid);
@@ -215,16 +218,44 @@ public class CapacitorWifiPlugin extends Plugin {
             NetworkSpecifier specifier = specifierBuilder.build();
-            NetworkRequest request = new NetworkRequest.Builder()
+            NetworkRequest.Builder requestBuilder = new NetworkRequest.Builder()
                 .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
-                .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
-                .setNetworkSpecifier(specifier)
-                .build();
+                .setNetworkSpecifier(specifier);
+            // Only remove internet capability if autoRouteTraffic is false
+            // If autoRouteTraffic is true, we want Android to consider this network valid for routing
+            if (autoRouteTraffic == null || !autoRouteTraffic) {
+                requestBuilder.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);
+            }
+            NetworkRequest request = requestBuilder.build();
             networkCallback = new ConnectivityManager.NetworkCallback() {
                 @Override
                 public void onAvailable(@NonNull Network network) {
                     super.onAvailable(network);
+                    // Bind process to network if autoRouteTraffic is enabled
+                    if (autoRouteTraffic != null && autoRouteTraffic) {
+                        try {
+                            synchronized (boundNetworkLock) {
+                                // Unbind from previous network if any
+                                if (boundNetwork != null) {
+                                    connectivityManager.bindProcessToNetwork(null);
+                                }
+                                // Bind to the new network
+                                boolean bound = connectivityManager.bindProcessToNetwork(network);
+                                if (bound) {
+                                    boundNetwork = network;
+                                }
+                            }
+                        } catch (Exception e) {
+                            // Log error but don't fail the connection
+                            android.util.Log.e("CapacitorWifi", "Failed to bind process to network: " + e.getMessage());
+                        }
+                    }
                     call.resolve();
                 }
@@ -255,6 +286,7 @@ public class CapacitorWifiPlugin extends Plugin {
         String password = call.getString("password");
         Boolean isHiddenSsid = call.getBoolean("isHiddenSsid", false);
+        Boolean autoRouteTraffic = call.getBoolean("autoRouteTraffic", false);
         try {
             WifiConfiguration wifiConfig = new WifiConfiguration();
@@ -294,6 +326,35 @@ public class CapacitorWifiPlugin extends Plugin {
                 return;
             }
+            // Bind process to network if autoRouteTraffic is enabled
+            if (autoRouteTraffic != null && autoRouteTraffic) {
+                // Use handler to bind asynchronously after connection is established
+                new android.os.Handler(android.os.Looper.getMainLooper()).postDelayed(
+                    () -> {
+                        try {
+                            synchronized (boundNetworkLock) {
+                                // Unbind from previous network if any
+                                if (boundNetwork != null) {
+                                    connectivityManager.bindProcessToNetwork(null);
+                                }
+                                Network activeNetwork = connectivityManager.getActiveNetwork();
+                                if (activeNetwork != null) {
+                                    boolean bound = connectivityManager.bindProcessToNetwork(activeNetwork);
+                                    if (bound) {
+                                        boundNetwork = activeNetwork;
+                                    }
+                                }
+                            }
+                        } catch (Exception e) {
+                            // Log error but don't fail the connection
+                            android.util.Log.e("CapacitorWifi", "Failed to bind process to network: " + e.getMessage());
+                        }
+                    },
+                    500
+                );
+            }
             call.resolve();
         } catch (Exception e) {
             call.reject("Failed to connect: " + e.getMessage(), e);
@@ -303,6 +364,15 @@ public class CapacitorWifiPlugin extends Plugin {
     @PluginMethod
     public void disconnect(PluginCall call) {
         try {
+            // Unbind from network if we were bound
+            synchronized (boundNetworkLock) {
+                if (boundNetwork != null) {
+                    connectivityManager.bindProcessToNetwork(null);
+                    boundNetwork = null;
+                    android.util.Log.d("CapacitorWifi", "Unbound process from network");
+                }
+            }
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                 if (networkCallback != null) {
                     connectivityManager.unregisterNetworkCallback(networkCallback);
@@ -358,19 +428,11 @@ public class CapacitorWifiPlugin extends Plugin {
         try {
             String ipAddress = null;
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-                Network network = connectivityManager.getActiveNetwork();
-                if (network != null) {
-                    NetworkCapabilities capabilities = connectivityManager.getNetworkCapabilities(network);
-                    if (capabilities != null && capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI)) {
-                        ipAddress = getWifiIpAddress();
-                    }
-                }
-            } else {
-                WifiInfo wifiInfo = wifiManager.getConnectionInfo();
-                if (wifiInfo != null) {
-                    int ip = wifiInfo.getIpAddress();
-                    ipAddress = String.format("%d.%d.%d.%d", (ip & 0xff), ((ip >> 8) & 0xff), ((ip >> 16) & 0xff), ((ip >> 24) & 0xff));
+            Network network = connectivityManager.getActiveNetwork();
+            if (network != null) {
+                NetworkCapabilities capabilities = connectivityManager.getNetworkCapabilities(network);
+                if (capabilities != null && capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI)) {
+                    ipAddress = getWifiIpAddress();
                 }
             }

package/dist/docs.json CHANGED Viewed

@@ -79,10 +79,10 @@
           },
           {
             "name": "example",
-            "text": "```typescript\nawait CapacitorWifi.connect({\n  ssid: 'MyNetwork',\n  password: 'mypassword'\n});\n```"
+            "text": "```typescript\nawait CapacitorWifi.connect({\n  ssid: 'MyNetwork',\n  password: 'mypassword',\n  autoRouteTraffic: true // Android only: route app traffic through this network\n});\n```"
           }
         ],
-        "docs": "Connect to a Wi-Fi network.\nOn Android, this creates a temporary connection that doesn't route traffic through the network by default.\nFor a persistent connection on Android, use addNetwork() instead.\nOn iOS, this creates a persistent connection.",
+        "docs": "Connect to a Wi-Fi network.\nOn Android, this creates a temporary connection that doesn't route traffic through the network by default.\nSet autoRouteTraffic to true to bind app traffic to the connected network (useful for local/device-hosted APs).\nFor a persistent connection on Android, use addNetwork() instead.\nOn iOS, this creates a persistent connection.",
         "complexTypes": [
           "ConnectOptions"
         ],
@@ -589,6 +589,22 @@
           "docs": "Whether the network is hidden (Android only)",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "autoRouteTraffic",
+          "tags": [
+            {
+              "text": "7.0.0",
+              "name": "since"
+            },
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "Whether to automatically route app traffic through the connected Wi-Fi network (Android only)\nWhen enabled, it binds the app process to the connected network using ConnectivityManager.bindProcessToNetwork()\nThis is useful for connecting to local/device-hosted APs (e.g., ESP32, IoT devices) that don't have internet access.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts CHANGED Viewed

@@ -28,6 +28,7 @@ export interface CapacitorWifiPlugin {
     /**
      * Connect to a Wi-Fi network.
      * On Android, this creates a temporary connection that doesn't route traffic through the network by default.
+     * Set autoRouteTraffic to true to bind app traffic to the connected network (useful for local/device-hosted APs).
      * For a persistent connection on Android, use addNetwork() instead.
      * On iOS, this creates a persistent connection.
      *
@@ -39,7 +40,8 @@ export interface CapacitorWifiPlugin {
      * ```typescript
      * await CapacitorWifi.connect({
      *   ssid: 'MyNetwork',
-     *   password: 'mypassword'
+     *   password: 'mypassword',
+     *   autoRouteTraffic: true // Android only: route app traffic through this network
      * });
      * ```
      */
@@ -282,6 +284,15 @@ export interface ConnectOptions {
      * @default false
      */
     isHiddenSsid?: boolean;
+    /**
+     * Whether to automatically route app traffic through the connected Wi-Fi network (Android only)
+     * When enabled, it binds the app process to the connected network using ConnectivityManager.bindProcessToNetwork()
+     * This is useful for connecting to local/device-hosted APs (e.g., ESP32, IoT devices) that don't have internet access.
+     *
+     * @since 7.0.0
+     * @default false
+     */
+    autoRouteTraffic?: boolean;
 }
 /**
  * Options for disconnecting from a network

package/dist/esm/definitions.js.map CHANGED Viewed

	@@ -1 +1 @@
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"]}
1	+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAgdA;;;;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 * Set autoRouteTraffic to true to bind app traffic to the connected network (useful for local/device-hosted APs).\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 * autoRouteTraffic: true // Android only: route app traffic through this network\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 Whether to automatically route app traffic through the connected Wi-Fi network (Android only)\n * When enabled, it binds the app process to the connected network using ConnectivityManager.bindProcessToNetwork()\n * This is useful for connecting to local/device-hosted APs (e.g., ESP32, IoT devices) that don't have internet access.\n \n @since 7.0.0\n * @default false\n /\n autoRouteTraffic?: 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/ios/Sources/CapacitorWifiPlugin/CapacitorWifiPlugin.swift CHANGED Viewed

@@ -6,7 +6,7 @@ import CoreLocation
 @objc(CapacitorWifiPlugin)
 public class CapacitorWifiPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.0.6"
+    private let pluginVersion: String = "8.1.2"
     public let identifier = "CapacitorWifiPlugin"
     public let jsName = "CapacitorWifi"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-wifi",
-  "version": "8.0.6",
+  "version": "8.1.2",
   "description": "Manage WiFi connectivity for your Capacitor app",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",