@brookesia/service 0.1.1

package/dist/nvs/nvs-client.d.ts

@@ -0,0 +1,41 @@
+import { type ServiceClientOptions, type ServiceHandle } from '../common/service-rpc.js';
+import type { NvsEntryInfo, NvsKeyValueMap } from './nvs-types.js';
+/** Registered name of the NVS service (`helper::NVS::get_name()`). */
+export declare const NVS_SERVICE_NAME = "NVS";
+/** Default namespace when omitted on the device (`helper::NVS::DEFAULT_NAMESPACE`). */
+export declare const NVS_DEFAULT_NAMESPACE = "storage";
+/** RPC function names exposed by `brookesia_service_nvs`. */
+export declare const NVS_FUNCTIONS: {
+    readonly List: "List";
+    readonly Set: "Set";
+    readonly Get: "Get";
+    readonly Erase: "Erase";
+};
+export type { NvsEntryInfo, NvsKeyValueMap, NvsValue, NvsValueType } from './nvs-types.js';
+export type NvsClientOptions = ServiceClientOptions;
+export { type ServiceHandle as NvsHandle };
+/** Check whether the NVS service is registered on the device. */
+export declare function isNvsAvailable(options?: NvsClientOptions): boolean;
+/** Bind the NVS service for the current app context. */
+export declare function openNvs(options?: NvsClientOptions): ServiceHandle;
+/** Release a handle from {@link openNvs}. */
+export declare function closeNvs(handle: ServiceHandle, options?: NvsClientOptions): void;
+/** List entries in a namespace. */
+export declare function listNvs(handle: ServiceHandle, nspace?: string, options?: NvsClientOptions): NvsEntryInfo[];
+/** Write key-value pairs into a namespace. */
+export declare function setNvs(handle: ServiceHandle, nspace: string, keyValuePairs: NvsKeyValueMap, options?: NvsClientOptions): void;
+/**
+ * Read keys from a namespace.
+ * When `keys` is omitted or empty, the device returns all pairs in the namespace.
+ */
+export declare function getNvs(handle: ServiceHandle, nspace: string, keys?: string[], options?: NvsClientOptions): NvsKeyValueMap;
+/**
+ * Erase keys from a namespace.
+ * When `keys` is omitted or empty, the device erases all pairs in the namespace.
+ */
+export declare function eraseNvs(handle: ServiceHandle, nspace: string, keys?: string[], options?: NvsClientOptions): void;
+/**
+ * Run `fn` with an NVS handle that is always closed in a `finally` block.
+ */
+export declare function withNvs<T>(fn: (handle: ServiceHandle) => T | Promise<T>, options?: NvsClientOptions): Promise<T>;
+//# sourceMappingURL=nvs-client.d.ts.map

package/dist/nvs/nvs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs-client.d.ts","sourceRoot":"","sources":["../../src/nvs/nvs-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C,6DAA6D;AAC7D,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE3F,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,aAAa,IAAI,SAAS,EAAE,CAAC;AAE3C,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAElE;AAED,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAEjE;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAEhF;AAWD,mCAAmC;AACnC,wBAAgB,OAAO,CACrB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,MAA8B,EACtC,OAAO,CAAC,EAAE,gBAAgB,GACzB,YAAY,EAAE,CAEhB;AAED,8CAA8C;AAC9C,wBAAgB,MAAM,CACpB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,cAAc,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,MAAM,CACpB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAEhB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC7C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/nvs/nvs-client.js

@@ -0,0 +1,64 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+import { callServiceFunction, closeService, isServiceAvailable, openService, resolveHost, } from '../common/service-rpc.js';
+/** Registered name of the NVS service (`helper::NVS::get_name()`). */
+export const NVS_SERVICE_NAME = 'NVS';
+/** Default namespace when omitted on the device (`helper::NVS::DEFAULT_NAMESPACE`). */
+export const NVS_DEFAULT_NAMESPACE = 'storage';
+/** RPC function names exposed by `brookesia_service_nvs`. */
+export const NVS_FUNCTIONS = {
+    List: 'List',
+    Set: 'Set',
+    Get: 'Get',
+    Erase: 'Erase',
+};
+/** Check whether the NVS service is registered on the device. */
+export function isNvsAvailable(options) {
+    return isServiceAvailable(NVS_SERVICE_NAME, options);
+}
+/** Bind the NVS service for the current app context. */
+export function openNvs(options) {
+    return openService(NVS_SERVICE_NAME, options);
+}
+/** Release a handle from {@link openNvs}. */
+export function closeNvs(handle, options) {
+    closeService(handle, options);
+}
+function callNvs(handle, functionName, params, options) {
+    return callServiceFunction(resolveHost(options), handle, functionName, params);
+}
+/** List entries in a namespace. */
+export function listNvs(handle, nspace = NVS_DEFAULT_NAMESPACE, options) {
+    return callNvs(handle, NVS_FUNCTIONS.List, { Nspace: nspace }, options);
+}
+/** Write key-value pairs into a namespace. */
+export function setNvs(handle, nspace, keyValuePairs, options) {
+    callNvs(handle, NVS_FUNCTIONS.Set, { Nspace: nspace, KeyValuePairs: keyValuePairs }, options);
+}
+/**
+ * Read keys from a namespace.
+ * When `keys` is omitted or empty, the device returns all pairs in the namespace.
+ */
+export function getNvs(handle, nspace, keys, options) {
+    return callNvs(handle, NVS_FUNCTIONS.Get, { Nspace: nspace, Keys: keys ?? [] }, options);
+}
+/**
+ * Erase keys from a namespace.
+ * When `keys` is omitted or empty, the device erases all pairs in the namespace.
+ */
+export function eraseNvs(handle, nspace, keys, options) {
+    callNvs(handle, NVS_FUNCTIONS.Erase, { Nspace: nspace, Keys: keys ?? [] }, options);
+}
+/**
+ * Run `fn` with an NVS handle that is always closed in a `finally` block.
+ */
+export async function withNvs(fn, options) {
+    const handle = openNvs(options);
+    try {
+        return await fn(handle);
+    }
+    finally {
+        closeNvs(handle, options);
+    }
+}
+//# sourceMappingURL=nvs-client.js.map

package/dist/nvs/nvs-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs-client.js","sourceRoot":"","sources":["../../src/nvs/nvs-client.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yCAAyC;AAEzC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,WAAW,GAGZ,MAAM,0BAA0B,CAAC;AAGlC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,uFAAuF;AACvF,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACN,CAAC;AAQX,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,OAA0B;IACvD,OAAO,kBAAkB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,OAAO,CAAC,OAA0B;IAChD,OAAO,WAAW,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CAAC,MAAqB,EAAE,OAA0B;IACxE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,OAAO,CACd,MAAqB,EACrB,YAAoB,EACpB,MAA+B,EAC/B,OAA0B;IAE1B,OAAO,mBAAmB,CAAI,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AACpF,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,OAAO,CACrB,MAAqB,EACrB,SAAiB,qBAAqB,EACtC,OAA0B;IAE1B,OAAO,OAAO,CAAiB,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,MAAM,CACpB,MAAqB,EACrB,MAAc,EACd,aAA6B,EAC7B,OAA0B;IAE1B,OAAO,CAAO,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;AACtG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,MAAqB,EACrB,MAAc,EACd,IAAe,EACf,OAA0B;IAE1B,OAAO,OAAO,CAAiB,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAqB,EACrB,MAAc,EACd,IAAe,EACf,OAA0B;IAE1B,OAAO,CAAO,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAA6C,EAC7C,OAA0B;IAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/nvs/nvs-types.d.ts

@@ -0,0 +1,9 @@
+export type NvsValue = boolean | number | string;
+export type NvsKeyValueMap = Record<string, NvsValue>;
+export type NvsValueType = 'Bool' | 'Int' | 'String';
+export type NvsEntryInfo = {
+    nspace: string;
+    key: string;
+    type: NvsValueType;
+};
+//# sourceMappingURL=nvs-types.d.ts.map

package/dist/nvs/nvs-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs-types.d.ts","sourceRoot":"","sources":["../../src/nvs/nvs-types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB,CAAC"}

package/dist/nvs/nvs-types.js

@@ -0,0 +1,4 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+export {};
+//# sourceMappingURL=nvs-types.js.map

package/dist/nvs/nvs-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs-types.js","sourceRoot":"","sources":["../../src/nvs/nvs-types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yCAAyC"}

package/dist/nvs/nvs.d.ts

@@ -0,0 +1,46 @@
+/**
+ * NVS module for JS apps — wraps brookesia_service_nvs (Set / Get / List / Erase).
+ *
+ * @example
+ * import nvs from '@brookesia/service/nvs';
+ * if (nvs.available()) {
+ *   nvs.set('config', 'theme', 'dark');
+ *   brookesia.print(nvs.get('config', 'theme'));
+ *   nvs.close();
+ * }
+ */
+import { listNvs, type NvsClientOptions } from './nvs-client.js';
+import type { NvsKeyValueMap, NvsValue } from './nvs-types.js';
+export type { NvsKeyValueMap, NvsValue };
+export type NvsModuleOptions = NvsClientOptions;
+/** For unit tests: inject mock host and reset cached handle. */
+export declare function configure(options: NvsModuleOptions): void;
+declare const nvs: {
+    /** Whether the device registered the NVS service. */
+    available(): boolean;
+    /**
+     * Write one key (maps to service `Set`).
+     * @param ns Namespace (`Nspace`), default `storage`
+     */
+    set(ns: string, key: string, value: NvsValue): void;
+    /**
+     * Write multiple keys in one call (service `Set` / `KeyValuePairs`).
+     */
+    write(ns: string, pairs: NvsKeyValueMap): void;
+    /**
+     * Read one key (`string`) or many (`string[]`). Pass `[]` to read the whole namespace.
+     */
+    get(ns: string, keyOrKeys: string | string[]): NvsValue | NvsKeyValueMap | undefined;
+    /**
+     * List entry metadata (service `List`).
+     */
+    list(ns?: string): ReturnType<typeof listNvs>;
+    /**
+     * Erase keys (service `Erase`). Omit `keys` or pass `[]` to clear the whole namespace.
+     */
+    erase(ns: string, keys?: string[]): void;
+    /** Release the NVS service binding. */
+    close(): void;
+};
+export default nvs;
+//# sourceMappingURL=nvs.d.ts.map

package/dist/nvs/nvs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs.d.ts","sourceRoot":"","sources":["../../src/nvs/nvs.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,OAAO,EAML,OAAO,EAGP,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/D,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAyBhD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAMzD;AAED,QAAA,MAAM,GAAG;IACP,qDAAqD;iBACxC,OAAO;IAIpB;;;OAGG;YACK,MAAM,OAAO,MAAM,SAAS,QAAQ,GAAG,IAAI;IAInD;;OAEG;cACO,MAAM,SAAS,cAAc,GAAG,IAAI;IAI9C;;OAEG;YACK,MAAM,aAAa,MAAM,GAAG,MAAM,EAAE,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS;IAOpF;;OAEG;cACO,MAAM,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC;IAI7C;;OAEG;cACO,MAAM,SAAS,MAAM,EAAE,GAAG,IAAI;IAIxC,uCAAuC;aAC9B,IAAI;CAOd,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/nvs/nvs.js

@@ -0,0 +1,87 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+/**
+ * NVS module for JS apps — wraps brookesia_service_nvs (Set / Get / List / Erase).
+ *
+ * @example
+ * import nvs from '@brookesia/service/nvs';
+ * if (nvs.available()) {
+ *   nvs.set('config', 'theme', 'dark');
+ *   brookesia.print(nvs.get('config', 'theme'));
+ *   nvs.close();
+ * }
+ */
+import { NVS_DEFAULT_NAMESPACE, closeNvs, eraseNvs, getNvs, isNvsAvailable, listNvs, openNvs, setNvs, } from './nvs-client.js';
+const state = { handle: null, options: {} };
+function namespace(name) {
+    const n = name?.trim();
+    return n && n.length > 0 ? n : NVS_DEFAULT_NAMESPACE;
+}
+function handle() {
+    if (state.handle !== null) {
+        return state.handle;
+    }
+    if (!isNvsAvailable(state.options)) {
+        throw new Error('NVS service is not available');
+    }
+    state.handle = openNvs(state.options);
+    return state.handle;
+}
+/** For unit tests: inject mock host and reset cached handle. */
+export function configure(options) {
+    if (state.handle !== null) {
+        closeNvs(state.handle, state.options);
+    }
+    state.handle = null;
+    state.options = options;
+}
+const nvs = {
+    /** Whether the device registered the NVS service. */
+    available() {
+        return isNvsAvailable(state.options);
+    },
+    /**
+     * Write one key (maps to service `Set`).
+     * @param ns Namespace (`Nspace`), default `storage`
+     */
+    set(ns, key, value) {
+        setNvs(handle(), namespace(ns), { [key]: value }, state.options);
+    },
+    /**
+     * Write multiple keys in one call (service `Set` / `KeyValuePairs`).
+     */
+    write(ns, pairs) {
+        setNvs(handle(), namespace(ns), pairs, state.options);
+    },
+    /**
+     * Read one key (`string`) or many (`string[]`). Pass `[]` to read the whole namespace.
+     */
+    get(ns, keyOrKeys) {
+        if (typeof keyOrKeys === 'string') {
+            return getNvs(handle(), namespace(ns), [keyOrKeys], state.options)[keyOrKeys];
+        }
+        return getNvs(handle(), namespace(ns), keyOrKeys, state.options);
+    },
+    /**
+     * List entry metadata (service `List`).
+     */
+    list(ns) {
+        return listNvs(handle(), namespace(ns), state.options);
+    },
+    /**
+     * Erase keys (service `Erase`). Omit `keys` or pass `[]` to clear the whole namespace.
+     */
+    erase(ns, keys) {
+        eraseNvs(handle(), namespace(ns), keys ?? [], state.options);
+    },
+    /** Release the NVS service binding. */
+    close() {
+        if (state.handle === null) {
+            return;
+        }
+        closeNvs(state.handle, state.options);
+        state.handle = null;
+    },
+};
+export default nvs;
+//# sourceMappingURL=nvs.js.map

package/dist/nvs/nvs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nvs.js","sourceRoot":"","sources":["../../src/nvs/nvs.ts"],"names":[],"mappings":"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"}

package/dist/wifi/index.d.ts

@@ -0,0 +1,5 @@
+/** App-facing Wi-Fi module (default import). */
+export { default, configure, type WifiModuleOptions, type WifiConnectApInfo, type WifiGeneralAction, type WifiGeneralState, type WifiScanApInfo, type WifiScanParams, type WifiSoftApParams, } from './wifi.js';
+/** Low-level Wi-Fi service RPC helpers (advanced). */
+export { WIFI_SERVICE_NAME, WIFI_FUNCTIONS, closeWifi, getConnectAp, getConnectedAps, getGeneralState, getSoftApParams, isWifiAvailable, openWifi, resetWifiData, setConnectAp, setScanParams, setSoftApParams, triggerGeneralAction, triggerScanStart, triggerScanStop, triggerSoftApProvisionStart, triggerSoftApProvisionStop, triggerSoftApStart, triggerSoftApStop, type WifiClientOptions, type WifiHandle, } from './wifi-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/wifi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wifi/index.ts"],"names":[],"mappings":"AAGA,gDAAgD;AAChD,OAAO,EACL,OAAO,EACP,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,sDAAsD;AACtD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/wifi/index.js

@@ -0,0 +1,7 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+/** App-facing Wi-Fi module (default import). */
+export { default, configure, } from './wifi.js';
+/** Low-level Wi-Fi service RPC helpers (advanced). */
+export { WIFI_SERVICE_NAME, WIFI_FUNCTIONS, closeWifi, getConnectAp, getConnectedAps, getGeneralState, getSoftApParams, isWifiAvailable, openWifi, resetWifiData, setConnectAp, setScanParams, setSoftApParams, triggerGeneralAction, triggerScanStart, triggerScanStop, triggerSoftApProvisionStart, triggerSoftApProvisionStop, triggerSoftApStart, triggerSoftApStop, } from './wifi-client.js';
+//# sourceMappingURL=index.js.map

package/dist/wifi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wifi/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yCAAyC;AAEzC,gDAAgD;AAChD,OAAO,EACL,OAAO,EACP,SAAS,GAQV,MAAM,WAAW,CAAC;AAEnB,sDAAsD;AACtD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC"}

package/dist/wifi/wifi-client.d.ts

@@ -0,0 +1,43 @@
+import { type ServiceClientOptions, type ServiceHandle } from '../common/service-rpc.js';
+import type { WifiConnectApInfo, WifiGeneralAction, WifiGeneralState, WifiScanParams, WifiSoftApParams } from './wifi-types.js';
+/** Registered name (`helper::Wifi::get_name()`). */
+export declare const WIFI_SERVICE_NAME = "Wifi";
+/** RPC function names (`helper::Wifi::FunctionId`). */
+export declare const WIFI_FUNCTIONS: {
+    readonly TriggerGeneralAction: "TriggerGeneralAction";
+    readonly GetGeneralState: "GetGeneralState";
+    readonly SetConnectAp: "SetConnectAp";
+    readonly GetConnectAp: "GetConnectAp";
+    readonly GetConnectedAps: "GetConnectedAps";
+    readonly SetScanParams: "SetScanParams";
+    readonly TriggerScanStart: "TriggerScanStart";
+    readonly TriggerScanStop: "TriggerScanStop";
+    readonly SetSoftApParams: "SetSoftApParams";
+    readonly GetSoftApParams: "GetSoftApParams";
+    readonly TriggerSoftApStart: "TriggerSoftApStart";
+    readonly TriggerSoftApStop: "TriggerSoftApStop";
+    readonly TriggerSoftApProvisionStart: "TriggerSoftApProvisionStart";
+    readonly TriggerSoftApProvisionStop: "TriggerSoftApProvisionStop";
+    readonly ResetData: "ResetData";
+};
+export type WifiClientOptions = ServiceClientOptions;
+export { type ServiceHandle as WifiHandle };
+export declare function isWifiAvailable(options?: WifiClientOptions): boolean;
+export declare function openWifi(options?: WifiClientOptions): ServiceHandle;
+export declare function closeWifi(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function triggerGeneralAction(handle: ServiceHandle, action: WifiGeneralAction, options?: WifiClientOptions): void;
+export declare function getGeneralState(handle: ServiceHandle, options?: WifiClientOptions): WifiGeneralState;
+export declare function setConnectAp(handle: ServiceHandle, ssid: string, password?: string, options?: WifiClientOptions): void;
+export declare function getConnectAp(handle: ServiceHandle, options?: WifiClientOptions): WifiConnectApInfo;
+export declare function getConnectedAps(handle: ServiceHandle, options?: WifiClientOptions): WifiConnectApInfo[];
+export declare function setScanParams(handle: ServiceHandle, params: WifiScanParams, options?: WifiClientOptions): void;
+export declare function triggerScanStart(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function triggerScanStop(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function setSoftApParams(handle: ServiceHandle, params: WifiSoftApParams, options?: WifiClientOptions): void;
+export declare function getSoftApParams(handle: ServiceHandle, options?: WifiClientOptions): WifiSoftApParams;
+export declare function triggerSoftApStart(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function triggerSoftApStop(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function triggerSoftApProvisionStart(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function triggerSoftApProvisionStop(handle: ServiceHandle, options?: WifiClientOptions): void;
+export declare function resetWifiData(handle: ServiceHandle, options?: WifiClientOptions): void;
+//# sourceMappingURL=wifi-client.d.ts.map

package/dist/wifi/wifi-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi-client.d.ts","sourceRoot":"","sources":["../../src/wifi/wifi-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAEhB,cAAc,EACd,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,uDAAuD;AACvD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAgBjB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,aAAa,IAAI,UAAU,EAAE,CAAC;AAE5C,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAEpE;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAEnE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAElF;AAWD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAElB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAK,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,iBAAiB,CAEnB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,iBAAiB,EAAE,CAErB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEzF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAExF;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAElB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAE1F;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEtF"}

package/dist/wifi/wifi-client.js

@@ -0,0 +1,81 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+import { callServiceFunction, closeService, isServiceAvailable, openService, resolveHost, } from '../common/service-rpc.js';
+/** Registered name (`helper::Wifi::get_name()`). */
+export const WIFI_SERVICE_NAME = 'Wifi';
+/** RPC function names (`helper::Wifi::FunctionId`). */
+export const WIFI_FUNCTIONS = {
+    TriggerGeneralAction: 'TriggerGeneralAction',
+    GetGeneralState: 'GetGeneralState',
+    SetConnectAp: 'SetConnectAp',
+    GetConnectAp: 'GetConnectAp',
+    GetConnectedAps: 'GetConnectedAps',
+    SetScanParams: 'SetScanParams',
+    TriggerScanStart: 'TriggerScanStart',
+    TriggerScanStop: 'TriggerScanStop',
+    SetSoftApParams: 'SetSoftApParams',
+    GetSoftApParams: 'GetSoftApParams',
+    TriggerSoftApStart: 'TriggerSoftApStart',
+    TriggerSoftApStop: 'TriggerSoftApStop',
+    TriggerSoftApProvisionStart: 'TriggerSoftApProvisionStart',
+    TriggerSoftApProvisionStop: 'TriggerSoftApProvisionStop',
+    ResetData: 'ResetData',
+};
+export function isWifiAvailable(options) {
+    return isServiceAvailable(WIFI_SERVICE_NAME, options);
+}
+export function openWifi(options) {
+    return openService(WIFI_SERVICE_NAME, options);
+}
+export function closeWifi(handle, options) {
+    closeService(handle, options);
+}
+function callWifi(handle, functionName, params, options) {
+    return callServiceFunction(resolveHost(options), handle, functionName, params);
+}
+export function triggerGeneralAction(handle, action, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerGeneralAction, { Action: action }, options);
+}
+export function getGeneralState(handle, options) {
+    return callWifi(handle, WIFI_FUNCTIONS.GetGeneralState, {}, options);
+}
+export function setConnectAp(handle, ssid, password = '', options) {
+    callWifi(handle, WIFI_FUNCTIONS.SetConnectAp, { SSID: ssid, Password: password }, options);
+}
+export function getConnectAp(handle, options) {
+    return callWifi(handle, WIFI_FUNCTIONS.GetConnectAp, {}, options);
+}
+export function getConnectedAps(handle, options) {
+    return callWifi(handle, WIFI_FUNCTIONS.GetConnectedAps, {}, options);
+}
+export function setScanParams(handle, params, options) {
+    callWifi(handle, WIFI_FUNCTIONS.SetScanParams, { Param: params }, options);
+}
+export function triggerScanStart(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerScanStart, {}, options);
+}
+export function triggerScanStop(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerScanStop, {}, options);
+}
+export function setSoftApParams(handle, params, options) {
+    callWifi(handle, WIFI_FUNCTIONS.SetSoftApParams, { Param: params }, options);
+}
+export function getSoftApParams(handle, options) {
+    return callWifi(handle, WIFI_FUNCTIONS.GetSoftApParams, {}, options);
+}
+export function triggerSoftApStart(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerSoftApStart, {}, options);
+}
+export function triggerSoftApStop(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerSoftApStop, {}, options);
+}
+export function triggerSoftApProvisionStart(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerSoftApProvisionStart, {}, options);
+}
+export function triggerSoftApProvisionStop(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.TriggerSoftApProvisionStop, {}, options);
+}
+export function resetWifiData(handle, options) {
+    callWifi(handle, WIFI_FUNCTIONS.ResetData, {}, options);
+}
+//# sourceMappingURL=wifi-client.js.map

package/dist/wifi/wifi-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi-client.js","sourceRoot":"","sources":["../../src/wifi/wifi-client.ts"],"names":[],"mappings":"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"}

package/dist/wifi/wifi-types.d.ts

@@ -0,0 +1,28 @@
+/** Matches `helper::Wifi::GeneralAction` enum strings on device. */
+export type WifiGeneralAction = 'Init' | 'Deinit' | 'Start' | 'Stop' | 'Connect' | 'Disconnect';
+/** Matches `helper::Wifi::GeneralState` enum strings returned by GetGeneralState. */
+export type WifiGeneralState = 'Idle' | 'Initing' | 'Inited' | 'Deiniting' | 'Starting' | 'Started' | 'Stopping' | 'Connecting' | 'Connected' | 'Disconnecting';
+export type WifiConnectApInfo = {
+    ssid: string;
+    password?: string;
+    is_connectable?: boolean;
+};
+export type WifiScanParams = {
+    ap_count?: number;
+    interval_ms?: number;
+    timeout_ms?: number;
+};
+export type WifiScanApInfo = {
+    ssid: string;
+    is_locked?: boolean;
+    rssi?: number;
+    signal_level?: string;
+    channel?: number;
+};
+export type WifiSoftApParams = {
+    ssid?: string;
+    password?: string;
+    max_connection?: number;
+    channel?: number;
+};
+//# sourceMappingURL=wifi-types.d.ts.map

package/dist/wifi/wifi-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi-types.d.ts","sourceRoot":"","sources":["../../src/wifi/wifi-types.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,GACT,YAAY,CAAC;AAEjB,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,WAAW,GACX,UAAU,GACV,SAAS,GACT,UAAU,GACV,YAAY,GACZ,WAAW,GACX,eAAe,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/wifi/wifi-types.js

@@ -0,0 +1,4 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+export {};
+//# sourceMappingURL=wifi-types.js.map

package/dist/wifi/wifi-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi-types.js","sourceRoot":"","sources":["../../src/wifi/wifi-types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yCAAyC"}

package/dist/wifi/wifi.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Wi-Fi service module for JS apps — wraps `brookesia_service_wifi` RPC.
+ *
+ * @example
+ * import wifi from '@brookesia/service/wifi';
+ * if (wifi.available()) {
+ *   await wifi.triggerGeneralAction('Init');
+ *   wifi.setConnectAp('MySSID', 'secret');
+ *   await wifi.triggerGeneralAction('Start');
+ *   await wifi.triggerGeneralAction('Connect');
+ *   brookesia.print(wifi.getGeneralState());
+ *   wifi.close();
+ * }
+ */
+import { type WifiClientOptions } from './wifi-client.js';
+import type { WifiConnectApInfo, WifiGeneralAction, WifiGeneralState, WifiScanApInfo, WifiScanParams, WifiSoftApParams } from './wifi-types.js';
+export type { WifiConnectApInfo, WifiGeneralAction, WifiGeneralState, WifiScanApInfo, WifiScanParams, WifiSoftApParams, };
+export type WifiModuleOptions = WifiClientOptions;
+/** For unit tests: inject mock host and reset cached handle. */
+export declare function configure(options: WifiModuleOptions): void;
+declare const wifi: {
+    available(): boolean;
+    close(): void;
+    getGeneralState(): WifiGeneralState;
+    triggerGeneralAction(action: WifiGeneralAction): void;
+    setConnectAp(ssid: string, password?: string): void;
+    getConnectAp(): WifiConnectApInfo;
+    getConnectedAps(): WifiConnectApInfo[];
+    setScanParams(params: WifiScanParams): void;
+    triggerScanStart(): void;
+    triggerScanStop(): void;
+    setSoftApParams(params: WifiSoftApParams): void;
+    getSoftApParams(): WifiSoftApParams;
+    triggerSoftApStart(): void;
+    triggerSoftApStop(): void;
+    triggerSoftApProvisionStart(): void;
+    triggerSoftApProvisionStop(): void;
+    resetData(): void;
+};
+export default wifi;
+//# sourceMappingURL=wifi.d.ts.map

package/dist/wifi/wifi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifi.d.ts","sourceRoot":"","sources":["../../src/wifi/wifi.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAmBL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAoBlD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAM1D;AAED,QAAA,MAAM,IAAI;iBACK,OAAO;aAIX,IAAI;uBAQM,gBAAgB;iCAIN,iBAAiB,GAAG,IAAI;uBAIlC,MAAM,sBAAkB,IAAI;oBAI/B,iBAAiB;uBAId,iBAAiB,EAAE;0BAIhB,cAAc,GAAG,IAAI;wBAIvB,IAAI;uBAIL,IAAI;4BAIC,gBAAgB,GAAG,IAAI;uBAI5B,gBAAgB;0BAIb,IAAI;yBAIL,IAAI;mCAIM,IAAI;kCAIL,IAAI;iBAIrB,IAAI;CAGlB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/wifi/wifi.js

@@ -0,0 +1,95 @@
+/* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD */
+/* SPDX-License-Identifier: Apache-2.0 */
+/**
+ * Wi-Fi service module for JS apps — wraps `brookesia_service_wifi` RPC.
+ *
+ * @example
+ * import wifi from '@brookesia/service/wifi';
+ * if (wifi.available()) {
+ *   await wifi.triggerGeneralAction('Init');
+ *   wifi.setConnectAp('MySSID', 'secret');
+ *   await wifi.triggerGeneralAction('Start');
+ *   await wifi.triggerGeneralAction('Connect');
+ *   brookesia.print(wifi.getGeneralState());
+ *   wifi.close();
+ * }
+ */
+import { closeWifi, getConnectAp, getConnectedAps, getGeneralState, getSoftApParams, isWifiAvailable, openWifi, resetWifiData, setConnectAp, setScanParams, setSoftApParams, triggerGeneralAction, triggerScanStart, triggerScanStop, triggerSoftApProvisionStart, triggerSoftApProvisionStop, triggerSoftApStart, triggerSoftApStop, } from './wifi-client.js';
+const state = { handle: null, options: {} };
+function handle() {
+    if (state.handle !== null) {
+        return state.handle;
+    }
+    if (!isWifiAvailable(state.options)) {
+        throw new Error('Wi-Fi service is not available');
+    }
+    state.handle = openWifi(state.options);
+    return state.handle;
+}
+/** For unit tests: inject mock host and reset cached handle. */
+export function configure(options) {
+    if (state.handle !== null) {
+        closeWifi(state.handle, state.options);
+    }
+    state.handle = null;
+    state.options = options;
+}
+const wifi = {
+    available() {
+        return isWifiAvailable(state.options);
+    },
+    close() {
+        if (state.handle === null) {
+            return;
+        }
+        closeWifi(state.handle, state.options);
+        state.handle = null;
+    },
+    getGeneralState() {
+        return getGeneralState(handle(), state.options);
+    },
+    triggerGeneralAction(action) {
+        triggerGeneralAction(handle(), action, state.options);
+    },
+    setConnectAp(ssid, password = '') {
+        setConnectAp(handle(), ssid, password, state.options);
+    },
+    getConnectAp() {
+        return getConnectAp(handle(), state.options);
+    },
+    getConnectedAps() {
+        return getConnectedAps(handle(), state.options);
+    },
+    setScanParams(params) {
+        setScanParams(handle(), params, state.options);
+    },
+    triggerScanStart() {
+        triggerScanStart(handle(), state.options);
+    },
+    triggerScanStop() {
+        triggerScanStop(handle(), state.options);
+    },
+    setSoftApParams(params) {
+        setSoftApParams(handle(), params, state.options);
+    },
+    getSoftApParams() {
+        return getSoftApParams(handle(), state.options);
+    },
+    triggerSoftApStart() {
+        triggerSoftApStart(handle(), state.options);
+    },
+    triggerSoftApStop() {
+        triggerSoftApStop(handle(), state.options);
+    },
+    triggerSoftApProvisionStart() {
+        triggerSoftApProvisionStart(handle(), state.options);
+    },
+    triggerSoftApProvisionStop() {
+        triggerSoftApProvisionStop(handle(), state.options);
+    },
+    resetData() {
+        resetWifiData(handle(), state.options);
+    },
+};
+export default wifi;
+//# sourceMappingURL=wifi.js.map