@hangtime/grip-connect 0.5.11 → 0.6.0

package/README.md

@@ -35,13 +35,22 @@ Learn more: [Documentation](https://stevie-ray.github.io/hangtime-grip-connect/)
 
 ## Install
 
-This project 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 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`.
@@ -115,7 +124,7 @@ document.querySelector("#motherboard").addEventListener("click", async () => {
     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 / Unique CW275 Scale
-- ✅ [PitchSix Force Board](https://stevie-ray.github.io/hangtime-grip-connect/devices/forceboard.html)
+- ✅ [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

@@ -1,6 +1,6 @@
 {
   "name": "@hangtime/grip-connect",
-  "version": "0.5.11",
+  "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, Progressor, WHC06, } 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, Progressor, WHC06, } 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 {
     /**

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,
             });

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 { ActiveCallback, NotifyCallback, WriteCallback } 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.
@@ -239,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,
             });
@@ -435,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,9 +1,8 @@
-// @ts-types="npm:@types/web-bluetooth@^0.0.20"
-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,6 +1,6 @@
 {
   "name": "@hangtime/grip-connect",
-  "version": "0.5.11",
+  "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",
@@ -33,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,
@@ -7,4 +9,4 @@ export {
   mySmartBoard,
   Progressor,
   WHC06,
-} from "./models/index"
+} 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({

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() {

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 {
   /**

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 {
   /**

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() {

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
@@ -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,
       })

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 { ActiveCallback, massObject, NotifyCallback, WriteCallback } 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 {
   /**
@@ -275,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,
       })
@@ -492,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,17 +1,15 @@
-// @ts-types="npm:@types/web-bluetooth@^0.0.20"
+export { Climbro } from "./device/climbro.model.js"
 
-export { Climbro } from "./device/climbro.model"
+export { Entralpi } from "./device/entralpi.model.js"
 
-export { Entralpi } from "./device/entralpi.model"
+export { ForceBoard } from "./device/forceboard.model.js"
 
-export { ForceBoard } from "./device/forceboard.model"
+export { KilterBoard } from "./device/kilterboard.model.js"
 
-export { KilterBoard } from "./device/kilterboard.model"
+export { Motherboard } from "./device/motherboard.model.js"
 
-export { Motherboard } from "./device/motherboard.model"
+export { mySmartBoard } from "./device/mysmartboard.model.js"
 
-export { mySmartBoard } from "./device/mysmartboard.model"
+export { Progressor } from "./device/progressor.model.js"
 
-export { Progressor } from "./device/progressor.model"
-
-export { WHC06 } from "./device/wh-c06.model"
+export { WHC06 } from "./device/wh-c06.model.js"