@hangtime/grip-connect 0.12.0 → 0.13.1

package/dist/cjs/interfaces/nordic.interface.d.ts

@@ -0,0 +1,47 @@
+import type { IDevice } from "./device.interface.js";
+/**
+ * Shared Nordic Secure DFU functionality for devices that expose the FE59 DFU service.
+ */
+export interface INordicDfuDevice extends IDevice {
+    /**
+     * Switches the device from application mode into the Nordic DFU bootloader.
+     */
+    dfuSwitch(): Promise<void>;
+    /**
+     * Sends a raw Nordic Secure DFU control operation and resolves with the response payload bytes.
+     * Call after dfuSwitch() has reconnected to the DFU bootloader.
+     */
+    dfuControl(operation: Uint8Array, payload?: ArrayBuffer): Promise<Uint8Array>;
+    /**
+     * Sends Nordic Secure DFU SELECT for command or data objects and returns the bootloader state.
+     */
+    dfuSelect(objectType: "command" | "data"): Promise<{
+        maxSize: number;
+        offset: number;
+        crc: number;
+    }>;
+    /**
+     * Sends Nordic Secure DFU CREATE for command or data objects.
+     */
+    dfuCreate(objectType: "command" | "data", size: number): Promise<void>;
+    /**
+     * Writes raw bytes to the Nordic Secure DFU packet characteristic.
+     */
+    dfuWritePacket(data: Uint8Array | ArrayBuffer): Promise<void>;
+    /**
+     * Sends Nordic Secure DFU CALCULATE_CHECKSUM and returns the bootloader state.
+     */
+    dfuChecksum(): Promise<{
+        offset: number;
+        crc: number;
+    }>;
+    /**
+     * Sends Nordic Secure DFU EXECUTE for the currently created object.
+     */
+    dfuExecute(): Promise<void>;
+    /**
+     * Runs a complete Nordic Secure DFU upload: switch to bootloader, send init packet, then send firmware.
+     */
+    dfuUpload(initPacket: Uint8Array | ArrayBuffer, firmware: Uint8Array | ArrayBuffer): Promise<void>;
+}
+//# sourceMappingURL=nordic.interface.d.ts.map

package/dist/cjs/interfaces/nordic.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nordic.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/nordic.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1B;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAE7E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEpG;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtE;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7D;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEvD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnG"}

package/dist/cjs/interfaces/nordic.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=nordic.interface.js.map

package/dist/cjs/interfaces/nordic.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nordic.interface.js","sourceRoot":"","sources":["../../../src/interfaces/nordic.interface.ts"],"names":[],"mappings":""}

package/dist/cjs/models/device/{kilterboard.model.d.ts → aurora.model.d.ts}

@@ -1,16 +1,15 @@
 import { Device } from "../device.model.js";
-import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface.js";
+import type { AuroraLedPlacement, IAurora } from "../../interfaces/device/aurora.interface.js";
 /**
  * For API level 2 and API level 3.
  * The first byte in the data is dependent on where the packet is in the message as a whole.
- * More details: https://github.com/1-max-1/fake_kilter_board
  */
-export declare enum KilterBoardPacket {
+export declare enum AuroraPacket {
     /** If this packet is in the middle, the byte gets set to 77 (M). */
     V2_MIDDLE = 77,
     /** If this packet is the first packet in the message, then this byte gets set to 78 (N). */
     V2_FIRST = 78,
-    /** If this is the last packet in the message, this byte gets set to 79 (0). */
+    /** If this is the last packet in the message, this byte gets set to 79 (O). */
     V2_LAST = 79,
     /** If this packet is the only packet in the message, the byte gets set to 80 (P). Note that this takes priority over the other conditions. */
     V2_ONLY = 80,
@@ -23,27 +22,15 @@ export declare enum KilterBoardPacket {
     /** If this packet is the only packet in the message, the byte gets set to 84 (T). Note that this takes priority over the other conditions. */
     V3_ONLY = 84
 }
-/**
- * Extracted from placement_roles database table.
- */
-export declare const KilterBoardPlacementRoles: {
-    id: number;
-    product_id: number;
-    position: number;
-    name: string;
-    full_name: string;
-    led_color: string;
-    screen_color: string;
-}[];
 /**
  * Represents a Aurora Climbing device.
- * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ * Aurora Board
  * {@link https://auroraclimbing.com}
  */
-export declare class KilterBoard extends Device implements IKilterBoard {
+export declare class Aurora extends Device implements IAurora {
     /**
      * UUID for the Aurora Climbing Advertising service.
-     * This constant is used to identify the specific Bluetooth service for Kilter Boards.
+     * This constant is used to identify the specific Bluetooth service for Aurora LED boards.
      * @type {string}
      * @static
      * @readonly
@@ -70,9 +57,20 @@ export declare class KilterBoard extends Device implements IKilterBoard {
      * @constant
      */
     private static readonly maxBluetoothMessageSize;
+    private apiLevel;
+    private writeQueue;
     constructor();
     /**
-     * Calculates the checksum for a byte array by summing up all bytes ot hre packet in a single-byte variable.
+     * Sets the API level from the Aurora board name format:
+     * display name, optional #serial, optional trailing @apiLevel. Missing @apiLevel defaults to API level 2.
+     * @param name - The name of the device.
+     */
+    protected setApiLevelFromDeviceName(name?: string | null): void;
+    protected onBluetoothDeviceSelected(device: BluetoothDevice): void;
+    private getApiLevelFromDeviceName;
+    private normalizeApiLevel;
+    /**
+     * Calculates the checksum for a byte array by summing up all packet-data bytes in a single-byte variable.
      * @param data - The array of bytes to calculate the checksum for.
      * @returns {number} The calculated checksum value.
      */
@@ -84,13 +82,20 @@ export declare class KilterBoard extends Device implements IKilterBoard {
      */
     private wrapBytes;
     /**
-     * Encodes a position into a byte array.
-     * The lowest 8 bits of the position get put in the first byte of the group.
-     * The highest 8 bits of the position get put in the second byte of the group.
+     * Encodes an API level 2 position into two bytes.
+     * The lowest 8 bits go in the first byte; the highest 2 bits are reserved for the second byte.
      * @param position - The position to encode.
      * @returns {number[]} The encoded byte array representing the position.
      */
-    private encodePosition;
+    private validatePosition;
+    private encodePositionV2;
+    /**
+     * Encodes an API level 3 position into two bytes.
+     * The lowest 8 bits go in the first byte; the highest 8 bits go in the second byte.
+     * @param position - The position to encode.
+     * @returns {number[]} The encoded byte array representing the position.
+     */
+    private encodePositionV3;
     /**
      * Encodes a color string into a numeric representation.
      * The rgb color, 3 bits for the R and G components, 2 bits for the B component, with the 3 R bits occupying the high end of the byte and the 2 B bits in the low end (hence 3 G bits in the middle).
@@ -98,20 +103,51 @@ export declare class KilterBoard extends Device implements IKilterBoard {
      * @param color - The color string in hexadecimal format (e.g., 'FFFFFF').
      * @returns The encoded /compressed color value.
      */
-    private encodeColor;
+    private encodeColorV3;
+    /**
+     * Encodes a color string using API level 2's 2-bit RGB format.
+     * Format: 0bRRGGBB00. The lowest two bits are reserved for the high bits of the LED position.
+     * @param color - The color string in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded /compressed color value.
+     */
+    private encodeColorV2;
+    private normalizeColor;
     /**
-     * Encodes a placement (requires a 16-bit position and a 24-bit rgb color. ) into a byte array.
+     * Encodes an API level 2 placement into two bytes.
+     * API level 2 stores a 10-bit position and a 2-bit-per-channel RGB color.
      * @param position - The position to encode.
      * @param ledColor - The color of the LED in hexadecimal format (e.g., 'FFFFFF').
      * @returns The encoded byte array representing the placement.
      */
-    private encodePlacement;
+    private encodePlacementV2;
     /**
-     * Prepares byte arrays for transmission based on a list of climb placements.
-     * @param {{ position: number; role_id?: number; color?: string }[]} climbPlacementList - The list of climb placements containing position and either role ID or color.
-     * @returns {number[]} The final byte array ready for transmission.
+     * Encodes an API level 3 placement into three bytes.
+     * API level 3 stores a 16-bit position and a 3/3/2-bit RGB color.
+     * @param position - The position to encode.
+     * @param ledColor - The color of the LED in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded byte array representing the placement.
+     */
+    private encodePlacementV3;
+    /**
+     * Resolves placements into LED positions and concrete hex colors.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The resolved placements ready for API-level encoding.
+     */
+    private resolvePlacements;
+    private buildPayload;
+    /**
+     * Prepares API level 2 byte arrays for transmission based on a list of climb placements.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The final byte array ready for transmission.
+     */
+    private prepBytesV2;
+    /**
+     * Prepares API level 3 byte arrays for transmission based on a list of climb placements.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The final byte array ready for transmission.
      */
     private prepBytesV3;
+    private prepBytes;
     /**
      * Splits a collection into slices of the specified length.
      * https://github.com/ramda/ramda/blob/master/source/splitEvery
@@ -121,26 +157,32 @@ export declare class KilterBoard extends Device implements IKilterBoard {
      */
     private splitEvery;
     /**
-     * The kilter board only supports messages of 20 bytes
+     * Aurora boards only support messages of 20 bytes
      * at a time. This method splits a full message into parts
      * of 20 bytes
      *
      * @param buffer
      */
     private splitMessages;
+    private getWriteCharacteristic;
     /**
      * Sends a series of messages to a device.
      */
     private writeMessageSeries;
+    private queueWrite;
+    private writeMessageChunk;
+    private canWriteWithoutResponse;
     /**
      * Configures the LEDs based on an array of climb placements.
-     * @param {{ position: number; role_id?: number; color?: string }[]} config - Array of climb placements for the LEDs. Either role_id or color (hex string) must be provided.
-     * @returns {Promise<number[] | undefined>} A promise that resolves with the payload array for the Kilter Board if LED settings were applied, or `undefined` if no action was taken or for the Motherboard.
-     */
-    led: (config: {
-        position: number;
-        role_id?: number;
-        color?: string;
-    }[]) => Promise<number[] | undefined>;
+     * @param config - Array of climb placements for the LEDs. Each placement must include a color hex string.
+     * @returns {Promise<number[] | undefined>} A promise that resolves with the payload array for the Aurora board if LED settings were applied, or `undefined` if no action was taken.
+     */
+    led: (config?: AuroraLedPlacement[]) => Promise<number[] | undefined>;
+}
+/**
+ * Aurora Board
+ * {@link https://auroraboardapp.com}
+ */
+export declare class AuroraBoard extends Aurora implements IAurora {
 }
-//# sourceMappingURL=kilterboard.model.d.ts.map
+//# sourceMappingURL=aurora.model.d.ts.map

package/dist/cjs/models/device/aurora.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aurora.model.d.ts","sourceRoot":"","sources":["../../../../src/models/device/aurora.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,6CAA6C,CAAA;AAgB9F;;;GAGG;AACH,oBAAY,YAAY;IACtB,oEAAoE;IACpE,SAAS,KAAK;IACd,4FAA4F;IAC5F,QAAQ,KAAA;IACR,+EAA+E;IAC/E,OAAO,KAAA;IACP,8IAA8I;IAC9I,OAAO,KAAA;IACP,oEAAoE;IACpE,SAAS,KAAA;IACT,4FAA4F;IAC5F,QAAQ,KAAA;IACR,+EAA+E;IAC/E,OAAO,KAAA;IACP,8IAA8I;IAC9I,OAAO,KAAA;CACR;AAED;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,MAAO,YAAW,OAAO;IACnD;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAyC;IAE3E;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAc;IAE1D;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAa;IAE5D,OAAO,CAAC,QAAQ,CAAgB;IAEhC,OAAO,CAAC,UAAU,CAAmC;;IAiCrD;;;;OAIG;IACH,SAAS,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;cAM5C,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI3E,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,iBAAiB;IAQzB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IASxB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,cAAc;IAUtB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,YAAY;IAoCpB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa,CACsE;IAE3F,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;YACW,kBAAkB;YAUlB,UAAU;YAOV,iBAAiB;IAgB/B,OAAO,CAAC,uBAAuB;IAO/B;;;;OAIG;IACH,GAAG,GAAU,SAAQ,kBAAkB,EAAO,KAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAc7E;CACF;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,MAAO,YAAW,OAAO;CAAG"}

package/dist/cjs/models/device/aurora.model.js

@@ -0,0 +1,407 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuroraBoard = exports.Aurora = exports.AuroraPacket = void 0;
+const device_model_js_1 = require("../device.model.js");
+/**
+ * For API level 2 and API level 3.
+ * The first byte in the data is dependent on where the packet is in the message as a whole.
+ */
+var AuroraPacket;
+(function (AuroraPacket) {
+    /** If this packet is in the middle, the byte gets set to 77 (M). */
+    AuroraPacket[AuroraPacket["V2_MIDDLE"] = 77] = "V2_MIDDLE";
+    /** If this packet is the first packet in the message, then this byte gets set to 78 (N). */
+    AuroraPacket[AuroraPacket["V2_FIRST"] = 78] = "V2_FIRST";
+    /** If this is the last packet in the message, this byte gets set to 79 (O). */
+    AuroraPacket[AuroraPacket["V2_LAST"] = 79] = "V2_LAST";
+    /** If this packet is the only packet in the message, the byte gets set to 80 (P). Note that this takes priority over the other conditions. */
+    AuroraPacket[AuroraPacket["V2_ONLY"] = 80] = "V2_ONLY";
+    /** If this packet is in the middle, the byte gets set to 81 (Q). */
+    AuroraPacket[AuroraPacket["V3_MIDDLE"] = 81] = "V3_MIDDLE";
+    /** If this packet is the first packet in the message, then this byte gets set to 82 (R). */
+    AuroraPacket[AuroraPacket["V3_FIRST"] = 82] = "V3_FIRST";
+    /** If this is the last packet in the message, this byte gets set to 83 (S). */
+    AuroraPacket[AuroraPacket["V3_LAST"] = 83] = "V3_LAST";
+    /** If this packet is the only packet in the message, the byte gets set to 84 (T). Note that this takes priority over the other conditions. */
+    AuroraPacket[AuroraPacket["V3_ONLY"] = 84] = "V3_ONLY";
+})(AuroraPacket || (exports.AuroraPacket = AuroraPacket = {}));
+/**
+ * Represents a Aurora Climbing device.
+ * Aurora Board
+ * {@link https://auroraclimbing.com}
+ */
+class Aurora extends device_model_js_1.Device {
+    constructor() {
+        super({
+            filters: [
+                {
+                    services: [Aurora.AuroraUUID],
+                },
+            ],
+            services: [
+                {
+                    name: "UART Nordic Service",
+                    id: "uart",
+                    uuid: "6e400001-b5a3-f393-e0a9-e50e24dcca9e",
+                    characteristics: [
+                        {
+                            name: "TX",
+                            id: "tx",
+                            uuid: "6e400002-b5a3-f393-e0a9-e50e24dcca9e",
+                        },
+                        // {
+                        //   name: "RX",
+                        //   id: "rx",
+                        //   uuid: "6e400003-b5a3-f393-e0a9-e50e24dcca9e",
+                        // },
+                    ],
+                },
+            ],
+        });
+        this.writeQueue = Promise.resolve();
+        /**
+         * Aurora boards only support messages of 20 bytes
+         * at a time. This method splits a full message into parts
+         * of 20 bytes
+         *
+         * @param buffer
+         */
+        this.splitMessages = (buffer) => this.splitEvery(Aurora.maxBluetoothMessageSize, buffer).map((arr) => new Uint8Array(arr));
+        /**
+         * Configures the LEDs based on an array of climb placements.
+         * @param config - Array of climb placements for the LEDs. Each placement must include a color hex string.
+         * @returns {Promise<number[] | undefined>} A promise that resolves with the payload array for the Aurora board if LED settings were applied, or `undefined` if no action was taken.
+         */
+        this.led = async (config = []) => {
+            // Handle Aurora LED board logic: process placements and send payload if connected
+            if (Array.isArray(config)) {
+                // Prepares byte arrays for transmission based on a list of climb placements.
+                const payload = this.prepBytes(config, this.apiLevel);
+                if (this.isConnected()) {
+                    const characteristic = this.getWriteCharacteristic();
+                    if (characteristic) {
+                        await this.queueWrite(() => this.writeMessageSeries(characteristic, this.splitMessages(payload)));
+                    }
+                }
+                return payload;
+            }
+            return undefined;
+        };
+        this.apiLevel = 2;
+    }
+    /**
+     * Sets the API level from the Aurora board name format:
+     * display name, optional #serial, optional trailing @apiLevel. Missing @apiLevel defaults to API level 2.
+     * @param name - The name of the device.
+     */
+    setApiLevelFromDeviceName(name) {
+        const detectedApiLevel = this.getApiLevelFromDeviceName(name);
+        this.apiLevel = detectedApiLevel;
+    }
+    onBluetoothDeviceSelected(device) {
+        this.setApiLevelFromDeviceName(device.name);
+    }
+    getApiLevelFromDeviceName(name) {
+        var _a;
+        const apiLevel = (_a = name === null || name === void 0 ? void 0 : name.match(/@(\d+)$/)) === null || _a === void 0 ? void 0 : _a[1];
+        if (apiLevel === undefined) {
+            return 2;
+        }
+        return this.normalizeApiLevel(Number(apiLevel));
+    }
+    normalizeApiLevel(apiLevel) {
+        if (apiLevel !== 2 && apiLevel !== 3) {
+            throw new Error(`Unsupported Aurora Board API level: ${apiLevel}`);
+        }
+        return apiLevel;
+    }
+    /**
+     * Calculates the checksum for a byte array by summing up all packet-data bytes in a single-byte variable.
+     * @param data - The array of bytes to calculate the checksum for.
+     * @returns {number} The calculated checksum value.
+     */
+    checksum(data) {
+        let i = 0;
+        for (const value of data) {
+            i = (i + value) & 255;
+        }
+        return ~i & 255;
+    }
+    /**
+     * Wraps a byte array with header and footer bytes for transmission.
+     * @param data - The array of bytes to wrap.
+     * @returns {number[]} The wrapped byte array.
+     */
+    wrapBytes(data) {
+        if (data.length > Aurora.messageBodyMaxLength) {
+            return [];
+        }
+        /**
+      - 0x1
+      - len(packets)
+      - checksum(packets)
+      - 0x2
+      - *packets
+      - 0x3
+    
+      First byte is always 1, the second is a number of packets, then checksum, then 2, packets themselves, and finally 3.
+       */
+        return [1, data.length, this.checksum(data), 2, ...data, 3];
+    }
+    /**
+     * Encodes an API level 2 position into two bytes.
+     * The lowest 8 bits go in the first byte; the highest 2 bits are reserved for the second byte.
+     * @param position - The position to encode.
+     * @returns {number[]} The encoded byte array representing the position.
+     */
+    validatePosition(position, maxPosition, apiLevel) {
+        if (!Number.isInteger(position) || position < 0 || position > maxPosition) {
+            throw new Error(`Aurora Board API level ${apiLevel} requires an integer LED position between 0 and ${maxPosition}`);
+        }
+    }
+    encodePositionV2(position) {
+        this.validatePosition(position, 0x3ff, 2);
+        const position1 = position & 255;
+        const position2 = (position & 0x300) >> 8;
+        return [position1, position2];
+    }
+    /**
+     * Encodes an API level 3 position into two bytes.
+     * The lowest 8 bits go in the first byte; the highest 8 bits go in the second byte.
+     * @param position - The position to encode.
+     * @returns {number[]} The encoded byte array representing the position.
+     */
+    encodePositionV3(position) {
+        this.validatePosition(position, 0xffff, 3);
+        const position1 = position & 255;
+        const position2 = (position & 65280) >> 8;
+        return [position1, position2];
+    }
+    /**
+     * Encodes a color string into a numeric representation.
+     * The rgb color, 3 bits for the R and G components, 2 bits for the B component, with the 3 R bits occupying the high end of the byte and the 2 B bits in the low end (hence 3 G bits in the middle).
+     * Format: 0bRRRGGGBB where RRR is 3 bits for red, GGG is 3 bits for green, BB is 2 bits for blue.
+     * @param color - The color string in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded /compressed color value.
+     */
+    encodeColorV3(color) {
+        const r = parseInt(color.substring(0, 2), 16);
+        const g = parseInt(color.substring(2, 4), 16);
+        const b = parseInt(color.substring(4, 6), 16);
+        // Integer division: R and G divided by 32, B divided by 64
+        // Then pack into 0bRRRGGGBB format
+        const rBits = Math.floor(r / 32); // 0-7 (3 bits)
+        const gBits = Math.floor(g / 32); // 0-7 (3 bits)
+        const bBits = Math.floor(b / 64); // 0-3 (2 bits)
+        // Pack: RRR in bits 7-5, GGG in bits 4-2, BB in bits 1-0
+        return (rBits << 5) | (gBits << 2) | bBits;
+    }
+    /**
+     * Encodes a color string using API level 2's 2-bit RGB format.
+     * Format: 0bRRGGBB00. The lowest two bits are reserved for the high bits of the LED position.
+     * @param color - The color string in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded /compressed color value.
+     */
+    encodeColorV2(color) {
+        const r = parseInt(color.substring(0, 2), 16);
+        const g = parseInt(color.substring(2, 4), 16);
+        const b = parseInt(color.substring(4, 6), 16);
+        const rBits = Math.floor(r / 64); // 0-3 (2 bits)
+        const gBits = Math.floor(g / 64); // 0-3 (2 bits)
+        const bBits = Math.floor(b / 64); // 0-3 (2 bits)
+        return (rBits << 6) | (gBits << 4) | (bBits << 2);
+    }
+    normalizeColor(color) {
+        const colorHex = color.trim().replace(/^#/, "").toUpperCase();
+        if (!/^[0-9A-F]{6}$/.test(colorHex)) {
+            throw new Error(`Invalid Aurora Board LED color: ${color}`);
+        }
+        return colorHex;
+    }
+    /**
+     * Encodes an API level 2 placement into two bytes.
+     * API level 2 stores a 10-bit position and a 2-bit-per-channel RGB color.
+     * @param position - The position to encode.
+     * @param ledColor - The color of the LED in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded byte array representing the placement.
+     */
+    encodePlacementV2(position, ledColor) {
+        const [position1, position2] = this.encodePositionV2(position);
+        return [position1, this.encodeColorV2(ledColor) | position2];
+    }
+    /**
+     * Encodes an API level 3 placement into three bytes.
+     * API level 3 stores a 16-bit position and a 3/3/2-bit RGB color.
+     * @param position - The position to encode.
+     * @param ledColor - The color of the LED in hexadecimal format (e.g., 'FFFFFF').
+     * @returns The encoded byte array representing the placement.
+     */
+    encodePlacementV3(position, ledColor) {
+        return [...this.encodePositionV3(position), this.encodeColorV3(ledColor)];
+    }
+    /**
+     * Resolves placements into LED positions and concrete hex colors.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The resolved placements ready for API-level encoding.
+     */
+    resolvePlacements(climbPlacementList) {
+        return climbPlacementList.flatMap((climbPlacement) => {
+            var _a, _b;
+            const color = (_b = (_a = climbPlacement.color) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "";
+            if (color === "") {
+                return [];
+            }
+            return [
+                {
+                    position: climbPlacement.position,
+                    colorHex: this.normalizeColor(color),
+                },
+            ];
+        });
+    }
+    buildPayload(resolvedPlacements, markers, bytesPerPlacement, encodePlacement) {
+        const resultArray = [];
+        let tempArray = [markers.middle];
+        for (const climbPlacement of resolvedPlacements) {
+            if (tempArray.length + bytesPerPlacement > Aurora.messageBodyMaxLength) {
+                resultArray.push(tempArray);
+                tempArray = [markers.middle];
+            }
+            const encodedPlacement = encodePlacement(climbPlacement.position, climbPlacement.colorHex);
+            tempArray.push(...encodedPlacement);
+        }
+        resultArray.push(tempArray);
+        if (resultArray.length === 1) {
+            resultArray[0][0] = markers.only;
+        }
+        else if (resultArray.length > 1) {
+            resultArray[0][0] = markers.first;
+            resultArray[resultArray.length - 1][0] = markers.last;
+        }
+        const finalResultArray = [];
+        for (const currentArray of resultArray) {
+            finalResultArray.push(...this.wrapBytes(currentArray));
+        }
+        return finalResultArray;
+    }
+    /**
+     * Prepares API level 2 byte arrays for transmission based on a list of climb placements.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The final byte array ready for transmission.
+     */
+    prepBytesV2(climbPlacementList) {
+        return this.buildPayload(this.resolvePlacements(climbPlacementList), {
+            middle: AuroraPacket.V2_MIDDLE,
+            first: AuroraPacket.V2_FIRST,
+            last: AuroraPacket.V2_LAST,
+            only: AuroraPacket.V2_ONLY,
+        }, 2, (position, ledColor) => this.encodePlacementV2(position, ledColor));
+    }
+    /**
+     * Prepares API level 3 byte arrays for transmission based on a list of climb placements.
+     * @param climbPlacementList - The list of climb placements containing position and color.
+     * @returns The final byte array ready for transmission.
+     */
+    prepBytesV3(climbPlacementList) {
+        return this.buildPayload(this.resolvePlacements(climbPlacementList), {
+            middle: AuroraPacket.V3_MIDDLE,
+            first: AuroraPacket.V3_FIRST,
+            last: AuroraPacket.V3_LAST,
+            only: AuroraPacket.V3_ONLY,
+        }, 3, (position, ledColor) => this.encodePlacementV3(position, ledColor));
+    }
+    prepBytes(climbPlacementList, apiLevel) {
+        return apiLevel === 2 ? this.prepBytesV2(climbPlacementList) : this.prepBytesV3(climbPlacementList);
+    }
+    /**
+     * Splits a collection into slices of the specified length.
+     * https://github.com/ramda/ramda/blob/master/source/splitEvery
+     * @param {Number} n
+     * @param {Array} list
+     * @return {Array<number[]>}
+     */
+    splitEvery(n, list) {
+        if (n <= 0) {
+            throw new Error("First argument to splitEvery must be a positive integer");
+        }
+        const result = [];
+        let idx = 0;
+        while (idx < list.length) {
+            result.push(list.slice(idx, (idx += n)));
+        }
+        return result;
+    }
+    getWriteCharacteristic() {
+        var _a, _b;
+        return (_b = (_a = this.services.find((service) => service.id === "uart")) === null || _a === void 0 ? void 0 : _a.characteristics.find((char) => char.id === "tx")) === null || _b === void 0 ? void 0 : _b.characteristic;
+    }
+    /**
+     * Sends a series of messages to a device.
+     */
+    async writeMessageSeries(characteristic, messages) {
+        for (const message of messages) {
+            if (!message) {
+                continue;
+            }
+            await this.writeMessageChunk(characteristic, message);
+        }
+    }
+    async queueWrite(operation) {
+        const queuedOperation = this.writeQueue.catch(() => undefined).then(operation);
+        this.writeQueue = queuedOperation.catch(() => undefined);
+        await queuedOperation;
+    }
+    async writeMessageChunk(characteristic, message) {
+        this.updateTimestamp();
+        const valueToWrite = new Uint8Array(message);
+        if (this.canWriteWithoutResponse(characteristic)) {
+            await characteristic.writeValueWithoutResponse(valueToWrite);
+        }
+        else {
+            await characteristic.writeValue(valueToWrite);
+        }
+        this.writeLast = message;
+    }
+    canWriteWithoutResponse(characteristic) {
+        return (characteristic.properties.writeWithoutResponse !== false &&
+            typeof characteristic.writeValueWithoutResponse === "function");
+    }
+}
+exports.Aurora = Aurora;
+/**
+ * UUID for the Aurora Climbing Advertising service.
+ * This constant is used to identify the specific Bluetooth service for Aurora LED boards.
+ * @type {string}
+ * @static
+ * @readonly
+ * @constant
+ */
+Aurora.AuroraUUID = "4488b571-7806-4df6-bcff-a2897e4953ff";
+/**
+ * Maximum length of the message body for byte wrapping.
+ * This value defines the limit for the size of messages that can be sent or received
+ * to ensure proper byte wrapping in communication.
+ * @type {number}
+ * @private
+ * @readonly
+ * @constant
+ */
+Aurora.messageBodyMaxLength = 255;
+/**
+ * Maximum length of the Bluetooth message chunk.
+ * This value sets the upper limit for the size of individual Bluetooth messages
+ * sent to and from the device to comply with Bluetooth protocol constraints.
+ * @type {number}
+ * @private
+ * @readonly
+ * @constant
+ */
+Aurora.maxBluetoothMessageSize = 20;
+/**
+ * Aurora Board
+ * {@link https://auroraboardapp.com}
+ */
+class AuroraBoard extends Aurora {
+}
+exports.AuroraBoard = AuroraBoard;
+//# sourceMappingURL=aurora.model.js.map