@hangtime/grip-connect 0.5.10 → 0.6.0

package/README.md

@@ -35,12 +35,22 @@ Learn more: [Documentation](https://stevie-ray.github.io/hangtime-grip-connect/)
 
 ## Install
 
-This project can be found in the [NPM package registry](https://www.npmjs.com/package/@hangtime/grip-connect).
+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.
 
 ```sh [npm]
 $ npm install @hangtime/grip-connect
 ```
 
+```sh [yarn]
+$ yarn add @hangtime/grip-connect
+```
+
+```sh [pnpm]
+$ pnpm add @hangtime/grip-connect
+```
+
 ## Example usage (with a Motherboard)
 
 Simply importing the device you need from `@hangtime/grip-connect`.
@@ -113,8 +123,8 @@ document.querySelector("#motherboard").addEventListener("click", async () => {
   - 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](https://stevie-ray.github.io/hangtime-grip-connect/devices/kilterboard.html)
-- ✅ [Entralpi](https://stevie-ray.github.io/hangtime-grip-connect/devices/entralpi.html) / Lefu Scale
-- ✅ [PitchSix Force Board](https://stevie-ray.github.io/hangtime-grip-connect/devices/forceboard.html)
+- ✅ [Entralpi](https://stevie-ray.github.io/hangtime-grip-connect/devices/entralpi.html) / Lefu / Unique CW275 Scale
+- ✅ [PitchSix - Force Board](https://stevie-ray.github.io/hangtime-grip-connect/devices/forceboard.html)
 - ➡️ [Climbro](https://stevie-ray.github.io/hangtime-grip-connect/devices/climbro.html)
 - ➡️ [Smartboard Climbing - mySmartBoard](https://stevie-ray.github.io/hangtime-grip-connect/devices/mysmartboard.html)
 

package/deno.json

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

package/dist/index.d.ts

@@ -1 +1 @@
-export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, WHC06, Progressor, } from "./models/index";
+export { Climbro, Entralpi, ForceBoard, KilterBoard, Motherboard, mySmartBoard, Progressor, WHC06, } from "./models/index.js";

package/dist/index.js

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

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

@@ -1,4 +1,4 @@
-import type { IDevice } from "../device.interface";
+import type { IDevice } from "../device.interface.js";
 /**
  * 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";
+import type { IDevice } from "../device.interface.js";
 /**
  * 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";
+import type { IDevice } from "../device.interface.js";
 /**
  * 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";
+import type { IDevice } from "../device.interface.js";
 /**
  * Interface representing the KilterBoard device, extending the base Device interface.
  */

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,8 +1,9 @@
-import { Device } from "../device.model";
-import type { IClimbro } from "../../interfaces/device/climbro.interface";
+import { Device } from "../device.model.js";
+import type { IClimbro } from "../../interfaces/device/climbro.interface.js";
 /**
- * Represents a Climbro device
+ * Represents a Climbro device.
  * TODO: Add services, do you own a Climbro? Help us!
+ * {@link https://climbro.com/}
  */
 export declare class Climbro extends Device implements IClimbro {
     constructor();

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

@@ -1,7 +1,8 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
 /**
- * Represents a Climbro device
+ * Represents a Climbro device.
  * TODO: Add services, do you own a Climbro? Help us!
+ * {@link https://climbro.com/}
  */
 export class Climbro extends Device {
     constructor() {

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

@@ -1,5 +1,9 @@
-import { Device } from "../device.model";
-import type { IEntralpi } from "../../interfaces/device/entralpi.interface";
+import { Device } from "../device.model.js";
+import type { IEntralpi } from "../../interfaces/device/entralpi.interface.js";
+/**
+ * Represents a Entralpi device.
+ * {@link https://entralpi.com}
+ */
 export declare class Entralpi extends Device implements IEntralpi {
     constructor();
     /**

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

@@ -1,4 +1,8 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
+/**
+ * Represents a Entralpi device.
+ * {@link https://entralpi.com}
+ */
 export class Entralpi extends Device {
     constructor() {
         super({

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

@@ -1,7 +1,8 @@
-import { Device } from "../device.model";
-import type { IForceBoard } from "../../interfaces/device/forceboard.interface";
+import { Device } from "../device.model.js";
+import type { IForceBoard } from "../../interfaces/device/forceboard.interface.js";
 /**
- * Represents a PitchSix Force Board device
+ * Represents a PitchSix Force Board device.
+ * {@link https://pitchsix.com}
  */
 export declare class ForceBoard extends Device implements IForceBoard {
     constructor();

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

@@ -1,6 +1,7 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
 /**
- * Represents a PitchSix Force Board device
+ * Represents a PitchSix Force Board device.
+ * {@link https://pitchsix.com}
  */
 export class ForceBoard extends Device {
     constructor() {

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

@@ -1,5 +1,5 @@
-import { Device } from "../device.model";
-import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface";
+import { Device } from "../device.model.js";
+import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface.js";
 /**
  * For API level 2 and API level 3.
  * The first byte in the data is dependent on where the packet is in the message as a whole.
@@ -36,8 +36,9 @@ export declare const KilterBoardPlacementRoles: {
     screen_color: string;
 }[];
 /**
- * Represents a Aurora Climbing device
+ * Represents a Aurora Climbing device.
  * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ * {@link https://auroraclimbing.com}
  */
 export declare class KilterBoard extends Device implements IKilterBoard {
     /**

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

@@ -1,4 +1,4 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
 /**
  * For API level 2 and API level 3.
  * The first byte in the data is dependent on where the packet is in the message as a whole.
@@ -65,8 +65,9 @@ export const KilterBoardPlacementRoles = [
     },
 ];
 /**
- * Represents a Aurora Climbing device
+ * Represents a Aurora Climbing device.
  * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ * {@link https://auroraclimbing.com}
  */
 export class KilterBoard extends Device {
     /**
@@ -154,7 +155,7 @@ export class KilterBoard extends Device {
       - 0x2
       - *packets
       - 0x3
-      
+    
       First byte is always 1, the second is a number of packets, then checksum, then 2, packets themselves, and finally 3.
        */
         return [1, data.length, this.checksum(data), 2, ...data, 3];

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

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

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

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

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

@@ -1,8 +1,9 @@
-import { Device } from "../device.model";
-import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface";
+import { Device } from "../device.model.js";
+import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface.js";
 /**
- * Represents a mySmartBoard device
+ * Represents a Smartboard Climbing mySmartBoard device.
  * TODO: Add services, do you own a mySmartBoard? Help us!
+ * {@link https://www.smartboard-climbing.com}
  */
 export declare class mySmartBoard extends Device implements ImySmartBoard {
     constructor();

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

@@ -1,7 +1,8 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
 /**
- * Represents a mySmartBoard device
+ * Represents a Smartboard Climbing mySmartBoard device.
  * TODO: Add services, do you own a mySmartBoard? Help us!
+ * {@link https://www.smartboard-climbing.com}
  */
 export class mySmartBoard extends Device {
     constructor() {

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

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

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

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

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

@@ -1,8 +1,10 @@
-import { Device } from "../device.model";
-import type { IWHC06 } from "../../interfaces/device/wh-c06.interface";
+import { Device } from "../device.model.js";
+import type { IWHC06 } from "../../interfaces/device/wh-c06.interface.js";
 /**
- * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
- * Enable 'Experimental Web Platform features' Chrome Flags.
+ * Represents a Weiheng - WH-C06 (or MAT Muscle Meter) device.
+ * To use this device enable: `chrome://flags/#enable-experimental-web-platform-features`.
+ * {@link https://googlechrome.github.io/samples/web-bluetooth/scan.html| Web Bluetooth}
+ * {@link https://weihengmanufacturer.com}
  */
 export declare class WHC06 extends Device implements IWHC06 {
     /**

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

@@ -1,7 +1,9 @@
-import { Device } from "../device.model";
+import { Device } from "../device.model.js";
 /**
- * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
- * Enable 'Experimental Web Platform features' Chrome Flags.
+ * Represents a Weiheng - WH-C06 (or MAT Muscle Meter) device.
+ * To use this device enable: `chrome://flags/#enable-experimental-web-platform-features`.
+ * {@link https://googlechrome.github.io/samples/web-bluetooth/scan.html| Web Bluetooth}
+ * {@link https://weihengmanufacturer.com}
  */
 export class WHC06 extends Device {
     /**
@@ -65,7 +67,8 @@ export class WHC06 extends Device {
         try {
             // Only data matching the optionalManufacturerData parameter to requestDevice is included in the advertisement event: https://github.com/WebBluetoothCG/web-bluetooth/issues/598
             const optionalManufacturerData = this.filters.flatMap((filter) => filter.manufacturerData?.map((data) => data.companyIdentifier) || []);
-            this.bluetooth = await navigator.bluetooth.requestDevice({
+            const bluetooth = await this.getBluetooth();
+            this.bluetooth = await bluetooth.requestDevice({
                 filters: this.filters,
                 optionalManufacturerData,
             });
@@ -154,10 +157,13 @@ export class WHC06 extends Device {
             clearTimeout(this.advertisementTimeout);
         }
         // Set a new timeout to stop tracking if no advertisement is received
-        this.advertisementTimeout = window.setTimeout(() => {
+        this.advertisementTimeout = globalThis.setTimeout(() => {
             // Mimic a disconnect
             const disconnectedEvent = new Event("gattserverdisconnected");
-            Object.defineProperty(disconnectedEvent, "target", { value: this.bluetooth, writable: false });
+            Object.defineProperty(disconnectedEvent, "target", {
+                value: this.bluetooth,
+                writable: false,
+            });
             // Print error to the console
             console.error(`No advertisement received for ${this.advertisementTimeoutTime} seconds, stopping tracking..`);
             this.onDisconnected(disconnectedEvent);

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

@@ -1,8 +1,8 @@
-import { BaseModel } from "./../models/base.model";
-import type { IDevice, Service } from "../interfaces/device.interface";
-import type { NotifyCallback, WriteCallback, ActiveCallback } from "../interfaces/callback.interface";
-import type { DownloadPacket } from "../interfaces/download.interface";
-import type { Commands } from "../interfaces/command.interface";
+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";
 export declare abstract class Device extends BaseModel implements IDevice {
     /**
      * Filters to identify the device during Bluetooth scanning.
@@ -274,6 +274,12 @@ export declare abstract class Device extends BaseModel implements IDevice {
      * console.log(serviceUUIDs);
      */
     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.

package/dist/models/device.model.js

@@ -1,4 +1,4 @@
-import { BaseModel } from "./../models/base.model";
+import { BaseModel } from "./../models/base.model.js";
 export class Device extends BaseModel {
     /**
      * Filters to identify the device during Bluetooth scanning.
@@ -51,7 +51,10 @@ export class Device extends BaseModel {
     /**
      * Configuration for threshold and duration.
      */
-    activeConfig = { threshold: 2.5, duration: 1000 };
+    activeConfig = {
+        threshold: 2.5,
+        duration: 1000,
+    };
     /**
      * Maximum mass recorded from the device, initialized to "0".
      * @type {string}
@@ -236,12 +239,10 @@ export class Device extends BaseModel {
      */
     connect = async (onSuccess = () => console.log("Connected successfully"), onError = (error) => console.error(error)) => {
         try {
-            if (typeof navigator === "undefined" || !("bluetooth" in navigator)) {
-                throw new Error("Web Bluetooth API not supported in this environment.");
-            }
             // Request device and set up connection
             const deviceServices = this.getAllServiceUUIDs();
-            this.bluetooth = await navigator.bluetooth.requestDevice({
+            const bluetooth = await this.getBluetooth();
+            this.bluetooth = await bluetooth.requestDevice({
                 filters: this.filters,
                 optionalServices: deviceServices,
             });
@@ -406,7 +407,7 @@ export class Device extends BaseModel {
         // 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);
+        const url = globalThis.URL.createObjectURL(blob);
         // Create a link element
         const link = document.createElement("a");
         // Set link attributes
@@ -418,7 +419,7 @@ export class Device extends BaseModel {
         link.click();
         // Clean up: remove the link and revoke the URL
         document.body.removeChild(link);
-        window.URL.revokeObjectURL(url);
+        globalThis.URL.revokeObjectURL(url);
     };
     /**
      * Returns UUIDs of all services associated with the device.
@@ -432,6 +433,21 @@ export class Device extends BaseModel {
     getAllServiceUUIDs = () => {
         return this.services.filter((service) => service?.uuid).map((service) => service.uuid);
     };
+    /**
+     * 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.
+     */
+    async getBluetooth() {
+        // If we're in a browser with real Web Bluetooth available:
+        if (typeof navigator !== "undefined" && "bluetooth" in navigator) {
+            return navigator.bluetooth;
+        }
+        // Otherwise, we're likely in Node or an environment without `navigator.bluetooth`.
+        // Use a dynamic import for the ESM version:
+        const { bluetooth } = await import("webbluetooth");
+        return bluetooth;
+    }
     /**
      * Retrieves the characteristic from the device's service.
      * @param {string} serviceId - The UUID of the service.

package/dist/models/index.d.ts

@@ -1,8 +1,8 @@
-export { Climbro } from "./device/climbro.model";
-export { Entralpi } from "./device/entralpi.model";
-export { ForceBoard } from "./device/forceboard.model";
-export { KilterBoard } from "./device/kilterboard.model";
-export { Motherboard } from "./device/motherboard.model";
-export { mySmartBoard } from "./device/mysmartboard.model";
-export { Progressor } from "./device/progressor.model";
-export { WHC06 } from "./device/wh-c06.model";
+export { Climbro } from "./device/climbro.model.js";
+export { Entralpi } from "./device/entralpi.model.js";
+export { ForceBoard } from "./device/forceboard.model.js";
+export { KilterBoard } from "./device/kilterboard.model.js";
+export { Motherboard } from "./device/motherboard.model.js";
+export { mySmartBoard } from "./device/mysmartboard.model.js";
+export { Progressor } from "./device/progressor.model.js";
+export { WHC06 } from "./device/wh-c06.model.js";

package/dist/models/index.js

@@ -1,8 +1,8 @@
-export { Climbro } from "./device/climbro.model";
-export { Entralpi } from "./device/entralpi.model";
-export { ForceBoard } from "./device/forceboard.model";
-export { KilterBoard } from "./device/kilterboard.model";
-export { Motherboard } from "./device/motherboard.model";
-export { mySmartBoard } from "./device/mysmartboard.model";
-export { Progressor } from "./device/progressor.model";
-export { WHC06 } from "./device/wh-c06.model";
+export { Climbro } from "./device/climbro.model.js";
+export { Entralpi } from "./device/entralpi.model.js";
+export { ForceBoard } from "./device/forceboard.model.js";
+export { KilterBoard } from "./device/kilterboard.model.js";
+export { Motherboard } from "./device/motherboard.model.js";
+export { mySmartBoard } from "./device/mysmartboard.model.js";
+export { Progressor } from "./device/progressor.model.js";
+export { WHC06 } from "./device/wh-c06.model.js";

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@hangtime/grip-connect",
-  "version": "0.5.10",
+  "version": "0.6.0",
   "description": "Griptonite Motherboard, Tindeq Progressor, PitchSix Force Board, WHC-06, Entralpi, Climbro, mySmartBoard: Web Bluetooth API Force-Sensing strength analysis for climbers",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -32,5 +33,8 @@
   "bugs": {
     "url": "https://github.com/Stevie-Ray/hangtime-grip-connect/issues"
   },
-  "homepage": "https://stevie-ray.github.io/hangtime-grip-connect/"
+  "homepage": "https://stevie-ray.github.io/hangtime-grip-connect/",
+  "dependencies": {
+    "webbluetooth": "^3.2.1"
+  }
 }

package/src/index.ts

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

package/src/interfaces/device/climbro.interface.ts

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

package/src/interfaces/device/entralpi.interface.ts

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

package/src/interfaces/device/forceboard.interface.ts

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

package/src/interfaces/device/kilterboard.interface.ts

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

package/src/interfaces/device/motherboard.interface.ts

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

package/src/interfaces/device/mysmartboard.interface.ts

@@ -1,6 +1,6 @@
-import type { IDevice } from "../device.interface"
+import type { IDevice } from "../device.interface.js"
 /**
- * Interface representing the mySmartBoard device, extending the base Device interface.
+ * Interface representing the Smartboard Climbing mySmartBoard device, extending the base Device interface.
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface ImySmartBoard extends IDevice {}

package/src/interfaces/device/progressor.interface.ts

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

package/src/interfaces/device/wh-c06.interface.ts

@@ -1,6 +1,6 @@
-import type { IDevice } from "../device.interface"
+import type { IDevice } from "../device.interface.js"
 /**
- * Interface representing the Weiheng WH-C06 device.
+ * Interface representing the Weiheng WH-C06 device, extending the base Device interface.
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface IWHC06 extends IDevice {}

package/src/interfaces/device.interface.ts

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

package/src/models/base.model.ts

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

package/src/models/device/climbro.model.ts

@@ -1,9 +1,10 @@
-import { Device } from "../device.model"
-import type { IClimbro } from "../../interfaces/device/climbro.interface"
+import { Device } from "../device.model.js"
+import type { IClimbro } from "../../interfaces/device/climbro.interface.js"
 
 /**
- * Represents a Climbro device
+ * Represents a Climbro device.
  * TODO: Add services, do you own a Climbro? Help us!
+ * {@link https://climbro.com/}
  */
 export class Climbro extends Device implements IClimbro {
   constructor() {

package/src/models/device/entralpi.model.ts

@@ -1,6 +1,10 @@
-import { Device } from "../device.model"
-import type { IEntralpi } from "../../interfaces/device/entralpi.interface"
+import { Device } from "../device.model.js"
+import type { IEntralpi } from "../../interfaces/device/entralpi.interface.js"
 
+/**
+ * Represents a Entralpi device.
+ * {@link https://entralpi.com}
+ */
 export class Entralpi extends Device implements IEntralpi {
   constructor() {
     super({
@@ -155,7 +159,7 @@ export class Entralpi extends Device implements IEntralpi {
    *
    * @param {BluetoothRemoteGATTCharacteristic} characteristic - The notification event.
    */
-  handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
+  override handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
     const value: DataView | undefined = characteristic.value
 
     if (value) {

package/src/models/device/forceboard.model.ts

@@ -1,8 +1,9 @@
-import { Device } from "../device.model"
-import type { IForceBoard } from "../../interfaces/device/forceboard.interface"
+import { Device } from "../device.model.js"
+import type { IForceBoard } from "../../interfaces/device/forceboard.interface.js"
 
 /**
- * Represents a PitchSix Force Board device
+ * Represents a PitchSix Force Board device.
+ * {@link https://pitchsix.com}
  */
 export class ForceBoard extends Device implements IForceBoard {
   constructor() {
@@ -182,7 +183,7 @@ export class ForceBoard extends Device implements IForceBoard {
    *
    * @param {BluetoothRemoteGATTCharacteristic} characteristic - The notification event.
    */
-  handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
+  override handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
     const value: DataView | undefined = characteristic.value
     if (value) {
       // Update timestamp

package/src/models/device/kilterboard.model.ts

@@ -1,5 +1,5 @@
-import { Device } from "../device.model"
-import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface"
+import { Device } from "../device.model.js"
+import type { IKilterBoard } from "../../interfaces/device/kilterboard.interface.js"
 
 /**
  * For API level 2 and API level 3.
@@ -67,8 +67,9 @@ export const KilterBoardPlacementRoles = [
 ]
 
 /**
- * Represents a Aurora Climbing device
+ * Represents a Aurora Climbing device.
  * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ * {@link https://auroraclimbing.com}
  */
 export class KilterBoard extends Device implements IKilterBoard {
   /**
@@ -161,7 +162,7 @@ export class KilterBoard extends Device implements IKilterBoard {
   - 0x2
   - *packets
   - 0x3
-  
+
   First byte is always 1, the second is a number of packets, then checksum, then 2, packets themselves, and finally 3.
    */
     return [1, data.length, this.checksum(data), 2, ...data, 3]

package/src/models/device/motherboard.model.ts

@@ -1,9 +1,10 @@
-import { Device } from "../device.model"
-import type { IMotherboard } from "../../interfaces/device/motherboard.interface"
-import type { DownloadPacket } from "../../interfaces/download.interface"
+import { Device } from "../device.model.js"
+import type { IMotherboard } from "../../interfaces/device/motherboard.interface.js"
+import type { DownloadPacket } from "../../interfaces/download.interface.js"
 
 /**
- * Represents a Griptonite Motherboard device
+ * Represents a Griptonite Motherboard device.
+ * {@link https://griptonite.io}
  */
 export class Motherboard extends Device implements IMotherboard {
   /**
@@ -203,7 +204,7 @@ export class Motherboard extends Device implements IMotherboard {
    *
    * @param {BluetoothRemoteGATTCharacteristic} characteristic - The notification event.
    */
-  handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
+  override handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
     const value: DataView | undefined = characteristic.value
 
     if (value) {

package/src/models/device/mysmartboard.model.ts

@@ -1,9 +1,10 @@
-import { Device } from "../device.model"
-import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface"
+import { Device } from "../device.model.js"
+import type { ImySmartBoard } from "../../interfaces/device/mysmartboard.interface.js"
 
 /**
- * Represents a mySmartBoard device
+ * Represents a Smartboard Climbing mySmartBoard device.
  * TODO: Add services, do you own a mySmartBoard? Help us!
+ * {@link https://www.smartboard-climbing.com}
  */
 export class mySmartBoard extends Device implements ImySmartBoard {
   constructor() {

package/src/models/device/progressor.model.ts

@@ -1,8 +1,9 @@
-import { Device } from "../device.model"
-import type { IProgressor } from "../../interfaces/device/progressor.interface"
+import { Device } from "../device.model.js"
+import type { IProgressor } from "../../interfaces/device/progressor.interface.js"
 
 /**
- * Represents the possible responses of a Tindeq Progressor device.
+ * Represents a Tindeq Progressor device.
+ * {@link https://tindeq.com}
  */
 enum ProgressorResponses {
   /**
@@ -37,7 +38,7 @@ enum ProgressorResponses {
 }
 
 /**
- * Represents a Tindeq Progressor device
+ * Represents a Tindeq Progressor device.
  */
 export class Progressor extends Device implements IProgressor {
   constructor() {
@@ -122,7 +123,7 @@ export class Progressor extends Device implements IProgressor {
    *
    * @param {BluetoothRemoteGATTCharacteristic} characteristic - The notification event.
    */
-  handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
+  override handleNotifications = (characteristic: BluetoothRemoteGATTCharacteristic): void => {
     const value: DataView | undefined = characteristic.value
 
     if (value) {

package/src/models/device/wh-c06.model.ts

@@ -1,9 +1,11 @@
-import { Device } from "../device.model"
-import type { IWHC06 } from "../../interfaces/device/wh-c06.interface"
+import { Device } from "../device.model.js"
+import type { IWHC06 } from "../../interfaces/device/wh-c06.interface.js"
 
 /**
- * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
- * Enable 'Experimental Web Platform features' Chrome Flags.
+ * Represents a Weiheng - WH-C06 (or MAT Muscle Meter) device.
+ * To use this device enable: `chrome://flags/#enable-experimental-web-platform-features`.
+ * {@link https://googlechrome.github.io/samples/web-bluetooth/scan.html| Web Bluetooth}
+ * {@link https://weihengmanufacturer.com}
  */
 export class WHC06 extends Device implements IWHC06 {
   /**
@@ -29,7 +31,7 @@ export class WHC06 extends Device implements IWHC06 {
    * @type {number|null}
    * @private
    */
-  private advertisementTimeout: number | null = null
+  private advertisementTimeout: ReturnType<typeof setTimeout> | null = null
 
   /**
    * The limit in seconds when timeout is triggered
@@ -68,7 +70,7 @@ export class WHC06 extends Device implements IWHC06 {
    * @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.
    */
-  connect = async (
+  override connect = async (
     onSuccess: () => void = () => console.log("Connected successfully"),
     onError: (error: Error) => void = (error) => console.error(error),
   ): Promise<void> => {
@@ -78,7 +80,9 @@ export class WHC06 extends Device implements IWHC06 {
         (filter) => filter.manufacturerData?.map((data) => data.companyIdentifier) || [],
       )
 
-      this.bluetooth = await navigator.bluetooth.requestDevice({
+      const bluetooth = await this.getBluetooth()
+
+      this.bluetooth = await bluetooth.requestDevice({
         filters: this.filters,
         optionalManufacturerData,
       })
@@ -168,7 +172,7 @@ export class WHC06 extends Device implements IWHC06 {
    * For the WH-C06 device, the `gatt.connected` property remains `false` even after the device is connected.
    * @returns {boolean} A boolean indicating whether the device is connected.
    */
-  isConnected = (): boolean => {
+  override isConnected = (): boolean => {
     return !!this.bluetooth
   }
 
@@ -182,10 +186,13 @@ export class WHC06 extends Device implements IWHC06 {
     }
 
     // Set a new timeout to stop tracking if no advertisement is received
-    this.advertisementTimeout = window.setTimeout(() => {
+    this.advertisementTimeout = globalThis.setTimeout(() => {
       // Mimic a disconnect
       const disconnectedEvent = new Event("gattserverdisconnected")
-      Object.defineProperty(disconnectedEvent, "target", { value: this.bluetooth, writable: false })
+      Object.defineProperty(disconnectedEvent, "target", {
+        value: this.bluetooth,
+        writable: false,
+      })
       // Print error to the console
       console.error(`No advertisement received for ${this.advertisementTimeoutTime} seconds, stopping tracking..`)
       this.onDisconnected(disconnectedEvent)

package/src/models/device.model.ts

@@ -1,8 +1,8 @@
-import { BaseModel } from "./../models/base.model"
-import type { IDevice, Service } from "../interfaces/device.interface"
-import type { NotifyCallback, massObject, WriteCallback, ActiveCallback } from "../interfaces/callback.interface"
-import type { DownloadPacket } from "../interfaces/download.interface"
-import type { Commands } from "../interfaces/command.interface"
+import { BaseModel } from "./../models/base.model.js"
+import type { IDevice, Service } from "../interfaces/device.interface.js"
+import type { ActiveCallback, massObject, NotifyCallback, WriteCallback } from "../interfaces/callback.interface.js"
+import type { DownloadPacket } from "../interfaces/download.interface.js"
+import type { Commands } from "../interfaces/command.interface.js"
 
 export abstract class Device extends BaseModel implements IDevice {
   /**
@@ -61,7 +61,10 @@ export abstract class Device extends BaseModel implements IDevice {
   /**
    * Configuration for threshold and duration.
    */
-  private activeConfig: { threshold: number; duration: number } = { threshold: 2.5, duration: 1000 }
+  private activeConfig: { threshold: number; duration: number } = {
+    threshold: 2.5,
+    duration: 1000,
+  }
 
   /**
    * Maximum mass recorded from the device, initialized to "0".
@@ -272,13 +275,12 @@ export abstract class Device extends BaseModel implements IDevice {
     onError: (error: Error) => void = (error) => console.error(error),
   ): Promise<void> => {
     try {
-      if (typeof navigator === "undefined" || !("bluetooth" in navigator)) {
-        throw new Error("Web Bluetooth API not supported in this environment.")
-      }
       // Request device and set up connection
       const deviceServices = this.getAllServiceUUIDs()
 
-      this.bluetooth = await navigator.bluetooth.requestDevice({
+      const bluetooth = await this.getBluetooth()
+
+      this.bluetooth = await bluetooth.requestDevice({
         filters: this.filters,
         optionalServices: deviceServices,
       })
@@ -456,7 +458,7 @@ export abstract class Device extends BaseModel implements IDevice {
     const blob = new Blob([content], { type: mimeType })
 
     // Create a URL for the Blob
-    const url = window.URL.createObjectURL(blob)
+    const url = globalThis.URL.createObjectURL(blob)
 
     // Create a link element
     const link = document.createElement("a")
@@ -473,7 +475,7 @@ export abstract class Device extends BaseModel implements IDevice {
 
     // Clean up: remove the link and revoke the URL
     document.body.removeChild(link)
-    window.URL.revokeObjectURL(url)
+    globalThis.URL.revokeObjectURL(url)
   }
 
   /**
@@ -489,6 +491,23 @@ export abstract class Device extends BaseModel implements IDevice {
     return this.services.filter((service) => service?.uuid).map((service) => service.uuid)
   }
 
+  /**
+   * 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 async getBluetooth() {
+    // If we're in a browser with real Web Bluetooth available:
+    if (typeof navigator !== "undefined" && "bluetooth" in navigator) {
+      return navigator.bluetooth
+    }
+
+    // Otherwise, we're likely in Node or an environment without `navigator.bluetooth`.
+    // Use a dynamic import for the ESM version:
+    const { bluetooth } = await import("webbluetooth")
+    return bluetooth
+  }
+
   /**
    * Retrieves the characteristic from the device's service.
    * @param {string} serviceId - The UUID of the service.

package/src/models/index.ts

@@ -1,15 +1,15 @@
-export { Climbro } from "./device/climbro.model"
+export { Climbro } from "./device/climbro.model.js"
 
-export { Entralpi } from "./device/entralpi.model"
+export { Entralpi } from "./device/entralpi.model.js"
 
-export { ForceBoard } from "./device/forceboard.model"
+export { ForceBoard } from "./device/forceboard.model.js"
 
-export { KilterBoard } from "./device/kilterboard.model"
+export { KilterBoard } from "./device/kilterboard.model.js"
 
-export { Motherboard } from "./device/motherboard.model"
+export { Motherboard } from "./device/motherboard.model.js"
 
-export { mySmartBoard } from "./device/mysmartboard.model"
+export { mySmartBoard } from "./device/mysmartboard.model.js"
 
-export { Progressor } from "./device/progressor.model"
+export { Progressor } from "./device/progressor.model.js"
 
-export { WHC06 } from "./device/wh-c06.model"
+export { WHC06 } from "./device/wh-c06.model.js"