esp-idf-provisioning-web 0.0.1

package/dist/protocol/protocol.d.ts

@@ -0,0 +1,4 @@
+import * as proto from '../generated/proto.js';
+import { ESPWifiAuthMode } from '../types.js';
+export declare function wifiAuthModeToESPWifiAuthMode(mode: proto.WifiAuthMode): ESPWifiAuthMode;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/protocol/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,eAAe,CAmBvF"}

package/dist/protocol/wifiConfig.d.ts

@@ -0,0 +1,8 @@
+import { ESPWifiStatus } from '../types.js';
+export declare function getConfigStatusRequest(): Uint8Array;
+export declare function processConfigStatusResponse(response: Uint8Array): ESPWifiStatus;
+export declare function getConfigUpdateRequest(ssid: string, passphrase: string): Uint8Array;
+export declare function processConfigUpdateResponse(response: Uint8Array): void;
+export declare function getConfigApplyRequest(): Uint8Array;
+export declare function processConfigApplyResponse(response: Uint8Array): void;
+//# sourceMappingURL=wifiConfig.d.ts.map

package/dist/protocol/wifiConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifiConfig.d.ts","sourceRoot":"","sources":["../../src/protocol/wifiConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,aAAa,EAAE,MAAM,aAAa,CAAC;AAI9F,wBAAgB,sBAAsB,IAAI,UAAU,CAKnD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAsD/E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAQnF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAUtE;AAED,wBAAgB,qBAAqB,IAAI,UAAU,CAKlD;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAUrE"}

package/dist/protocol/wifiScan.d.ts

@@ -0,0 +1,8 @@
+import { ESPScanStatusResponse, ESPWifiAp } from '../types.js';
+export declare function getScanStartRequest(blocking?: boolean, passive?: boolean, groupChannels?: number, periodMs?: number): Uint8Array;
+export declare function processScanStartResponse(response: Uint8Array): void;
+export declare function getScanStatusRequest(): Uint8Array;
+export declare function processScanStatusResponse(response: Uint8Array): ESPScanStatusResponse;
+export declare function getScanResultRequest(index: number, count: number): Uint8Array;
+export declare function processScanResultResponse(response: Uint8Array): ESPWifiAp[];
+//# sourceMappingURL=wifiScan.d.ts.map

package/dist/protocol/wifiScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wifiScan.d.ts","sourceRoot":"","sources":["../../src/protocol/wifiScan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI/D,wBAAgB,mBAAmB,CACjC,QAAQ,GAAE,OAAc,EACxB,OAAO,GAAE,OAAe,EACxB,aAAa,GAAE,MAAU,EACzB,QAAQ,GAAE,MAAY,GACrB,UAAU,CAWZ;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CASnE;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAMjD;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,GAAG,qBAAqB,CAcrF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAS7E;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,EAAE,CAqB3E"}

package/dist/security/Security.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base class for security implementations
+ */
+export declare abstract class Security {
+    /**
+     * Encrypt data for transmission
+     */
+    abstract encrypt(data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Decrypt received data
+     */
+    abstract decrypt(data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Get session setup request data
+     */
+    abstract getSessionSetupRequest(): Promise<Uint8Array>;
+    /**
+     * Process session setup response
+     */
+    abstract processSessionSetupResponse(response: Uint8Array): Promise<void>;
+    /**
+     * Check if security is established
+     */
+    abstract isEstablished(): boolean;
+}
+//# sourceMappingURL=Security.d.ts.map

package/dist/security/Security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Security.d.ts","sourceRoot":"","sources":["../../src/security/Security.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,8BAAsB,QAAQ;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,sBAAsB,IAAI,OAAO,CAAC,UAAU,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,aAAa,IAAI,OAAO;CAClC"}

package/dist/security/Security0.d.ts

@@ -0,0 +1,13 @@
+import { Security } from './Security';
+/**
+ * Security0 - No encryption (unsecure mode)
+ */
+export declare class Security0 extends Security {
+    private established;
+    encrypt(data: Uint8Array): Promise<Uint8Array>;
+    decrypt(data: Uint8Array): Promise<Uint8Array>;
+    getSessionSetupRequest(): Promise<Uint8Array>;
+    processSessionSetupResponse(response: Uint8Array): Promise<void>;
+    isEstablished(): boolean;
+}
+//# sourceMappingURL=Security0.d.ts.map

package/dist/security/Security0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Security0.d.ts","sourceRoot":"","sources":["../../src/security/Security0.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACrC,OAAO,CAAC,WAAW,CAAkB;IAE/B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C,sBAAsB,IAAI,OAAO,CAAC,UAAU,CAAC;IAU7C,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE,aAAa,IAAI,OAAO;CAGzB"}

package/dist/transport/BLETransport.d.ts

@@ -0,0 +1,22 @@
+import { Transport } from './Transport';
+/**
+ * BLE Transport implementation using Web Bluetooth API
+ */
+export declare class BLETransport extends Transport {
+    private device;
+    private serviceUUID;
+    private nuLookup;
+    private server?;
+    private service?;
+    private connected;
+    constructor(device: BluetoothDevice, serviceUUID: string, nuLookup: Map<string, string>);
+    connect(): Promise<void>;
+    disconnect(): void;
+    sendData(endpoint: string, data: Uint8Array): Promise<Uint8Array>;
+    isConnected(): boolean;
+    /**
+     * Get the underlying Bluetooth device
+     */
+    getDevice(): BluetoothDevice;
+}
+//# sourceMappingURL=BLETransport.d.ts.map

package/dist/transport/BLETransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BLETransport.d.ts","sourceRoot":"","sources":["../../src/transport/BLETransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAsB;IAEtC,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAOjF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C9B,UAAU,IAAI,IAAI;IASZ,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBvE,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B"}

package/dist/transport/SoftAPTransport.d.ts

@@ -0,0 +1,27 @@
+import { Transport } from './Transport';
+/**
+ * SoftAP Transport implementation using HTTP
+ * Note: Browser cannot automatically connect to WiFi networks.
+ * User must manually connect to the device's SoftAP before using this transport.
+ */
+export declare class SoftAPTransport extends Transport {
+    private baseUrl;
+    private connected;
+    /**
+     * @param baseUrl - Base URL of the device (e.g., http://192.168.4.1)
+     */
+    constructor(baseUrl: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    sendData(endpoint: string, data: Uint8Array): Promise<Uint8Array>;
+    isConnected(): boolean;
+    /**
+     * Set custom base URL
+     */
+    setBaseUrl(url: string): void;
+    /**
+     * Get current base URL
+     */
+    getBaseUrl(): string;
+}
+//# sourceMappingURL=SoftAPTransport.d.ts.map

package/dist/transport/SoftAPTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoftAPTransport.d.ts","sourceRoot":"","sources":["../../src/transport/SoftAPTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAkB;IAEnC;;OAEG;gBACS,OAAO,EAAE,MAAM;IAKrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,UAAU,IAAI,IAAI;IAIZ,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BvE,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/dist/transport/Transport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Base class for transport implementations
+ */
+export declare abstract class Transport {
+    /**
+     * Connect to the device
+     */
+    abstract connect(): Promise<void>;
+    /**
+     * Disconnect from the device
+     */
+    abstract disconnect(): void;
+    /**
+     * Send data to a specific endpoint
+     */
+    abstract sendData(endpoint: string, data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Check if transport is connected
+     */
+    abstract isConnected(): boolean;
+}
+//# sourceMappingURL=Transport.d.ts.map

package/dist/transport/Transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.d.ts","sourceRoot":"","sources":["../../src/transport/Transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,8BAAsB,SAAS;IAC7B;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,IAAI;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAE1E;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO;CAChC"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+export type ESPSecurityConfig = ESPSecurity1Config | ESPSecurity2Config;
+export interface ESPSecurity1Config {
+    type: 'Security1';
+    proofOfPossession: string;
+}
+export interface ESPSecurity2Config {
+    type: 'Security2';
+    username: string;
+    password: string;
+}
+/**
+ * WiFi authentication modes
+ */
+export declare enum ESPWifiAuthMode {
+    open = 0,
+    wep = 1,
+    wpa2Enterprise = 2,
+    wpa2Psk = 3,
+    wpaPsk = 4,
+    wpaWpa2Psk = 5,
+    wpa3Psk = 6,
+    wpa2Wpa3Psk = 7
+}
+/**
+ * WiFi STA state
+ */
+export declare enum ESPWifiStaState {
+    connected = 0,
+    connecting = 1,
+    disconnected = 2,
+    failed = 3
+}
+/**
+ * WiFi scan failure reasons
+ */
+export declare enum ESPConnectFailReason {
+    authError = 1,
+    networkNotFound = 2
+}
+export interface ESPWifiStatus {
+    staState: ESPWifiStaState;
+    failedReason?: ESPConnectFailReason;
+    connected?: ESPWifiAp;
+}
+/**
+ * WiFi network information returned by device scan
+ */
+export interface ESPWifiAp {
+    ssid: string;
+    rssi: number;
+    auth: ESPWifiAuthMode;
+    bssid: string;
+    channel: number;
+}
+/**
+ * Scan status response
+ */
+export interface ESPScanStatusResponse {
+    scanFinished: boolean;
+    count: number;
+}
+/**
+ * Device interface for ESP provisioning
+ */
+export interface ESPDeviceInterface {
+    connect(security?: ESPSecurityConfig): Promise<void>;
+    scanWifiList(): Promise<ESPWifiAp[]>;
+    disconnect(): void;
+    provision(ssid: string, passphrase: string): Promise<void>;
+    fetchWifiStatus(): Promise<ESPWifiStatus>;
+    getDevice(): BluetoothDevice | URL;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,IAAI;IACR,GAAG,IAAI;IACP,cAAc,IAAI;IAClB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,UAAU,IAAI;IACd,OAAO,IAAI;IACX,WAAW,IAAI;CAChB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,SAAS,IAAI;IACb,UAAU,IAAI;IACd,YAAY,IAAI;IAChB,MAAM,IAAI;CACX;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,SAAS,IAAI;IACb,eAAe,IAAI;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErC,UAAU,IAAI,IAAI,CAAC;IAEnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1C,SAAS,IAAI,eAAe,GAAG,GAAG,CAAC;CACpC"}

package/dist/utils/crypto.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cryptographic utilities for ESP provisioning protocol
+ */
+/**
+ * Generate random bytes
+ */
+export declare function generateRandomBytes(length: number): Uint8Array;
+/**
+ * Convert hex string to Uint8Array
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Convert Uint8Array to hex string
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert string to Uint8Array
+ */
+export declare function stringToBytes(str: string): Uint8Array;
+/**
+ * Convert Uint8Array to string
+ */
+export declare function bytesToString(bytes: Uint8Array): string;
+/**
+ * SHA-256 hash function
+ */
+export declare function sha256(data: Uint8Array): Promise<Uint8Array>;
+/**
+ * HMAC-SHA-256
+ */
+export declare function hmacSha256(key: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * AES-CTR encryption
+ */
+export declare function aesEncrypt(key: Uint8Array, counter: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * AES-CTR decryption
+ */
+export declare function aesDecrypt(key: Uint8Array, counter: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+export declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/utils/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAI9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUvF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC,CAcrB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC,CAcrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS/D"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "esp-idf-provisioning-web",
+  "version": "0.0.1",
+  "description": "ESP-IDF WiFi Provisioning SDK for web browsers",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "esp32",
+    "esp-idf",
+    "provisioning",
+    "wifi",
+    "ble",
+    "bluetooth",
+    "web-bluetooth",
+    "softap",
+    "iot"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "protobufjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/web-bluetooth": "0.0.21",
+    "@typescript-eslint/eslint-plugin": "8.46.2",
+    "@typescript-eslint/parser": "8.46.2",
+    "eslint": "9.38.0",
+    "jest": "30.2.0",
+    "prettier": "^3.0.0",
+    "protobufjs-cli": "^1.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0",
+    "vite": "7.1.11"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ho-229/esp-idf-provisioning-web.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ho-229/esp-idf-provisioning-web/issues"
+  },
+  "scripts": {
+    "prebuild": "pbjs -t static-module -w es6 -o src/generated/proto.js src/proto/*.proto && pbts -o src/generated/proto.d.ts src/generated/proto.js",
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "dev": "vite build --watch",
+    "example": "npx http-server -p 8080 -o /examples/ble-provisioning.html",
+    "serve": "npx http-server -p 8080",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  }
+}

package/src/ESPDevice.ts

@@ -0,0 +1,231 @@
+import {
+  ESPDeviceInterface,
+  ESPWifiAp,
+  ESPWifiStatus,
+  ESPSecurityConfig,
+} from './types';
+import { Transport } from './transport/Transport';
+import { BLETransport } from './transport/BLETransport';
+import { SoftAPTransport } from './transport/SoftAPTransport';
+import { Security } from './security/Security';
+import { Security0 } from './security/Security0';
+import { FALLBACK_NU_LOOKUP, FALLBACK_SERVICE_UUID, PROTO_ENDPOINTS } from './constants';
+import {
+  getScanResultRequest,
+  getScanStartRequest,
+  getScanStatusRequest,
+  processScanResultResponse,
+  processScanStartResponse,
+  processScanStatusResponse,
+} from './protocol/wifiScan';
+import {
+  getConfigApplyRequest,
+  getConfigStatusRequest,
+  getConfigUpdateRequest,
+  processConfigApplyResponse,
+  processConfigStatusResponse,
+  processConfigUpdateResponse,
+} from './protocol/wifiConfig';
+
+/**
+ * ESP Device class for provisioning operations
+ */
+export class ESPDevice implements ESPDeviceInterface {
+  private device: BluetoothDevice | URL;
+  private transportImpl?: Transport;
+  private securityImpl?: Security;
+
+  /**
+   * Create a new ESPDevice instance
+   * @param device - BluetoothDevice for BLE or URL for SoftAP
+   */
+  constructor(device: BluetoothDevice | URL) {
+    this.device = device;
+  }
+
+  /**
+   * Connect to the device
+   * @param proofOfPossession - Proof of possession for secure modes
+   * @param softAPPassword - Password for SoftAP mode (not used in browser)
+   * @param username - Username for authentication
+   */
+  async connect(security?: ESPSecurityConfig): Promise<void> {
+    // Initialize transport
+    await this.initializeTransport();
+
+    // Initialize security
+    this.initializeSecurity(security);
+
+    // Establish secure session if needed
+    if (security) {
+      await this.establishSession();
+    }
+  }
+
+  /**
+   * Scan for available WiFi networks
+   * @returns List of WiFi networks
+   */
+  async scanWifiList(): Promise<ESPWifiAp[]> {
+    if (!this.transportImpl || !this.securityImpl) {
+      throw new Error('Device not connected');
+    }
+
+    try {
+      const scanRequest = getScanStartRequest();
+      const scanResponse = await this.sendData(PROTO_ENDPOINTS.PROV_SCAN, scanRequest);
+      processScanStartResponse(scanResponse);
+
+      const scanStatusRequest = getScanStatusRequest();
+      const scanStatusResponse = await this.sendData(PROTO_ENDPOINTS.PROV_SCAN, scanStatusRequest);
+      const { scanFinished, count } = processScanStatusResponse(scanStatusResponse);
+      if (!scanFinished) {
+        throw new Error('WiFi scan should have finished');
+      }
+
+      let wifiList: ESPWifiAp[] = [];
+      for (let i = 0; i < count; i++) {
+        const scanResultRequest = getScanResultRequest(i, 1);
+        const scanResultResponse = await this.sendData(
+          PROTO_ENDPOINTS.PROV_SCAN,
+          scanResultRequest
+        );
+        const list = processScanResultResponse(scanResultResponse);
+        wifiList = wifiList.concat(list);
+      }
+      return wifiList;
+    } catch (error) {
+      throw new Error(`WiFi scan failed: ${error}`);
+    }
+  }
+
+  /**
+   * Provision device with WiFi credentials
+   * @note Call fetchWifiStatus() after provisioning to check provisioning status
+   * @param ssid - WiFi network SSID
+   * @param passphrase - WiFi network password
+   */
+  async provision(ssid: string, passphrase: string): Promise<void> {
+    if (!this.transportImpl || !this.securityImpl) {
+      throw new Error('Device not connected');
+    }
+
+    try {
+      const configRequest = getConfigUpdateRequest(ssid, passphrase);
+      const configResponse = await this.sendData(PROTO_ENDPOINTS.PROV_CONFIG, configRequest);
+      processConfigUpdateResponse(configResponse);
+
+      const applyRequest = getConfigApplyRequest();
+      const applyResponse = await this.sendData(PROTO_ENDPOINTS.PROV_CONFIG, applyRequest);
+      processConfigApplyResponse(applyResponse);
+    } catch (error) {
+      throw new Error(`Provisioning failed: ${error}`);
+    }
+  }
+
+  /**
+   * Fetch WiFi status from device
+   * @returns WiFi status
+   */
+  async fetchWifiStatus(): Promise<ESPWifiStatus> {
+    if (!this.transportImpl || !this.securityImpl) {
+      throw new Error('Device not connected');
+    }
+
+    try {
+      const statusRequest = getConfigStatusRequest();
+      const statusResponse = await this.sendData(PROTO_ENDPOINTS.PROV_CONFIG, statusRequest);
+      return processConfigStatusResponse(statusResponse);
+    } catch (error) {
+      throw new Error(`Fetching WiFi status failed: ${error}`);
+    }
+  }
+
+  /**
+   * Disconnect from device
+   */
+  disconnect(): void {
+    if (this.transportImpl) {
+      this.transportImpl.disconnect();
+      this.transportImpl = undefined;
+    }
+    this.securityImpl = undefined;
+  }
+
+  /**
+   * Get device
+   */
+  getDevice(): BluetoothDevice | URL {
+    return this.device;
+  }
+
+  /**
+   * Initialize security layer based on security type
+   */
+  private initializeSecurity(security?: ESPSecurityConfig): void {
+    if (!security) {
+      this.securityImpl = new Security0();
+    } else {
+      throw new Error('Unsupported security configuration');
+    }
+  }
+
+  /**
+   * Establish secure session with device
+   */
+  private async establishSession(): Promise<void> {
+    if (!this.transportImpl || !this.securityImpl) {
+      throw new Error('Transport or security not initialized');
+    }
+
+    // Get session setup request
+    const setupRequest = await this.securityImpl.getSessionSetupRequest();
+
+    // Send session setup request
+    const setupResponse = await this.transportImpl.sendData(
+      PROTO_ENDPOINTS.PROV_SESSION,
+      setupRequest
+    );
+
+    // Process session setup response
+    await this.securityImpl.processSessionSetupResponse(setupResponse);
+  }
+
+  /**
+   * Initialize transport layer based on transport type
+   */
+  private async initializeTransport(): Promise<void> {
+    if (this.device instanceof URL) {
+      this.transportImpl = new SoftAPTransport(this.device.toString());
+    } else {  // BluetoothDevice
+      this.transportImpl = new BLETransport(
+        this.device,
+        FALLBACK_SERVICE_UUID,
+        new Map(Object.entries(FALLBACK_NU_LOOKUP))
+      );
+    }
+    await this.transportImpl.connect();
+  }
+
+  /**
+   * Send custom data to device
+   * @param path - Data endpoint path
+   * @param data - Data to send
+   * @returns Response data from device
+   */
+  private async sendData(path: string, data: Uint8Array): Promise<Uint8Array> {
+    if (!this.transportImpl || !this.securityImpl) {
+      throw new Error('Device not connected');
+    }
+
+    // Encrypt data if security is established
+    const encryptedData = await this.securityImpl.encrypt(data);
+    console.debug('Send encrypted data length:', encryptedData.length);
+
+    // Send encrypted data
+    const encryptedResponse = await this.transportImpl.sendData(path, encryptedData);
+
+    // Decrypt response
+    return await this.securityImpl.decrypt(encryptedResponse);
+  }
+}

package/src/ESPProvisionManager.ts

@@ -0,0 +1,78 @@
+import { ESPDevice } from './ESPDevice';
+import { DEFAULT_BLE_DEVICE_OPTIONS } from './constants';
+
+/**
+ * ESP Provision Manager for device discovery
+ */
+export class ESPProvisionManager {
+  /**
+   * Search for ESP devices using BLE
+   * @param devicePrefix - Prefix to filter device names
+   * @param transport - Transport type (only BLE supported for search)
+   * @param security - Security type to use
+   * @returns Promise resolving to array of discovered devices
+   */
+  static async searchBLEDevice(
+    bleDeviceOptions: RequestDeviceOptions = DEFAULT_BLE_DEVICE_OPTIONS,
+  ): Promise<ESPDevice | null> {
+    // Check if Web Bluetooth is available
+    const availability = await ESPProvisionManager.getBluetoothAvailability();
+    if (!availability) {
+      throw new Error('Web Bluetooth is not available.');
+    }
+
+    try {
+      // Request Bluetooth device with filters
+      const device = await navigator.bluetooth.requestDevice(bleDeviceOptions);
+      if (!device.name) {
+        throw new Error('Device name not available');
+      }
+
+      // Create ESPDevice instance
+      return new ESPDevice(device);
+    } catch (error) {
+      if ((error as Error).name === 'NotFoundError') {
+        // User cancelled the device selection
+        return null;
+      }
+      throw new Error(`Device search failed: ${error}`);
+    }
+  }
+
+  /**
+   * Create an ESPDevice instance for SoftAP mode
+   * Note: Browser cannot automatically connect to WiFi.
+   * User must manually connect to the device's access point before using this.
+   *
+   * @param baseURL - Base URL for the SoftAP
+   * @returns ESPDevice instance configured for SoftAP
+   */
+  static createSoftAPDevice(baseURL: URL): ESPDevice {
+    return new ESPDevice(baseURL);
+  }
+
+  /**
+   * Check if Web Bluetooth is supported
+   * @returns true if Web Bluetooth is available
+   */
+  static isBluetoothSupported(): boolean {
+    return typeof navigator !== 'undefined' && 'bluetooth' in navigator;
+  }
+
+  /**
+   * Get Bluetooth availability status
+   * @returns Promise resolving to availability status
+   */
+  static async getBluetoothAvailability(): Promise<boolean> {
+    if (!this.isBluetoothSupported()) {
+      return false;
+    }
+
+    try {
+      return await navigator.bluetooth.getAvailability();
+    } catch (error) {
+      console.error('Failed to get Bluetooth availability:', error);
+      return false;
+    }
+  }
+}