@microbit/microbit-connection 0.0.0-alpha.9 → 0.1.0

package/build/esm/bluetooth.d.ts

@@ -0,0 +1,108 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { AccelerometerData } from "./accelerometer.js";
+import { DeviceConnection } from "./device.js";
+import { LedMatrix } from "./led.js";
+import { Logging } from "./logging.js";
+import { MagnetometerData } from "./magnetometer.js";
+import { ServiceConnectionEventMap } from "./service-events.js";
+export interface MicrobitWebBluetoothConnectionOptions {
+    logging?: Logging;
+}
+export interface MicrobitWebBluetoothConnection extends DeviceConnection<ServiceConnectionEventMap> {
+    /**
+     * Sets micro:bit name filter for device requesting.
+     *
+     * @param name The name of the micro:bit.
+     */
+    setNameFilter(name: string): void;
+    /**
+     * Gets micro:bit accelerometer data.
+     *
+     * @returns accelerometer data or undefined if there is no connection.
+     */
+    getAccelerometerData(): Promise<AccelerometerData | undefined>;
+    /**
+     * Gets micro:bit accelerometer period.
+     *
+     * @returns accelerometer period or undefined if there is no connection.
+     */
+    getAccelerometerPeriod(): Promise<number | undefined>;
+    /**
+     * Sets micro:bit accelerometer period.
+     *
+     * @param value The accelerometer period.
+     */
+    setAccelerometerPeriod(value: number): Promise<void>;
+    /**
+     * Sets micro:bit LED text.
+     *
+     * @param text The text displayed on micro:bit LED.
+     */
+    setLedText(text: string): Promise<void>;
+    /**
+     * Gets micro:bit LED scrolling delay.
+     *
+     * @returns LED scrolling delay in milliseconds.
+     */
+    getLedScrollingDelay(): Promise<number | undefined>;
+    /**
+     * Sets micro:bit LED scrolling delay.
+     *
+     * @param delayInMillis LED scrolling delay in milliseconds.
+     */
+    setLedScrollingDelay(delayInMillis: number): Promise<void>;
+    /**
+     * Gets micro:bit LED matrix.
+     *
+     * @returns a boolean matrix representing the micro:bit LED display.
+     */
+    getLedMatrix(): Promise<LedMatrix | undefined>;
+    /**
+     * Sets micro:bit LED matrix.
+     *
+     * @param matrix an boolean matrix representing the micro:bit LED display.
+     */
+    setLedMatrix(matrix: LedMatrix): Promise<void>;
+    /**
+     * Gets micro:bit magnetometer data.
+     *
+     * @returns magnetometer data.
+     */
+    getMagnetometerData(): Promise<MagnetometerData | undefined>;
+    /**
+     * Gets micro:bit magnetometer bearing.
+     *
+     * @returns magnetometer bearing.
+     */
+    getMagnetometerBearing(): Promise<number | undefined>;
+    /**
+     * Gets micro:bit magnetometer period.
+     *
+     * @returns magnetometer period.
+     */
+    getMagnetometerPeriod(): Promise<number | undefined>;
+    /**
+     * Sets micro:bit magnetometer period.
+     *
+     * @param value magnetometer period.
+     */
+    setMagnetometerPeriod(value: number): Promise<void>;
+    /**
+     * Triggers micro:bit magnetometer calibration.
+     */
+    triggerMagnetometerCalibration(): Promise<void>;
+    /**
+     * Write UART messages.
+     *
+     * @param data UART message.
+     */
+    uartWrite(data: Uint8Array): Promise<void>;
+}
+/**
+ * A Bluetooth connection factory.
+ */
+export declare const createWebBluetoothConnection: (options?: MicrobitWebBluetoothConnectionOptions) => MicrobitWebBluetoothConnection;

package/build/{bluetooth.js → esm/bluetooth.js}

@@ -4,10 +4,14 @@ import { AfterRequestDevice, BeforeRequestDevice, ConnectionStatus, ConnectionSt
 import { TypedEventTarget } from "./events.js";
 import { NullLogging } from "./logging.js";
 const requestDeviceTimeoutDuration = 30000;
+/**
+ * A Bluetooth connection factory.
+ */
+export const createWebBluetoothConnection = (options) => new MicrobitWebBluetoothConnectionImpl(options);
 /**
  * A Bluetooth connection to a micro:bit device.
  */
-export class MicrobitWebBluetoothConnection extends TypedEventTarget {
+class MicrobitWebBluetoothConnectionImpl extends TypedEventTarget {
     constructor(options = {}) {
         super();
         Object.defineProperty(this, "status", {
@@ -38,28 +42,6 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "_addEventListener", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: this.addEventListener
-        });
-        Object.defineProperty(this, "_removeEventListener", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: this.removeEventListener
-        });
-        Object.defineProperty(this, "activeEvents", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {
-                accelerometerdatachanged: false,
-                buttonachanged: false,
-                buttonbchanged: false,
-            }
-        });
         Object.defineProperty(this, "availabilityListener", {
             enumerable: true,
             configurable: true,
@@ -83,14 +65,12 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
             value: void 0
         });
         this.logging = options.logging || new NullLogging();
-        this.addEventListener = (type, ...args) => {
-            this._addEventListener(type, ...args);
-            this.connection?.startNotifications(type);
-        };
-        this.removeEventListener = (type, ...args) => {
-            this.connection?.stopNotifications(type);
-            this._removeEventListener(type, ...args);
-        };
+    }
+    eventActivated(type) {
+        this.connection?.startNotifications(type);
+    }
+    eventDeactivated(type) {
+        this.connection?.stopNotifications(type);
     }
     log(v) {
         this.logging.log(v);
@@ -127,7 +107,7 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
         }
         finally {
             this.connection = undefined;
-            this.setStatus(ConnectionStatus.NOT_CONNECTED);
+            this.setStatus(ConnectionStatus.DISCONNECTED);
             this.logging.log("Disconnection complete");
             this.logging.event({
                 type: "Bluetooth-info",
@@ -155,14 +135,21 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
         if (!this.connection) {
             const device = await this.chooseDevice();
             if (!device) {
+                this.setStatus(ConnectionStatus.NO_AUTHORIZED_DEVICE);
                 return;
             }
-            this.connection = await createBluetoothDeviceWrapper(device, this.logging, this.dispatchTypedEvent.bind(this), this.activeEvents);
+            this.connection = await createBluetoothDeviceWrapper(device, this.logging, this.dispatchTypedEvent.bind(this), () => this.getActiveEvents(), {
+                onConnecting: () => this.setStatus(ConnectionStatus.CONNECTING),
+                onReconnecting: () => this.setStatus(ConnectionStatus.RECONNECTING),
+                onSuccess: () => this.setStatus(ConnectionStatus.CONNECTED),
+                onFail: () => {
+                    this.setStatus(ConnectionStatus.DISCONNECTED);
+                    this.connection = undefined;
+                },
+            });
+            return;
         }
         // TODO: timeout unification?
-        // Connection happens inside createBluetoothDeviceWrapper.
-        // await this.connection?.connect();
-        this.setStatus(ConnectionStatus.CONNECTED);
     }
     setNameFilter(name) {
         this.nameFilter = name;
@@ -183,6 +170,12 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
                                 ? `BBC micro:bit [${this.nameFilter}]`
                                 : "BBC micro:bit",
                         },
+                        {
+                            // See https://github.com/bsiever/microbit-pxt-blehid/issues/31
+                            namePrefix: this.nameFilter
+                                ? `uBit [${this.nameFilter}]`
+                                : "uBit",
+                        },
                     ],
                     optionalServices: [
                         profile.accelerometer.id,
@@ -227,5 +220,49 @@ export class MicrobitWebBluetoothConnection extends TypedEventTarget {
         const accelerometerService = await this.connection?.getAccelerometerService();
         return accelerometerService?.setPeriod(value);
     }
+    async setLedText(text) {
+        const ledService = await this.connection?.getLedService();
+        return ledService?.setText(text);
+    }
+    async getLedScrollingDelay() {
+        const ledService = await this.connection?.getLedService();
+        return ledService?.getScrollingDelay();
+    }
+    async setLedScrollingDelay(delayInMillis) {
+        const ledService = await this.connection?.getLedService();
+        await ledService?.setScrollingDelay(delayInMillis);
+    }
+    async getLedMatrix() {
+        const ledService = await this.connection?.getLedService();
+        return ledService?.getLedMatrix();
+    }
+    async setLedMatrix(matrix) {
+        const ledService = await this.connection?.getLedService();
+        ledService?.setLedMatrix(matrix);
+    }
+    async getMagnetometerData() {
+        const magnetometerService = await this.connection?.getMagnetometerService();
+        return magnetometerService?.getData();
+    }
+    async getMagnetometerPeriod() {
+        const magnetometerService = await this.connection?.getMagnetometerService();
+        return magnetometerService?.getPeriod();
+    }
+    async setMagnetometerPeriod(value) {
+        const magnetometerService = await this.connection?.getMagnetometerService();
+        return magnetometerService?.setPeriod(value);
+    }
+    async getMagnetometerBearing() {
+        const magnetometerService = await this.connection?.getMagnetometerService();
+        return magnetometerService?.getBearing();
+    }
+    async triggerMagnetometerCalibration() {
+        const magnetometerService = await this.connection?.getMagnetometerService();
+        return magnetometerService?.triggerCalibration();
+    }
+    async uartWrite(data) {
+        const uartService = await this.connection?.getUARTService();
+        uartService?.writeData(data);
+    }
 }
 //# sourceMappingURL=bluetooth.js.map

package/build/esm/bluetooth.js.map

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

package/build/esm/board-id.d.ts

@@ -0,0 +1,36 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BoardVersion } from "./device.js";
+/**
+ * Validates micro:bit board IDs.
+ */
+export declare class BoardId {
+    id: number;
+    private static v1Normalized;
+    private static v2Normalized;
+    constructor(id: number);
+    toBoardVersion(): BoardVersion;
+    isV1(): boolean;
+    isV2(): boolean;
+    /**
+     * Return the board ID using the default ID for the board type.
+     * Used to integrate with MicropythonFsHex.
+     */
+    normalize(): BoardId;
+    /**
+     * toString matches the input to parse.
+     *
+     * @returns the ID as a string.
+     */
+    toString(): string;
+    /**
+     * @param value The ID as a hex string with no 0x prefix (e.g. 9900).
+     * @returns the valid board ID
+     * @throws if the ID isn't known.
+     */
+    static parse(value: string): BoardId;
+    static forVersion(boardVersion: BoardVersion): BoardId;
+}

package/build/esm/board-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-id.js","sourceRoot":"","sources":["../../lib/board-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,OAAO,OAAO;IAIlB,YAAmB,EAAU;QAAjB;;;;mBAAO,EAAE;WAAQ;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC;IAClD,CAAC;IAED,IAAI;QACF,OAAO,CACL,IAAI,CAAC,EAAE,KAAK,MAAM;YAClB,IAAI,CAAC,EAAE,KAAK,MAAM;YAClB,IAAI,CAAC,EAAE,KAAK,MAAM;YAClB,IAAI,CAAC,EAAE,KAAK,MAAM,CACnB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,YAA0B;QAC1C,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,IAAI;gBACP,OAAO,IAAI,CAAC,YAAY,CAAC;YAC3B,KAAK,IAAI;gBACP,OAAO,IAAI,CAAC,YAAY,CAAC;QAC7B,CAAC;IACH,CAAC;;AA3Dc;;;;WAAe,IAAI,OAAO,CAAC,MAAM,CAAC;EAAtB,CAAuB;AACnC;;;;WAAe,IAAI,OAAO,CAAC,MAAM,CAAC;EAAtB,CAAuB"}

package/build/esm/board-serial-info.d.ts

@@ -0,0 +1,14 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BoardId } from "./board-id.js";
+export declare class BoardSerialInfo {
+    id: BoardId;
+    familyId: string;
+    hic: string;
+    constructor(id: BoardId, familyId: string, hic: string);
+    static parse(device: USBDevice, log: (msg: string) => void): BoardSerialInfo;
+    eq(other: BoardSerialInfo): boolean;
+}

package/build/esm/board-serial-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-serial-info.js","sourceRoot":"","sources":["../../lib/board-serial-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,OAAO,eAAe;IAC1B,YACS,EAAW,EACX,QAAgB,EAChB,GAAW;QAFlB;;;;mBAAO,EAAE;WAAS;QAClB;;;;mBAAO,QAAQ;WAAQ;QACvB;;;;mBAAO,GAAG;WAAQ;IACjB,CAAC;IACJ,MAAM,CAAC,KAAK,CAAC,MAAiB,EAAE,GAA0B;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,wCAAwC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,EAAE,CAAC,KAAsB;QACvB,OAAO,CACL,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;YACpB,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAChC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CACvB,CAAC;IACJ,CAAC;CACF"}

package/build/esm/button-service.d.ts

@@ -0,0 +1,13 @@
+import { Service } from "./bluetooth-device-wrapper.js";
+import { TypedServiceEvent, TypedServiceEventDispatcher } from "./service-events.js";
+export declare class ButtonService implements Service {
+    private buttonACharacteristic;
+    private buttonBCharacteristic;
+    private dispatchTypedEvent;
+    constructor(buttonACharacteristic: BluetoothRemoteGATTCharacteristic, buttonBCharacteristic: BluetoothRemoteGATTCharacteristic, dispatchTypedEvent: TypedServiceEventDispatcher);
+    static createService(gattServer: BluetoothRemoteGATTServer, dispatcher: TypedServiceEventDispatcher, queueGattOperation: <R>(action: () => Promise<R>) => Promise<R>, listenerInit: boolean): Promise<ButtonService | undefined>;
+    private dataViewToButtonState;
+    startNotifications(type: TypedServiceEvent): Promise<void>;
+    stopNotifications(type: TypedServiceEvent): Promise<void>;
+    private characteristicForEvent;
+}

package/build/esm/button-service.js.map

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

package/build/esm/buttons.d.ts

@@ -0,0 +1,10 @@
+export declare enum ButtonState {
+    NotPressed = 0,
+    ShortPress = 1,
+    LongPress = 2
+}
+export type ButtonEventType = "buttonachanged" | "buttonbchanged";
+export declare class ButtonEvent extends Event {
+    readonly state: ButtonState;
+    constructor(type: ButtonEventType, state: ButtonState);
+}

package/build/esm/buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttons.js","sourceRoot":"","sources":["../../lib/buttons.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,yDAAc,CAAA;IACd,yDAAc,CAAA;IACd,uDAAa,CAAA;AACf,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAID,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YACE,IAAqB,EACL,KAAkB;QAElC,KAAK,CAAC,IAAI,CAAC,CAAC;QAFZ;;;;mBAAgB,KAAK;WAAa;IAGpC,CAAC;CACF"}

package/build/esm/constants.d.ts

@@ -0,0 +1,48 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+export declare const FICR: {
+    CODEPAGESIZE: number;
+    CODESIZE: number;
+    DEVICE_ID_1: number;
+};
+export declare const DapCmd: {
+    DAP_INFO: number;
+    DAP_CONNECT: number;
+    DAP_DISCONNECT: number;
+    DAP_TRANSFER: number;
+    DAP_TRANSFER_BLOCK: number;
+};
+export declare const Csw: {
+    CSW_SIZE: number;
+    CSW_SIZE32: number;
+    CSW_ADDRINC: number;
+    CSW_SADDRINC: number;
+    CSW_DBGSTAT: number;
+    CSW_HPROT: number;
+    CSW_MSTRDBG: number;
+    CSW_RESERVED: number;
+    CSW_VALUE: number;
+};
+export declare const DapVal: {
+    AP_ACC: number;
+    READ: number;
+    WRITE: number;
+};
+export declare const ApReg: {
+    CSW: number;
+    TAR: number;
+    DRW: number;
+};
+export declare const CortexSpecialReg: {
+    DEMCR: number;
+    DEMCR_VC_CORERESET: number;
+    CPUID: number;
+    DHCSR: number;
+    S_RESET_ST: number;
+    NVIC_AIRCR: number;
+    NVIC_AIRCR_VECTKEY: number;
+    NVIC_AIRCR_SYSRESETREQ: number;
+};

package/build/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sGAAsG;AACtG,yGAAyG;AAEzG,sGAAsG;AACtG,kEAAkE;AAClE,0EAA0E;AAE1E,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,YAAY,EAAE,UAAU,GAAG,IAAI;IAC/B,QAAQ,EAAE,UAAU,GAAG,IAAI;IAE3B,WAAW,EAAE,UAAU,GAAG,IAAI;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,kBAAkB,EAAE,IAAI;IACxB,aAAa;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,UAAU;IACvB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY;IAC3B,aAAa;CACd,CAAC;AACF,GAAG,CAAC,SAAS;IACX,GAAG,CAAC,YAAY;QAChB,GAAG,CAAC,WAAW;QACf,GAAG,CAAC,SAAS;QACb,GAAG,CAAC,WAAW;QACf,GAAG,CAAC,YAAY,CAAC;AAEnB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,CAAC,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,IAAI,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,+CAA+C;IAC/C,KAAK,EAAE,UAAU;IACjB,gDAAgD;IAChD,kBAAkB,EAAE,CAAC,IAAI,CAAC;IAE1B,iBAAiB;IACjB,KAAK,EAAE,UAAU;IAEjB,4CAA4C;IAC5C,KAAK,EAAE,UAAU;IACjB,UAAU,EAAE,CAAC,IAAI,EAAE;IAEnB,UAAU,EAAE,UAAU;IACtB,kBAAkB,EAAE,KAAK,IAAI,EAAE;IAC/B,sBAAsB,EAAE,CAAC,IAAI,CAAC;IAE9B,aAAa;CACd,CAAC"}

package/build/esm/device.d.ts

@@ -0,0 +1,181 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { TypedEventTarget, ValueIsEvent } from "./events.js";
+/**
+ * Specific identified error types.
+ *
+ * New members may be added over time.
+ */
+export type DeviceErrorCode = 
+/**
+ * Device not selected, e.g. because the user cancelled the dialog.
+ */
+"no-device-selected"
+/**
+ * Device not found, perhaps because it doesn't have new enough firmware (for V1).
+ */
+ | "update-req"
+/**
+ * Unable to claim the interface, usually because it's in use in another tab/window.
+ */
+ | "clear-connect"
+/**
+ * The device was found to be disconnected.
+ */
+ | "device-disconnected"
+/**
+ * A communication timeout occurred.
+ */
+ | "timeout-error"
+/**
+ * This is the fallback error case suggesting that the user reconnects their device.
+ */
+ | "reconnect-microbit"
+/**
+ * Error occured during serial or bluetooth communication.
+ */
+ | "background-comms-error"
+/**
+ * Bluetooth service is missing on device.
+ */
+ | "service-missing";
+/**
+ * Error type used for all interactions with this module.
+ *
+ * The code indicates the error type and may be suitable for providing
+ * translated error messages.
+ *
+ * The message is the underlying message text and will usually be in
+ * English.
+ */
+export declare class DeviceError extends Error {
+    code: DeviceErrorCode;
+    constructor({ code, message }: {
+        code: DeviceErrorCode;
+        message?: string;
+    });
+}
+/**
+ * Tracks connection status,
+ */
+export declare enum ConnectionStatus {
+    /**
+     * Determining whether the connection type is supported requires
+     * initialize() to complete.
+     */
+    SUPPORT_NOT_KNOWN = "SUPPORT_NOT_KNOWN",
+    /**
+     * Not supported.
+     */
+    NOT_SUPPORTED = "NOT_SUPPORTED",
+    /**
+     * Supported but no device available.
+     *
+     * This will be the case even when a device is physically connected
+     * but has not been connected via the browser security UI.
+     */
+    NO_AUTHORIZED_DEVICE = "NO_AUTHORIZED_DEVICE",
+    /**
+     * Authorized device available but we haven't connected to it.
+     */
+    DISCONNECTED = "DISCONNECTED",
+    /**
+     * Connected.
+     */
+    CONNECTED = "CONNECTED",
+    /**
+     * Connecting.
+     */
+    CONNECTING = "CONNECTING",
+    /**
+     * Reconnecting. When there is unexpected disruption in the connection,
+     * a reconnection is attempted.
+     */
+    RECONNECTING = "RECONNECTING"
+}
+export interface FlashOptions {
+    /**
+     * True to use a partial flash where possible, false to force a full flash.
+     */
+    partial: boolean;
+    /**
+     * A progress callback. Called with undefined when the process is complete or has failed.
+     *
+     * Requesting a partial flash doesn't guarantee one is performed. Partial flashes are avoided
+     * if too many blocks have changed and failed partial flashes are retried as full flashes.
+     * The partial parameter reports the flash type currently in progress.
+     */
+    progress: (percentage: number | undefined, partial: boolean) => void;
+    /**
+     * Smallest possible progress increment to limit callback rate.
+     */
+    minimumProgressIncrement?: number;
+}
+export declare class FlashDataError extends Error {
+}
+export type FlashDataSource = (boardVersion: BoardVersion) => Promise<string | Uint8Array>;
+export type BoardVersion = "V1" | "V2";
+export declare class ConnectionStatusEvent extends Event {
+    readonly status: ConnectionStatus;
+    constructor(status: ConnectionStatus);
+}
+export declare class BeforeRequestDevice extends Event {
+    constructor();
+}
+export declare class AfterRequestDevice extends Event {
+    constructor();
+}
+export declare class BackgroundErrorEvent extends Event {
+    readonly errorMessage: string;
+    constructor(errorMessage: string);
+}
+export declare class DeviceConnectionEventMap {
+    "status": ConnectionStatusEvent;
+    "backgrounderror": BackgroundErrorEvent;
+    "beforerequestdevice": Event;
+    "afterrequestdevice": Event;
+}
+export interface DeviceConnection<M extends ValueIsEvent<M>> extends TypedEventTarget<DeviceConnectionEventMap & M> {
+    status: ConnectionStatus;
+    /**
+     * Initializes the device.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Removes all listeners.
+     */
+    dispose(): void;
+    /**
+     * Connects to a currently paired device or requests pairing.
+     * Throws on error.
+     *
+     * @returns the final connection status.
+     */
+    connect(): Promise<ConnectionStatus>;
+    /**
+     * Get the board version.
+     *
+     * @returns the board version or undefined if there is no connection.
+     */
+    getBoardVersion(): BoardVersion | undefined;
+    /**
+     * Disconnect from the device.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Write serial data to the device.
+     *
+     * Does nothing if there is no connection.
+     *
+     * @param data The data to write.
+     * @returns A promise that resolves when the write is complete.
+     */
+    serialWrite(data: string): Promise<void>;
+    /**
+     * Clear device to enable chooseDevice.
+     */
+    clearDevice(): Promise<void> | void;
+}