@elizaos/capacitor-wifi 2.0.0-beta.1 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# @elizaos/capacitor-wifi
+
+Android Wi-Fi bridge for elizaOS apps built on Capacitor. Exposes `WifiManager` and `ConnectivityManager` APIs to JavaScript running inside a Capacitor Android shell.
+
+## What this plugin does
+
+This Capacitor plugin gives a Capacitor-hosted elizaOS app access to the Android Wi-Fi stack from JavaScript/TypeScript:
+
+- Read the current Wi-Fi radio state (enabled, connected, signal strength).
+- Retrieve the active connection details (SSID, BSSID, frequency, RSSI).
+- Scan for nearby networks and receive a deduplicated list sorted by signal strength.
+- Connect to a network by SSID (open or WPA2-protected, visible or hidden).
+- Disconnect from the current network.
+
+On web/desktop, all methods resolve safely with empty data and a one-time console warning — the app compiles and runs without errors, but real Wi-Fi operations only work on Android.
+
+## Capabilities
+
+| Method | What it does |
+|--------|-------------|
+| `WiFi.getWifiState()` | Returns `{ enabled, connected, rssi }` for the Wi-Fi radio. |
+| `WiFi.getConnectedNetwork()` | Returns the active `WiFiNetwork` or `null`. |
+| `WiFi.listAvailableNetworks(opts?)` | Triggers (or reuses) a scan and returns a deduplicated `WiFiNetwork[]`. |
+| `WiFi.connectToNetwork({ ssid, password?, hidden? })` | Requests a connection; uses `WifiNetworkSuggestion` on Android 10+ and the legacy `WifiConfiguration` path on Android 6–9. |
+| `WiFi.disconnectFromNetwork()` | Disconnects the active network. |
+
+## Requirements
+
+- Android only. Minimum SDK: 23 (Android 6.0).
+- `@capacitor/core ^8.3.1` as a peer dependency.
+
+### Android permissions
+
+Declared in the plugin's `AndroidManifest.xml`; the host app must request runtime grants where required:
+
+| Permission | Required by |
+|-----------|-------------|
+| `ACCESS_WIFI_STATE` | `getConnectedNetwork`, `listAvailableNetworks` |
+| `CHANGE_WIFI_STATE` | `connectToNetwork`, `disconnectFromNetwork` |
+| `ACCESS_FINE_LOCATION` | `listAvailableNetworks` on Android 8+ (API 26+) — without it the plugin rejects with an error (does NOT silently return an empty list) |
+| `ACCESS_NETWORK_STATE`, `CHANGE_NETWORK_STATE` | `connectToNetwork` on Android 10+ (`WifiNetworkSuggestion` path) |
+
+## Installation
+
+```bash
+npm install @elizaos/capacitor-wifi
+npx cap sync android
+```
+
+Then sync the Capacitor project so Gradle includes the plugin:
+
+```bash
+npx cap sync
+```
+
+## Usage
+
+```typescript
+import { WiFi } from '@elizaos/capacitor-wifi';
+
+// Read radio state
+const state = await WiFi.getWifiState();
+console.log('Wi-Fi enabled:', state.enabled, 'Connected:', state.connected);
+
+// List nearby networks
+const { networks } = await WiFi.listAvailableNetworks({ maxAge: 15000, limit: 20 });
+for (const net of networks) {
+  console.log(net.ssid, net.rssi, 'dBm', net.secured ? '(secured)' : '(open)');
+}
+
+// Connect
+const result = await WiFi.connectToNetwork({ ssid: 'MyNetwork', password: 'secret' });
+if (!result.success) console.error(result.message);
+```
+
+## Notes
+
+- `connectToNetwork` on Android 10+ submits a `WifiNetworkSuggestion`. The call resolving with `success: true` means the suggestion was accepted by the system, not that the device is connected. Poll `getConnectedNetwork()` to observe connection state.
+- Wi-Fi scanning is rate-limited by Android (roughly 4 scans per 2 minutes in the foreground). Use the `maxAge` option to reuse a recent scan and avoid hitting the throttle.
+- The plugin rejects `listAvailableNetworks` with a clear error on API 26+ when `ACCESS_FINE_LOCATION` is not granted, rather than silently returning an empty list.

package/android/build.gradle

@@ -3,6 +3,11 @@ ext {
 }
 
 apply plugin: 'com.android.library'
+// Apply the Kotlin Android plugin so the plugin's .kt class is bundled into the
+// library AAR. Without it AGP's built-in kotlinc compiles the sources but does
+// NOT bundle the .class files, so the Capacitor plugin class is absent from the
+// app dex at runtime (PluginLoadException -> the whole plugin set fails to load).
+apply plugin: 'org.jetbrains.kotlin.android'
 android {
     namespace = "ai.eliza.plugins.wifi"
     compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
@@ -14,6 +19,9 @@ android {
         sourceCompatibility JavaVersion.VERSION_17
         targetCompatibility JavaVersion.VERSION_17
     }
+    kotlinOptions {
+        jvmTarget = "17"
+    }
 }
 
 repositories {

package/android/src/main/java/ai/eliza/plugins/wifi/WiFiPlugin.kt

@@ -296,6 +296,6 @@ class WiFiPlugin : Plugin() {
             upper.contains("SAE")
     }
 
-    /** No-op callback for the `requestNetwork` call — connection state is queried separately. */
+    /** Empty callback for the `requestNetwork` call — connection state is queried separately. */
     private object NoOpNetworkCallback : ConnectivityManager.NetworkCallback()
 }

package/dist/esm/definitions.d.ts

@@ -68,7 +68,7 @@ export interface ConnectResult {
     /** Optional human-readable message, populated on failure. */
     message?: string;
 }
-/** Public Capacitor plugin contract — implemented natively on Android, stubbed on web. */
+/** Public Capacitor plugin contract — implemented natively on Android with an empty-data web fallback. */
 export interface WiFiPlugin {
     /** Read radio + active connection state. */
     getWifiState(): Promise<WifiStateResult>;

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACzC,sCAAsC;IACtC,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvD,yEAAyE;IACzE,qBAAqB,CACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,8DAA8D;IAC9D,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAClE,kDAAkD;IAClD,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0GAA0G;AAC1G,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACzC,sCAAsC;IACtC,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvD,yEAAyE;IACzE,qBAAqB,CACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,8DAA8D;IAC9D,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAClE,kDAAkD;IAClD,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD"}

package/dist/esm/web.d.ts

@@ -10,8 +10,8 @@ import type { ConnectedNetworkResult, ConnectOptions, ConnectResult, ListNetwork
 export declare class WiFiWeb extends WebPlugin implements WiFiPlugin {
     getWifiState(): Promise<WifiStateResult>;
     getConnectedNetwork(): Promise<ConnectedNetworkResult>;
-    listAvailableNetworks(_options?: ListNetworksOptions): Promise<ListNetworksResult>;
-    connectToNetwork(_options: ConnectOptions): Promise<ConnectResult>;
+    listAvailableNetworks(options?: ListNetworksOptions): Promise<ListNetworksResult>;
+    connectToNetwork(options: ConnectOptions): Promise<ConnectResult>;
     disconnectFromNetwork(): Promise<ConnectResult>;
 }
 //# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,eAAe,EAChB,MAAM,eAAe,CAAC;AAWvB;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,SAAU,YAAW,UAAU;IACpD,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAKxC,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAKtD,qBAAqB,CACzB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAKxB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAKlE,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC;CAItD"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,eAAe,EAChB,MAAM,eAAe,CAAC;AAmDvB;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,SAAU,YAAW,UAAU;IACpD,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAKxC,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAKtD,qBAAqB,CACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAMxB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjE,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC;CAItD"}

package/dist/esm/web.js

@@ -7,6 +7,40 @@ function warnOnce() {
     warned = true;
     console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function normalizeListOptions(options) {
+    if (options === undefined)
+        return;
+    if (!isRecord(options)) {
+        throw new Error("options must be an object");
+    }
+    if (options?.maxAge !== undefined) {
+        if (typeof options.maxAge !== "number" ||
+            !Number.isFinite(options.maxAge) ||
+            options.maxAge < 0) {
+            throw new Error("maxAge must be a non-negative finite number");
+        }
+    }
+    if (options?.limit !== undefined) {
+        if (typeof options.limit !== "number" ||
+            !Number.isFinite(options.limit) ||
+            !Number.isInteger(options.limit) ||
+            options.limit < 0) {
+            throw new Error("limit must be a non-negative finite integer");
+        }
+    }
+}
+function validateConnectOptions(options) {
+    const ssid = typeof options?.ssid === "string" ? options.ssid.trim() : "";
+    if (!ssid) {
+        throw new Error("ssid is required");
+    }
+    if (options?.password !== undefined && typeof options.password !== "string") {
+        throw new Error("password must be a string");
+    }
+}
 /**
  * Web fallback — every method resolves with empty / disabled data so the
  * full TypeScript interface is satisfied without throwing during normal
@@ -23,11 +57,13 @@ export class WiFiWeb extends WebPlugin {
         warnOnce();
         return { network: null };
     }
-    async listAvailableNetworks(_options) {
+    async listAvailableNetworks(options) {
+        normalizeListOptions(options);
         warnOnce();
         return { networks: [] };
     }
-    async connectToNetwork(_options) {
+    async connectToNetwork(options) {
+        validateConnectOptions(options);
         warnOnce();
         return { success: false, message: UNAVAILABLE_MESSAGE };
     }

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E,IAAI,MAAM,GAAG,KAAK,CAAC;AACnB,SAAS,QAAQ;IACf,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,eAAe,mBAAmB,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC,KAAK,CAAC,YAAY;QAChB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,QAA8B;QAE9B,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAwB;QAC7C,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC1D,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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"}

package/dist/esm/web.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.test.d.ts.map

package/dist/esm/web.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.d.ts","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":""}

package/dist/esm/web.test.js

@@ -0,0 +1,79 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { WiFiWeb } from "./web";
+describe("WiFiWeb fallback", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns disabled fallback state and warns once", async () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const wifi = new WiFiWeb();
+        await expect(wifi.getWifiState()).resolves.toEqual({
+            enabled: false,
+            connected: false,
+            rssi: null,
+        });
+        await expect(wifi.getConnectedNetwork()).resolves.toEqual({
+            network: null,
+        });
+        await expect(wifi.listAvailableNetworks({ limit: 10 })).resolves.toEqual({
+            networks: [],
+        });
+        expect(warn).toHaveBeenCalledTimes(1);
+    });
+    it.each([
+        { maxAge: -1 },
+        { maxAge: Number.POSITIVE_INFINITY },
+        { limit: -1 },
+        { limit: 1.5 },
+        { limit: Number.NaN },
+    ])("rejects malformed scan options %#", async (options) => {
+        const wifi = new WiFiWeb();
+        await expect(wifi.listAvailableNetworks(options)).rejects.toThrow(/must be a non-negative/);
+    });
+    it.each([
+        null,
+        "limit=1",
+        1,
+        false,
+    ])("rejects non-object scan options %# without warning", async (options) => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const wifi = new WiFiWeb();
+        await expect(wifi.listAvailableNetworks(options)).rejects.toThrow("options must be an object");
+        expect(warn).not.toHaveBeenCalled();
+    });
+    it("rejects malformed connect options before Android-only fallback responses", async () => {
+        const wifi = new WiFiWeb();
+        await expect(wifi.connectToNetwork({ ssid: " \t\n " })).rejects.toThrow("ssid is required");
+        await expect(wifi.connectToNetwork({
+            ssid: ["home"],
+            password: { value: "secret" },
+        })).rejects.toThrow("ssid is required");
+        await expect(wifi.connectToNetwork({
+            ssid: "home",
+            password: { value: "secret" },
+        })).rejects.toThrow("password must be a string");
+        await expect(wifi.connectToNetwork({ ssid: "home" })).resolves.toEqual({
+            success: false,
+            message: "Wi-Fi controls are only available on Android.",
+        });
+    });
+    it("keeps fallback state stable across repeated unavailable operations", async () => {
+        const wifi = new WiFiWeb();
+        await expect(Promise.all([
+            wifi.listAvailableNetworks({ limit: 0 }),
+            wifi.connectToNetwork({ ssid: "__proto__", password: "" }),
+            wifi.disconnectFromNetwork(),
+        ])).resolves.toEqual([
+            { networks: [] },
+            {
+                success: false,
+                message: "Wi-Fi controls are only available on Android.",
+            },
+            {
+                success: false,
+                message: "Wi-Fi controls are only available on Android.",
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=web.test.js.map

package/dist/esm/web.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.js","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAE3B,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjD,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACxD,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACvE,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;QACd,EAAE,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE;QACpC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE;QACb,EAAE,KAAK,EAAE,GAAG,EAAE;QACd,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC,mCAAmC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAE3B,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC/D,wBAAwB,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,IAAI;QACJ,SAAS;QACT,CAAC;QACD,KAAK;KACN,CAAC,CAAC,oDAAoD,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACzE,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAE3B,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxE,2BAA2B,CAC5B,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAE3B,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACrE,kBAAkB,CACnB,CAAC;QACF,MAAM,MAAM,CACV,IAAI,CAAC,gBAAgB,CAAC;YACpB,IAAI,EAAE,CAAC,MAAM,CAAsB;YACnC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAuB;SACnD,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACtC,MAAM,MAAM,CACV,IAAI,CAAC,gBAAgB,CAAC;YACpB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAuB;SACnD,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QAC/C,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrE,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QAE3B,MAAM,MAAM,CACV,OAAO,CAAC,GAAG,CAAC;YACV,IAAI,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,qBAAqB,EAAE;SAC7B,CAAC,CACH,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjB,EAAE,QAAQ,EAAE,EAAE,EAAE;YAChB;gBACE,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,+CAA+C;aACzD;YACD;gBACE,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,+CAA+C;aACzD;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugin.cjs.js

@@ -15,6 +15,40 @@ function warnOnce() {
     warned = true;
     console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function normalizeListOptions(options) {
+    if (options === undefined)
+        return;
+    if (!isRecord(options)) {
+        throw new Error("options must be an object");
+    }
+    if (options?.maxAge !== undefined) {
+        if (typeof options.maxAge !== "number" ||
+            !Number.isFinite(options.maxAge) ||
+            options.maxAge < 0) {
+            throw new Error("maxAge must be a non-negative finite number");
+        }
+    }
+    if (options?.limit !== undefined) {
+        if (typeof options.limit !== "number" ||
+            !Number.isFinite(options.limit) ||
+            !Number.isInteger(options.limit) ||
+            options.limit < 0) {
+            throw new Error("limit must be a non-negative finite integer");
+        }
+    }
+}
+function validateConnectOptions(options) {
+    const ssid = typeof options?.ssid === "string" ? options.ssid.trim() : "";
+    if (!ssid) {
+        throw new Error("ssid is required");
+    }
+    if (options?.password !== undefined && typeof options.password !== "string") {
+        throw new Error("password must be a string");
+    }
+}
 /**
  * Web fallback — every method resolves with empty / disabled data so the
  * full TypeScript interface is satisfied without throwing during normal
@@ -31,11 +65,13 @@ class WiFiWeb extends core.WebPlugin {
         warnOnce();
         return { network: null };
     }
-    async listAvailableNetworks(_options) {
+    async listAvailableNetworks(options) {
+        normalizeListOptions(options);
         warnOnce();
         return { networks: [] };
     }
-    async connectToNetwork(_options) {
+    async connectToNetwork(options) {
+        validateConnectOptions(options);
         warnOnce();
         return { success: false, message: UNAVAILABLE_MESSAGE };
     }

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.WiFiWeb());\nexport const WiFi = registerPlugin(\"ElizaWiFi\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst UNAVAILABLE_MESSAGE = \"Wi-Fi controls are only available on Android.\";\nlet warned = false;\nfunction warnOnce() {\n    if (warned)\n        return;\n    warned = true;\n    console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);\n}\n/**\n * Web fallback — every method resolves with empty / disabled data so the\n * full TypeScript interface is satisfied without throwing during normal\n * desktop or browser dev sessions. `connectToNetwork` and\n * `disconnectFromNetwork` resolve with `{ success: false }` because there is\n * no meaningful action to take on the web side.\n */\nexport class WiFiWeb extends WebPlugin {\n    async getWifiState() {\n        warnOnce();\n        return { enabled: false, connected: false, rssi: null };\n    }\n    async getConnectedNetwork() {\n        warnOnce();\n        return { network: null };\n    }\n    async listAvailableNetworks(_options) {\n        warnOnce();\n        return { networks: [] };\n    }\n    async connectToNetwork(_options) {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n    async disconnectFromNetwork() {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACtD,MAAC,IAAI,GAAGA,mBAAc,CAAC,WAAW,EAAE;AAChD,IAAI,GAAG,EAAE,OAAO;AAChB,CAAC;;ACJD,MAAM,mBAAmB,GAAG,+CAA+C;AAC3E,IAAI,MAAM,GAAG,KAAK;AAClB,SAAS,QAAQ,GAAG;AACpB,IAAI,IAAI,MAAM;AACd,QAAQ;AACR,IAAI,MAAM,GAAG,IAAI;AACjB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACtD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,QAAQ,EAAE;AAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;AAC/D,IAAI;AACJ,IAAI,MAAM,mBAAmB,GAAG;AAChC,QAAQ,QAAQ,EAAE;AAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;AAChC,IAAI;AACJ,IAAI,MAAM,qBAAqB,CAAC,QAAQ,EAAE;AAC1C,QAAQ,QAAQ,EAAE;AAClB,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;AAC/B,IAAI;AACJ,IAAI,MAAM,gBAAgB,CAAC,QAAQ,EAAE;AACrC,QAAQ,QAAQ,EAAE;AAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE;AAC/D,IAAI;AACJ,IAAI,MAAM,qBAAqB,GAAG;AAClC,QAAQ,QAAQ,EAAE;AAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE;AAC/D,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.WiFiWeb());\nexport const WiFi = registerPlugin(\"ElizaWiFi\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst UNAVAILABLE_MESSAGE = \"Wi-Fi controls are only available on Android.\";\nlet warned = false;\nfunction warnOnce() {\n    if (warned)\n        return;\n    warned = true;\n    console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);\n}\nfunction isRecord(value) {\n    return typeof value === \"object\" && value !== null;\n}\nfunction normalizeListOptions(options) {\n    if (options === undefined)\n        return;\n    if (!isRecord(options)) {\n        throw new Error(\"options must be an object\");\n    }\n    if (options?.maxAge !== undefined) {\n        if (typeof options.maxAge !== \"number\" ||\n            !Number.isFinite(options.maxAge) ||\n            options.maxAge < 0) {\n            throw new Error(\"maxAge must be a non-negative finite number\");\n        }\n    }\n    if (options?.limit !== undefined) {\n        if (typeof options.limit !== \"number\" ||\n            !Number.isFinite(options.limit) ||\n            !Number.isInteger(options.limit) ||\n            options.limit < 0) {\n            throw new Error(\"limit must be a non-negative finite integer\");\n        }\n    }\n}\nfunction validateConnectOptions(options) {\n    const ssid = typeof options?.ssid === \"string\" ? options.ssid.trim() : \"\";\n    if (!ssid) {\n        throw new Error(\"ssid is required\");\n    }\n    if (options?.password !== undefined && typeof options.password !== \"string\") {\n        throw new Error(\"password must be a string\");\n    }\n}\n/**\n * Web fallback — every method resolves with empty / disabled data so the\n * full TypeScript interface is satisfied without throwing during normal\n * desktop or browser dev sessions. `connectToNetwork` and\n * `disconnectFromNetwork` resolve with `{ success: false }` because there is\n * no meaningful action to take on the web side.\n */\nexport class WiFiWeb extends WebPlugin {\n    async getWifiState() {\n        warnOnce();\n        return { enabled: false, connected: false, rssi: null };\n    }\n    async getConnectedNetwork() {\n        warnOnce();\n        return { network: null };\n    }\n    async listAvailableNetworks(options) {\n        normalizeListOptions(options);\n        warnOnce();\n        return { networks: [] };\n    }\n    async connectToNetwork(options) {\n        validateConnectOptions(options);\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n    async disconnectFromNetwork() {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -14,6 +14,40 @@ var capacitorWifi = (function (exports, core) {
         warned = true;
         console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);
     }
+    function isRecord(value) {
+        return typeof value === "object" && value !== null;
+    }
+    function normalizeListOptions(options) {
+        if (options === undefined)
+            return;
+        if (!isRecord(options)) {
+            throw new Error("options must be an object");
+        }
+        if (options?.maxAge !== undefined) {
+            if (typeof options.maxAge !== "number" ||
+                !Number.isFinite(options.maxAge) ||
+                options.maxAge < 0) {
+                throw new Error("maxAge must be a non-negative finite number");
+            }
+        }
+        if (options?.limit !== undefined) {
+            if (typeof options.limit !== "number" ||
+                !Number.isFinite(options.limit) ||
+                !Number.isInteger(options.limit) ||
+                options.limit < 0) {
+                throw new Error("limit must be a non-negative finite integer");
+            }
+        }
+    }
+    function validateConnectOptions(options) {
+        const ssid = typeof options?.ssid === "string" ? options.ssid.trim() : "";
+        if (!ssid) {
+            throw new Error("ssid is required");
+        }
+        if (options?.password !== undefined && typeof options.password !== "string") {
+            throw new Error("password must be a string");
+        }
+    }
     /**
      * Web fallback — every method resolves with empty / disabled data so the
      * full TypeScript interface is satisfied without throwing during normal
@@ -30,11 +64,13 @@ var capacitorWifi = (function (exports, core) {
             warnOnce();
             return { network: null };
         }
-        async listAvailableNetworks(_options) {
+        async listAvailableNetworks(options) {
+            normalizeListOptions(options);
             warnOnce();
             return { networks: [] };
         }
-        async connectToNetwork(_options) {
+        async connectToNetwork(options) {
+            validateConnectOptions(options);
             warnOnce();
             return { success: false, message: UNAVAILABLE_MESSAGE };
         }

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.WiFiWeb());\nexport const WiFi = registerPlugin(\"ElizaWiFi\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst UNAVAILABLE_MESSAGE = \"Wi-Fi controls are only available on Android.\";\nlet warned = false;\nfunction warnOnce() {\n    if (warned)\n        return;\n    warned = true;\n    console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);\n}\n/**\n * Web fallback — every method resolves with empty / disabled data so the\n * full TypeScript interface is satisfied without throwing during normal\n * desktop or browser dev sessions. `connectToNetwork` and\n * `disconnectFromNetwork` resolve with `{ success: false }` because there is\n * no meaningful action to take on the web side.\n */\nexport class WiFiWeb extends WebPlugin {\n    async getWifiState() {\n        warnOnce();\n        return { enabled: false, connected: false, rssi: null };\n    }\n    async getConnectedNetwork() {\n        warnOnce();\n        return { network: null };\n    }\n    async listAvailableNetworks(_options) {\n        warnOnce();\n        return { networks: [] };\n    }\n    async connectToNetwork(_options) {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n    async disconnectFromNetwork() {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACtD,UAAC,IAAI,GAAGA,mBAAc,CAAC,WAAW,EAAE;IAChD,IAAI,GAAG,EAAE,OAAO;IAChB,CAAC;;ICJD,MAAM,mBAAmB,GAAG,+CAA+C;IAC3E,IAAI,MAAM,GAAG,KAAK;IAClB,SAAS,QAAQ,GAAG;IACpB,IAAI,IAAI,MAAM;IACd,QAAQ;IACR,IAAI,MAAM,GAAG,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACtD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACO,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,QAAQ,EAAE;IAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;IAC/D,IAAI;IACJ,IAAI,MAAM,mBAAmB,GAAG;IAChC,QAAQ,QAAQ,EAAE;IAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAChC,IAAI;IACJ,IAAI,MAAM,qBAAqB,CAAC,QAAQ,EAAE;IAC1C,QAAQ,QAAQ,EAAE;IAClB,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/B,IAAI;IACJ,IAAI,MAAM,gBAAgB,CAAC,QAAQ,EAAE;IACrC,QAAQ,QAAQ,EAAE;IAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE;IAC/D,IAAI;IACJ,IAAI,MAAM,qBAAqB,GAAG;IAClC,QAAQ,QAAQ,EAAE;IAClB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE;IAC/D,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.WiFiWeb());\nexport const WiFi = registerPlugin(\"ElizaWiFi\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst UNAVAILABLE_MESSAGE = \"Wi-Fi controls are only available on Android.\";\nlet warned = false;\nfunction warnOnce() {\n    if (warned)\n        return;\n    warned = true;\n    console.warn(`[ElizaWiFi] ${UNAVAILABLE_MESSAGE}`);\n}\nfunction isRecord(value) {\n    return typeof value === \"object\" && value !== null;\n}\nfunction normalizeListOptions(options) {\n    if (options === undefined)\n        return;\n    if (!isRecord(options)) {\n        throw new Error(\"options must be an object\");\n    }\n    if (options?.maxAge !== undefined) {\n        if (typeof options.maxAge !== \"number\" ||\n            !Number.isFinite(options.maxAge) ||\n            options.maxAge < 0) {\n            throw new Error(\"maxAge must be a non-negative finite number\");\n        }\n    }\n    if (options?.limit !== undefined) {\n        if (typeof options.limit !== \"number\" ||\n            !Number.isFinite(options.limit) ||\n            !Number.isInteger(options.limit) ||\n            options.limit < 0) {\n            throw new Error(\"limit must be a non-negative finite integer\");\n        }\n    }\n}\nfunction validateConnectOptions(options) {\n    const ssid = typeof options?.ssid === \"string\" ? options.ssid.trim() : \"\";\n    if (!ssid) {\n        throw new Error(\"ssid is required\");\n    }\n    if (options?.password !== undefined && typeof options.password !== \"string\") {\n        throw new Error(\"password must be a string\");\n    }\n}\n/**\n * Web fallback — every method resolves with empty / disabled data so the\n * full TypeScript interface is satisfied without throwing during normal\n * desktop or browser dev sessions. `connectToNetwork` and\n * `disconnectFromNetwork` resolve with `{ success: false }` because there is\n * no meaningful action to take on the web side.\n */\nexport class WiFiWeb extends WebPlugin {\n    async getWifiState() {\n        warnOnce();\n        return { enabled: false, connected: false, rssi: null };\n    }\n    async getConnectedNetwork() {\n        warnOnce();\n        return { network: null };\n    }\n    async listAvailableNetworks(options) {\n        normalizeListOptions(options);\n        warnOnce();\n        return { networks: [] };\n    }\n    async connectToNetwork(options) {\n        validateConnectOptions(options);\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n    async disconnectFromNetwork() {\n        warnOnce();\n        return { success: false, message: UNAVAILABLE_MESSAGE };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/capacitor-wifi",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.2",
   "description": "Android Wi-Fi (WifiManager) bridge for ElizaOS.",
   "main": "./dist/plugin.cjs.js",
   "module": "./dist/esm/index.js",
@@ -8,6 +8,8 @@
   "exports": {
     ".": {
       "types": "./dist/esm/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
       "import": "./dist/esm/index.js",
       "require": "./dist/plugin.cjs.js"
     },
@@ -20,9 +22,11 @@
     "dist"
   ],
   "scripts": {
-    "build": "bun run clean && tsc && bun --bun rollup -c rollup.config.mjs",
-    "clean": "node ../../../scripts/rm-path-recursive.mjs dist",
-    "prepublishOnly": "bun run build"
+    "build": "node ../../packages/scripts/with-package-build-lock.mjs plugins/plugin-native-wifi -- bun run build:unlocked",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build",
+    "build:unlocked": "bun run clean && tsc && bunx rollup -c rollup.config.mjs"
   },
   "license": "MIT",
   "capacitor": {
@@ -31,11 +35,10 @@
     }
   },
   "devDependencies": {
-    "@capacitor/cli": "^8.0.0",
     "@capacitor/core": "^8.3.1",
-    "rimraf": "^6.0.0",
     "rollup": "^4.60.2",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
   },
   "peerDependencies": {
     "@capacitor/core": "^8.3.1"
@@ -53,5 +56,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }