@microbit/microbit-connection 0.9.0-apps.alpha.17 → 0.9.0-apps.alpha.19

package/build/esm/bluetooth/services/event-service.js

@@ -0,0 +1,269 @@
+import { BleClient } from "@capacitor-community/bluetooth-le";
+import { profile } from "../profile.js";
+import { mapBleError } from "../ble-error.js";
+import { EventSource, V2Source, } from "../../microbit-events.js";
+const NAMED_EVENTS = [
+    "gesturechanged",
+    "buttonaaction",
+    "buttonbaction",
+    "buttonabaction",
+    "logoaction",
+];
+function isNamedEvent(type) {
+    return NAMED_EVENTS.includes(type);
+}
+export class EventService {
+    constructor(deviceId, dispatchTypedEvent, getBoardVersion) {
+        Object.defineProperty(this, "deviceId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: deviceId
+        });
+        Object.defineProperty(this, "dispatchTypedEvent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dispatchTypedEvent
+        });
+        Object.defineProperty(this, "getBoardVersion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getBoardVersion
+        });
+        Object.defineProperty(this, "uuid", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: profile.event.id
+        });
+        Object.defineProperty(this, "activeEventTypes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        /**
+         * Filters registered via named events (gestures, buttons), keyed as "source:value".
+         * Persists across reconnects so we can replay them.
+         */
+        Object.defineProperty(this, "namedRequirements", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        /**
+         * Filters registered via explicit {@link subscribeToEvent} calls, keyed as "source:value".
+         * Only events matching these are dispatched as `microbitevent`.
+         * Persists across reconnects so we can replay them.
+         */
+        Object.defineProperty(this, "explicitSubscriptions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        /**
+         * Tracks which named event types contributed which filter keys,
+         * so we can clean up when a named event is stopped.
+         */
+        Object.defineProperty(this, "namedEventFilters", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    getRelevantEvents() {
+        return [
+            "gesturechanged",
+            "buttonaaction",
+            "buttonbaction",
+            "buttonabaction",
+            "logoaction",
+            "microbitevent",
+        ];
+    }
+    async startNotifications(type) {
+        if (!this.getRelevantEvents().includes(type)) {
+            return;
+        }
+        this.activeEventTypes.add(type);
+        try {
+            // Always (re-)register the BLE notification. After a reconnect the
+            // previous subscription is gone even though the service instance is
+            // reused, so we cannot skip this.
+            await BleClient.startNotifications(this.deviceId, profile.event.id, profile.event.characteristics.microBitEvent.id, (value) => this.handleNotification(value));
+            if (isNamedEvent(type)) {
+                this.writeRequirementsForNamedEvent(type);
+            }
+            // Replay all filters (handles reconnect case where the micro:bit
+            // has lost its listener registrations).
+            await this.replayAllRequirements();
+        }
+        catch (e) {
+            this.dispatchTypedEvent("backgrounderror", {
+                error: mapBleError(e),
+                event: type,
+            });
+        }
+    }
+    async stopNotifications(type) {
+        if (!this.getRelevantEvents().includes(type)) {
+            return;
+        }
+        this.activeEventTypes.delete(type);
+        // Remove filters contributed by this named event type
+        if (isNamedEvent(type)) {
+            const keys = this.namedEventFilters.get(type) ?? [];
+            for (const key of keys) {
+                this.namedRequirements.delete(key);
+            }
+            this.namedEventFilters.delete(type);
+        }
+        if (this.activeEventTypes.size === 0) {
+            try {
+                await BleClient.stopNotifications(this.deviceId, profile.event.id, profile.event.characteristics.microBitEvent.id);
+            }
+            catch (e) {
+                this.dispatchTypedEvent("backgrounderror", {
+                    error: mapBleError(e),
+                    event: type,
+                });
+            }
+        }
+    }
+    /**
+     * Register interest in a specific micro:bit message bus event.
+     * Tells the micro:bit to forward matching message bus traffic over BLE.
+     * Matching events are dispatched as `microbitevent`.
+     * Use 0 as the value to match all events from a source.
+     */
+    async subscribeToEvent(source, value) {
+        const key = filterKey(source, value);
+        if (!this.explicitSubscriptions.has(key)) {
+            this.explicitSubscriptions.add(key);
+            await this.writeClientRequirement(source, value);
+        }
+    }
+    /**
+     * Send an event to the micro:bit's message bus.
+     */
+    async sendEvent(source, value) {
+        const data = new DataView(new ArrayBuffer(4));
+        data.setUint16(0, source, true);
+        data.setUint16(2, value, true);
+        await BleClient.writeWithoutResponse(this.deviceId, profile.event.id, profile.event.characteristics.clientEvent.id, data);
+    }
+    handleNotification(dataView) {
+        for (let offset = 0; offset + 4 <= dataView.byteLength; offset += 4) {
+            const source = dataView.getUint16(offset, true);
+            const value = dataView.getUint16(offset + 2, true);
+            if (this.activeEventTypes.has("microbitevent") &&
+                this.matchesExplicitSubscription(source, value)) {
+                this.dispatchTypedEvent("microbitevent", { source, value });
+            }
+            this.demuxToNamedEvents(source, value);
+        }
+    }
+    demuxToNamedEvents(source, value) {
+        const src = this.getSourceIds();
+        if (!src)
+            return;
+        if (source === src.Gesture && this.activeEventTypes.has("gesturechanged")) {
+            this.dispatchTypedEvent("gesturechanged", {
+                gesture: value,
+            });
+        }
+        if (source === src.ButtonA && this.activeEventTypes.has("buttonaaction")) {
+            this.dispatchTypedEvent("buttonaaction", {
+                button: "A",
+                action: value,
+            });
+        }
+        if (source === src.ButtonB && this.activeEventTypes.has("buttonbaction")) {
+            this.dispatchTypedEvent("buttonbaction", {
+                button: "B",
+                action: value,
+            });
+        }
+        if (source === src.ButtonAB &&
+            this.activeEventTypes.has("buttonabaction")) {
+            this.dispatchTypedEvent("buttonabaction", {
+                button: "AB",
+                action: value,
+            });
+        }
+        if (source === V2Source.Logo && this.activeEventTypes.has("logoaction")) {
+            this.dispatchTypedEvent("logoaction", {
+                button: "Logo",
+                action: value,
+            });
+        }
+    }
+    writeRequirementsForNamedEvent(type) {
+        const src = this.getSourceIds();
+        if (!src)
+            return;
+        const filters = [];
+        switch (type) {
+            case "gesturechanged":
+                filters.push([src.Gesture, 0]);
+                break;
+            case "buttonaaction":
+                filters.push([src.ButtonA, 0]);
+                break;
+            case "buttonbaction":
+                filters.push([src.ButtonB, 0]);
+                break;
+            case "buttonabaction":
+                filters.push([src.ButtonAB, 0]);
+                break;
+            case "logoaction":
+                filters.push([V2Source.Logo, 0]);
+                break;
+        }
+        const keys = [];
+        for (const [source, value] of filters) {
+            const key = filterKey(source, value);
+            keys.push(key);
+            this.namedRequirements.add(key);
+        }
+        this.namedEventFilters.set(type, keys);
+    }
+    matchesExplicitSubscription(source, value) {
+        if (this.explicitSubscriptions.has(filterKey(source, value)))
+            return true;
+        if (this.explicitSubscriptions.has(filterKey(source, 0)))
+            return true;
+        return false;
+    }
+    async replayAllRequirements() {
+        for (const key of this.namedRequirements) {
+            const [source, value] = key.split(":").map(Number);
+            await this.writeClientRequirement(source, value);
+        }
+        for (const key of this.explicitSubscriptions) {
+            const [source, value] = key.split(":").map(Number);
+            await this.writeClientRequirement(source, value);
+        }
+    }
+    async writeClientRequirement(source, value) {
+        const data = new DataView(new ArrayBuffer(4));
+        data.setUint16(0, source, true);
+        data.setUint16(2, value, true);
+        await BleClient.write(this.deviceId, profile.event.id, profile.event.characteristics.clientRequirements.id, data);
+    }
+    getSourceIds() {
+        const version = this.getBoardVersion();
+        if (!version)
+            return undefined;
+        return version === "V1" ? EventSource.v1 : EventSource.v2;
+    }
+}
+function filterKey(source, value) {
+    return `${source}:${value}`;
+}
+//# sourceMappingURL=event-service.js.map

package/build/esm/bluetooth/services/event-service.js.map

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

package/build/esm/bluetooth/services/event-service.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/esm/bluetooth/services/event-service.test.js

@@ -0,0 +1,250 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { BleClient } from "@capacitor-community/bluetooth-le";
+import { EventService } from "./event-service.js";
+import { V2Source, GestureEvent, ButtonAction } from "../../microbit-events.js";
+vi.mock("@capacitor-community/bluetooth-le", () => ({
+    BleClient: {
+        startNotifications: vi.fn().mockResolvedValue(undefined),
+        stopNotifications: vi.fn().mockResolvedValue(undefined),
+        write: vi.fn().mockResolvedValue(undefined),
+        writeWithoutResponse: vi.fn().mockResolvedValue(undefined),
+    },
+}));
+vi.mock("../ble-error.js", () => ({
+    mapBleError: (e) => e,
+}));
+function makeEvent(source, value) {
+    const data = new DataView(new ArrayBuffer(4));
+    data.setUint16(0, source, true);
+    data.setUint16(2, value, true);
+    return data;
+}
+function makeMultiEvent(...pairs) {
+    const data = new DataView(new ArrayBuffer(pairs.length * 4));
+    pairs.forEach(([source, value], i) => {
+        data.setUint16(i * 4, source, true);
+        data.setUint16(i * 4 + 2, value, true);
+    });
+    return data;
+}
+/** Captures the notification callback passed to BleClient.startNotifications */
+function captureNotificationCallback() {
+    const calls = BleClient.startNotifications.mock.calls;
+    const lastCall = calls[calls.length - 1];
+    return lastCall[3];
+}
+describe("EventService", () => {
+    let service;
+    let dispatch;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        dispatch = vi.fn();
+        service = new EventService("test-device", dispatch, () => "V2");
+    });
+    describe("named events", () => {
+        it("dispatches gesturechanged when listening", async () => {
+            await service.startNotifications("gesturechanged");
+            const notify = captureNotificationCallback();
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            expect(dispatch).toHaveBeenCalledWith("gesturechanged", {
+                gesture: GestureEvent.Shake,
+            });
+        });
+        it("dispatches button actions for A, B, AB", async () => {
+            await service.startNotifications("buttonaaction");
+            await service.startNotifications("buttonbaction");
+            await service.startNotifications("buttonabaction");
+            const notify = captureNotificationCallback();
+            notify(makeEvent(V2Source.ButtonA, ButtonAction.Click));
+            notify(makeEvent(V2Source.ButtonB, ButtonAction.LongClick));
+            notify(makeEvent(V2Source.ButtonAB, ButtonAction.DoubleClick));
+            expect(dispatch).toHaveBeenCalledWith("buttonaaction", {
+                button: "A",
+                action: ButtonAction.Click,
+            });
+            expect(dispatch).toHaveBeenCalledWith("buttonbaction", {
+                button: "B",
+                action: ButtonAction.LongClick,
+            });
+            expect(dispatch).toHaveBeenCalledWith("buttonabaction", {
+                button: "AB",
+                action: ButtonAction.DoubleClick,
+            });
+        });
+        it("dispatches logoaction (V2 only)", async () => {
+            await service.startNotifications("logoaction");
+            const notify = captureNotificationCallback();
+            notify(makeEvent(V2Source.Logo, ButtonAction.Click));
+            expect(dispatch).toHaveBeenCalledWith("logoaction", {
+                button: "Logo",
+                action: ButtonAction.Click,
+            });
+        });
+        it("does not dispatch after stopping a named event", async () => {
+            await service.startNotifications("gesturechanged");
+            const notify = captureNotificationCallback();
+            await service.stopNotifications("gesturechanged");
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            expect(dispatch).not.toHaveBeenCalledWith("gesturechanged", expect.anything());
+        });
+        it("handles multiple events packed in one notification", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("buttonaaction");
+            const notify = captureNotificationCallback();
+            notify(makeMultiEvent([V2Source.Gesture, GestureEvent.FaceUp], [V2Source.ButtonA, ButtonAction.Click]));
+            expect(dispatch).toHaveBeenCalledWith("gesturechanged", {
+                gesture: GestureEvent.FaceUp,
+            });
+            expect(dispatch).toHaveBeenCalledWith("buttonaaction", {
+                button: "A",
+                action: ButtonAction.Click,
+            });
+        });
+    });
+    describe("microbitevent isolation", () => {
+        it("does not dispatch microbitevent for named event traffic", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("microbitevent");
+            const notify = captureNotificationCallback();
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            expect(dispatch).toHaveBeenCalledWith("gesturechanged", {
+                gesture: GestureEvent.Shake,
+            });
+            expect(dispatch).not.toHaveBeenCalledWith("microbitevent", expect.anything());
+        });
+        it("dispatches microbitevent only for explicit subscriptions", async () => {
+            await service.startNotifications("microbitevent");
+            await service.subscribeToEvent(999, 0);
+            const notify = captureNotificationCallback();
+            notify(makeEvent(999, 42));
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: 999,
+                value: 42,
+            });
+        });
+        it("wildcard subscription (value=0) matches all values from that source", async () => {
+            await service.startNotifications("microbitevent");
+            await service.subscribeToEvent(999, 0);
+            const notify = captureNotificationCallback();
+            notify(makeEvent(999, 1));
+            notify(makeEvent(999, 2));
+            notify(makeEvent(888, 1));
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: 999,
+                value: 1,
+            });
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: 999,
+                value: 2,
+            });
+            expect(dispatch).not.toHaveBeenCalledWith("microbitevent", expect.objectContaining({ source: 888 }));
+        });
+        it("exact subscription only matches that specific value", async () => {
+            await service.startNotifications("microbitevent");
+            await service.subscribeToEvent(999, 5);
+            const notify = captureNotificationCallback();
+            notify(makeEvent(999, 5));
+            notify(makeEvent(999, 6));
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: 999,
+                value: 5,
+            });
+            expect(dispatch).not.toHaveBeenCalledWith("microbitevent", expect.objectContaining({ value: 6 }));
+        });
+        it("named events and explicit subscriptions work independently", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("microbitevent");
+            await service.subscribeToEvent(999, 0);
+            const notify = captureNotificationCallback();
+            // Gesture events go to gesturechanged only
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            // Custom events go to microbitevent only
+            notify(makeEvent(999, 42));
+            expect(dispatch).toHaveBeenCalledWith("gesturechanged", {
+                gesture: GestureEvent.Shake,
+            });
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: 999,
+                value: 42,
+            });
+            // Gesture should NOT leak into microbitevent
+            expect(dispatch).not.toHaveBeenCalledWith("microbitevent", expect.objectContaining({ source: V2Source.Gesture }));
+        });
+        it("overlapping named + explicit subscription dispatches both", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("microbitevent");
+            // Explicitly subscribe to the same source as the named event
+            await service.subscribeToEvent(V2Source.Gesture, 0);
+            const notify = captureNotificationCallback();
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            // Both fire — you asked for both
+            expect(dispatch).toHaveBeenCalledWith("gesturechanged", {
+                gesture: GestureEvent.Shake,
+            });
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: V2Source.Gesture,
+                value: GestureEvent.Shake,
+            });
+        });
+        it("stopping named event leaves explicit subscription working", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("microbitevent");
+            await service.subscribeToEvent(V2Source.Gesture, 0);
+            const notify = captureNotificationCallback();
+            await service.stopNotifications("gesturechanged");
+            dispatch.mockClear();
+            notify(makeEvent(V2Source.Gesture, GestureEvent.Shake));
+            // Named event stopped
+            expect(dispatch).not.toHaveBeenCalledWith("gesturechanged", expect.anything());
+            // Explicit subscription still works
+            expect(dispatch).toHaveBeenCalledWith("microbitevent", {
+                source: V2Source.Gesture,
+                value: GestureEvent.Shake,
+            });
+        });
+    });
+    describe("BLE notification lifecycle", () => {
+        it("re-registers BLE notifications on each startNotifications call to handle reconnect", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("buttonaaction");
+            await service.startNotifications("microbitevent");
+            expect(BleClient.startNotifications).toHaveBeenCalledTimes(3);
+        });
+        it("stops BLE notifications only when all event types are stopped", async () => {
+            await service.startNotifications("gesturechanged");
+            await service.startNotifications("buttonaaction");
+            await service.stopNotifications("gesturechanged");
+            expect(BleClient.stopNotifications).not.toHaveBeenCalled();
+            await service.stopNotifications("buttonaaction");
+            expect(BleClient.stopNotifications).toHaveBeenCalledTimes(1);
+        });
+        it("ignores irrelevant event types", async () => {
+            await service.startNotifications("accelerometerdatachanged");
+            expect(BleClient.startNotifications).not.toHaveBeenCalled();
+        });
+    });
+    describe("client requirements", () => {
+        it("writes client requirements for named events", async () => {
+            await service.startNotifications("gesturechanged");
+            expect(BleClient.write).toHaveBeenCalled();
+            const calls = BleClient.write.mock.calls;
+            const data = calls[calls.length - 1][3];
+            expect(data.getUint16(0, true)).toBe(V2Source.Gesture);
+            expect(data.getUint16(2, true)).toBe(0);
+        });
+        it("writes client requirements for explicit subscriptions", async () => {
+            await service.subscribeToEvent(999, 42);
+            expect(BleClient.write).toHaveBeenCalled();
+            const calls = BleClient.write.mock.calls;
+            const data = calls[calls.length - 1][3];
+            expect(data.getUint16(0, true)).toBe(999);
+            expect(data.getUint16(2, true)).toBe(42);
+        });
+        it("does not duplicate explicit subscription writes", async () => {
+            await service.subscribeToEvent(999, 42);
+            await service.subscribeToEvent(999, 42);
+            expect(BleClient.write).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+//# sourceMappingURL=event-service.test.js.map

package/build/esm/bluetooth/services/event-service.test.js.map

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

package/build/esm/bluetooth/services/io-pin-service.d.ts

@@ -0,0 +1,65 @@
+import { Service } from "../device-wrapper.js";
+import { PinValue, TypedServiceEvent, TypedServiceEventDispatcher } from "../../service-events.js";
+export declare class IoPinService implements Service {
+    private deviceId;
+    private dispatchTypedEvent;
+    uuid: string;
+    constructor(deviceId: string, dispatchTypedEvent: TypedServiceEventDispatcher);
+    getRelevantEvents(): TypedServiceEvent[];
+    /**
+     * Gets which pins are configured as analog.
+     * All other pins are digital (the default).
+     *
+     * @returns array of pin numbers (0-18) configured as analog.
+     */
+    getAnalogPins(): Promise<number[]>;
+    /**
+     * Sets which pins are configured as analog.
+     * All other pins become digital (the default).
+     *
+     * @param pins array of pin numbers (0-18) to configure as analog.
+     */
+    setAnalogPins(pins: number[]): Promise<void>;
+    /**
+     * Gets which pins are configured as inputs.
+     * Input pins are monitored by the service and their values reported
+     * via notifications and reads of the pin data characteristic.
+     * All other pins are outputs (the default).
+     *
+     * @returns array of pin numbers (0-18) configured as inputs.
+     */
+    getInputPins(): Promise<number[]>;
+    /**
+     * Sets which pins are configured as inputs.
+     * Input pins are monitored by the service and their values reported
+     * via notifications and reads of the pin data characteristic.
+     * All other pins become outputs (the default).
+     *
+     * @param pins array of pin numbers (0-18) to configure as inputs.
+     */
+    setInputPins(pins: number[]): Promise<void>;
+    /**
+     * Reads pin data for all active input pins.
+     * For digital pins, value is 0 or 1.
+     * For analog pins, value is 0-255 (10-bit analog value >> 2).
+     */
+    readPins(): Promise<PinValue[]>;
+    /**
+     * Writes pin data for output pins.
+     * Only pins configured as outputs (not active inputs) will be affected.
+     * For digital pins, value is 0 or 1.
+     * For analog pins, value 0-255 is scaled to 0-1023 on the device.
+     */
+    writePins(data: PinValue[]): Promise<void>;
+    /**
+     * Sets PWM output on a pin.
+     *
+     * @param pin Pin number (0-18).
+     * @param value Analog value (0-1024).
+     * @param period Period in microseconds.
+     */
+    setPwm(pin: number, value: number, period: number): Promise<void>;
+    startNotifications(type: TypedServiceEvent): Promise<void>;
+    stopNotifications(type: TypedServiceEvent): Promise<void>;
+    private dataViewToPinData;
+}