@microbit/microbit-connection 0.9.0-apps.alpha.2 → 0.9.0-apps.alpha.20

package/build/esm/bluetooth/connection.test.js

@@ -0,0 +1,86 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { ConnectionStatus } from "../device.js";
+import { createBluetoothConnection } from "./connection.js";
+import { expect, vi, describe, it } from "vitest";
+// Mock Capacitor
+vi.mock("@capacitor/core", () => ({
+    Capacitor: {
+        isNativePlatform: () => false,
+        getPlatform: () => "web",
+    },
+}));
+// Mock BleClient
+vi.mock("@capacitor-community/bluetooth-le", () => ({
+    BleClient: {
+        initialize: vi.fn().mockResolvedValue(undefined),
+        isEnabled: vi.fn().mockResolvedValue(true),
+        requestDevice: vi.fn(),
+        connect: vi.fn(),
+        disconnect: vi.fn().mockResolvedValue(undefined),
+        getServices: vi.fn().mockResolvedValue([]),
+    },
+}));
+// Mock flashing modules
+vi.mock("./flashing/flashing-partial.js", () => ({
+    default: vi.fn(),
+    PartialFlashResult: { AttemptFullFlash: "AttemptFullFlash" },
+}));
+vi.mock("./flashing/flashing-full.js", () => ({
+    fullFlash: vi.fn(),
+}));
+const setupNavigatorMock = () => {
+    Object.defineProperty(globalThis, "navigator", {
+        value: {
+            bluetooth: {
+                getAvailability: vi.fn().mockResolvedValue(true),
+                addEventListener: vi.fn(),
+                removeEventListener: vi.fn(),
+                requestDevice: vi.fn(),
+            },
+        },
+        writable: true,
+        configurable: true,
+    });
+};
+describe("Bluetooth connection status events", () => {
+    it("emits status events with correct previousStatus", async () => {
+        setupNavigatorMock();
+        const connection = createBluetoothConnection();
+        await connection.initialize();
+        expect(connection.status).toBe(ConnectionStatus.NoAuthorizedDevice);
+        const events = [];
+        connection.addEventListener("status", (e) => {
+            events.push(e);
+        });
+        await connection.disconnect();
+        expect(events).toHaveLength(1);
+        expect(events[0].status).toBe(ConnectionStatus.Disconnected);
+        expect(events[0].previousStatus).toBe(ConnectionStatus.NoAuthorizedDevice);
+    });
+    it("defers status updates during flash, emitting single catch-up event", async () => {
+        setupNavigatorMock();
+        const connection = createBluetoothConnection();
+        await connection.initialize();
+        const statusBeforeFlash = connection.status;
+        expect(statusBeforeFlash).toBe(ConnectionStatus.NoAuthorizedDevice);
+        const events = [];
+        connection.addEventListener("status", (e) => {
+            events.push(e);
+        });
+        // flash() will fail but the finally block still emits a catch-up event
+        try {
+            await connection.flash(async () => "mock-hex-data", {});
+        }
+        catch {
+            // Expected to fail
+        }
+        // Should have exactly one catch-up event with correct previousStatus
+        expect(events).toHaveLength(1);
+        expect(events[0].previousStatus).toBe(statusBeforeFlash);
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/build/esm/bluetooth/connection.test.js.map

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

package/build/esm/bluetooth/device-bond-state.d.ts

@@ -0,0 +1,14 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+export interface DeviceBondState {
+    setBonded(id: string, isBonded: boolean): void;
+    isBonded(id: string): boolean;
+}
+export declare class DefaultDeviceBondState implements DeviceBondState {
+    private bondStates;
+    setBonded(id: string, isBonded: boolean): void;
+    isBonded(id: string): boolean;
+}

package/build/esm/bluetooth/device-bond-state.js

@@ -0,0 +1,22 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+export class DefaultDeviceBondState {
+    constructor() {
+        Object.defineProperty(this, "bondStates", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    setBonded(id, isBonded) {
+        this.bondStates[id] = isBonded;
+    }
+    isBonded(id) {
+        return this.bondStates[id] ?? false;
+    }
+}
+//# sourceMappingURL=device-bond-state.js.map

package/build/esm/bluetooth/device-bond-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-bond-state.js","sourceRoot":"","sources":["../../../src/bluetooth/device-bond-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,OAAO,sBAAsB;IAAnC;QACU;;;;mBAAsC,EAAE;WAAC;IAOnD,CAAC;IANC,SAAS,CAAC,EAAU,EAAE,QAAiB;QACrC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;IACjC,CAAC;IACD,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACtC,CAAC;CACF"}

package/build/esm/{bluetooth-device-wrapper.d.ts → bluetooth/device-wrapper.d.ts}

@@ -4,15 +4,24 @@
  * SPDX-License-Identifier: MIT
  */
 import { BleDevice, TimeoutOptions } from "@capacitor-community/bluetooth-le";
-import { AccelerometerService } from "./accelerometer-service.js";
-import { ButtonService } from "./button-service.js";
-import { DeviceInformationService } from "./device-information-service.js";
-import { BoardVersion } from "./device.js";
-import { LedService } from "./led-service.js";
-import { Logging, LoggingEvent } from "./logging.js";
-import { MagnetometerService } from "./magnetometer-service.js";
-import { ServiceConnectionEventMap, TypedServiceEvent, TypedServiceEventDispatcher } from "./service-events.js";
-import { UARTService } from "./uart-service.js";
+import { AccelerometerService } from "./services/accelerometer-service.js";
+import { ButtonService } from "./services/button-service.js";
+import { DeviceInformationService } from "./services/device-information-service.js";
+import { BoardVersion, ConnectOptions } from "../device.js";
+import { LedService } from "./services/led-service.js";
+import { Logging, LoggingEvent } from "../logging.js";
+import { MagnetometerService } from "./services/magnetometer-service.js";
+import { ServiceConnectionEventMap, TypedServiceEvent, TypedServiceEventDispatcher } from "../service-events.js";
+import { EventService } from "./services/event-service.js";
+import { TemperatureService } from "./services/temperature-service.js";
+import { IoPinService } from "./services/io-pin-service.js";
+import { UARTService } from "./services/uart-service.js";
+import { DeviceBondState } from "./device-bond-state.js";
+/**
+ * The @capacitor-community/bluetooth-le plugin throws this message when
+ * a characteristic UUID is not found in the device's GATT table.
+ */
+export declare const isCharacteristicNotFoundError: (e: unknown) => boolean;
 export declare const bondingTimeoutInMs = 40000;
 export declare const connectTimeoutInMs = 10000;
 export declare const scanningTimeoutInMs = 10000;
@@ -25,24 +34,25 @@ export interface Service {
 }
 interface ConnectCallbacks {
     onConnecting: () => void;
-    onReconnecting: () => void;
-    onFail: () => void;
+    onDisconnect: () => void;
     onSuccess: () => void;
 }
 export declare class BluetoothDeviceWrapper implements Logging {
-    readonly device: BleDevice;
+    readonly bleDevice: BleDevice;
     private logging;
+    private deviceBondState;
     private currentEvents;
     private callbacks;
-    private duringExplicitConnectDisconnect;
-    private connected;
-    private isReconnect;
+    connected: boolean;
     private serviceIds;
     accelerometer: AccelerometerService;
     buttons: ButtonService;
     deviceInformation: DeviceInformationService;
+    events: EventService;
+    ioPin: IoPinService;
     led: LedService;
     magnetometer: MagnetometerService;
+    temperature: TemperatureService;
     uart: UARTService;
     /**
      * Only defined after connection.
@@ -51,13 +61,13 @@ export declare class BluetoothDeviceWrapper implements Logging {
     private services;
     private waitingForDisconnectEventCallbacks;
     private internalNotificationListeners;
-    constructor(device: BleDevice, logging: Logging, dispatchTypedEvent: TypedServiceEventDispatcher, currentEvents: () => Array<keyof ServiceConnectionEventMap>, callbacks: ConnectCallbacks);
-    connect(): Promise<void>;
+    constructor(bleDevice: BleDevice, logging: Logging | undefined, deviceBondState: DeviceBondState | undefined, dispatchTypedEvent: TypedServiceEventDispatcher, currentEvents: () => Array<keyof ServiceConnectionEventMap>, callbacks: ConnectCallbacks);
+    setBonded(isBonded: boolean): void;
+    connect(options?: ConnectOptions): Promise<void>;
     private connectInternal;
     disconnect(): Promise<void>;
     private disconnectInternal;
-    reconnect(): Promise<void>;
-    handleDisconnectEvent: () => Promise<void>;
+    handleDisconnectEvent: () => void;
     getBoardVersion(): Promise<BoardVersion>;
     startNotifications(type: TypedServiceEvent): Promise<void>;
     stopNotifications(type: TypedServiceEvent): Promise<void>;
@@ -93,5 +103,11 @@ export declare class BluetoothDeviceWrapper implements Logging {
      */
     private connectHandlingBond;
     private bondConnectDeviceInternal;
+    /**
+     * On iOS, accessing an encrypted characteristic triggers the pairing dialog.
+     * Try each candidate characteristic in turn until one succeeds. The error is
+     * fast (local GATT cache lookup) so there's no meaningful delay from retries.
+     */
+    private triggerIosPairing;
 }
 export {};