@hangtime/grip-connect 0.3.1 → 0.3.3

package/src/calibration.d.ts

@@ -1,7 +0,0 @@
-import { Device } from "./devices/types";
-/**
- * Writes a command to get calibration data from the device.
- * @param {Device} board - The device.
- * @returns {Promise<void>} A Promise that resolves when the command is successfully sent.
- */
-export declare const calibration: (board: Device) => Promise<void>;

package/src/calibration.js

@@ -1,19 +0,0 @@
-import { isConnected } from "./is-connected";
-import { write } from "./write";
-import { Motherboard } from "./devices";
-import { MotherboardCommands } from "./commands";
-/**
- * Writes a command to get calibration data from the device.
- * @param {Device} board - The device.
- * @returns {Promise<void>} A Promise that resolves when the command is successfully sent.
- */
-export const calibration = async (board) => {
-    // Check if the device is connected
-    if (isConnected(board)) {
-        // If the device is connected, and it is a Motherboard device
-        if (board.name === "Motherboard") {
-            // Write the command to get calibration data to the device
-            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_CALIBRATION, 2500);
-        }
-    }
-};

package/src/characteristic.d.ts

@@ -1,10 +0,0 @@
-/// <reference types="web-bluetooth" />
-import { Device } from "./devices/types";
-/**
- * Retrieves the characteristic from the device's service.
- * @param {Device} board - The device.
- * @param {string} serviceId - The UUID of the service.
- * @param {string} characteristicId - The UUID of the characteristic.
- * @returns {BluetoothRemoteGATTCharacteristic | undefined} The characteristic, if found.
- */
-export declare const getCharacteristic: (board: Device, serviceId: string, characteristicId: string) => BluetoothRemoteGATTCharacteristic | undefined;

package/src/characteristic.js

@@ -1,20 +0,0 @@
-/**
- * Retrieves the characteristic from the device's service.
- * @param {Device} board - The device.
- * @param {string} serviceId - The UUID of the service.
- * @param {string} characteristicId - The UUID of the characteristic.
- * @returns {BluetoothRemoteGATTCharacteristic | undefined} The characteristic, if found.
- */
-export const getCharacteristic = (board, serviceId, characteristicId) => {
-    // Find the service with the specified serviceId
-    const boardService = board.services.find((service) => service.id === serviceId);
-    if (boardService) {
-        // If the service is found, find the characteristic with the specified characteristicId
-        const boardCharacteristic = boardService.characteristics.find((characteristic) => characteristic.id === characteristicId);
-        if (boardCharacteristic) {
-            // If the characteristic is found, return it
-            return boardCharacteristic.characteristic;
-        }
-    }
-    // Return undefined if the service or characteristic is not found
-};

package/src/commands/climbro.d.ts

@@ -1,6 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const ClimbroCommands: Commands;

package/src/commands/climbro.js

@@ -1,5 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const ClimbroCommands = {};

package/src/commands/entralpi.d.ts

@@ -1,6 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const EntralpiCommands: Commands;

package/src/commands/entralpi.js

@@ -1,5 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const EntralpiCommands = {};

package/src/commands/index.d.ts

@@ -1,6 +0,0 @@
-export { ClimbroCommands } from "./climbro";
-export { EntralpiCommands } from "./entralpi";
-export { MotherboardCommands } from "./motherboard";
-export { MuscleMeterCommands } from "./musclemeter";
-export { ProgressorCommands } from "./progressor";
-export { mySmartBoardCommands } from "./mysmartboard";

package/src/commands/index.js

@@ -1,6 +0,0 @@
-export { ClimbroCommands } from "./climbro";
-export { EntralpiCommands } from "./entralpi";
-export { MotherboardCommands } from "./motherboard";
-export { MuscleMeterCommands } from "./musclemeter";
-export { ProgressorCommands } from "./progressor";
-export { mySmartBoardCommands } from "./mysmartboard";

package/src/commands/motherboard.d.ts

@@ -1,6 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const MotherboardCommands: Commands;

package/src/commands/motherboard.js

@@ -1,13 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const MotherboardCommands = {
-    GET_SERIAL: "#",
-    START_WEIGHT_MEAS: "S30",
-    STOP_WEIGHT_MEAS: "", // All commands will stop the data stream.
-    GET_CALIBRATION: "C",
-    SLEEP: 0,
-    GET_TEXT: "T",
-    DEBUG_STREAM: "D",
-};

package/src/commands/musclemeter.d.ts

@@ -1,6 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const MuscleMeterCommands: Commands;

package/src/commands/musclemeter.js

@@ -1,5 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const MuscleMeterCommands = {};

package/src/commands/mysmartboard.d.ts

@@ -1,6 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const mySmartBoardCommands: Commands;

package/src/commands/mysmartboard.js

@@ -1,5 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const mySmartBoardCommands = {};

package/src/commands/progressor.d.ts

@@ -1,17 +0,0 @@
-import { Commands } from "../commands/types";
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export declare const ProgressorCommands: Commands;
-/**
- * The Progressor returns a Uint8Array.
- * The first item [0] is the type of response it returns
- */
-export declare const ProgressorResponses: {
-    COMMAND_RESPONSE: number;
-    WEIGHT_MEASURE: number;
-    PEAK_RFD_MEAS: number;
-    PEAK_RFD_MEAS_SERIES: number;
-    LOW_BATTERY_WARNING: number;
-};

package/src/commands/progressor.js

@@ -1,29 +0,0 @@
-/**
- * Warning:
- * Using other commands can seriously harm your device
- */
-export const ProgressorCommands = {
-    TARE_SCALE: "d", // 0x64,
-    START_WEIGHT_MEAS: "e", // 0x65,
-    STOP_WEIGHT_MEAS: "f", // 0x66,
-    START_PEAK_RFD_MEAS: "g", //  0x67,
-    START_PEAK_RFD_MEAS_SERIES: "h", //  0x68,
-    ADD_CALIB_POINT: "i", //  0x69,
-    SAVE_CALIB: "j", //  0x6a,
-    GET_FW_VERSION: "k", //  0x6b,
-    GET_ERR_INFO: "l", //  0x6c,
-    CLR_ERR_INFO: "m", //  0x6d,
-    SLEEP: "n", // 0x6e,
-    GET_BATT_VLTG: "o", //  0x6f,
-};
-/**
- * The Progressor returns a Uint8Array.
- * The first item [0] is the type of response it returns
- */
-export const ProgressorResponses = {
-    COMMAND_RESPONSE: 0,
-    WEIGHT_MEASURE: 1,
-    PEAK_RFD_MEAS: 2,
-    PEAK_RFD_MEAS_SERIES: 3,
-    LOW_BATTERY_WARNING: 4,
-};

package/src/commands/types.d.ts

@@ -1,18 +0,0 @@
-export interface Commands {
-    START_WEIGHT_MEAS?: string;
-    STOP_WEIGHT_MEAS?: string;
-    SLEEP?: number | string;
-    GET_SERIAL?: string;
-    GET_TEXT?: string;
-    DEBUG_STREAM?: string;
-    GET_CALIBRATION?: string;
-    TARE_SCALE?: string;
-    START_PEAK_RFD_MEAS?: string;
-    START_PEAK_RFD_MEAS_SERIES?: string;
-    ADD_CALIB_POINT?: string;
-    SAVE_CALIB?: string;
-    GET_FW_VERSION?: string;
-    GET_ERR_INFO?: string;
-    CLR_ERR_INFO?: string;
-    GET_BATT_VLTG?: string;
-}

package/src/commands/types.js

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

package/src/connect.d.ts

@@ -1,7 +0,0 @@
-import { Device } from "./devices/types";
-/**
- * Connects to a Bluetooth device.
- * @param {Device} board - The device to connect to.
- * @param {Function} onSuccess - Callback function to execute on successful connection.
- */
-export declare const connect: (board: Device, onSuccess: () => void) => Promise<void>;

package/src/connect.js

@@ -1,152 +0,0 @@
-import { handleEntralpiData, handleMotherboardData, handleProgressorData } from "./data";
-let server;
-const receiveBuffer = [];
-/**
- * Handles the 'disconnected' event.
- * @param {Event} event - The 'disconnected' event.
- * @param {Device} board - The device that is disconnected.
- */
-const onDisconnected = (event, board) => {
-    board.device = undefined;
-    const device = event.target;
-    console.log(`Device ${device.name} is disconnected.`);
-};
-/**
- * Handles notifications received from a characteristic.
- * @param {Event} event - The notification event.
- * @param {Device} board - The device associated with the characteristic.
- */
-const handleNotifications = (event, board) => {
-    const characteristic = event.target;
-    const value = characteristic.value;
-    if (value) {
-        if (board.name === "Motherboard") {
-            for (let i = 0; i < value.byteLength; i++) {
-                receiveBuffer.push(value.getUint8(i));
-            }
-            let idx;
-            while ((idx = receiveBuffer.indexOf(10)) >= 0) {
-                const line = receiveBuffer.splice(0, idx + 1).slice(0, -1); // Combine and remove LF
-                if (line.length > 0 && line[line.length - 1] === 13)
-                    line.pop(); // Remove CR
-                const decoder = new TextDecoder("utf-8");
-                const receivedData = decoder.decode(new Uint8Array(line));
-                handleMotherboardData(receivedData);
-            }
-        }
-        else if (board.name === "ENTRALPI") {
-            if (value.buffer) {
-                const buffer = value.buffer;
-                const rawData = new DataView(buffer);
-                const receivedData = (rawData.getUint16(0) / 100).toFixed(1);
-                handleEntralpiData(receivedData);
-            }
-        }
-        else if (board.name && board.name.startsWith("Progressor")) {
-            if (value.buffer) {
-                const buffer = value.buffer;
-                const rawData = new DataView(buffer);
-                handleProgressorData(rawData);
-            }
-        }
-        else {
-            console.log(value);
-        }
-    }
-};
-/**
- * Handles the 'connected' event.
- * @param {Device} board - The connected device.
- * @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));
-                            }
-                        }
-                    }
-                    else {
-                        console.warn(`Characteristic ${characteristic.uuid} not found in service ${service.uuid}`);
-                    }
-                }
-            }
-        }
-        // Call the onSuccess callback after successful connection and setup
-        onSuccess();
-    }
-    catch (error) {
-        console.error(error);
-    }
-};
-/**
- * Returns UUIDs of all services associated with the device.
- * @param {Device} device - The device.
- * @returns {string[]} Array of service UUIDs.
- */
-const getAllServiceUUIDs = (device) => {
-    return device.services.map((service) => service.uuid);
-};
-/**
- * Connects to a Bluetooth device.
- * @param {Device} board - The device to connect to.
- * @param {Function} onSuccess - Callback function to execute on successful connection.
- */
-export const connect = async (board, onSuccess) => {
-    try {
-        // Request device and set up connection
-        const deviceServices = getAllServiceUUIDs(board);
-        // setup filter list
-        const filters = [];
-        if (board.name) {
-            const filterName = board.name === "Progressor" ? { namePrefix: board.name } : { name: board.name };
-            filters.push(filterName);
-        }
-        if (board.companyId) {
-            filters.push({
-                manufacturerData: [
-                    {
-                        companyIdentifier: board.companyId,
-                    },
-                ],
-            });
-        }
-        const device = await navigator.bluetooth.requestDevice({
-            filters: filters,
-            optionalServices: deviceServices,
-        });
-        board.device = device;
-        if (!board.device.gatt) {
-            console.error("GATT is not available on this device");
-            return;
-        }
-        server = await board.device?.gatt?.connect();
-        board.device.addEventListener("gattserverdisconnected", (event) => onDisconnected(event, board));
-        if (server.connected) {
-            await onConnected(board, onSuccess);
-        }
-    }
-    catch (error) {
-        console.error(error);
-    }
-};

package/src/data.d.ts

@@ -1,16 +0,0 @@
-export declare const CALIBRATION: never[][];
-/**
- * Handles data received from the Motherboard device.
- * @param {string} receivedData - The received data string.
- */
-export declare const handleMotherboardData: (receivedData: string) => void;
-/**
- * Handles data received from the Progressor device.
- * @param {DataView} data - The received data.
- */
-export declare const handleProgressorData: (data: DataView) => void;
-/**
- * Handles data received from the Entralpi device.
- * @param {string} receivedData - The received data string.
- */
-export declare const handleEntralpiData: (receivedData: string) => void;

package/src/data.js

@@ -1,220 +0,0 @@
-import { notifyCallback } from "./notify";
-import { applyTare } from "./tare";
-import { ProgressorCommands, ProgressorResponses } from "./commands/progressor";
-import { MotherboardCommands } from "./commands";
-import { lastWrite } from "./write";
-import { DownloadPackets } from "./download";
-import struct from "./struct";
-// Constants
-const PACKET_LENGTH = 32;
-const NUM_SAMPLES = 3;
-let MASS_MAX = "0";
-let MASS_AVERAGE = "0";
-let MASS_TOTAL_SUM = 0;
-let DATAPOINT_COUNT = 0;
-export const CALIBRATION = [[], [], [], []];
-/**
- * Applies calibration to a sample value.
- * @param {number} sample - The sample value to calibrate.
- * @param {number[][]} calibration - The calibration data.
- * @returns {number} The calibrated sample value.
- */
-const applyCalibration = (sample, calibration) => {
-    // Extract the calibrated value for the zero point
-    const zeroCalibration = calibration[0][2];
-    // Initialize sign as positive
-    let sign = 1;
-    // Initialize the final calibrated value
-    let final = 0;
-    // If the sample value is less than the zero calibration point
-    if (sample < zeroCalibration) {
-        // Change the sign to negative
-        sign = -1;
-        // Reflect the sample around the zero calibration point
-        sample = /* 2 * zeroCalibration */ -sample;
-    }
-    // Iterate through the calibration data
-    for (let i = 1; i < calibration.length; i++) {
-        // Extract the lower and upper bounds of the current calibration range
-        const calibrationStart = calibration[i - 1][2];
-        const calibrationEnd = calibration[i][2];
-        // If the sample value is within the current calibration range
-        if (sample < calibrationEnd) {
-            // Interpolate to get the calibrated value within the range
-            final =
-                calibration[i - 1][1] +
-                    ((sample - calibrationStart) / (calibrationEnd - calibrationStart)) *
-                        (calibration[i][1] - calibration[i - 1][1]);
-            break;
-        }
-    }
-    // Return the calibrated value with the appropriate sign (positive/negative)
-    return sign * final;
-};
-/**
- * Handles data received from the Motherboard device.
- * @param {string} receivedData - The received data string.
- */
-export const handleMotherboardData = (receivedData) => {
-    const receivedTime = Date.now();
-    // Check if the line is entirely hex characters
-    const isAllHex = /^[0-9A-Fa-f]+$/g.test(receivedData);
-    // Handle streaming packet
-    if (isAllHex && receivedData.length === PACKET_LENGTH) {
-        // Base-16 decode the string: convert hex pairs to byte values
-        const bytes = Array.from({ length: receivedData.length / 2 }, (_, i) => Number(`0x${receivedData.substring(i * 2, i * 2 + 2)}`));
-        // Translate header into packet, number of samples from the packet length
-        const packet = {
-            received: receivedTime,
-            sampleNum: new DataView(new Uint8Array(bytes).buffer).getUint16(0, true),
-            battRaw: new DataView(new Uint8Array(bytes).buffer).getUint16(2, true),
-            samples: [],
-            masses: [],
-        };
-        const dataView = new DataView(new Uint8Array(bytes).buffer);
-        for (let i = 0; i < NUM_SAMPLES; i++) {
-            const sampleStart = 4 + 3 * i;
-            // Use DataView to read the 24-bit unsigned integer
-            const rawValue = dataView.getUint8(sampleStart) |
-                (dataView.getUint8(sampleStart + 1) << 8) |
-                (dataView.getUint8(sampleStart + 2) << 16);
-            // Ensure unsigned 32-bit integer
-            packet.samples[i] = rawValue >>> 0;
-            if (packet.samples[i] >= 0x7fffff) {
-                packet.samples[i] -= 0x1000000;
-            }
-            packet.masses[i] = applyCalibration(packet.samples[i], CALIBRATION[i]);
-        }
-        // invert center and right values
-        packet.masses[1] *= -1;
-        packet.masses[2] *= -1;
-        // Add data to downloadable Array
-        DownloadPackets.push({
-            received: packet.received,
-            sampleNum: packet.battRaw,
-            battRaw: packet.received,
-            samples: [...packet.samples],
-            masses: [...packet.masses],
-        });
-        let left = packet.masses[0];
-        let center = packet.masses[1];
-        let right = packet.masses[2];
-        // Tare correction
-        left -= applyTare(left);
-        center -= applyTare(center);
-        right -= applyTare(right);
-        MASS_MAX = Math.max(Number(MASS_MAX), Math.max(-1000, left + center + right)).toFixed(1);
-        // Update running sum and count
-        const currentMassTotal = Math.max(-1000, left + center + right);
-        MASS_TOTAL_SUM += currentMassTotal;
-        DATAPOINT_COUNT++;
-        // Calculate the average dynamically
-        MASS_AVERAGE = (MASS_TOTAL_SUM / DATAPOINT_COUNT).toFixed(1);
-        // Notify with weight data
-        notifyCallback({
-            massTotal: Math.max(-1000, left + center + right).toFixed(1),
-            massMax: MASS_MAX,
-            massAverage: MASS_AVERAGE,
-            massLeft: Math.max(-1000, packet.masses[0]).toFixed(1),
-            massCenter: Math.max(-1000, packet.masses[1]).toFixed(1),
-            massRight: Math.max(-1000, packet.masses[2]).toFixed(1),
-        });
-    }
-    else if (lastWrite === MotherboardCommands.GET_CALIBRATION) {
-        // check data integrity
-        if ((receivedData.match(/,/g) || []).length === 3) {
-            const parts = receivedData.split(",");
-            const numericParts = parts.map((x) => parseFloat(x));
-            CALIBRATION[numericParts[0]].push(numericParts.slice(1));
-        }
-    }
-    else {
-        // unhandled data
-        console.log(receivedData);
-    }
-};
-/**
- * Handles data received from the Progressor device.
- * @param {DataView} data - The received data.
- */
-export const handleProgressorData = (data) => {
-    const receivedTime = Date.now();
-    const [kind] = struct("<bb").unpack(data.buffer.slice(0, 2));
-    if (kind === ProgressorResponses.WEIGHT_MEASURE) {
-        const iterable = struct("<fi").iter_unpack(data.buffer.slice(2));
-        console.log(iterable);
-        // eslint-disable-next-line prefer-const
-        for (let [weight, seconds] of iterable) {
-            if (typeof weight === "number" && !isNaN(weight) && typeof seconds === "number" && !isNaN(seconds)) {
-                // Add data to downloadable Array: sample and mass are the same
-                DownloadPackets.push({
-                    received: receivedTime,
-                    sampleNum: seconds,
-                    battRaw: 0,
-                    samples: [weight],
-                    masses: [weight],
-                });
-                // Tare correction
-                weight -= applyTare(weight);
-                // Check for max weight
-                MASS_MAX = Math.max(Number(MASS_MAX), Number(weight)).toFixed(1);
-                // Update running sum and count
-                const currentMassTotal = Math.max(-1000, Number(weight));
-                MASS_TOTAL_SUM += currentMassTotal;
-                DATAPOINT_COUNT++;
-                // Calculate the average dynamically
-                MASS_AVERAGE = (MASS_TOTAL_SUM / DATAPOINT_COUNT).toFixed(1);
-                notifyCallback({
-                    massMax: MASS_MAX,
-                    massAverage: MASS_AVERAGE,
-                    massTotal: Math.max(-1000, weight).toFixed(1),
-                });
-            }
-        }
-    }
-    else if (kind === ProgressorResponses.COMMAND_RESPONSE) {
-        if (!lastWrite)
-            return;
-        let value = "";
-        if (lastWrite === ProgressorCommands.GET_BATT_VLTG) {
-            const vdd = new DataView(data.buffer, 2).getUint32(0, true);
-            value = `ℹ️ Battery level: ${vdd} mV`;
-        }
-        else if (lastWrite === ProgressorCommands.GET_FW_VERSION) {
-            value = new TextDecoder().decode(data.buffer.slice(2));
-        }
-        else if (lastWrite === ProgressorCommands.GET_ERR_INFO) {
-            value = new TextDecoder().decode(data.buffer.slice(2));
-        }
-        console.log(value);
-    }
-    else if (kind === ProgressorResponses.LOW_BATTERY_WARNING) {
-        console.warn("⚠️ Low power detected. Please consider connecting to a power source.");
-    }
-    else {
-        console.error(`❌ Error: Unknown message kind detected: ${kind}`);
-    }
-};
-/**
- * Handles data received from the Entralpi device.
- * @param {string} receivedData - The received data string.
- */
-export const handleEntralpiData = (receivedData) => {
-    let numericData = Number(receivedData);
-    // 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);
-    // Notify with weight data
-    notifyCallback({
-        massMax: MASS_MAX,
-        massAverage: MASS_AVERAGE,
-        massTotal: Math.max(-1000, numericData).toFixed(1),
-    });
-};

package/src/devices/climbro.d.ts

@@ -1,6 +0,0 @@
-import { Device } from "./types";
-/**
- * Represents a Climbro device
- * TODO: Add services, do you own a Climbro? Help us!
- */
-export declare const Climbro: Device;

package/src/devices/climbro.js

@@ -1,8 +0,0 @@
-/**
- * Represents a Climbro device
- * TODO: Add services, do you own a Climbro? Help us!
- */
-export const Climbro = {
-    name: "Climbro",
-    services: [],
-};

package/src/devices/entralpi.d.ts

@@ -1,5 +0,0 @@
-import { Device } from "./types";
-/**
- * Represents a Entralpi device
- */
-export declare const Entralpi: Device;