@hangtime/grip-connect 0.3.8 → 0.3.10

package/README.md

@@ -7,8 +7,7 @@ Force-Sensing Hangboards / Dynamometers / Plates / LED system boards used by cli
 the [Griptonite Motherboard](https://griptonite.io/shop/motherboard/), [Climbro](https://climbro.com/),
 [mySmartBoard](https://www.smartboard-climbing.com/), [Entralpi](https://entralpi.com/),
 [Tindeq Progressor](https://tindeq.com/) or
-[Weiheng WH-C06](https://weihengmanufacturer.com/products/wh-c06-bluetooth-300kg-hanging-scale/) also sold as
-[MAT Muscle Meter](https://www.matassessment.com/musclemeter).
+[Weiheng WH-C06](https://weihengmanufacturer.com/products/wh-c06-bluetooth-300kg-hanging-scale/).
 
 And LED system boards from [Aurora Climbing](https://auroraclimbing.com/) like the
 [Kilter Board](https://settercloset.com/pages/the-kilter-board),
@@ -28,7 +27,7 @@ Learn more: [Docs](https://stevie-ray.github.io/hangtime-grip-connect/) -
 ## Try it out
 
 [Chart](https://grip-connect.vercel.app/) - [Flappy Bird](https://grip-connect-flappy-bird.vercel.app/) -
-[Kilter Board](https://grip-connect-kilter-board.vercel.app/)
+[Kilter Board](https://grip-connect-kilter-board.vercel.app/?route=p1083r15p1117r15p1164r12p1185r12p1233r13p1282r13p1303r13p1372r13p1392r14p1505r15)
 
 ## Install
 
@@ -52,75 +51,85 @@ import { Motherboard, active, battery, connect, disconnect, info, notify, stream
 const motherboardButton = document.querySelector("#motherboard")
 
 motherboardButton.addEventListener("click", () => {
-  connect(Motherboard, async () => {
-    // Listen for stream notifications
-    notify((data) => {
-      // { massTotal: "0", massMax: "0", massAverage: "0", massLeft: "0", massCenter: "0", massRight: "0" }
-      console.log(data)
-    })
-
-    // Check if device is being used
-    active((value) => {
-      console.log(value)
-    })
-
-    // Read battery + device info
-    await battery(Motherboard)
-    await info(Motherboard)
-
-    // trigger LEDs
-    // await led(device)
-
-    // Start weight streaming (for a minute) remove parameter for a continues stream
-    await stream(Motherboard, 60000)
-
-    // Manualy tare the device when the stream is running
-    // await tare(5000)
-
-    // Manually call stop method if stream is continues
-    // await stop(Motherboard)
-
-    // Download data to CSV: format => timestamp, frame, battery, samples, masses
-    // download()
-
-    // Disconnect from device after we are done
-    disconnect(Motherboard)
-  })
+  connect(
+    Motherboard,
+    async () => {
+      // Listen for stream notifications
+      notify((data) => {
+        // { massTotal: "0", massMax: "0", massAverage: "0", massLeft: "0", massCenter: "0", massRight: "0" }
+        console.log(data)
+      })
+
+      // Check if device is being used
+      active((value) => {
+        console.log(value)
+      })
+
+      // Read battery + device info
+      await battery(Motherboard)
+      await info(Motherboard)
+
+      // trigger LEDs
+      // await led(device)
+
+      // Start weight streaming (for a minute) remove parameter for a continues stream
+      await stream(Motherboard, 60000)
+
+      // Manualy tare the device when the stream is running
+      // await tare(5000)
+
+      // Manually call stop method if stream is continues
+      // await stop(Motherboard)
+
+      // Download data as CSV, JSON, or XML (default: CSV) format => timestamp, frame, battery, samples, masses
+      // download('json')
+
+      // Disconnect from device after we are done
+      disconnect(Motherboard)
+    },
+    (error) => {
+      // Optinal custom error handeling
+      console.error(error.message)
+    },
+  )
 })
 ```
 
-## Roadmap
+## Device support
 
-**Help wanted:** Do you own any of these devices? Use Google Chrome's Bluetooth Internals
+- ✅ Griptonite - Motherboard
+- ✅ Tindeq - Progressor
+- ✅ Weiheng - WH-C06
+  - By default [watchAdvertisements](https://chromestatus.com/feature/5180688812736512) isn't supported . For Chrome,
+    enable it at `chrome://flags/#enable-experimental-web-platform-features`.
+- ✅ Kilter Board
+- ⏳ Entralpi (not verified)
+- ➡️ Climbro
+- ➡️ Smartboard Climbing - mySmartBoard
+
+## Features
+
+**Help wanted:** Do you own any of the missing devices? Use Google Chrome's Bluetooth Internals
 `chrome://bluetooth-internals/#devices` and press `Start Scan` to look for your device, click on `Inspect` and share all
 available services with us.
 
-### Device support
-
-- ✅ Griptonite Motherboard
-- ✅ Tindeq Progressor
-- ⏳ Entralpi (not verified)
-- ⏳ Kilterboard (see example)
-- ⏳ Weiheng WH-C06 / MAT Muscle Meter
-  - Enable: `chrome://flags#enable-experimental-web-platform-features`
-- ➡️ Climbro
-- ➡️ mySmartBoard
-
-### Features
-
-- ✅ Connect / Disconnect
-- ✅ Start / Stop data stream
-- ✅ Battery status
-- ✅ Read calibration
-- ✅ Device info: firmware / serial etc.
-- ✅ Check if device is connected
-- ✅ Check if device is being used
-- ✅ Peak / Average load
-- ✅️ Tare / unladen weight
-- ✅️ Download data to CVS
-- ➡️ Endurance
-- ➡️ Rate of Force Development: RFD
-- ➡️ Critical Force
+|                                                                                         | Motherboard | Progressor | WH-C06 | Entralpi | Kilter Board | Climbro | mySmartBoard |
+| --------------------------------------------------------------------------------------- | ----------- | ---------- | ------ | -------- | ------------ | ------- | ------------ |
+| [Battery](https://stevie-ray.github.io/hangtime-grip-connect/api/battery.html)          | ✅          | ✅         |        |          |              |         |              |
+| [Calibration](https://stevie-ray.github.io/hangtime-grip-connect/api/calibration.html)  | ✅          |            |        |          |              |         |              |
+| [Connect](https://stevie-ray.github.io/hangtime-grip-connect/api/connect.html)          | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Disconnect](https://stevie-ray.github.io/hangtime-grip-connect/api/disconnect.html)    | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Download](https://stevie-ray.github.io/hangtime-grip-connect/api/download.html)        | ✅          | ✅         |        |          |              |         |              |
+| [Info](https://stevie-ray.github.io/hangtime-grip-connect/api/info.html)                | ✅          | ✅         |        |          |              |         |              |
+| [isActive](https://stevie-ray.github.io/hangtime-grip-connect/api/is-active.html)       | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [isConnected](https://stevie-ray.github.io/hangtime-grip-connect/api/is-connected.html) | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Led](https://stevie-ray.github.io/hangtime-grip-connect/api/led.html)                  | ✅          |            |        |          | ✅           |         |              |
+| [Notify](https://stevie-ray.github.io/hangtime-grip-connect/api/notify.html)            | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [Read](https://stevie-ray.github.io/hangtime-grip-connect/api/read.html)                | ✅          |            |        |          |              |         |              |
+| [Stop](https://stevie-ray.github.io/hangtime-grip-connect/api/stop.html)                | ✅          | ✅         |        |          |              |         |              |
+| [Stream](https://stevie-ray.github.io/hangtime-grip-connect/api/stream.html)            | ✅          | ✅         |        |          |              |         |              |
+| [Tare](https://stevie-ray.github.io/hangtime-grip-connect/api/tare.html)                | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [Write](https://stevie-ray.github.io/hangtime-grip-connect/api/write.html)              | ✅          | ✅         |        |          |              |         |              |
 
 ## Development
 
@@ -146,7 +155,7 @@ A special thank you to:
 - [@1-max-1](https://github.com/1-max-1) for the docs on his Kilter Board
   [simulator](https://github.com/1-max-1/fake_kilter_board) that I coverted to
   [hangtime-arduino-kilterboard](https://github.com/Stevie-Ray/hangtime-arduino-kilterboard).
-- [sebws](https://github.com/sebw) for a [code sample](https://github.com/sebws/Crane) of the Weiheng WH-C06 App.
+- [@sebws](https://github.com/sebw) for a [code sample](https://github.com/sebws/Crane) of the Weiheng WH-C06 App.
 
 ## Disclaimer
 

package/dist/commands/kilterboard.d.ts

@@ -21,3 +21,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;
+}[];

package/dist/commands/kilterboard.js

@@ -22,3 +22,44 @@ export var 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. */
     KilterBoardPacket[KilterBoardPacket["V3_ONLY"] = 84] = "V3_ONLY";
 })(KilterBoardPacket || (KilterBoardPacket = {}));
+/**
+ * Extracted from placement_roles database table.
+ */
+export const KilterBoardPlacementRoles = [
+    {
+        id: 12,
+        product_id: 1,
+        position: 1,
+        name: "start",
+        full_name: "Start",
+        led_color: "00FF00",
+        screen_color: "00DD00",
+    },
+    {
+        id: 13,
+        product_id: 1,
+        position: 2,
+        name: "middle",
+        full_name: "Middle",
+        led_color: "00FFFF",
+        screen_color: "00FFFF",
+    },
+    {
+        id: 14,
+        product_id: 1,
+        position: 3,
+        name: "finish",
+        full_name: "Finish",
+        led_color: "FF00FF",
+        screen_color: "FF00FF",
+    },
+    {
+        id: 15,
+        product_id: 1,
+        position: 4,
+        name: "foot",
+        full_name: "Foot Only",
+        led_color: "FFA500",
+        screen_color: "FFA500",
+    },
+];

package/dist/connect.d.ts

@@ -2,6 +2,7 @@ import type { Device } from "./types/devices";
 /**
  * Connects to a Bluetooth device.
  * @param {Device} board - The device to connect to.
- * @param {Function} onSuccess - Callback function to execute on successful connection.
+ * @param {Function} [onSuccess] - Optional callback function to execute on successful connection. Default logs success.
+ * @param {Function} [onError] - Optional callback function to execute on error. Default logs the error.
  */
-export declare const connect: (board: Device, onSuccess: () => void) => Promise<void>;
+export declare const connect: (board: Device, onSuccess?: () => void, onError?: (error: Error) => void) => Promise<void>;

package/dist/connect.js

@@ -9,7 +9,7 @@ const receiveBuffer = [];
 const onDisconnected = (event, board) => {
     board.device = undefined;
     const device = event.target;
-    console.log(`Device ${device.name} is disconnected.`);
+    throw new Error(`Device ${device.name} is disconnected.`);
 };
 /**
  * Handles notifications received from a characteristic.
@@ -61,46 +61,40 @@ const handleNotifications = (event, board) => {
  * @param {Function} onSuccess - Callback function to execute on successful connection.
  */
 const onConnected = async (board, onSuccess) => {
-    try {
-        // Connect to GATT server and set up characteristics
-        const services = await server.getPrimaryServices();
-        if (!services || services.length === 0) {
-            console.error("No services found");
-            return;
-        }
-        for (const service of services) {
-            const matchingService = board.services.find((boardService) => boardService.uuid === service.uuid);
-            if (matchingService) {
-                // Android bug: Introduce a delay before getting characteristics
-                await new Promise((resolve) => setTimeout(resolve, 100));
-                const characteristics = await service.getCharacteristics();
-                for (const characteristic of matchingService.characteristics) {
-                    const matchingCharacteristic = characteristics.find((char) => char.uuid === characteristic.uuid);
-                    if (matchingCharacteristic) {
-                        const element = matchingService.characteristics.find((char) => char.uuid === matchingCharacteristic.uuid);
-                        if (element) {
-                            element.characteristic = matchingCharacteristic;
-                            // notify
-                            if (element.id === "rx") {
-                                matchingCharacteristic.startNotifications();
-                                matchingCharacteristic.addEventListener("characteristicvaluechanged", (event) => {
-                                    handleNotifications(event, board);
-                                });
-                            }
+    // Connect to GATT server and set up characteristics
+    const services = await server.getPrimaryServices();
+    if (!services || services.length === 0) {
+        throw new Error("No services found");
+    }
+    for (const service of services) {
+        const matchingService = board.services.find((boardService) => boardService.uuid === service.uuid);
+        if (matchingService) {
+            // Android bug: Introduce a delay before getting characteristics
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            const characteristics = await service.getCharacteristics();
+            for (const characteristic of matchingService.characteristics) {
+                const matchingCharacteristic = characteristics.find((char) => char.uuid === characteristic.uuid);
+                if (matchingCharacteristic) {
+                    const element = matchingService.characteristics.find((char) => char.uuid === matchingCharacteristic.uuid);
+                    if (element) {
+                        element.characteristic = matchingCharacteristic;
+                        // notify
+                        if (element.id === "rx") {
+                            matchingCharacteristic.startNotifications();
+                            matchingCharacteristic.addEventListener("characteristicvaluechanged", (event) => {
+                                handleNotifications(event, board);
+                            });
                         }
                     }
-                    else {
-                        console.warn(`Characteristic ${characteristic.uuid} not found in service ${service.uuid}`);
-                    }
+                }
+                else {
+                    throw new Error(`Characteristic ${characteristic.uuid} not found in service ${service.uuid}`);
                 }
             }
         }
-        // Call the onSuccess callback after successful connection and setup
-        onSuccess();
-    }
-    catch (error) {
-        console.error(error);
     }
+    // Call the onSuccess callback after successful connection and setup
+    onSuccess();
 };
 /**
  * Returns UUIDs of all services associated with the device.
@@ -113,9 +107,10 @@ const getAllServiceUUIDs = (device) => {
 /**
  * Connects to a Bluetooth device.
  * @param {Device} board - The device to connect to.
- * @param {Function} onSuccess - Callback function to execute on successful connection.
+ * @param {Function} [onSuccess] - Optional callback function to execute on successful connection. Default logs success.
+ * @param {Function} [onError] - Optional callback function to execute on error. Default logs the error.
  */
-export const connect = async (board, onSuccess) => {
+export const connect = async (board, onSuccess = () => console.log("Connected successfully"), onError = (error) => console.error(error)) => {
     try {
         // Request device and set up connection
         const deviceServices = getAllServiceUUIDs(board);
@@ -128,8 +123,7 @@ export const connect = async (board, onSuccess) => {
         });
         board.device = device;
         if (!board.device.gatt) {
-            console.error("GATT is not available on this device");
-            return;
+            throw new Error("GATT is not available on this device");
         }
         board.device.addEventListener("gattserverdisconnected", (event) => {
             onDisconnected(event, board);
@@ -145,8 +139,17 @@ export const connect = async (board, onSuccess) => {
                 handleWHC06Data(manufacturerData);
             }
         });
+        // When the companyIdentifier is provided we want to get manufacturerData using watchAdvertisements.
         if (optionalManufacturerData.length) {
-            await board.device.watchAdvertisements();
+            // Receive events when the system receives an advertisement packet from a watched device.
+            // To use this function in Chrome: chrome://flags/#enable-experimental-web-platform-features has to be enabled.
+            // More info: https://chromestatus.com/feature/5180688812736512
+            if (typeof board.device.watchAdvertisements === "function") {
+                await board.device.watchAdvertisements();
+            }
+            else {
+                throw new Error("watchAdvertisements isn't supported. For Chrome, enable it at chrome://flags/#enable-experimental-web-platform-features.");
+            }
         }
         server = await board.device.gatt.connect();
         if (server.connected) {
@@ -154,6 +157,6 @@ export const connect = async (board, onSuccess) => {
         }
     }
     catch (error) {
-        console.error(error);
+        onError(error);
     }
 };

package/dist/download.d.ts

@@ -5,6 +5,12 @@ import type { DownloadPacket } from "./types/download";
 export declare const DownloadPackets: DownloadPacket[];
 export declare const emptyDownloadPackets: () => void;
 /**
- * Exports the data as a CSV file.
+ * Exports the data in the specified format (CSV, JSON, XML) with a filename format:
+ * 'data-export-YYYY-MM-DD-HH-MM-SS.{format}'.
+ *
+ * @param {('csv' | 'json' | 'xml')} [format='csv'] - The format in which to download the data.
+ * Defaults to 'csv'. Accepted values are 'csv', 'json', and 'xml'.
+ *
+ * @returns {void} Initiates a download of the data in the specified format.
  */
-export declare const download: () => void;
+export declare const download: (format?: "csv" | "json" | "xml") => void;

package/dist/download.js

@@ -26,20 +26,76 @@ const packetsToCSV = (data) => {
         .join("\r\n");
 };
 /**
- * Exports the data as a CSV file.
+ * Converts an array of DownloadPacket objects to a JSON string.
+ * @param data - Array of DownloadPacket objects.
+ * @returns JSON string representation of the data.
+ */
+const packetsToJSON = (data) => {
+    return JSON.stringify(data, null, 2); // Pretty print JSON with 2-space indentation
+};
+/**
+ * Converts an array of DownloadPacket objects to an XML string.
+ * @param data - Array of DownloadPacket objects.
+ * @returns XML string representation of the data.
+ */
+const packetsToXML = (data) => {
+    const xmlPackets = data
+        .map((packet) => {
+        const samples = packet.samples.map((sample) => `<sample>${sample}</sample>`).join("");
+        const masses = packet.masses.map((mass) => `<mass>${mass}</mass>`).join("");
+        return `
+        <packet>
+          <received>${packet.received}</received>
+          <sampleNum>${packet.sampleNum}</sampleNum>
+          <battRaw>${packet.battRaw}</battRaw>
+          <samples>${samples}</samples>
+          <masses>${masses}</masses>
+        </packet>
+      `;
+    })
+        .join("");
+    return `<DownloadPackets>${xmlPackets}</DownloadPackets>`;
+};
+/**
+ * Exports the data in the specified format (CSV, JSON, XML) with a filename format:
+ * 'data-export-YYYY-MM-DD-HH-MM-SS.{format}'.
+ *
+ * @param {('csv' | 'json' | 'xml')} [format='csv'] - The format in which to download the data.
+ * Defaults to 'csv'. Accepted values are 'csv', 'json', and 'xml'.
+ *
+ * @returns {void} Initiates a download of the data in the specified format.
  */
-export const download = () => {
-    // Generate CSV string from DownloadPackets array
-    const csvContent = packetsToCSV(DownloadPackets);
-    // Create a Blob object containing the CSV data
-    const blob = new Blob([csvContent], { type: "text/csv" });
+export const download = (format = "csv") => {
+    let content = "";
+    let mimeType = "";
+    let fileName = "";
+    if (format === "csv") {
+        content = packetsToCSV(DownloadPackets);
+        mimeType = "text/csv";
+    }
+    else if (format === "json") {
+        content = packetsToJSON(DownloadPackets);
+        mimeType = "application/json";
+    }
+    else if (format === "xml") {
+        content = packetsToXML(DownloadPackets);
+        mimeType = "application/xml";
+    }
+    const now = new Date();
+    // YYYY-MM-DD
+    const date = now.toISOString().split("T")[0];
+    // HH-MM-SS
+    const time = now.toTimeString().split(" ")[0].replace(/:/g, "-");
+    fileName = `data-export-${date}-${time}.${format}`;
+    // Create a Blob object containing the data
+    const blob = new Blob([content], { type: mimeType });
     // Create a URL for the Blob
     const url = window.URL.createObjectURL(blob);
     // Create a link element
     const link = document.createElement("a");
     // Set link attributes
     link.href = url;
-    link.setAttribute("download", "data.csv");
+    link.setAttribute("download", fileName);
     // Append link to document body
     document.body.appendChild(link);
     // Programmatically click the link to trigger the download

package/dist/led.d.ts

@@ -1,8 +1,8 @@
 import type { Device } from "./types/devices";
 declare class ClimbPlacement {
     position: number;
-    role_id: string;
-    constructor(position: number, role_id: string);
+    role_id: number;
+    constructor(position: number, role_id: number);
 }
 /**
  * Prepares byte arrays for transmission based on a list of climb placements.

package/dist/led.js

@@ -1,7 +1,7 @@
 import { write } from "./write";
 import { isConnected } from "./is-connected";
 import { KilterBoard, Motherboard } from "./devices";
-import { KilterBoardPacket } from "./commands/kilterboard";
+import { KilterBoardPacket, KilterBoardPlacementRoles } from "./commands/kilterboard";
 /**
  * Maximum length of the message body for byte wrapping.
  */
@@ -102,8 +102,11 @@ export function prepBytesV3(climbPlacementList) {
             resultArray.push(tempArray);
             tempArray = [KilterBoardPacket.V3_MIDDLE];
         }
-        const ledColor = climbPlacement.role_id;
-        const encodedPlacement = encodePlacement(climbPlacement.position, ledColor);
+        const role = KilterBoardPlacementRoles.find((placement) => placement.id === climbPlacement.role_id);
+        if (!role) {
+            throw new Error(`Role with id ${climbPlacement.role_id} not found in placement_roles`);
+        }
+        const encodedPlacement = encodePlacement(climbPlacement.position, role.led_color);
         tempArray.push(...encodedPlacement);
     }
     resultArray.push(tempArray);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hangtime/grip-connect",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "A client that can establish connections with various Force-Sensing Hangboards/Plates used by climbers for strength measurement. Examples of such hangboards include the Griptonite Motherboard, Climbro, SmartBoard, Entralpi or Tindeq Progressor",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,7 +23,9 @@
     "motherboard",
     "tindeq",
     "progressor",
-    "entralpi"
+    "entralpi",
+    "wh-c06",
+    "kilterboard"
   ],
   "bugs": {
     "url": "https://github.com/Stevie-Ray/hangtime-grip-connect/issues"

package/src/commands/kilterboard.ts

@@ -21,3 +21,44 @@ export 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,
 }
+/**
+ * Extracted from placement_roles database table.
+ */
+export const KilterBoardPlacementRoles = [
+  {
+    id: 12,
+    product_id: 1,
+    position: 1,
+    name: "start",
+    full_name: "Start",
+    led_color: "00FF00",
+    screen_color: "00DD00",
+  },
+  {
+    id: 13,
+    product_id: 1,
+    position: 2,
+    name: "middle",
+    full_name: "Middle",
+    led_color: "00FFFF",
+    screen_color: "00FFFF",
+  },
+  {
+    id: 14,
+    product_id: 1,
+    position: 3,
+    name: "finish",
+    full_name: "Finish",
+    led_color: "FF00FF",
+    screen_color: "FF00FF",
+  },
+  {
+    id: 15,
+    product_id: 1,
+    position: 4,
+    name: "foot",
+    full_name: "Foot Only",
+    led_color: "FFA500",
+    screen_color: "FFA500",
+  },
+]

package/src/connect.ts

@@ -12,7 +12,7 @@ const receiveBuffer: number[] = []
 const onDisconnected = (event: Event, board: Device): void => {
   board.device = undefined
   const device = event.target as BluetoothDevice
-  console.log(`Device ${device.name} is disconnected.`)
+  throw new Error(`Device ${device.name} is disconnected.`)
 }
 /**
  * Handles notifications received from a characteristic.
@@ -62,52 +62,47 @@ const handleNotifications = (event: Event, board: Device): void => {
  * @param {Function} onSuccess - Callback function to execute on successful connection.
  */
 const onConnected = async (board: Device, onSuccess: () => void): Promise<void> => {
-  try {
-    // Connect to GATT server and set up characteristics
-    const services: BluetoothRemoteGATTService[] = await server.getPrimaryServices()
+  // Connect to GATT server and set up characteristics
+  const services: BluetoothRemoteGATTService[] = await server.getPrimaryServices()
 
-    if (!services || services.length === 0) {
-      console.error("No services found")
-      return
-    }
+  if (!services || services.length === 0) {
+    throw new Error("No services found")
+  }
 
-    for (const service of services) {
-      const matchingService = board.services.find((boardService) => boardService.uuid === service.uuid)
+  for (const service of services) {
+    const matchingService = board.services.find((boardService) => boardService.uuid === service.uuid)
 
-      if (matchingService) {
-        // Android bug: Introduce a delay before getting characteristics
-        await new Promise((resolve) => setTimeout(resolve, 100))
+    if (matchingService) {
+      // Android bug: Introduce a delay before getting characteristics
+      await new Promise((resolve) => setTimeout(resolve, 100))
 
-        const characteristics = await service.getCharacteristics()
+      const characteristics = await service.getCharacteristics()
 
-        for (const characteristic of matchingService.characteristics) {
-          const matchingCharacteristic = characteristics.find((char) => char.uuid === characteristic.uuid)
+      for (const characteristic of matchingService.characteristics) {
+        const matchingCharacteristic = characteristics.find((char) => char.uuid === characteristic.uuid)
 
-          if (matchingCharacteristic) {
-            const element = matchingService.characteristics.find((char) => char.uuid === matchingCharacteristic.uuid)
-            if (element) {
-              element.characteristic = matchingCharacteristic
+        if (matchingCharacteristic) {
+          const element = matchingService.characteristics.find((char) => char.uuid === matchingCharacteristic.uuid)
+          if (element) {
+            element.characteristic = matchingCharacteristic
 
-              // notify
-              if (element.id === "rx") {
-                matchingCharacteristic.startNotifications()
-                matchingCharacteristic.addEventListener("characteristicvaluechanged", (event: Event) => {
-                  handleNotifications(event, board)
-                })
-              }
+            // notify
+            if (element.id === "rx") {
+              matchingCharacteristic.startNotifications()
+              matchingCharacteristic.addEventListener("characteristicvaluechanged", (event: Event) => {
+                handleNotifications(event, board)
+              })
             }
-          } else {
-            console.warn(`Characteristic ${characteristic.uuid} not found in service ${service.uuid}`)
           }
+        } else {
+          throw new Error(`Characteristic ${characteristic.uuid} not found in service ${service.uuid}`)
         }
       }
     }
-
-    // Call the onSuccess callback after successful connection and setup
-    onSuccess()
-  } catch (error) {
-    console.error(error)
   }
+
+  // Call the onSuccess callback after successful connection and setup
+  onSuccess()
 }
 /**
  * Returns UUIDs of all services associated with the device.
@@ -120,9 +115,14 @@ const getAllServiceUUIDs = (device: Device) => {
 /**
  * Connects to a Bluetooth device.
  * @param {Device} board - The device to connect to.
- * @param {Function} onSuccess - Callback function to execute on successful connection.
+ * @param {Function} [onSuccess] - Optional callback function to execute on successful connection. Default logs success.
+ * @param {Function} [onError] - Optional callback function to execute on error. Default logs the error.
  */
-export const connect = async (board: Device, onSuccess: () => void): Promise<void> => {
+export const connect = async (
+  board: Device,
+  onSuccess: () => void = () => console.log("Connected successfully"),
+  onError: (error: Error) => void = (error) => console.error(error),
+): Promise<void> => {
   try {
     // Request device and set up connection
     const deviceServices = getAllServiceUUIDs(board)
@@ -141,8 +141,7 @@ export const connect = async (board: Device, onSuccess: () => void): Promise<voi
     board.device = device
 
     if (!board.device.gatt) {
-      console.error("GATT is not available on this device")
-      return
+      throw new Error("GATT is not available on this device")
     }
 
     board.device.addEventListener("gattserverdisconnected", (event) => {
@@ -162,8 +161,18 @@ export const connect = async (board: Device, onSuccess: () => void): Promise<voi
       }
     })
 
+    // When the companyIdentifier is provided we want to get manufacturerData using watchAdvertisements.
     if (optionalManufacturerData.length) {
-      await board.device.watchAdvertisements()
+      // Receive events when the system receives an advertisement packet from a watched device.
+      // To use this function in Chrome: chrome://flags/#enable-experimental-web-platform-features has to be enabled.
+      // More info: https://chromestatus.com/feature/5180688812736512
+      if (typeof board.device.watchAdvertisements === "function") {
+        await board.device.watchAdvertisements()
+      } else {
+        throw new Error(
+          "watchAdvertisements isn't supported. For Chrome, enable it at chrome://flags/#enable-experimental-web-platform-features.",
+        )
+      }
     }
 
     server = await board.device.gatt.connect()
@@ -172,6 +181,6 @@ export const connect = async (board: Device, onSuccess: () => void): Promise<voi
       await onConnected(board, onSuccess)
     }
   } catch (error) {
-    console.error(error)
+    onError(error as Error)
   }
 }

package/src/download.ts

@@ -32,14 +32,74 @@ const packetsToCSV = (data: DownloadPacket[]): string => {
 }
 
 /**
- * Exports the data as a CSV file.
+ * Converts an array of DownloadPacket objects to a JSON string.
+ * @param data - Array of DownloadPacket objects.
+ * @returns JSON string representation of the data.
+ */
+const packetsToJSON = (data: DownloadPacket[]): string => {
+  return JSON.stringify(data, null, 2) // Pretty print JSON with 2-space indentation
+}
+
+/**
+ * Converts an array of DownloadPacket objects to an XML string.
+ * @param data - Array of DownloadPacket objects.
+ * @returns XML string representation of the data.
+ */
+const packetsToXML = (data: DownloadPacket[]): string => {
+  const xmlPackets = data
+    .map((packet) => {
+      const samples = packet.samples.map((sample) => `<sample>${sample}</sample>`).join("")
+      const masses = packet.masses.map((mass) => `<mass>${mass}</mass>`).join("")
+      return `
+        <packet>
+          <received>${packet.received}</received>
+          <sampleNum>${packet.sampleNum}</sampleNum>
+          <battRaw>${packet.battRaw}</battRaw>
+          <samples>${samples}</samples>
+          <masses>${masses}</masses>
+        </packet>
+      `
+    })
+    .join("")
+
+  return `<DownloadPackets>${xmlPackets}</DownloadPackets>`
+}
+
+/**
+ * Exports the data in the specified format (CSV, JSON, XML) with a filename format:
+ * 'data-export-YYYY-MM-DD-HH-MM-SS.{format}'.
+ *
+ * @param {('csv' | 'json' | 'xml')} [format='csv'] - The format in which to download the data.
+ * Defaults to 'csv'. Accepted values are 'csv', 'json', and 'xml'.
+ *
+ * @returns {void} Initiates a download of the data in the specified format.
  */
-export const download = (): void => {
-  // Generate CSV string from DownloadPackets array
-  const csvContent: string = packetsToCSV(DownloadPackets)
+export const download = (format: "csv" | "json" | "xml" = "csv"): void => {
+  let content = ""
+  let mimeType = ""
+  let fileName = ""
+
+  if (format === "csv") {
+    content = packetsToCSV(DownloadPackets)
+    mimeType = "text/csv"
+  } else if (format === "json") {
+    content = packetsToJSON(DownloadPackets)
+    mimeType = "application/json"
+  } else if (format === "xml") {
+    content = packetsToXML(DownloadPackets)
+    mimeType = "application/xml"
+  }
+
+  const now = new Date()
+  // YYYY-MM-DD
+  const date = now.toISOString().split("T")[0]
+  // HH-MM-SS
+  const time = now.toTimeString().split(" ")[0].replace(/:/g, "-")
+
+  fileName = `data-export-${date}-${time}.${format}`
 
-  // Create a Blob object containing the CSV data
-  const blob = new Blob([csvContent], { type: "text/csv" })
+  // Create a Blob object containing the data
+  const blob = new Blob([content], { type: mimeType })
 
   // Create a URL for the Blob
   const url = window.URL.createObjectURL(blob)
@@ -49,7 +109,7 @@ export const download = (): void => {
 
   // Set link attributes
   link.href = url
-  link.setAttribute("download", "data.csv")
+  link.setAttribute("download", fileName)
 
   // Append link to document body
   document.body.appendChild(link)

package/src/led.ts

@@ -2,7 +2,8 @@ import type { Device } from "./types/devices"
 import { write } from "./write"
 import { isConnected } from "./is-connected"
 import { KilterBoard, Motherboard } from "./devices"
-import { KilterBoardPacket } from "./commands/kilterboard"
+import { KilterBoardPacket, KilterBoardPlacementRoles } from "./commands/kilterboard"
+
 /**
  * Maximum length of the message body for byte wrapping.
  */
@@ -46,9 +47,9 @@ function wrapBytes(data: number[]) {
 }
 class ClimbPlacement {
   position: number
-  role_id: string
+  role_id: number
 
-  constructor(position: number, role_id: string) {
+  constructor(position: number, role_id: number) {
     this.position = position
     this.role_id = role_id
   }
@@ -109,10 +110,11 @@ export function prepBytesV3(climbPlacementList: ClimbPlacement[]) {
       resultArray.push(tempArray)
       tempArray = [KilterBoardPacket.V3_MIDDLE]
     }
-
-    const ledColor = climbPlacement.role_id
-
-    const encodedPlacement = encodePlacement(climbPlacement.position, ledColor)
+    const role = KilterBoardPlacementRoles.find((placement) => placement.id === climbPlacement.role_id)
+    if (!role) {
+      throw new Error(`Role with id ${climbPlacement.role_id} not found in placement_roles`)
+    }
+    const encodedPlacement = encodePlacement(climbPlacement.position, role.led_color)
     tempArray.push(...encodedPlacement)
   }