@capgo/capacitor-wifi 8.4.0 → 8.5.0-beta.pr20.12.1

package/dist/docs.json

@@ -71,7 +71,7 @@
           },
           {
             "name": "throws",
-            "text": "Error if connection fails"
+            "text": "CapacitorException with `code` from {@link WifiConnectionErrorCode}"
           },
           {
             "name": "since",
@@ -79,10 +79,10 @@
           },
           {
             "name": "example",
-            "text": "```typescript\nawait CapacitorWifi.connect({\n  ssid: 'MyNetwork',\n  password: 'mypassword',\n  autoRouteTraffic: true // Android only: route app traffic through this network\n});\n```"
+            "text": "```typescript\ntry {\n  await CapacitorWifi.connect({\n    ssid: 'MyNetwork',\n    password: 'mypassword',\n    autoRouteTraffic: true, // Android only\n    timeoutMs: 30000,\n  });\n} catch (error: any) {\n  switch (error.code) {\n    case WifiConnectionErrorCode.WIFI_DISABLED:\n      // Ask the user to enable Wi-Fi\n      break;\n    case WifiConnectionErrorCode.PERMISSION_DENIED:\n      // Request the required permission\n      break;\n    default:\n      // Generic connection error\n      break;\n  }\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.\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.",
+        "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.\n\nResolves only after the device is confirmed associated with the requested SSID.\nOn failure, rejects with a Capacitor error that includes a stable `code`\nfrom {@link WifiConnectionErrorCode}. Prefer `error.code` over parsing `error.message`.\nSpecific codes are returned only when the native OS provides that reason;\notherwise the plugin returns `CONNECTION_FAILED`.",
         "complexTypes": [
           "ConnectOptions"
         ],
@@ -714,6 +714,22 @@
           "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"
+        },
+        {
+          "name": "timeoutMs",
+          "tags": [
+            {
+              "text": "8.5.0",
+              "name": "since"
+            },
+            {
+              "text": "30000",
+              "name": "default"
+            }
+          ],
+          "docs": "Maximum time in milliseconds to wait for confirmation that the device is associated\nwith the requested SSID before rejecting with `CONNECTION_TIMEOUT`.\nMust be a positive number when provided.",
+          "complexTypes": [],
+          "type": "number | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -32,17 +32,38 @@ export interface CapacitorWifiPlugin {
      * For a persistent connection on Android, use addNetwork() instead.
      * On iOS, this creates a persistent connection.
      *
+     * Resolves only after the device is confirmed associated with the requested SSID.
+     * On failure, rejects with a Capacitor error that includes a stable `code`
+     * from {@link WifiConnectionErrorCode}. Prefer `error.code` over parsing `error.message`.
+     * Specific codes are returned only when the native OS provides that reason;
+     * otherwise the plugin returns `CONNECTION_FAILED`.
+     *
      * @param options - Connection options
      * @returns Promise that resolves when connected
-     * @throws Error if connection fails
+     * @throws CapacitorException with `code` from {@link WifiConnectionErrorCode}
      * @since 7.0.0
      * @example
      * ```typescript
-     * await CapacitorWifi.connect({
-     *   ssid: 'MyNetwork',
-     *   password: 'mypassword',
-     *   autoRouteTraffic: true // Android only: route app traffic through this network
-     * });
+     * try {
+     *   await CapacitorWifi.connect({
+     *     ssid: 'MyNetwork',
+     *     password: 'mypassword',
+     *     autoRouteTraffic: true, // Android only
+     *     timeoutMs: 30000,
+     *   });
+     * } catch (error: any) {
+     *   switch (error.code) {
+     *     case WifiConnectionErrorCode.WIFI_DISABLED:
+     *       // Ask the user to enable Wi-Fi
+     *       break;
+     *     case WifiConnectionErrorCode.PERMISSION_DENIED:
+     *       // Request the required permission
+     *       break;
+     *     default:
+     *       // Generic connection error
+     *       break;
+     *   }
+     * }
      * ```
      */
     connect(options: ConnectOptions): Promise<void>;
@@ -368,6 +389,125 @@ export interface ConnectOptions {
      * @default false
      */
     autoRouteTraffic?: boolean;
+    /**
+     * Maximum time in milliseconds to wait for confirmation that the device is associated
+     * with the requested SSID before rejecting with `CONNECTION_TIMEOUT`.
+     * Must be a positive number when provided.
+     *
+     * @since 8.5.0
+     * @default 30000
+     */
+    timeoutMs?: number;
+}
+/**
+ * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.
+ * Specific codes are returned only when the native platform explicitly provides that reason.
+ * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.
+ *
+ * @since 8.5.0
+ */
+export declare enum WifiConnectionErrorCode {
+    /**
+     * The SSID, password format, security configuration, timeout, or native request parameters are invalid.
+     *
+     * @since 8.5.0
+     */
+    INVALID_CONFIGURATION = "INVALID_CONFIGURATION",
+    /**
+     * A required permission or authorization is missing or was denied.
+     *
+     * @since 8.5.0
+     */
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    /**
+     * Wi-Fi is disabled and the connection cannot be started.
+     *
+     * @since 8.5.0
+     */
+    WIFI_DISABLED = "WIFI_DISABLED",
+    /**
+     * The native API explicitly reports that the user rejected the connection request.
+     * Available on iOS; on Android only when the OS reports user rejection (API 36+).
+     *
+     * @since 8.5.0
+     */
+    USER_DENIED = "USER_DENIED",
+    /**
+     * The native API explicitly reports an authentication failure.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    AUTHENTICATION_FAILED = "AUTHENTICATION_FAILED",
+    /**
+     * The native API explicitly reports that the requested access point was not found.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    NETWORK_NOT_FOUND = "NETWORK_NOT_FOUND",
+    /**
+     * The plugin timeout expired before the requested network was confirmed as connected.
+     *
+     * @since 8.5.0
+     */
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    /**
+     * The connection failed, but the platform did not provide a reliable detailed reason.
+     *
+     * @since 8.5.0
+     */
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    /**
+     * Another Wi-Fi connection attempt is already active.
+     *
+     * @since 8.5.0
+     */
+    CONNECTION_IN_PROGRESS = "CONNECTION_IN_PROGRESS",
+    /**
+     * An unexpected plugin or native error occurred.
+     *
+     * @since 8.5.0
+     */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Optional platform-specific diagnostics attached to a rejected `connect()` call.
+ * Applications should depend only on the stable plugin `code`.
+ *
+ * @since 8.5.0
+ */
+export interface WifiConnectionErrorData {
+    /**
+     * Platform that produced the error
+     *
+     * @since 8.5.0
+     */
+    platform: 'android' | 'ios';
+    /**
+     * Native error or reason code when available
+     *
+     * @since 8.5.0
+     */
+    nativeCode?: number | string;
+    /**
+     * Native error message when available (may be localized; do not parse for logic)
+     *
+     * @since 8.5.0
+     */
+    nativeMessage?: string;
+    /**
+     * Android API level of the device
+     *
+     * @since 8.5.0
+     */
+    androidApiLevel?: number;
+    /**
+     * Stage of the connection flow where the failure occurred
+     *
+     * @since 8.5.0
+     */
+    connectionStage?: 'validation' | 'permission' | 'request' | 'association' | 'authentication' | 'ipProvisioning' | 'verification';
 }
 /**
  * Options for disconnecting from a network

package/dist/esm/definitions.js

@@ -1,3 +1,76 @@
+/**
+ * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.
+ * Specific codes are returned only when the native platform explicitly provides that reason.
+ * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.
+ *
+ * @since 8.5.0
+ */
+export var WifiConnectionErrorCode;
+(function (WifiConnectionErrorCode) {
+    /**
+     * The SSID, password format, security configuration, timeout, or native request parameters are invalid.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["INVALID_CONFIGURATION"] = "INVALID_CONFIGURATION";
+    /**
+     * A required permission or authorization is missing or was denied.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /**
+     * Wi-Fi is disabled and the connection cannot be started.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["WIFI_DISABLED"] = "WIFI_DISABLED";
+    /**
+     * The native API explicitly reports that the user rejected the connection request.
+     * Available on iOS; on Android only when the OS reports user rejection (API 36+).
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["USER_DENIED"] = "USER_DENIED";
+    /**
+     * The native API explicitly reports an authentication failure.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+    /**
+     * The native API explicitly reports that the requested access point was not found.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["NETWORK_NOT_FOUND"] = "NETWORK_NOT_FOUND";
+    /**
+     * The plugin timeout expired before the requested network was confirmed as connected.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+    /**
+     * The connection failed, but the platform did not provide a reliable detailed reason.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    /**
+     * Another Wi-Fi connection attempt is already active.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_IN_PROGRESS"] = "CONNECTION_IN_PROGRESS";
+    /**
+     * An unexpected plugin or native error occurred.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["UNKNOWN"] = "UNKNOWN";
+})(WifiConnectionErrorCode || (WifiConnectionErrorCode = {}));
 /**
  * Network security types
  *

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAolBA;;;;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   * Get comprehensive information about the currently connected WiFi network.\n   * This method provides detailed network information including SSID, BSSID, IP address,\n   * frequency, link speed, and signal strength in a single call.\n   * On iOS, some fields may not be available and will be undefined.\n   *\n   * @returns Promise that resolves with the WiFi information\n   * @throws Error if getting WiFi info fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const info = await CapacitorWifi.getWifiInfo();\n   * console.log('Network:', info.ssid);\n   * console.log('BSSID:', info.bssid);\n   * console.log('IP:', info.ip);\n   * console.log('Frequency:', info.frequency, 'MHz');\n   * console.log('Speed:', info.linkSpeed, 'Mbps');\n   * console.log('Signal:', info.signalStrength);\n   * ```\n   */\n  getWifiInfo(): Promise<WifiInfo>;\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   * Check whether a network with the given SSID has already been saved/configured by this app.\n   * On Android SDK 30+, this checks the app's Wi-Fi network suggestions.\n   * On older Android (including SDK 29), this checks the system's configured networks list.\n   * On iOS, this checks the hotspot configurations managed by this app.\n   * Use this to decide whether to call addNetwork() (first time) or connect() (already saved).\n   *\n   * @param options - Options containing the SSID to check\n   * @returns Promise that resolves with whether the network is saved\n   * @throws Error if the check fails\n   * @since 8.2.0\n   * @example\n   * ```typescript\n   * const { isSaved } = await CapacitorWifi.isNetworkSaved({ ssid: 'MyNetwork' });\n   * if (isSaved) {\n   *   await CapacitorWifi.connect({ ssid: 'MyNetwork', password: 'mypassword' });\n   * } else {\n   *   await CapacitorWifi.addNetwork({ ssid: 'MyNetwork', password: 'mypassword' });\n   * }\n   * ```\n   */\n  isNetworkSaved(options: IsNetworkSavedOptions): Promise<IsNetworkSavedResult>;\n\n  /**\n   * Share Wi-Fi network credentials using platform-native sharing flows.\n   *\n   * On Android 10+, this uses Wi-Fi Easy Connect (DPP). When `dppUri` is provided, the system\n   * provisions credentials to the target device. Otherwise, it opens the system UI to share the\n   * current or specified network (optionally via QR code when `ssid` and `password` are provided).\n   *\n   * On iOS 26.2+, this uses the Wi-Fi Infrastructure framework with a paired AccessorySetupKit\n   * accessory. The host app must pair the accessory first and pass its `bluetoothIdentifier` or\n   * `accessoryIdentifier`. The app also needs the `com.apple.developer.wifi-infrastructure` entitlement.\n   *\n   * @param options - Sharing options\n   * @returns Promise that resolves when the sharing flow starts or completes\n   * @throws Error if sharing is unavailable or fails\n   * @since 8.4.0\n   * @example\n   * ```typescript\n   * // Android: provision credentials to an IoT device via DPP URI\n   * await CapacitorWifi.shareNetwork({ dppUri: 'DPP:...' });\n   *\n   * // Android: show system UI to share the current network\n   * await CapacitorWifi.shareNetwork();\n   *\n   * // iOS: share with a paired Bluetooth accessory\n   * await CapacitorWifi.shareNetwork({\n   *   bluetoothIdentifier: accessory.bluetoothIdentifier,\n   *   requestAuthorization: true,\n   *   askToShare: true,\n   * });\n   * ```\n   */\n  shareNetwork(options?: ShareNetworkOptions): Promise<ShareNetworkResult>;\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 * Comprehensive WiFi information\n *\n * @since 7.0.0\n */\nexport interface WifiInfo {\n  /**\n   * The SSID (network name) of the current network\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n\n  /**\n   * The BSSID (MAC address) of the access point.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  bssid?: string;\n\n  /**\n   * The device's IP address on the network\n   *\n   * @since 7.0.0\n   */\n  ip: string;\n\n  /**\n   * The network frequency in MHz.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  frequency?: number;\n\n  /**\n   * The connection speed in Mbps.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  linkSpeed?: number;\n\n  /**\n   * The signal strength (0-100).\n   * Calculated from RSSI on Android.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  signalStrength?: number;\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\n/**\n * Options for checking whether a network is saved\n *\n * @since 8.2.0\n */\nexport interface IsNetworkSavedOptions {\n  /**\n   * The SSID of the network to check\n   *\n   * @since 8.2.0\n   */\n  ssid: string;\n}\n\n/**\n * Result from isNetworkSaved()\n *\n * @since 8.2.0\n */\nexport interface IsNetworkSavedResult {\n  /**\n   * Whether the network has already been saved/configured by this app\n   *\n   * @since 8.2.0\n   */\n  isSaved: boolean;\n}\n\n/**\n * Options for sharing Wi-Fi network credentials\n *\n * @since 8.4.0\n */\nexport interface ShareNetworkOptions {\n  /**\n   * Android: Wi-Fi Easy Connect (DPP) URI from the target device.\n   * When provided, launches the system UI to provision Wi-Fi credentials to that device.\n   *\n   * @since 8.4.0\n   */\n  dppUri?: string;\n\n  /**\n   * Network SSID to share via QR code on Android.\n   * When omitted, the system uses the currently connected network when possible.\n   *\n   * @since 8.4.0\n   */\n  ssid?: string;\n\n  /**\n   * Network password for QR code sharing on Android.\n   * Required when sharing a specific WPA/WPA2/WPA3 network via QR code.\n   * iOS does not allow reading saved Wi-Fi passwords from the system.\n   *\n   * @since 8.4.0\n   */\n  password?: string;\n\n  /**\n   * iOS 26.2+: Bluetooth identifier of a paired AccessorySetupKit accessory.\n   * Required for Wi-Fi Infrastructure network sharing on iOS unless `accessoryIdentifier` is set.\n   *\n   * @since 8.4.0\n   */\n  bluetoothIdentifier?: string;\n\n  /**\n   * iOS 26.2+: Accessory UUID from AccessorySetupKit.\n   * Alternative lookup key when `bluetoothIdentifier` is unavailable.\n   *\n   * @since 8.4.0\n   */\n  accessoryIdentifier?: string;\n\n  /**\n   * iOS 26.2+: Request initial Wi-Fi network sharing authorization for the accessory.\n   *\n   * @since 8.4.0\n   * @default false\n   */\n  requestAuthorization?: boolean;\n\n  /**\n   * iOS 26.2+: Prompt the user to share the current Wi-Fi network with the accessory.\n   *\n   * @since 8.4.0\n   * @default true\n   */\n  askToShare?: boolean;\n}\n\n/**\n * Authorization state returned by iOS Wi-Fi Infrastructure sharing\n *\n * @since 8.4.0\n */\nexport type WifiSharingAuthorizationState = 'authorized' | 'denied' | 'notDetermined' | 'unsupported';\n\n/**\n * Result state returned by iOS Wi-Fi Infrastructure askToShare()\n *\n * @since 8.4.0\n */\nexport type WifiSharingAskState = 'shared' | 'declined' | 'cancelled' | 'notNeeded' | 'unsupported';\n\n/**\n * Result from shareNetwork()\n *\n * @since 8.4.0\n */\nexport interface ShareNetworkResult {\n  /**\n   * Whether the platform sharing flow was started or completed.\n   *\n   * @since 8.4.0\n   */\n  started: boolean;\n\n  /**\n   * iOS: Authorization state after `requestAuthorization`, when requested.\n   *\n   * @since 8.4.0\n   */\n  authorizationState?: WifiSharingAuthorizationState;\n\n  /**\n   * iOS: Result of `askToShare` when requested.\n   *\n   * @since 8.4.0\n   */\n  askToShareState?: WifiSharingAskState;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA0aA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,uBAyEX;AAzED,WAAY,uBAAuB;IACjC;;;;OAIG;IACH,0EAA+C,CAAA;IAE/C;;;;OAIG;IACH,kEAAuC,CAAA;IAEvC;;;;OAIG;IACH,0DAA+B,CAAA;IAE/B;;;;;OAKG;IACH,sDAA2B,CAAA;IAE3B;;;;;OAKG;IACH,0EAA+C,CAAA;IAE/C;;;;;OAKG;IACH,kEAAuC,CAAA;IAEvC;;;;OAIG;IACH,oEAAyC,CAAA;IAEzC;;;;OAIG;IACH,kEAAuC,CAAA;IAEvC;;;;OAIG;IACH,4EAAiD,CAAA;IAEjD;;;;OAIG;IACH,8CAAmB,CAAA;AACrB,CAAC,EAzEW,uBAAuB,KAAvB,uBAAuB,QAyElC;AA6PD;;;;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   * Resolves only after the device is confirmed associated with the requested SSID.\n   * On failure, rejects with a Capacitor error that includes a stable `code`\n   * from {@link WifiConnectionErrorCode}. Prefer `error.code` over parsing `error.message`.\n   * Specific codes are returned only when the native OS provides that reason;\n   * otherwise the plugin returns `CONNECTION_FAILED`.\n   *\n   * @param options - Connection options\n   * @returns Promise that resolves when connected\n   * @throws CapacitorException with `code` from {@link WifiConnectionErrorCode}\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * try {\n   *   await CapacitorWifi.connect({\n   *     ssid: 'MyNetwork',\n   *     password: 'mypassword',\n   *     autoRouteTraffic: true, // Android only\n   *     timeoutMs: 30000,\n   *   });\n   * } catch (error: any) {\n   *   switch (error.code) {\n   *     case WifiConnectionErrorCode.WIFI_DISABLED:\n   *       // Ask the user to enable Wi-Fi\n   *       break;\n   *     case WifiConnectionErrorCode.PERMISSION_DENIED:\n   *       // Request the required permission\n   *       break;\n   *     default:\n   *       // Generic connection error\n   *       break;\n   *   }\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   * Get comprehensive information about the currently connected WiFi network.\n   * This method provides detailed network information including SSID, BSSID, IP address,\n   * frequency, link speed, and signal strength in a single call.\n   * On iOS, some fields may not be available and will be undefined.\n   *\n   * @returns Promise that resolves with the WiFi information\n   * @throws Error if getting WiFi info fails\n   * @since 7.0.0\n   * @example\n   * ```typescript\n   * const info = await CapacitorWifi.getWifiInfo();\n   * console.log('Network:', info.ssid);\n   * console.log('BSSID:', info.bssid);\n   * console.log('IP:', info.ip);\n   * console.log('Frequency:', info.frequency, 'MHz');\n   * console.log('Speed:', info.linkSpeed, 'Mbps');\n   * console.log('Signal:', info.signalStrength);\n   * ```\n   */\n  getWifiInfo(): Promise<WifiInfo>;\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   * Check whether a network with the given SSID has already been saved/configured by this app.\n   * On Android SDK 30+, this checks the app's Wi-Fi network suggestions.\n   * On older Android (including SDK 29), this checks the system's configured networks list.\n   * On iOS, this checks the hotspot configurations managed by this app.\n   * Use this to decide whether to call addNetwork() (first time) or connect() (already saved).\n   *\n   * @param options - Options containing the SSID to check\n   * @returns Promise that resolves with whether the network is saved\n   * @throws Error if the check fails\n   * @since 8.2.0\n   * @example\n   * ```typescript\n   * const { isSaved } = await CapacitorWifi.isNetworkSaved({ ssid: 'MyNetwork' });\n   * if (isSaved) {\n   *   await CapacitorWifi.connect({ ssid: 'MyNetwork', password: 'mypassword' });\n   * } else {\n   *   await CapacitorWifi.addNetwork({ ssid: 'MyNetwork', password: 'mypassword' });\n   * }\n   * ```\n   */\n  isNetworkSaved(options: IsNetworkSavedOptions): Promise<IsNetworkSavedResult>;\n\n  /**\n   * Share Wi-Fi network credentials using platform-native sharing flows.\n   *\n   * On Android 10+, this uses Wi-Fi Easy Connect (DPP). When `dppUri` is provided, the system\n   * provisions credentials to the target device. Otherwise, it opens the system UI to share the\n   * current or specified network (optionally via QR code when `ssid` and `password` are provided).\n   *\n   * On iOS 26.2+, this uses the Wi-Fi Infrastructure framework with a paired AccessorySetupKit\n   * accessory. The host app must pair the accessory first and pass its `bluetoothIdentifier` or\n   * `accessoryIdentifier`. The app also needs the `com.apple.developer.wifi-infrastructure` entitlement.\n   *\n   * @param options - Sharing options\n   * @returns Promise that resolves when the sharing flow starts or completes\n   * @throws Error if sharing is unavailable or fails\n   * @since 8.4.0\n   * @example\n   * ```typescript\n   * // Android: provision credentials to an IoT device via DPP URI\n   * await CapacitorWifi.shareNetwork({ dppUri: 'DPP:...' });\n   *\n   * // Android: show system UI to share the current network\n   * await CapacitorWifi.shareNetwork();\n   *\n   * // iOS: share with a paired Bluetooth accessory\n   * await CapacitorWifi.shareNetwork({\n   *   bluetoothIdentifier: accessory.bluetoothIdentifier,\n   *   requestAuthorization: true,\n   *   askToShare: true,\n   * });\n   * ```\n   */\n  shareNetwork(options?: ShareNetworkOptions): Promise<ShareNetworkResult>;\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   * Maximum time in milliseconds to wait for confirmation that the device is associated\n   * with the requested SSID before rejecting with `CONNECTION_TIMEOUT`.\n   * Must be a positive number when provided.\n   *\n   * @since 8.5.0\n   * @default 30000\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.\n * Specific codes are returned only when the native platform explicitly provides that reason.\n * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.\n *\n * @since 8.5.0\n */\nexport enum WifiConnectionErrorCode {\n  /**\n   * The SSID, password format, security configuration, timeout, or native request parameters are invalid.\n   *\n   * @since 8.5.0\n   */\n  INVALID_CONFIGURATION = 'INVALID_CONFIGURATION',\n\n  /**\n   * A required permission or authorization is missing or was denied.\n   *\n   * @since 8.5.0\n   */\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n\n  /**\n   * Wi-Fi is disabled and the connection cannot be started.\n   *\n   * @since 8.5.0\n   */\n  WIFI_DISABLED = 'WIFI_DISABLED',\n\n  /**\n   * The native API explicitly reports that the user rejected the connection request.\n   * Available on iOS; on Android only when the OS reports user rejection (API 36+).\n   *\n   * @since 8.5.0\n   */\n  USER_DENIED = 'USER_DENIED',\n\n  /**\n   * The native API explicitly reports an authentication failure.\n   * Not reliably available on Android API 29–33.\n   *\n   * @since 8.5.0\n   */\n  AUTHENTICATION_FAILED = 'AUTHENTICATION_FAILED',\n\n  /**\n   * The native API explicitly reports that the requested access point was not found.\n   * Not reliably available on Android API 29–33.\n   *\n   * @since 8.5.0\n   */\n  NETWORK_NOT_FOUND = 'NETWORK_NOT_FOUND',\n\n  /**\n   * The plugin timeout expired before the requested network was confirmed as connected.\n   *\n   * @since 8.5.0\n   */\n  CONNECTION_TIMEOUT = 'CONNECTION_TIMEOUT',\n\n  /**\n   * The connection failed, but the platform did not provide a reliable detailed reason.\n   *\n   * @since 8.5.0\n   */\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n\n  /**\n   * Another Wi-Fi connection attempt is already active.\n   *\n   * @since 8.5.0\n   */\n  CONNECTION_IN_PROGRESS = 'CONNECTION_IN_PROGRESS',\n\n  /**\n   * An unexpected plugin or native error occurred.\n   *\n   * @since 8.5.0\n   */\n  UNKNOWN = 'UNKNOWN',\n}\n\n/**\n * Optional platform-specific diagnostics attached to a rejected `connect()` call.\n * Applications should depend only on the stable plugin `code`.\n *\n * @since 8.5.0\n */\nexport interface WifiConnectionErrorData {\n  /**\n   * Platform that produced the error\n   *\n   * @since 8.5.0\n   */\n  platform: 'android' | 'ios';\n\n  /**\n   * Native error or reason code when available\n   *\n   * @since 8.5.0\n   */\n  nativeCode?: number | string;\n\n  /**\n   * Native error message when available (may be localized; do not parse for logic)\n   *\n   * @since 8.5.0\n   */\n  nativeMessage?: string;\n\n  /**\n   * Android API level of the device\n   *\n   * @since 8.5.0\n   */\n  androidApiLevel?: number;\n\n  /**\n   * Stage of the connection flow where the failure occurred\n   *\n   * @since 8.5.0\n   */\n  connectionStage?:\n    | 'validation'\n    | 'permission'\n    | 'request'\n    | 'association'\n    | 'authentication'\n    | 'ipProvisioning'\n    | 'verification';\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 * Comprehensive WiFi information\n *\n * @since 7.0.0\n */\nexport interface WifiInfo {\n  /**\n   * The SSID (network name) of the current network\n   *\n   * @since 7.0.0\n   */\n  ssid: string;\n\n  /**\n   * The BSSID (MAC address) of the access point.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  bssid?: string;\n\n  /**\n   * The device's IP address on the network\n   *\n   * @since 7.0.0\n   */\n  ip: string;\n\n  /**\n   * The network frequency in MHz.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  frequency?: number;\n\n  /**\n   * The connection speed in Mbps.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  linkSpeed?: number;\n\n  /**\n   * The signal strength (0-100).\n   * Calculated from RSSI on Android.\n   * Not available on iOS.\n   *\n   * @since 7.0.0\n   */\n  signalStrength?: number;\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\n/**\n * Options for checking whether a network is saved\n *\n * @since 8.2.0\n */\nexport interface IsNetworkSavedOptions {\n  /**\n   * The SSID of the network to check\n   *\n   * @since 8.2.0\n   */\n  ssid: string;\n}\n\n/**\n * Result from isNetworkSaved()\n *\n * @since 8.2.0\n */\nexport interface IsNetworkSavedResult {\n  /**\n   * Whether the network has already been saved/configured by this app\n   *\n   * @since 8.2.0\n   */\n  isSaved: boolean;\n}\n\n/**\n * Options for sharing Wi-Fi network credentials\n *\n * @since 8.4.0\n */\nexport interface ShareNetworkOptions {\n  /**\n   * Android: Wi-Fi Easy Connect (DPP) URI from the target device.\n   * When provided, launches the system UI to provision Wi-Fi credentials to that device.\n   *\n   * @since 8.4.0\n   */\n  dppUri?: string;\n\n  /**\n   * Network SSID to share via QR code on Android.\n   * When omitted, the system uses the currently connected network when possible.\n   *\n   * @since 8.4.0\n   */\n  ssid?: string;\n\n  /**\n   * Network password for QR code sharing on Android.\n   * Required when sharing a specific WPA/WPA2/WPA3 network via QR code.\n   * iOS does not allow reading saved Wi-Fi passwords from the system.\n   *\n   * @since 8.4.0\n   */\n  password?: string;\n\n  /**\n   * iOS 26.2+: Bluetooth identifier of a paired AccessorySetupKit accessory.\n   * Required for Wi-Fi Infrastructure network sharing on iOS unless `accessoryIdentifier` is set.\n   *\n   * @since 8.4.0\n   */\n  bluetoothIdentifier?: string;\n\n  /**\n   * iOS 26.2+: Accessory UUID from AccessorySetupKit.\n   * Alternative lookup key when `bluetoothIdentifier` is unavailable.\n   *\n   * @since 8.4.0\n   */\n  accessoryIdentifier?: string;\n\n  /**\n   * iOS 26.2+: Request initial Wi-Fi network sharing authorization for the accessory.\n   *\n   * @since 8.4.0\n   * @default false\n   */\n  requestAuthorization?: boolean;\n\n  /**\n   * iOS 26.2+: Prompt the user to share the current Wi-Fi network with the accessory.\n   *\n   * @since 8.4.0\n   * @default true\n   */\n  askToShare?: boolean;\n}\n\n/**\n * Authorization state returned by iOS Wi-Fi Infrastructure sharing\n *\n * @since 8.4.0\n */\nexport type WifiSharingAuthorizationState = 'authorized' | 'denied' | 'notDetermined' | 'unsupported';\n\n/**\n * Result state returned by iOS Wi-Fi Infrastructure askToShare()\n *\n * @since 8.4.0\n */\nexport type WifiSharingAskState = 'shared' | 'declined' | 'cancelled' | 'notNeeded' | 'unsupported';\n\n/**\n * Result from shareNetwork()\n *\n * @since 8.4.0\n */\nexport interface ShareNetworkResult {\n  /**\n   * Whether the platform sharing flow was started or completed.\n   *\n   * @since 8.4.0\n   */\n  started: boolean;\n\n  /**\n   * iOS: Authorization state after `requestAuthorization`, when requested.\n   *\n   * @since 8.4.0\n   */\n  authorizationState?: WifiSharingAuthorizationState;\n\n  /**\n   * iOS: Result of `askToShare` when requested.\n   *\n   * @since 8.4.0\n   */\n  askToShareState?: WifiSharingAskState;\n}\n"]}

package/dist/plugin.cjs.js

@@ -2,6 +2,79 @@
 
 var core = require('@capacitor/core');
 
+/**
+ * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.
+ * Specific codes are returned only when the native platform explicitly provides that reason.
+ * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.
+ *
+ * @since 8.5.0
+ */
+exports.WifiConnectionErrorCode = void 0;
+(function (WifiConnectionErrorCode) {
+    /**
+     * The SSID, password format, security configuration, timeout, or native request parameters are invalid.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["INVALID_CONFIGURATION"] = "INVALID_CONFIGURATION";
+    /**
+     * A required permission or authorization is missing or was denied.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /**
+     * Wi-Fi is disabled and the connection cannot be started.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["WIFI_DISABLED"] = "WIFI_DISABLED";
+    /**
+     * The native API explicitly reports that the user rejected the connection request.
+     * Available on iOS; on Android only when the OS reports user rejection (API 36+).
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["USER_DENIED"] = "USER_DENIED";
+    /**
+     * The native API explicitly reports an authentication failure.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+    /**
+     * The native API explicitly reports that the requested access point was not found.
+     * Not reliably available on Android API 29–33.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["NETWORK_NOT_FOUND"] = "NETWORK_NOT_FOUND";
+    /**
+     * The plugin timeout expired before the requested network was confirmed as connected.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+    /**
+     * The connection failed, but the platform did not provide a reliable detailed reason.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    /**
+     * Another Wi-Fi connection attempt is already active.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["CONNECTION_IN_PROGRESS"] = "CONNECTION_IN_PROGRESS";
+    /**
+     * An unexpected plugin or native error occurred.
+     *
+     * @since 8.5.0
+     */
+    WifiConnectionErrorCode["UNKNOWN"] = "UNKNOWN";
+})(exports.WifiConnectionErrorCode || (exports.WifiConnectionErrorCode = {}));
 /**
  * Network security types
  *

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Network security types\n *\n * @since 7.0.0\n */\nexport var NetworkSecurityType;\n(function (NetworkSecurityType) {\n    /**\n     * Open network with no security\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"OPEN\"] = 0] = \"OPEN\";\n    /**\n     * WEP security\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WEP\"] = 1] = \"WEP\";\n    /**\n     * WPA/WPA2 Personal (PSK)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA2_PSK\"] = 2] = \"WPA2_PSK\";\n    /**\n     * WPA/WPA2/WPA3 Enterprise (EAP)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"EAP\"] = 3] = \"EAP\";\n    /**\n     * WPA3 Personal (SAE)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"SAE\"] = 4] = \"SAE\";\n    /**\n     * WPA3 Enterprise\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA3_ENTERPRISE\"] = 5] = \"WPA3_ENTERPRISE\";\n    /**\n     * WPA3 Enterprise 192-bit mode\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA3_ENTERPRISE_192_BIT\"] = 6] = \"WPA3_ENTERPRISE_192_BIT\";\n    /**\n     * Passpoint network\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"PASSPOINT\"] = 7] = \"PASSPOINT\";\n    /**\n     * Enhanced Open (OWE)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"OWE\"] = 8] = \"OWE\";\n    /**\n     * WAPI PSK\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WAPI_PSK\"] = 9] = \"WAPI_PSK\";\n    /**\n     * WAPI Certificate\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WAPI_CERT\"] = 10] = \"WAPI_CERT\";\n})(NetworkSecurityType || (NetworkSecurityType = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst CapacitorWifi = registerPlugin('CapacitorWifi', {\n    web: () => import('./web').then((m) => new m.CapacitorWifiWeb()),\n});\nexport * from './definitions';\nexport { CapacitorWifi };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorWifiWeb extends WebPlugin {\n    async addNetwork(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async connect(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async disconnect(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAvailableNetworks() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getIpAddress() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getRssi() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getSsid() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getWifiInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async isEnabled() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async startScan() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async checkPermissions() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async requestPermissions(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async isNetworkSaved(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async shareNetwork(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getPluginVersion() {\n        return { version: '1.0.0' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["NetworkSecurityType","registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.\n * Specific codes are returned only when the native platform explicitly provides that reason.\n * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.\n *\n * @since 8.5.0\n */\nexport var WifiConnectionErrorCode;\n(function (WifiConnectionErrorCode) {\n    /**\n     * The SSID, password format, security configuration, timeout, or native request parameters are invalid.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"INVALID_CONFIGURATION\"] = \"INVALID_CONFIGURATION\";\n    /**\n     * A required permission or authorization is missing or was denied.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /**\n     * Wi-Fi is disabled and the connection cannot be started.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"WIFI_DISABLED\"] = \"WIFI_DISABLED\";\n    /**\n     * The native API explicitly reports that the user rejected the connection request.\n     * Available on iOS; on Android only when the OS reports user rejection (API 36+).\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"USER_DENIED\"] = \"USER_DENIED\";\n    /**\n     * The native API explicitly reports an authentication failure.\n     * Not reliably available on Android API 29–33.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"AUTHENTICATION_FAILED\"] = \"AUTHENTICATION_FAILED\";\n    /**\n     * The native API explicitly reports that the requested access point was not found.\n     * Not reliably available on Android API 29–33.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"NETWORK_NOT_FOUND\"] = \"NETWORK_NOT_FOUND\";\n    /**\n     * The plugin timeout expired before the requested network was confirmed as connected.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"CONNECTION_TIMEOUT\"] = \"CONNECTION_TIMEOUT\";\n    /**\n     * The connection failed, but the platform did not provide a reliable detailed reason.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"CONNECTION_FAILED\"] = \"CONNECTION_FAILED\";\n    /**\n     * Another Wi-Fi connection attempt is already active.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"CONNECTION_IN_PROGRESS\"] = \"CONNECTION_IN_PROGRESS\";\n    /**\n     * An unexpected plugin or native error occurred.\n     *\n     * @since 8.5.0\n     */\n    WifiConnectionErrorCode[\"UNKNOWN\"] = \"UNKNOWN\";\n})(WifiConnectionErrorCode || (WifiConnectionErrorCode = {}));\n/**\n * Network security types\n *\n * @since 7.0.0\n */\nexport var NetworkSecurityType;\n(function (NetworkSecurityType) {\n    /**\n     * Open network with no security\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"OPEN\"] = 0] = \"OPEN\";\n    /**\n     * WEP security\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WEP\"] = 1] = \"WEP\";\n    /**\n     * WPA/WPA2 Personal (PSK)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA2_PSK\"] = 2] = \"WPA2_PSK\";\n    /**\n     * WPA/WPA2/WPA3 Enterprise (EAP)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"EAP\"] = 3] = \"EAP\";\n    /**\n     * WPA3 Personal (SAE)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"SAE\"] = 4] = \"SAE\";\n    /**\n     * WPA3 Enterprise\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA3_ENTERPRISE\"] = 5] = \"WPA3_ENTERPRISE\";\n    /**\n     * WPA3 Enterprise 192-bit mode\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WPA3_ENTERPRISE_192_BIT\"] = 6] = \"WPA3_ENTERPRISE_192_BIT\";\n    /**\n     * Passpoint network\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"PASSPOINT\"] = 7] = \"PASSPOINT\";\n    /**\n     * Enhanced Open (OWE)\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"OWE\"] = 8] = \"OWE\";\n    /**\n     * WAPI PSK\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WAPI_PSK\"] = 9] = \"WAPI_PSK\";\n    /**\n     * WAPI Certificate\n     *\n     * @since 7.0.0\n     */\n    NetworkSecurityType[NetworkSecurityType[\"WAPI_CERT\"] = 10] = \"WAPI_CERT\";\n})(NetworkSecurityType || (NetworkSecurityType = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst CapacitorWifi = registerPlugin('CapacitorWifi', {\n    web: () => import('./web').then((m) => new m.CapacitorWifiWeb()),\n});\nexport * from './definitions';\nexport { CapacitorWifi };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorWifiWeb extends WebPlugin {\n    async addNetwork(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async connect(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async disconnect(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAvailableNetworks() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getIpAddress() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getRssi() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getSsid() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getWifiInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async isEnabled() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async startScan() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async checkPermissions() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async requestPermissions(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async isNetworkSaved(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async shareNetwork(_options) {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getPluginVersion() {\n        return { version: '1.0.0' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["WifiConnectionErrorCode","NetworkSecurityType","registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -1,6 +1,79 @@
 var capacitorCapgoWifi = (function (exports, core) {
     'use strict';
 
+    /**
+     * Stable error codes returned by {@link CapacitorWifiPlugin.connect} on failure.
+     * Specific codes are returned only when the native platform explicitly provides that reason.
+     * Otherwise the plugin returns {@link WifiConnectionErrorCode.CONNECTION_FAILED}.
+     *
+     * @since 8.5.0
+     */
+    exports.WifiConnectionErrorCode = void 0;
+    (function (WifiConnectionErrorCode) {
+        /**
+         * The SSID, password format, security configuration, timeout, or native request parameters are invalid.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["INVALID_CONFIGURATION"] = "INVALID_CONFIGURATION";
+        /**
+         * A required permission or authorization is missing or was denied.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /**
+         * Wi-Fi is disabled and the connection cannot be started.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["WIFI_DISABLED"] = "WIFI_DISABLED";
+        /**
+         * The native API explicitly reports that the user rejected the connection request.
+         * Available on iOS; on Android only when the OS reports user rejection (API 36+).
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["USER_DENIED"] = "USER_DENIED";
+        /**
+         * The native API explicitly reports an authentication failure.
+         * Not reliably available on Android API 29–33.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+        /**
+         * The native API explicitly reports that the requested access point was not found.
+         * Not reliably available on Android API 29–33.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["NETWORK_NOT_FOUND"] = "NETWORK_NOT_FOUND";
+        /**
+         * The plugin timeout expired before the requested network was confirmed as connected.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+        /**
+         * The connection failed, but the platform did not provide a reliable detailed reason.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+        /**
+         * Another Wi-Fi connection attempt is already active.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["CONNECTION_IN_PROGRESS"] = "CONNECTION_IN_PROGRESS";
+        /**
+         * An unexpected plugin or native error occurred.
+         *
+         * @since 8.5.0
+         */
+        WifiConnectionErrorCode["UNKNOWN"] = "UNKNOWN";
+    })(exports.WifiConnectionErrorCode || (exports.WifiConnectionErrorCode = {}));
     /**
      * Network security types
      *