@hangtime/grip-connect 0.6.0 → 0.6.2

package/README.md

@@ -35,9 +35,8 @@ Learn more: [Documentation](https://stevie-ray.github.io/hangtime-grip-connect/)
 
 ## Install
 
-This package is compatible with both Node.js and browser environments. It can be found in the
-[NPM](https://www.npmjs.com/package/@hangtime/grip-connect) and [JSR](https://jsr.io/@hangtime/grip-connect) package
-registries.
+This package works with Node.js, Bun, Deno, and the web, and is available on both
+[NPM](https://www.npmjs.com/package/@hangtime/grip-connect) and [JSR](https://jsr.io/@hangtime/grip-connect).
 
 ```sh [npm]
 $ npm install @hangtime/grip-connect
@@ -102,10 +101,10 @@ document.querySelector("#motherboard").addEventListener("click", async () => {
       // await motherboard.stop()
 
       // Download data as CSV, JSON, or XML (default: CSV) format => timestamp, frame, battery, samples, masses
-      // motherboard.download('json')
+      // await motherboard.download('json')
 
       // Optionally disconnect from device after we are done
-      motherboard.disconnect(Motherboard)
+      motherboard.disconnect()
     },
     (error) => {
       // Optinal custom error handeling

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@hangtime/grip-connect",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "license": "BSD-2-Clause",
   "exports": {
     ".": "./src/index.ts"

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, Progressor, WHC06, } from "./models/index.js";
+export type { IClimbro, IEntralpi, IForceBoard, IKilterBoard, IMotherboard, ImySmartBoard, IProgressor, IWHC06, } from "./interfaces/index";
+export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, Progressor, WHC06, } from "./models/index";

package/dist/index.js

@@ -1,2 +1 @@
-// @ts-types="npm:@types/web-bluetooth@^0.0.20"
-export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, Progressor, WHC06, } from "./models/index.js";
+export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, Progressor, WHC06, } from "./models/index";

package/dist/interfaces/device/climbro.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Climbro device, extending the base Device interface.
  */

package/dist/interfaces/device/entralpi.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Entralpi device, extending the base Device interface.
  */

package/dist/interfaces/device/forceboard.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the PitchSix ForceBoard device, extending the base Device interface.
  */

package/dist/interfaces/device/kilterboard.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the KilterBoard device, extending the base Device interface.
  */

package/dist/interfaces/device/motherboard.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Griptonite Motherboard device, extending the base Device interface.
  */

package/dist/interfaces/device/mysmartboard.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Smartboard Climbing mySmartBoard device, extending the base Device interface.
  */

package/dist/interfaces/device/progressor.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Tindeq Progressor device, extending the base Device interface.
  */

package/dist/interfaces/device/wh-c06.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface.js";
+import type { IDevice } from "../device.interface";
 /**
  * Interface representing the Weiheng WH-C06 device, extending the base Device interface.
  */

package/dist/interfaces/device.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IBase } from "./base.interface.js";
-import type { massObject } from "./callback.interface.js";
-import type { Commands } from "./command.interface.js";
+import type { IBase } from "./base.interface";
+import type { massObject } from "./callback.interface";
+import type { Commands } from "./command.interface";
 /**
  * Represents a characteristic of a Bluetooth service.
  */

package/dist/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+export type { IClimbro } from "./device/climbro.interface";
+export type { IEntralpi } from "./device/entralpi.interface";
+export type { IForceBoard } from "./device/forceboard.interface";
+export type { IKilterBoard } from "./device/kilterboard.interface";
+export type { IMotherboard } from "./device/motherboard.interface";
+export type { ImySmartBoard } from "./device/mysmartboard.interface";
+export type { IProgressor } from "./device/progressor.interface";
+export type { IWHC06 } from "./device/wh-c06.interface";

package/dist/interfaces/index.js

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

package/dist/models/base.model.d.ts

@@ -1,4 +1,4 @@
-import type { IBase } from "../interfaces/base.interface.js";
+import type { IBase } from "../interfaces/base.interface";
 export declare abstract class BaseModel {
     id?: string;
     createdAt?: Date;

package/dist/models/device/climbro.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IClimbro } from "../../interfaces/device/climbro.interface.js";
+import { Device } from "../device.model";
+import type { IClimbro } from "../../interfaces/device/climbro.interface";
 /**
  * Represents a Climbro device.
  * TODO: Add services, do you own a Climbro? Help us!

package/dist/models/device/climbro.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a Climbro device.
  * TODO: Add services, do you own a Climbro? Help us!

package/dist/models/device/entralpi.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IEntralpi } from "../../interfaces/device/entralpi.interface.js";
+import { Device } from "../device.model";
+import type { IEntralpi } from "../../interfaces/device/entralpi.interface";
 /**
  * Represents a Entralpi device.
  * {@link https://entralpi.com}

package/dist/models/device/entralpi.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a Entralpi device.
  * {@link https://entralpi.com}

package/dist/models/device/forceboard.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IForceBoard } from "../../interfaces/device/forceboard.interface.js";
+import { Device } from "../device.model";
+import type { IForceBoard } from "../../interfaces/device/forceboard.interface";
 /**
  * Represents a PitchSix Force Board device.
  * {@link https://pitchsix.com}

package/dist/models/device/forceboard.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a PitchSix Force Board device.
  * {@link https://pitchsix.com}

package/dist/models/device/kilterboard.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface.js";
+import { Device } from "../device.model";
+import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface";
 /**
  * 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.
@@ -74,13 +74,13 @@ export declare class KilterBoard extends Device implements IKilterBoard {
     /**
      * 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.
+     * @returns {number} The calculated checksum value.
      */
     private checksum;
     /**
      * Wraps a byte array with header and footer bytes for transmission.
      * @param data - The array of bytes to wrap.
-     * @returns The wrapped byte array.
+     * @returns {number[]} The wrapped byte array.
      */
     private wrapBytes;
     /**
@@ -88,7 +88,7 @@ export declare class KilterBoard extends Device implements IKilterBoard {
      * 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.
+     * @returns {number[]} The encoded byte array representing the position.
      */
     private encodePosition;
     /**
@@ -113,10 +113,10 @@ export declare class KilterBoard extends Device implements IKilterBoard {
     private prepBytesV3;
     /**
      * Splits a collection into slices of the specified length.
-     * https://github.com/ramda/ramda/blob/master/source/splitEvery.js
+     * https://github.com/ramda/ramda/blob/master/source/splitEvery
      * @param {Number} n
      * @param {Array} list
-     * @return {Array}
+     * @return {Array<number[]>}
      */
     private splitEvery;
     /**

package/dist/models/device/kilterboard.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * 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.
@@ -130,7 +130,7 @@ export class KilterBoard extends Device {
     /**
      * 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.
+     * @returns {number} The calculated checksum value.
      */
     checksum(data) {
         let i = 0;
@@ -142,7 +142,7 @@ export class KilterBoard extends Device {
     /**
      * Wraps a byte array with header and footer bytes for transmission.
      * @param data - The array of bytes to wrap.
-     * @returns The wrapped byte array.
+     * @returns {number[]} The wrapped byte array.
      */
     wrapBytes(data) {
         if (data.length > KilterBoard.messageBodyMaxLength) {
@@ -165,7 +165,7 @@ export class KilterBoard extends Device {
      * 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.
+     * @returns {number[]} The encoded byte array representing the position.
      */
     encodePosition(position) {
         const position1 = position & 255;
@@ -234,10 +234,10 @@ export class KilterBoard extends Device {
     }
     /**
      * Splits a collection into slices of the specified length.
-     * https://github.com/ramda/ramda/blob/master/source/splitEvery.js
+     * https://github.com/ramda/ramda/blob/master/source/splitEvery
      * @param {Number} n
      * @param {Array} list
-     * @return {Array}
+     * @return {Array<number[]>}
      */
     splitEvery(n, list) {
         if (n <= 0) {

package/dist/models/device/motherboard.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IMotherboard } from "../../interfaces/device/motherboard.interface.js";
+import { Device } from "../device.model";
+import type { IMotherboard } from "../../interfaces/device/motherboard.interface";
 /**
  * Represents a Griptonite Motherboard device.
  * {@link https://griptonite.io}

package/dist/models/device/motherboard.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a Griptonite Motherboard device.
  * {@link https://griptonite.io}

package/dist/models/device/mysmartboard.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface.js";
+import { Device } from "../device.model";
+import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface";
 /**
  * Represents a Smartboard Climbing mySmartBoard device.
  * TODO: Add services, do you own a mySmartBoard? Help us!

package/dist/models/device/mysmartboard.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a Smartboard Climbing mySmartBoard device.
  * TODO: Add services, do you own a mySmartBoard? Help us!

package/dist/models/device/progressor.model.d.ts

@@ -1,7 +1,8 @@
-import { Device } from "../device.model.js";
-import type { IProgressor } from "../../interfaces/device/progressor.interface.js";
+import { Device } from "../device.model";
+import type { IProgressor } from "../../interfaces/device/progressor.interface";
 /**
  * Represents a Tindeq Progressor device.
+ * {@link https://tindeq.com}
  */
 export declare class Progressor extends Device implements IProgressor {
     constructor();

package/dist/models/device/progressor.model.js

@@ -1,7 +1,6 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
- * Represents a Tindeq Progressor device.
- * {@link https://tindeq.com}
+ * Progressor responses
  */
 var ProgressorResponses;
 (function (ProgressorResponses) {
@@ -33,6 +32,7 @@ var ProgressorResponses;
 })(ProgressorResponses || (ProgressorResponses = {}));
 /**
  * Represents a Tindeq Progressor device.
+ * {@link https://tindeq.com}
  */
 export class Progressor extends Device {
     constructor() {

package/dist/models/device/wh-c06.model.d.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model.js";
-import type { IWHC06 } from "../../interfaces/device/wh-c06.interface.js";
+import { Device } from "../device.model";
+import type { IWHC06 } from "../../interfaces/device/wh-c06.interface";
 /**
  * Represents a Weiheng - WH-C06 (or MAT Muscle Meter) device.
  * To use this device enable: `chrome://flags/#enable-experimental-web-platform-features`.

package/dist/models/device/wh-c06.model.js

@@ -1,4 +1,4 @@
-import { Device } from "../device.model.js";
+import { Device } from "../device.model";
 /**
  * Represents a Weiheng - WH-C06 (or MAT Muscle Meter) device.
  * To use this device enable: `chrome://flags/#enable-experimental-web-platform-features`.

package/dist/models/device.model.d.ts

@@ -1,8 +1,8 @@
-import { BaseModel } from "./../models/base.model.js";
-import type { IDevice, Service } from "../interfaces/device.interface.js";
-import type { ActiveCallback, NotifyCallback, WriteCallback } from "../interfaces/callback.interface.js";
-import type { DownloadPacket } from "../interfaces/download.interface.js";
-import type { Commands } from "../interfaces/command.interface.js";
+import { BaseModel } from "./../models/base.model";
+import type { IDevice, Service } from "../interfaces/device.interface";
+import type { ActiveCallback, NotifyCallback, WriteCallback } from "../interfaces/callback.interface";
+import type { DownloadPacket } from "../interfaces/download.interface";
+import type { Commands } from "../interfaces/command.interface";
 export declare abstract class Device extends BaseModel implements IDevice {
     /**
      * Filters to identify the device during Bluetooth scanning.
@@ -26,7 +26,7 @@ export declare abstract class Device extends BaseModel implements IDevice {
      * @type {BluetoothDevice | undefined}
      * @public
      */
-    bluetooth?: BluetoothDevice | undefined;
+    bluetooth?: BluetoothDevice;
     /**
      * Object representing the set of commands available for this device.
      * These commands allow communication with the device to perform various operations such as starting measurements, retrieving data, or calibrating the device.
@@ -257,13 +257,13 @@ export declare abstract class Device extends BaseModel implements IDevice {
      * @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.
-     * @private
+     * @returns {Promise<void>} Resolves when the data has been downloaded/written
+     * @public
      *
      * @example
-     * device.download('json');
+     * await device.download('json');
      */
-    download: (format?: "csv" | "json" | "xml") => void;
+    download: (format?: "csv" | "json" | "xml") => Promise<void>;
     /**
      * Returns UUIDs of all services associated with the device.
      * @returns {string[]} Array of service UUIDs.
@@ -275,25 +275,15 @@ export declare abstract class Device extends BaseModel implements IDevice {
      */
     protected getAllServiceUUIDs: () => string[];
     /**
-     * Attempt to use ES module import rather than require.
-     * This approach uses an async dynamic import for `webbluetooth`,
-     * so we can fallback if `navigator.bluetooth` is unavailable.
-     */
-    protected getBluetooth(): Promise<Bluetooth | import("webbluetooth").Bluetooth>;
-    /**
-     * Retrieves the characteristic from the device's service.
-     * @param {string} serviceId - The UUID of the service.
-     * @param {string} characteristicId - The UUID of the characteristic.
-     * @returns {BluetoothRemoteGATTCharacteristic | undefined} The characteristic, if found.
-     * @protected
+     * Returns the Bluetooth instance available for the current environment.
+     * In browsers, it returns the native Web Bluetooth API (i.e. `navigator.bluetooth`).
+     * In a Node, Bun, or Deno environment, it dynamically imports the `webbluetooth` package.
+     * {@link https://github.com/thegecko/webbluetooth}
      *
-     * @example
-     * const characteristic = device.getCharacteristic('battery', 'level');
-     * if (characteristic) {
-     *   console.log('Characteristic found');
-     * }
+     * @returns {Promise<Bluetooth>} A promise that resolves to the Bluetooth instance.
+     * @throws {Error} If Web Bluetooth is not available in the current environment.
      */
-    protected getCharacteristic: (serviceId: string, characteristicId: string) => BluetoothRemoteGATTCharacteristic | undefined;
+    protected getBluetooth(): Promise<Bluetooth>;
     /**
      * Handles notifications received from a characteristic.
      * @param {BluetoothRemoteGATTCharacteristic} characteristic - The notification event.