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

package/build/cjs/constants.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CortexSpecialReg = exports.ApReg = exports.DapVal = exports.Csw = exports.DapCmd = exports.FICR = void 0;
+// https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/dap/constants.ts
+// https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/cortex/constants.ts
+// CRA's build tooling doesn't support const enums so we've converted them to prefixed constants here.
+// If we move this to a separate library then we can replace them.
+// In the meantime we should prune the list below to what we actually use.
+// FICR Registers
+exports.FICR = {
+    CODEPAGESIZE: 0x10000000 | 0x10,
+    CODESIZE: 0x10000000 | 0x14,
+    DEVICE_ID_1: 0x10000000 | 0x64,
+};
+exports.DapCmd = {
+    DAP_INFO: 0x00,
+    DAP_CONNECT: 0x02,
+    DAP_DISCONNECT: 0x03,
+    DAP_TRANSFER: 0x05,
+    DAP_TRANSFER_BLOCK: 0x06,
+    // Many more.
+};
+exports.Csw = {
+    CSW_SIZE: 0x00000007,
+    CSW_SIZE32: 0x00000002,
+    CSW_ADDRINC: 0x00000030,
+    CSW_SADDRINC: 0x00000010,
+    CSW_DBGSTAT: 0x00000040,
+    CSW_HPROT: 0x02000000,
+    CSW_MSTRDBG: 0x20000000,
+    CSW_RESERVED: 0x01000000,
+    CSW_VALUE: -1, // see below
+    // Many more.
+};
+exports.Csw.CSW_VALUE =
+    exports.Csw.CSW_RESERVED |
+        exports.Csw.CSW_MSTRDBG |
+        exports.Csw.CSW_HPROT |
+        exports.Csw.CSW_DBGSTAT |
+        exports.Csw.CSW_SADDRINC;
+exports.DapVal = {
+    AP_ACC: 1 << 0,
+    READ: 1 << 1,
+    WRITE: 0 << 1,
+    // More.
+};
+exports.ApReg = {
+    CSW: 0x00,
+    TAR: 0x04,
+    DRW: 0x0c,
+    // More.
+};
+exports.CortexSpecialReg = {
+    // Debug Exception and Monitor Control Register
+    DEMCR: 0xe000edfc,
+    // DWTENA in armv6 architecture reference manual
+    DEMCR_VC_CORERESET: 1 << 0,
+    // CPUID Register
+    CPUID: 0xe000ed00,
+    // Debug Halting Control and Status Register
+    DHCSR: 0xe000edf0,
+    S_RESET_ST: 1 << 25,
+    NVIC_AIRCR: 0xe000ed0c,
+    NVIC_AIRCR_VECTKEY: 0x5fa << 16,
+    NVIC_AIRCR_SYSRESETREQ: 1 << 2,
+    // Many more.
+};
+//# sourceMappingURL=constants.js.map

package/build/cjs/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;AACJ,QAAA,IAAI,GAAG;IAClB,YAAY,EAAE,UAAU,GAAG,IAAI;IAC/B,QAAQ,EAAE,UAAU,GAAG,IAAI;IAE3B,WAAW,EAAE,UAAU,GAAG,IAAI;CAC/B,CAAC;AAEW,QAAA,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;AAEW,QAAA,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,WAAG,CAAC,SAAS;IACX,WAAG,CAAC,YAAY;QAChB,WAAG,CAAC,WAAW;QACf,WAAG,CAAC,SAAS;QACb,WAAG,CAAC,WAAW;QACf,WAAG,CAAC,YAAY,CAAC;AAEN,QAAA,MAAM,GAAG;IACpB,MAAM,EAAE,CAAC,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,IAAI,CAAC;IACZ,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,QAAQ;CACT,CAAC;AAEW,QAAA,KAAK,GAAG;IACnB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ;CACT,CAAC;AAEW,QAAA,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/{device.d.ts → cjs/device.d.ts}

@@ -3,7 +3,7 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { TypedEventTarget } from "./events.js";
+import { TypedEventTarget, ValueIsEvent } from "./events.js";
 /**
  * Specific identified error types.
  *
@@ -81,11 +81,38 @@ export declare enum ConnectionStatus {
     /**
      * Authorized device available but we haven't connected to it.
      */
-    NOT_CONNECTED = "NOT_CONNECTED",
+    DISCONNECTED = "DISCONNECTED",
     /**
      * Connected.
      */
-    CONNECTED = "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 {
 }
@@ -95,20 +122,6 @@ export declare class ConnectionStatusEvent extends Event {
     readonly status: ConnectionStatus;
     constructor(status: ConnectionStatus);
 }
-export declare class SerialDataEvent extends Event {
-    readonly data: string;
-    constructor(data: string);
-}
-export declare class SerialResetEvent extends Event {
-    constructor();
-}
-export declare class SerialErrorEvent extends Event {
-    readonly error: unknown;
-    constructor(error: unknown);
-}
-export declare class FlashEvent extends Event {
-    constructor();
-}
 export declare class BeforeRequestDevice extends Event {
     constructor();
 }
@@ -121,15 +134,11 @@ export declare class BackgroundErrorEvent extends Event {
 }
 export declare class DeviceConnectionEventMap {
     "status": ConnectionStatusEvent;
-    "serialdata": SerialDataEvent;
-    "serialreset": Event;
-    "serialerror": Event;
-    "flash": Event;
+    "backgrounderror": BackgroundErrorEvent;
     "beforerequestdevice": Event;
     "afterrequestdevice": Event;
-    "backgrounderror": BackgroundErrorEvent;
 }
-export interface DeviceConnection extends TypedEventTarget<DeviceConnectionEventMap> {
+export interface DeviceConnection<M extends ValueIsEvent<M>> extends TypedEventTarget<DeviceConnectionEventMap & M> {
     status: ConnectionStatus;
     /**
      * Initializes the device.
@@ -149,29 +158,9 @@ export interface DeviceConnection extends TypedEventTarget<DeviceConnectionEvent
     /**
      * Get the board version.
      *
-     * @returns the board version or null if there is no connection.
+     * @returns the board version or undefined if there is no connection.
      */
     getBoardVersion(): BoardVersion | undefined;
-    /**
-     * Flash the micro:bit.
-     *
-     * @param dataSource The data to use.
-     * @param options Flash options and progress callback.
-     */
-    flash?(dataSource: FlashDataSource, options: {
-        /**
-         * 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;
-    }): Promise<void>;
     /**
      * Disconnect from the device.
      */
@@ -179,7 +168,7 @@ export interface DeviceConnection extends TypedEventTarget<DeviceConnectionEvent
     /**
      * Write serial data to the device.
      *
-     * Does nothting if there is no connection.
+     * Does nothing if there is no connection.
      *
      * @param data The data to write.
      * @returns A promise that resolves when the write is complete.
@@ -188,5 +177,5 @@ export interface DeviceConnection extends TypedEventTarget<DeviceConnectionEvent
     /**
      * Clear device to enable chooseDevice.
      */
-    clearDevice(): void;
+    clearDevice(): Promise<void> | void;
 }

package/build/cjs/device.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceConnectionEventMap = exports.BackgroundErrorEvent = exports.AfterRequestDevice = exports.BeforeRequestDevice = exports.ConnectionStatusEvent = exports.FlashDataError = exports.ConnectionStatus = exports.DeviceError = void 0;
+/**
+ * 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.
+ */
+class DeviceError extends Error {
+    constructor({ code, message }) {
+        super(message);
+        Object.defineProperty(this, "code", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.code = code;
+    }
+}
+exports.DeviceError = DeviceError;
+/**
+ * Tracks connection status,
+ */
+var ConnectionStatus;
+(function (ConnectionStatus) {
+    /**
+     * Determining whether the connection type is supported requires
+     * initialize() to complete.
+     */
+    ConnectionStatus["SUPPORT_NOT_KNOWN"] = "SUPPORT_NOT_KNOWN";
+    /**
+     * Not supported.
+     */
+    ConnectionStatus["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.
+     */
+    ConnectionStatus["NO_AUTHORIZED_DEVICE"] = "NO_AUTHORIZED_DEVICE";
+    /**
+     * Authorized device available but we haven't connected to it.
+     */
+    ConnectionStatus["DISCONNECTED"] = "DISCONNECTED";
+    /**
+     * Connected.
+     */
+    ConnectionStatus["CONNECTED"] = "CONNECTED";
+    /**
+     * Connecting.
+     */
+    ConnectionStatus["CONNECTING"] = "CONNECTING";
+    /**
+     * Reconnecting. When there is unexpected disruption in the connection,
+     * a reconnection is attempted.
+     */
+    ConnectionStatus["RECONNECTING"] = "RECONNECTING";
+})(ConnectionStatus || (exports.ConnectionStatus = ConnectionStatus = {}));
+class FlashDataError extends Error {
+}
+exports.FlashDataError = FlashDataError;
+class ConnectionStatusEvent extends Event {
+    constructor(status) {
+        super("status");
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: status
+        });
+    }
+}
+exports.ConnectionStatusEvent = ConnectionStatusEvent;
+class BeforeRequestDevice extends Event {
+    constructor() {
+        super("beforerequestdevice");
+    }
+}
+exports.BeforeRequestDevice = BeforeRequestDevice;
+class AfterRequestDevice extends Event {
+    constructor() {
+        super("afterrequestdevice");
+    }
+}
+exports.AfterRequestDevice = AfterRequestDevice;
+class BackgroundErrorEvent extends Event {
+    constructor(errorMessage) {
+        super("backgrounderror");
+        Object.defineProperty(this, "errorMessage", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: errorMessage
+        });
+    }
+}
+exports.BackgroundErrorEvent = BackgroundErrorEvent;
+class DeviceConnectionEventMap {
+    constructor() {
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "backgrounderror", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "beforerequestdevice", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "afterrequestdevice", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+}
+exports.DeviceConnectionEventMap = DeviceConnectionEventMap;
+//# sourceMappingURL=device.js.map

package/build/cjs/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../lib/device.ts"],"names":[],"mappings":";;;AA8CA;;;;;;;;GAQG;AACH,MAAa,WAAY,SAAQ,KAAK;IAEpC,YAAY,EAAE,IAAI,EAAE,OAAO,EAA+C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QAFjB;;;;;WAAsB;QAGpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAND,kCAMC;AAED;;GAEG;AACH,IAAY,gBAkCX;AAlCD,WAAY,gBAAgB;IAC1B;;;OAGG;IACH,2DAAuC,CAAA;IACvC;;OAEG;IACH,mDAA+B,CAAA;IAC/B;;;;;OAKG;IACH,iEAA6C,CAAA;IAC7C;;OAEG;IACH,iDAA6B,CAAA;IAC7B;;OAEG;IACH,2CAAuB,CAAA;IACvB;;OAEG;IACH,6CAAyB,CAAA;IACzB;;;OAGG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EAlCW,gBAAgB,gCAAhB,gBAAgB,QAkC3B;AAqBD,MAAa,cAAe,SAAQ,KAAK;CAAG;AAA5C,wCAA4C;AAQ5C,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAA4B,MAAwB;QAClD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADN;;;;mBAAgB,MAAM;WAAkB;IAEpD,CAAC;CACF;AAJD,sDAIC;AAED,MAAa,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC/B,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9B,CAAC;CACF;AAJD,gDAIC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAA4B,YAAoB;QAC9C,KAAK,CAAC,iBAAiB,CAAC,CAAC;QADf;;;;mBAAgB,YAAY;WAAQ;IAEhD,CAAC;CACF;AAJD,oDAIC;AAED,MAAa,wBAAwB;IAArC;QACE,4BAAA,QAAQ;;;;;WAAwB;QAChC,4BAAA,iBAAiB;;;;;WAAuB;QACxC,4BAAA,qBAAqB;;;;;WAAQ;QAC7B,4BAAA,oBAAoB;;;;;WAAQ;IAC9B,CAAC;CAAA;AALD,4DAKC"}

package/build/{events.d.ts → cjs/events.d.ts}

@@ -32,7 +32,7 @@ export interface TypedEventListenerObject<M, T extends keyof M> {
  * @template T The type of event to listen for (has to be keyof `M`).
  */
 export type TypedEventListenerOrEventListenerObject<M, T extends keyof M> = TypedEventListener<M, T> | TypedEventListenerObject<M, T>;
-type ValueIsEvent<T> = {
+export type ValueIsEvent<T> = {
     [key in keyof T]: Event;
 };
 /**
@@ -90,7 +90,17 @@ export interface TypedEventTarget<M extends ValueIsEvent<M>> {
      */
     dispatchEvent: (event: Event) => boolean;
 }
-export declare class TypedEventTarget<M extends ValueIsEvent<M>> extends EventTarget {
+export declare class TrackingEventTarget extends EventTarget {
+    private activeEventTracking;
+    addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
+    removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void;
+    dispatchEvent(event: Event): boolean;
+    private filterRegistrations;
+    protected eventActivated(type: string): void;
+    protected eventDeactivated(type: string): void;
+    protected getActiveEvents(): string[];
+}
+export declare class TypedEventTarget<M extends ValueIsEvent<M>> extends TrackingEventTarget {
     /**
      * Dispatches a synthetic event event to target and returns true if either
      * event's cancelable attribute value is false or its preventDefault() method
@@ -98,4 +108,3 @@ export declare class TypedEventTarget<M extends ValueIsEvent<M>> extends EventTa
      */
     dispatchTypedEvent<T extends keyof M>(_type: T, event: M[T]): boolean;
 }
-export {};

package/build/cjs/events.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Copyright (c) 2022 Jonas "DerZade" Schade
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * https://github.com/DerZade/typescript-event-target/blob/master/src/TypedEventTarget.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedEventTarget = exports.TrackingEventTarget = void 0;
+// We've added this in to keep track of what events are active.
+// Having done this it's questionable whether it's worth the reimplementation
+// just to use an EventTarget API.
+class TrackingEventTarget extends EventTarget {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "activeEventTracking", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    addEventListener(type, callback, options) {
+        if (callback !== null) {
+            const registrations = this.activeEventTracking.get(type) ?? [];
+            const wasEmpty = registrations.length === 0;
+            const registration = new Registration(callback, options ?? false);
+            if (!registrations.find((r) => r.eq(registration))) {
+                registrations.push(registration);
+                this.activeEventTracking.set(type, registrations);
+                if (wasEmpty) {
+                    this.eventActivated(type);
+                }
+            }
+        }
+        super.addEventListener(type, callback, options);
+    }
+    removeEventListener(type, callback, options) {
+        if (callback !== null) {
+            const registration = new Registration(callback, options ?? false);
+            this.filterRegistrations(type, (r) => !r.eq(registration));
+        }
+        super.removeEventListener(type, callback, options);
+    }
+    dispatchEvent(event) {
+        const result = super.dispatchEvent(event);
+        this.filterRegistrations(event.type, (r) => !r.isOnce());
+        return result;
+    }
+    filterRegistrations(type, predicate) {
+        let registrations = this.activeEventTracking.get(type) ?? [];
+        registrations = registrations.filter(predicate);
+        if (registrations.length === 0) {
+            this.activeEventTracking.delete(type);
+            this.eventDeactivated(type);
+        }
+        else {
+            this.activeEventTracking.set(type, registrations);
+        }
+    }
+    eventActivated(type) { }
+    eventDeactivated(type) { }
+    getActiveEvents() {
+        return [...this.activeEventTracking.keys()];
+    }
+}
+exports.TrackingEventTarget = TrackingEventTarget;
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+class TypedEventTarget extends TrackingEventTarget {
+    /**
+     * Dispatches a synthetic event event to target and returns true if either
+     * event's cancelable attribute value is false or its preventDefault() method
+     * was not invoked, and false otherwise.
+     */
+    dispatchTypedEvent(_type, event) {
+        return super.dispatchEvent(event);
+    }
+}
+exports.TypedEventTarget = TypedEventTarget;
+class Registration {
+    constructor(callback, options) {
+        Object.defineProperty(this, "callback", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: callback
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: options
+        });
+    }
+    isOnce() {
+        return typeof this.options === "object" && this.options.once === true;
+    }
+    eq(other) {
+        return (other.callback === this.callback &&
+            eqUseCapture(this.options, other.options));
+    }
+}
+const eqUseCapture = (left, right) => {
+    const leftValue = typeof left === "boolean" ? left : left.capture ?? false;
+    const rightValue = typeof right === "boolean" ? right : right.capture ?? false;
+    return leftValue === rightValue;
+};
+//# sourceMappingURL=events.js.map

package/build/cjs/events.js.map

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

package/build/cjs/hex-flash-data-source.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniversalHexFlashDataSource = void 0;
+const board_id_js_1 = require("./board-id.js");
+const device_js_1 = require("./device.js");
+const microbit_universal_hex_1 = require("@microbit/microbit-universal-hex");
+/**
+ * A flash data source that converts universal hex files as needed.
+ *
+ * @param universalHex A hex file, potentially universal.
+ */
+const createUniversalHexFlashDataSource = (universalHex) => {
+    return (boardVersion) => {
+        if ((0, microbit_universal_hex_1.isUniversalHex)(universalHex)) {
+            const parts = (0, microbit_universal_hex_1.separateUniversalHex)(universalHex);
+            const matching = parts.find((p) => p.boardId == board_id_js_1.BoardId.forVersion(boardVersion).id);
+            if (!matching) {
+                throw new device_js_1.FlashDataError("No matching part");
+            }
+            return Promise.resolve(matching.hex);
+        }
+        return Promise.resolve(universalHex);
+    };
+};
+exports.createUniversalHexFlashDataSource = createUniversalHexFlashDataSource;
+//# sourceMappingURL=hex-flash-data-source.js.map

package/build/cjs/hex-flash-data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-flash-data-source.js","sourceRoot":"","sources":["../../lib/hex-flash-data-source.ts"],"names":[],"mappings":";;;AAAA,+CAAwC;AACxC,2CAIqB;AACrB,6EAG0C;AAE1C;;;;GAIG;AACI,MAAM,iCAAiC,GAAG,CAC/C,YAAoB,EACH,EAAE;IACnB,OAAO,CAAC,YAA0B,EAAE,EAAE;QACpC,IAAI,IAAA,uCAAc,EAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAA,6CAAoB,EAAC,YAAY,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,qBAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CACxD,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,0BAAc,CAAC,kBAAkB,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,iCAAiC,qCAgB5C"}

package/build/cjs/index.d.ts

@@ -0,0 +1,17 @@
+import { AccelerometerData, AccelerometerDataEvent } from "./accelerometer.js";
+import { createWebBluetoothConnection, MicrobitWebBluetoothConnection, MicrobitWebBluetoothConnectionOptions } from "./bluetooth.js";
+import { BoardId } from "./board-id.js";
+import { ButtonEvent, ButtonEventType, ButtonState } from "./buttons.js";
+import { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, BoardVersion, ConnectionStatus, ConnectionStatusEvent, DeviceConnection, DeviceConnectionEventMap, DeviceError, DeviceErrorCode, FlashDataError, FlashDataSource, FlashOptions } from "./device.js";
+import { TypedEventTarget } from "./events.js";
+import { createUniversalHexFlashDataSource } from "./hex-flash-data-source.js";
+import { LedMatrix } from "./led.js";
+import { Logging, LoggingEvent } from "./logging.js";
+import { MagnetometerData, MagnetometerDataEvent } from "./magnetometer.js";
+import { FlashEvent, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent } from "./serial-events.js";
+import { ServiceConnectionEventMap } from "./service-events.js";
+import { UARTDataEvent } from "./uart.js";
+import { createRadioBridgeConnection, MicrobitRadioBridgeConnection, MicrobitRadioBridgeConnectionOptions } from "./usb-radio-bridge.js";
+import { createWebUSBConnection, DeviceSelectionMode, MicrobitWebUSBConnection, MicrobitWebUSBConnectionOptions } from "./usb.js";
+export { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, BoardId, ConnectionStatus, ConnectionStatusEvent, createRadioBridgeConnection, createUniversalHexFlashDataSource, createWebBluetoothConnection, createWebUSBConnection, DeviceConnectionEventMap, DeviceSelectionMode, DeviceError, FlashDataError, FlashEvent, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent, ServiceConnectionEventMap, TypedEventTarget, UARTDataEvent, };
+export type { AccelerometerData, AccelerometerDataEvent, BoardVersion, ButtonEvent, ButtonEventType, ButtonState, DeviceConnection, DeviceErrorCode, FlashDataSource, FlashOptions, LedMatrix, Logging, LoggingEvent, MagnetometerData, MagnetometerDataEvent, MicrobitRadioBridgeConnection, MicrobitRadioBridgeConnectionOptions, MicrobitWebBluetoothConnection, MicrobitWebBluetoothConnectionOptions, MicrobitWebUSBConnection, MicrobitWebUSBConnectionOptions, };

package/build/cjs/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UARTDataEvent = exports.TypedEventTarget = exports.ServiceConnectionEventMap = exports.SerialResetEvent = exports.SerialErrorEvent = exports.SerialDataEvent = exports.SerialConnectionEventMap = exports.FlashEvent = exports.FlashDataError = exports.DeviceError = exports.DeviceSelectionMode = exports.DeviceConnectionEventMap = exports.createWebUSBConnection = exports.createWebBluetoothConnection = exports.createUniversalHexFlashDataSource = exports.createRadioBridgeConnection = exports.ConnectionStatusEvent = exports.ConnectionStatus = exports.BoardId = exports.BeforeRequestDevice = exports.BackgroundErrorEvent = exports.AfterRequestDevice = void 0;
+const bluetooth_js_1 = require("./bluetooth.js");
+Object.defineProperty(exports, "createWebBluetoothConnection", { enumerable: true, get: function () { return bluetooth_js_1.createWebBluetoothConnection; } });
+const board_id_js_1 = require("./board-id.js");
+Object.defineProperty(exports, "BoardId", { enumerable: true, get: function () { return board_id_js_1.BoardId; } });
+const device_js_1 = require("./device.js");
+Object.defineProperty(exports, "AfterRequestDevice", { enumerable: true, get: function () { return device_js_1.AfterRequestDevice; } });
+Object.defineProperty(exports, "BackgroundErrorEvent", { enumerable: true, get: function () { return device_js_1.BackgroundErrorEvent; } });
+Object.defineProperty(exports, "BeforeRequestDevice", { enumerable: true, get: function () { return device_js_1.BeforeRequestDevice; } });
+Object.defineProperty(exports, "ConnectionStatus", { enumerable: true, get: function () { return device_js_1.ConnectionStatus; } });
+Object.defineProperty(exports, "ConnectionStatusEvent", { enumerable: true, get: function () { return device_js_1.ConnectionStatusEvent; } });
+Object.defineProperty(exports, "DeviceConnectionEventMap", { enumerable: true, get: function () { return device_js_1.DeviceConnectionEventMap; } });
+Object.defineProperty(exports, "DeviceError", { enumerable: true, get: function () { return device_js_1.DeviceError; } });
+Object.defineProperty(exports, "FlashDataError", { enumerable: true, get: function () { return device_js_1.FlashDataError; } });
+const events_js_1 = require("./events.js");
+Object.defineProperty(exports, "TypedEventTarget", { enumerable: true, get: function () { return events_js_1.TypedEventTarget; } });
+const hex_flash_data_source_js_1 = require("./hex-flash-data-source.js");
+Object.defineProperty(exports, "createUniversalHexFlashDataSource", { enumerable: true, get: function () { return hex_flash_data_source_js_1.createUniversalHexFlashDataSource; } });
+const serial_events_js_1 = require("./serial-events.js");
+Object.defineProperty(exports, "FlashEvent", { enumerable: true, get: function () { return serial_events_js_1.FlashEvent; } });
+Object.defineProperty(exports, "SerialConnectionEventMap", { enumerable: true, get: function () { return serial_events_js_1.SerialConnectionEventMap; } });
+Object.defineProperty(exports, "SerialDataEvent", { enumerable: true, get: function () { return serial_events_js_1.SerialDataEvent; } });
+Object.defineProperty(exports, "SerialErrorEvent", { enumerable: true, get: function () { return serial_events_js_1.SerialErrorEvent; } });
+Object.defineProperty(exports, "SerialResetEvent", { enumerable: true, get: function () { return serial_events_js_1.SerialResetEvent; } });
+const service_events_js_1 = require("./service-events.js");
+Object.defineProperty(exports, "ServiceConnectionEventMap", { enumerable: true, get: function () { return service_events_js_1.ServiceConnectionEventMap; } });
+const uart_js_1 = require("./uart.js");
+Object.defineProperty(exports, "UARTDataEvent", { enumerable: true, get: function () { return uart_js_1.UARTDataEvent; } });
+const usb_radio_bridge_js_1 = require("./usb-radio-bridge.js");
+Object.defineProperty(exports, "createRadioBridgeConnection", { enumerable: true, get: function () { return usb_radio_bridge_js_1.createRadioBridgeConnection; } });
+const usb_js_1 = require("./usb.js");
+Object.defineProperty(exports, "createWebUSBConnection", { enumerable: true, get: function () { return usb_js_1.createWebUSBConnection; } });
+Object.defineProperty(exports, "DeviceSelectionMode", { enumerable: true, get: function () { return usb_js_1.DeviceSelectionMode; } });
+//# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;AACA,iDAIwB;AAqDtB,6GAxDA,2CAA4B,OAwDA;AApD9B,+CAAwC;AA+CtC,wFA/CO,qBAAO,OA+CP;AA7CT,2CAcqB;AA4BnB,mGAzCA,8BAAkB,OAyCA;AAClB,qGAzCA,gCAAoB,OAyCA;AACpB,oGAzCA,+BAAmB,OAyCA;AAEnB,iGAzCA,4BAAgB,OAyCA;AAChB,sGAzCA,iCAAqB,OAyCA;AAKrB,yGA5CA,oCAAwB,OA4CA;AAExB,4FA7CA,uBAAW,OA6CA;AACX,+FA5CA,0BAAc,OA4CA;AAxChB,2CAA+C;AA+C7C,iGA/CO,4BAAgB,OA+CP;AA9ClB,yEAA+E;AAiC7E,kHAjCO,4DAAiC,OAiCP;AA7BnC,yDAM4B;AA8B1B,2FAnCA,6BAAU,OAmCA;AACV,yGAnCA,2CAAwB,OAmCA;AACxB,gGAnCA,kCAAe,OAmCA;AACf,iGAnCA,mCAAgB,OAmCA;AAChB,iGAnCA,mCAAgB,OAmCA;AAjClB,2DAAgE;AAkC9D,0GAlCO,6CAAyB,OAkCP;AAjC3B,uCAA0C;AAmCxC,8FAnCO,uBAAa,OAmCP;AAlCf,+DAI+B;AAe7B,4GAlBA,iDAA2B,OAkBA;AAd7B,qCAKkB;AAYhB,uGAhBA,+BAAsB,OAgBA;AAEtB,oGAjBA,4BAAmB,OAiBA"}

package/build/cjs/led-service.d.ts

@@ -0,0 +1,20 @@
+import { Service } from "./bluetooth-device-wrapper.js";
+import { LedMatrix } from "./led.js";
+import { TypedServiceEvent, TypedServiceEventDispatcher } from "./service-events.js";
+export declare class LedService implements Service {
+    private matrixStateCharacteristic;
+    private scrollingDelayCharacteristic;
+    private textCharactertistic;
+    private queueGattOperation;
+    constructor(matrixStateCharacteristic: BluetoothRemoteGATTCharacteristic, scrollingDelayCharacteristic: BluetoothRemoteGATTCharacteristic, textCharactertistic: BluetoothRemoteGATTCharacteristic, queueGattOperation: <R>(action: () => Promise<R>) => Promise<R>);
+    static createService(gattServer: BluetoothRemoteGATTServer, dispatcher: TypedServiceEventDispatcher, queueGattOperation: <R>(action: () => Promise<R>) => Promise<R>, listenerInit: boolean): Promise<LedService | undefined>;
+    getLedMatrix(): Promise<LedMatrix>;
+    setLedMatrix(value: LedMatrix): Promise<void>;
+    private dataViewToLedMatrix;
+    private ledMatrixToDataView;
+    setText(text: string): Promise<void>;
+    setScrollingDelay(value: number): Promise<void>;
+    getScrollingDelay(): Promise<number>;
+    startNotifications(type: TypedServiceEvent): Promise<void>;
+    stopNotifications(type: TypedServiceEvent): Promise<void>;
+}