@hangtime/grip-connect 0.4.2 → 0.5.1

package/src/data/wh-c06.ts

@@ -1,47 +0,0 @@
-import { checkActivity } from "./../is-active"
-import { notifyCallback } from "./../notify"
-import { applyTare } from "./../tare"
-
-// Constants
-let MASS_MAX = "0"
-let MASS_AVERAGE = "0"
-let MASS_TOTAL_SUM = 0
-let DATAPOINT_COUNT = 0
-const WEIGHT_OFFSET = 10
-// const STABLE_OFFSET = 14
-
-/**
- * Handles data received from the WH-C06 device.
- * @param {DataView} data - The received data.
- */
-export const handleWHC06Data = (data: DataView): void => {
-  const weight = (data.getUint8(WEIGHT_OFFSET) << 8) | data.getUint8(WEIGHT_OFFSET + 1)
-  // const stable = (data.getUint8(STABLE_OFFSET) & 0xf0) >> 4
-  // const unit = data.getUint8(STABLE_OFFSET) & 0x0f
-
-  let numericData = weight / 100
-
-  // Tare correction
-  numericData -= applyTare(numericData)
-
-  // Update MASS_MAX
-  MASS_MAX = Math.max(Number(MASS_MAX), numericData).toFixed(1)
-
-  // Update running sum and count
-  const currentMassTotal = Math.max(-1000, numericData)
-  MASS_TOTAL_SUM += currentMassTotal
-  DATAPOINT_COUNT++
-
-  // Calculate the average dynamically
-  MASS_AVERAGE = (MASS_TOTAL_SUM / DATAPOINT_COUNT).toFixed(1)
-
-  // Check if device is being used
-  checkActivity(numericData)
-
-  // Notify with weight data
-  notifyCallback({
-    massMax: MASS_MAX,
-    massAverage: MASS_AVERAGE,
-    massTotal: Math.max(-1000, numericData).toFixed(1),
-  })
-}

package/src/devices/climbro.ts

@@ -1,10 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Represents a Climbro device
- * TODO: Add services, do you own a Climbro? Help us!
- */
-export const Climbro: Device = {
-  filters: [{ name: "Climbro" }],
-  services: [],
-}

package/src/devices/entralpi.ts

@@ -1,61 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Represents a Entralpi device
- */
-export const Entralpi: Device = {
-  filters: [
-    {
-      name: "ENTRALPI",
-    },
-  ],
-  services: [
-    {
-      name: "Device Information",
-      id: "device",
-      uuid: "0000180a-0000-1000-8000-00805f9b34fb",
-      characteristics: [],
-    },
-    {
-      name: "Battery Service",
-      id: "battery",
-      uuid: "0000180f-0000-1000-8000-00805f9b34fb",
-      characteristics: [],
-    },
-    {
-      name: "Generic Attribute",
-      id: "attribute",
-      uuid: "00001801-0000-1000-8000-00805f9b34fb",
-      characteristics: [],
-    },
-    {
-      name: "UART ISSC Transparent Service",
-      id: "uart",
-      uuid: "0000fff0-0000-1000-8000-00805f9b34fb",
-      characteristics: [
-        {
-          name: "TX",
-          id: "tx",
-          uuid: "0000fff5-0000-1000-8000-00805f9b34fb",
-        },
-        {
-          name: "RX",
-          id: "rx",
-          uuid: "0000fff4-0000-1000-8000-00805f9b34fb",
-        },
-      ],
-    },
-    {
-      name: "Weight Scale",
-      id: "weight",
-      uuid: "0000181d-0000-1000-8000-00805f9b34fb",
-      characteristics: [],
-    },
-    {
-      name: "Generic Access",
-      id: "access",
-      uuid: "00001800-0000-1000-8000-00805f9b34fb",
-      characteristics: [],
-    },
-  ],
-}

package/src/devices/index.ts

@@ -1,13 +0,0 @@
-export { Climbro } from "./climbro"
-
-export { Entralpi } from "./entralpi"
-
-export { KilterBoard } from "./kilterboard"
-
-export { Motherboard } from "./motherboard"
-
-export { mySmartBoard } from "./mysmartboard"
-
-export { WHC06 } from "./wh-c06"
-
-export { Progressor } from "./progressor"

package/src/devices/kilterboard.ts

@@ -1,37 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Aurora Climbing Advertising service
- */
-export const AuroraUUID = "4488b571-7806-4df6-bcff-a2897e4953ff"
-
-/**
- * Represents a Aurora Climbing device
- * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
- */
-export const KilterBoard: Device = {
-  filters: [
-    {
-      services: [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",
-        // },
-      ],
-    },
-  ],
-}

package/src/devices/motherboard.ts

@@ -1,83 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Represents a Griptonite Motherboard device
- */
-export const Motherboard: Device = {
-  filters: [{ name: "Motherboard" }],
-  services: [
-    {
-      name: "Device Information",
-      id: "device",
-      uuid: "0000180a-0000-1000-8000-00805f9b34fb",
-      characteristics: [
-        // {
-        //     name: 'Serial Number (Blocked)',
-        //     id: 'serial'
-        //     uuid: '00002a25-0000-1000-8000-00805f9b34fb'
-        // },
-        {
-          name: "Firmware Revision",
-          id: "firmware",
-          uuid: "00002a26-0000-1000-8000-00805f9b34fb",
-        },
-        {
-          name: "Hardware Revision",
-          id: "hardware",
-          uuid: "00002a27-0000-1000-8000-00805f9b34fb",
-        },
-        {
-          name: "Manufacturer Name",
-          id: "manufacturer",
-          uuid: "00002a29-0000-1000-8000-00805f9b34fb",
-        },
-      ],
-    },
-    {
-      name: "Battery Service",
-      id: "battery",
-      uuid: "0000180f-0000-1000-8000-00805f9b34fb",
-      characteristics: [
-        {
-          name: "Battery Level",
-          id: "level",
-          uuid: "00002a19-0000-1000-8000-00805f9b34fb",
-        },
-      ],
-    },
-    {
-      name: "LED Service",
-      id: "led",
-      uuid: "10ababcd-15e1-28ff-de13-725bea03b127",
-      characteristics: [
-        {
-          name: "Red LED",
-          id: "red",
-          uuid: "10ab1524-15e1-28ff-de13-725bea03b127",
-        },
-        {
-          name: "Green LED",
-          id: "green",
-          uuid: "10ab1525-15e1-28ff-de13-725bea03b127",
-        },
-      ],
-    },
-    {
-      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",
-        },
-      ],
-    },
-  ],
-}

package/src/devices/mysmartboard.ts

@@ -1,10 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Represents a mySmartBoard device
- * TODO: Add services, do you own a mySmartBoard? Help us!
- */
-export const mySmartBoard: Device = {
-  filters: [{ name: "mySmartBoard" }],
-  services: [],
-}

package/src/devices/progressor.ts

@@ -1,38 +0,0 @@
-import type { Device } from "../types/devices"
-/**
- * Represents a Tindeq Progressor device
- */
-export const Progressor: Device = {
-  filters: [{ namePrefix: "Progressor" }],
-  services: [
-    {
-      name: "Progressor Service",
-      id: "progressor",
-      uuid: "7e4e1701-1ea6-40c9-9dcc-13d34ffead57",
-      characteristics: [
-        {
-          name: "Notify",
-          id: "rx",
-          uuid: "7e4e1702-1ea6-40c9-9dcc-13d34ffead57",
-        },
-        {
-          name: "Write",
-          id: "tx",
-          uuid: "7e4e1703-1ea6-40c9-9dcc-13d34ffead57",
-        },
-      ],
-    },
-    {
-      name: "Nordic Device Firmware Update (DFU) Service",
-      id: "dfu",
-      uuid: "0000fe59-0000-1000-8000-00805f9b34fb",
-      characteristics: [
-        {
-          name: "Buttonless DFU",
-          id: "dfu",
-          uuid: "8ec90003-f315-4f60-9fb8-838830daea50",
-        },
-      ],
-    },
-  ],
-}

package/src/devices/wh-c06.ts

@@ -1,19 +0,0 @@
-import type { Device } from "../types/devices"
-
-/**
- * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
- * Enable 'Experimental Web Platform features' Chrome Flags.
- */
-export const WHC06: Device = {
-  filters: [
-    {
-      // namePrefix: "IF_B7",
-      manufacturerData: [
-        {
-          companyIdentifier: 0x0100, // 256
-        },
-      ],
-    },
-  ],
-  services: [],
-}

package/src/disconnect.ts

@@ -1,16 +0,0 @@
-import type { Device } from "./types/devices"
-import { isConnected } from "./is-connected"
-
-/**
- * Disconnects the device if it is currently connected.
- * - Checks if the device is connected via its GATT server.
- * - If the device is connected, it attempts to gracefully disconnect.
- * @param {Device} board - The device to be disconnected. The device must have a `gatt` property accessible through `board.device`.
- */
-export const disconnect = (board: Device): void => {
-  // Verify that the device is connected using the provided helper function
-  if (isConnected(board)) {
-    // Safely attempt to disconnect the device's GATT server, if available
-    board.device?.gatt?.disconnect()
-  }
-}

package/src/firmware.ts

@@ -1,36 +0,0 @@
-import type { Device } from "./types/devices"
-import { write } from "./write"
-import { read } from "./read"
-import { isConnected } from "./is-connected"
-import { ProgressorCommands } from "./commands"
-import { isMotherboard, isProgressor } from "./is-device"
-
-/**
- * Retrieves firmware version from the device.
- * - For Motherboard devices, it reads the firmare version.
- * - For Progressor devices, it sends a command to retrieve firware version.
- *
- * @param {Device} board - The device from which to retrieve firmware version.
- * @returns {Promise<string>} A Promise that resolves with the firmware version,
- */
-export const firmware = async (board: Device): Promise<string | undefined> => {
-  // Check if the device is connected
-  if (isConnected(board)) {
-    // If the device is connected and it is a Motherboard device
-    if (isMotherboard(board)) {
-      // Read firmware version from the Motherboard
-      return await read(board, "device", "firmware", 250)
-    }
-    // If the device is connected and its name starts with "Progressor"
-    if (isProgressor(board)) {
-      // Write command to get firmware version information to the Progressor
-      let response: string | undefined = undefined
-      await write(board, "progressor", "tx", ProgressorCommands.GET_FW_VERSION, 250, (data) => {
-        response = data
-      })
-      return response
-    }
-  }
-  // If device is not found, return undefined
-  return undefined
-}

package/src/hardware.ts

@@ -1,24 +0,0 @@
-import type { Device } from "./types/devices"
-import { read } from "./read"
-import { isConnected } from "./is-connected"
-import { isMotherboard } from "./is-device"
-
-/**
- * Retrieves hardware version from the device.
- * - For Motherboard devices, it reads the hardware version.
- *
- * @param {Device} board - The device from which to retrieve hardware version.
- * @returns {Promise<string>} A Promise that resolves with the hardware version,
- */
-export const hardware = async (board: Device): Promise<string | undefined> => {
-  // Check if the device is connected
-  if (isConnected(board)) {
-    // If the device is connected and it is a Motherboard device
-    if (isMotherboard(board)) {
-      // Read hardware version from the Motherboard
-      return await read(board, "device", "hardware", 250)
-    }
-  }
-  // If device is not found, return undefined
-  return
-}

package/src/is-connected.ts

@@ -1,15 +0,0 @@
-import type { Device } from "./types/devices"
-
-/**
- * Checks if a Bluetooth device is connected.
- * @param {Device} board - The device to check for connection.
- * @returns {boolean} A boolean indicating whether the device is connected.
- */
-export const isConnected = (board?: Device): boolean => {
-  // Check if the device is defined and available
-  if (!board?.device) {
-    return false
-  }
-  // Check if the device is connected
-  return !!board.device.gatt?.connected
-}

package/src/led.ts

@@ -1,210 +0,0 @@
-import type { Device } from "./types/devices"
-import { write } from "./write"
-import { isConnected } from "./is-connected"
-import { KilterBoardPacket, KilterBoardPlacementRoles } from "./commands/kilterboard"
-import { isKilterboard, isMotherboard } from "./is-device"
-
-/**
- * Maximum length of the message body for byte wrapping.
- */
-const MESSAGE_BODY_MAX_LENGTH = 255
-/**
- * Maximum length of the the bluetooth chunk.
- */
-const MAX_BLUETOOTH_MESSAGE_SIZE = 20
-/**
- * Calculates the checksum for a byte array by summing up all bytes ot hre packet in a single-byte variable.
- * @param data - The array of bytes to calculate the checksum for.
- * @returns The calculated checksum value.
- */
-function checksum(data: number[]) {
-  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 The wrapped byte array.
- */
-function wrapBytes(data: number[]) {
-  if (data.length > MESSAGE_BODY_MAX_LENGTH) {
-    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, checksum(data), 2, ...data, 3]
-}
-class ClimbPlacement {
-  position: number
-  role_id: number
-
-  constructor(position: number, role_id: number) {
-    this.position = position
-    this.role_id = role_id
-  }
-}
-/**
- * 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.
- * @param position - The position to encode.
- * @returns The encoded byte array representing the position.
- */
-function encodePosition(position: number) {
-  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).
- * @param color - The color string in hexadecimal format (e.g., 'FFFFFF').
- * @returns The encoded /compressed color value.
- */
-function encodeColor(color: string) {
-  const substring = color.substring(0, 2)
-  const substring2 = color.substring(2, 4)
-
-  const parsedSubstring = parseInt(substring, 16) / 32
-  const parsedSubstring2 = parseInt(substring2, 16) / 32
-  const parsedResult = (parsedSubstring << 5) | (parsedSubstring2 << 2)
-
-  const substring3 = color.substring(4, 6)
-  const parsedSubstring3 = parseInt(substring3, 16) / 64
-  const finalParsedResult = parsedResult | parsedSubstring3
-
-  return finalParsedResult
-}
-/**
- * Encodes a placement (requires a 16-bit position and a 24-bit rgb color. ) into a byte array.
- * @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.
- */
-function encodePlacement(position: number, ledColor: string) {
-  return [...encodePosition(position), encodeColor(ledColor)]
-}
-/**
- * Prepares byte arrays for transmission based on a list of climb placements.
- * @param climbPlacementList - The list of climb placements containing position and role ID.
- * @returns The final byte array ready for transmission.
- */
-export function prepBytesV3(climbPlacementList: ClimbPlacement[]) {
-  const resultArray: number[][] = []
-  let tempArray: number[] = [KilterBoardPacket.V3_MIDDLE]
-
-  for (const climbPlacement of climbPlacementList) {
-    if (tempArray.length + 3 > MESSAGE_BODY_MAX_LENGTH) {
-      resultArray.push(tempArray)
-      tempArray = [KilterBoardPacket.V3_MIDDLE]
-    }
-    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)
-
-  if (resultArray.length === 1) {
-    resultArray[0][0] = KilterBoardPacket.V3_ONLY
-  } else if (resultArray.length > 1) {
-    resultArray[0][0] = KilterBoardPacket.V3_FIRST
-    resultArray[resultArray.length - 1][0] = KilterBoardPacket.V3_LAST
-  }
-
-  const finalResultArray: number[] = []
-  for (const currentArray of resultArray) {
-    finalResultArray.push(...wrapBytes(currentArray))
-  }
-
-  return finalResultArray
-}
-/**
- * Splits a collection into slices of the specified length.
- * https://github.com/ramda/ramda/blob/master/source/splitEvery.js
- * @param {Number} n
- * @param {Array} list
- * @return {Array}
- */
-function splitEvery(n: number, list: number[]) {
-  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
-}
-/**
- * The kilter board only supports messages of 20 bytes
- * at a time. This method splits a full message into parts
- * of 20 bytes
- *
- * @param buffer
- */
-const splitMessages = (buffer: number[]) =>
-  splitEvery(MAX_BLUETOOTH_MESSAGE_SIZE, buffer).map((arr) => new Uint8Array(arr))
-/**
- * Sends a series of messages to a device.
- */
-async function writeMessageSeries(board: Device, messages: Uint8Array[]) {
-  for (const message of messages) {
-    await write(board, "uart", "tx", message)
-  }
-}
-/**
- * Sets the LEDs on the specified device.
- *
- * - For Kilter Board: Configures the LEDs based on an array of climb placements. If a configuration is provided, it prepares and sends a payload to the device.
- * - For Motherboard: Sets the LED color based on a single color option. Defaults to turning the LEDs off if no configuration is provided.
- *
- * @param {Device} board - The device on which to set the LEDs.
- * @param {"green" | "red" | "orange" | ClimbPlacement[]} [config] - Optional color or array of climb placements for the LEDs. Ignored if placements are 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.
- */
-export const led = async (
-  board: Device,
-  config?: "green" | "red" | "orange" | ClimbPlacement[],
-): Promise<number[] | undefined> => {
-  // Handle Kilterboard logic: process placements and send payload if connected
-  if (isKilterboard(board) && Array.isArray(config)) {
-    // Prepares byte arrays for transmission based on a list of climb placements.
-    const payload = prepBytesV3(config)
-    if (isConnected(board)) {
-      await writeMessageSeries(board, splitMessages(payload))
-    }
-    return payload
-  }
-  // Handle Motherboard logic: set color if provided
-  if (isMotherboard(board)) {
-    const colorMapping: Record<string, number[][]> = {
-      green: [[0x00], [0x01]],
-      red: [[0x01], [0x00]],
-      orange: [[0x01], [0x01]],
-      off: [[0x00], [0x00]],
-    }
-    // Default to "off" color if config is not set or not found in colorMapping
-    const color = typeof config === "string" && colorMapping[config] ? config : "off"
-    const [redValue, greenValue] = colorMapping[color]
-    await write(board, "led", "red", new Uint8Array(redValue))
-    await write(board, "led", "green", new Uint8Array(greenValue), 1250)
-  }
-  return undefined
-}

package/src/manufacturer.ts

@@ -1,24 +0,0 @@
-import type { Device } from "./types/devices"
-import { read } from "./read"
-import { isConnected } from "./is-connected"
-import { isMotherboard } from "./is-device"
-
-/**
- * Retrieves manufacturer information from the device.
- * - For Motherboard devices, it reads the manufacturer information.
- *
- * @param {Device} board - The device from which to retrieve manufacturer information.
- * @returns {Promise<string>} A Promise that resolves with the manufacturer information,
- */
-export const manufacturer = async (board: Device): Promise<string | undefined> => {
-  // Check if the device is connected
-  if (isConnected(board)) {
-    // If the device is connected and it is a Motherboard device
-    if (isMotherboard(board)) {
-      // Read manufacturer information from the Motherboard
-      return await read(board, "device", "manufacturer", 250)
-    }
-  }
-  // If device is not found, return undefined
-  return undefined
-}

package/src/notify.ts

@@ -1,18 +0,0 @@
-import type { massObject } from "./types/notify"
-/** Define the type for the callback function */
-type NotifyCallback = (data: massObject) => void
-/**
- * Defines the type for the callback function.
- * @callback NotifyCallback
- * @param {massObject} data - The data passed to the callback.
- */
-export let notifyCallback: NotifyCallback
-
-/**
- * Sets the callback function to be called when notifications are received.
- * @param {NotifyCallback} callback - The callback function to be set.
- * @returns {void}
- */
-export const notify = (callback: NotifyCallback): void => {
-  notifyCallback = callback
-}