@voltras/node-sdk 0.1.0

package/dist/types/voltra/protocol/constants.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Voltra Protocol Constants
+ *
+ * BLE configuration, authentication, and command constants for
+ * Beyond Power Voltra resistance training devices.
+ */
+export declare const BLE: {
+    /** Main service UUID for Voltra devices */
+    readonly SERVICE_UUID: string;
+    /** Characteristic for receiving notifications */
+    readonly NOTIFY_CHAR_UUID: string;
+    /** Characteristic for writing commands */
+    readonly WRITE_CHAR_UUID: string;
+    /** Device name prefix for scanning (e.g., "VTR-") */
+    readonly DEVICE_NAME_PREFIX: string;
+};
+export declare const Timing: {
+    /** Delay between init commands (ms) */
+    readonly INIT_COMMAND_DELAY_MS: 20;
+    /** Delay between dual commands like chains/eccentric (ms) */
+    readonly DUAL_COMMAND_DELAY_MS: 500;
+    /** Timeout for authentication response (ms) */
+    readonly AUTH_TIMEOUT_MS: 3000;
+    /** Minimum responses expected during auth */
+    readonly MIN_AUTH_RESPONSES: 2;
+    /** Minimum responses expected after commands */
+    readonly MIN_COMMAND_RESPONSES: 4;
+};
+/**
+ * Device authentication identifiers.
+ *
+ * 41-byte device IDs that identify the connecting app.
+ * Both iPhone and iPad IDs work - the Voltra doesn't care which.
+ */
+export declare const Auth: {
+    /** iPhone identity from Beyond+ app */
+    readonly DEVICE_ID: Uint8Array<ArrayBufferLike>;
+    /** iPad identity (alternative) */
+    readonly DEVICE_ID_IPAD: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * Minimal 2-command init sequence (reduced from 22+ in Beyond+ app).
+ */
+export declare const Init: {
+    readonly SEQUENCE: Uint8Array<ArrayBufferLike>[];
+};
+/**
+ * Workout control commands.
+ *
+ * To start: set weight -> PREPARE -> SETUP -> GO
+ * To stop: STOP
+ */
+export declare const Workout: {
+    /** Prepare for workout (b04f=01) */
+    readonly PREPARE: Uint8Array<ArrayBufferLike>;
+    /** Setup workout mode (823e setup) */
+    readonly SETUP: Uint8Array<ArrayBufferLike>;
+    /** Start resistance (893e=05) */
+    readonly GO: Uint8Array<ArrayBufferLike>;
+    /** Stop resistance (893e=04) */
+    readonly STOP: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * Message type identifiers (first 4 bytes of notifications).
+ * Values loaded from protocol.json for single source of truth.
+ */
+export declare const MessageTypes: {
+    /** Real-time telemetry stream (~11 Hz) */
+    readonly TELEMETRY_STREAM: Uint8Array<ArrayBufferLike>;
+    /** Rep completion summary */
+    readonly REP_SUMMARY: Uint8Array<ArrayBufferLike>;
+    /** Set completion summary */
+    readonly SET_SUMMARY: Uint8Array<ArrayBufferLike>;
+    /** Status update */
+    readonly STATUS_UPDATE: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * Byte offsets for parsing telemetry stream messages.
+ * Values loaded from protocol.json for single source of truth.
+ */
+export declare const TelemetryOffsets: {
+    readonly SEQUENCE: number;
+    readonly PHASE: number;
+    readonly POSITION: number;
+    readonly FORCE: number;
+    readonly VELOCITY: number;
+};
+/**
+ * Movement phase during workout.
+ * Values match protocol.json telemetry.phases.
+ */
+export declare enum MovementPhase {
+    IDLE = 0,// protocolData.telemetry.phases.idle
+    CONCENTRIC = 1,// protocolData.telemetry.phases.concentric - Pulling (muscle shortening)
+    HOLD = 2,// protocolData.telemetry.phases.hold - Top of rep / transition
+    ECCENTRIC = 3,// protocolData.telemetry.phases.eccentric - Releasing (muscle lengthening)
+    UNKNOWN = -1
+}
+/**
+ * Human-readable phase names.
+ */
+export declare const PhaseNames: Record<MovementPhase, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/voltra/protocol/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,eAAO,MAAM,GAAG;IACd,2CAA2C;;IAE3C,iDAAiD;;IAEjD,0CAA0C;;IAE1C,qDAAqD;;CAE7C,CAAC;AAMX,eAAO,MAAM,MAAM;IACjB,uCAAuC;;IAEvC,6DAA6D;;IAE7D,+CAA+C;;IAE/C,6CAA6C;;IAE7C,gDAAgD;;CAExC,CAAC;AAMX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;IACf,uCAAuC;;IAEvC,kCAAkC;;CAE1B,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEP,CAAC;AAMX;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAClB,oCAAoC;;IAEpC,sCAAsC;;IAEtC,iCAAiC;;IAEjC,gCAAgC;;CAExB,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,0CAA0C;;IAE1C,6BAA6B;;IAE7B,6BAA6B;;IAE7B,oBAAoB;;CAEZ,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX;;;GAGG;AACH,oBAAY,aAAa;IACvB,IAAI,IAAI,CAAE,qCAAqC;IAC/C,UAAU,IAAI,CAAE,yEAAyE;IACzF,IAAI,IAAI,CAAE,+DAA+D;IACzE,SAAS,IAAI,CAAE,2EAA2E;IAC1F,OAAO,KAAK;CACb;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAMpD,CAAC"}

package/dist/types/voltra/protocol/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Voltra Protocol Module
+ *
+ * Complete TypeScript implementation of the Voltra BLE protocol.
+ */
+export * from './constants';
+export * from './commands';
+export * from './telemetry-decoder';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/voltra/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/types/voltra/protocol/telemetry-decoder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Telemetry Decoder
+ *
+ * Low-level protocol decoder for Voltra BLE telemetry notifications.
+ * Only handles parsing bytes into typed data - no business logic.
+ */
+import { type TelemetryFrame } from '../models/telemetry/frame';
+/**
+ * Types of messages that can be decoded.
+ */
+export type MessageType = 'telemetry_stream' | 'rep_summary' | 'set_summary' | 'status_update' | 'unknown';
+/**
+ * Identify the message type from raw bytes.
+ */
+export declare function identifyMessageType(data: Uint8Array): MessageType;
+/**
+ * Result of decoding a telemetry notification.
+ */
+export type DecodeResult = {
+    type: 'frame';
+    frame: TelemetryFrame;
+} | {
+    type: 'rep_boundary';
+} | {
+    type: 'set_boundary';
+} | {
+    type: 'status';
+    data: Uint8Array;
+} | null;
+/**
+ * Decode a telemetry stream message into a TelemetryFrame.
+ */
+export declare function decodeTelemetryFrame(data: Uint8Array): TelemetryFrame | null;
+/**
+ * Decode a BLE notification.
+ * Returns structured data based on message type.
+ */
+export declare function decodeNotification(data: Uint8Array): DecodeResult;
+/**
+ * Encode a TelemetryFrame into a BLE notification payload.
+ * Creates a minimal 30-byte message that can be decoded by decodeTelemetryFrame.
+ * Used for replay functionality.
+ */
+export declare function encodeTelemetryFrame(frame: TelemetryFrame): Uint8Array;
+//# sourceMappingURL=telemetry-decoder.d.ts.map

package/dist/types/voltra/protocol/telemetry-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-decoder.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/telemetry-decoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA4C7E;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,eAAe,GACf,SAAS,CAAC;AAEd;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAgBjE;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACpC,IAAI,CAAC;AAMT;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAuB5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAuBjE;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAyBtE"}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@voltras/node-sdk",
+  "version": "0.1.0",
+  "description": "SDK for connecting to and controlling Voltra fitness devices",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/types/react/index.d.ts",
+        "default": "./dist/esm/react/index.js"
+      },
+      "require": {
+        "types": "./dist/types/react/index.d.ts",
+        "default": "./dist/cjs/react/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run clean && npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "docs:api": "typedoc --out docs/api src/index.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm run test",
+    "prepare": "husky"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-native-ble-plx": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-native-ble-plx": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "webbluetooth": "^3.4.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.0",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/web-bluetooth": "^0.0.21",
+    "@vitest/coverage-v8": "^4.0.0",
+    "eslint": "^9.18.0",
+    "husky": "^9.1.0",
+    "lint-staged": "^15.3.0",
+    "prettier": "^3.4.0",
+    "typedoc": "^0.27.0",
+    "typescript": "~5.8.2",
+    "typescript-eslint": "^8.21.0",
+    "vitest": "^4.0.17"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "keywords": [
+    "voltra",
+    "bluetooth",
+    "ble",
+    "fitness",
+    "sdk",
+    "react-native",
+    "node",
+    "web-bluetooth"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HJewkes/voltra-node-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HJewkes/voltra-node-sdk/issues"
+  },
+  "homepage": "https://github.com/HJewkes/voltra-node-sdk#readme",
+  "author": "Voltra",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}