@voltras/node-sdk 0.1.1 → 0.2.0

package/dist/cjs/voltra/protocol/data/protocol.json

@@ -1,54 +0,0 @@
-{
-    "_comment": "Voltra BLE Protocol - Authentication, Initialization, and Telemetry",
-    "_version": "1.1.0",
-    "ble": {
-        "service_uuid": "E4DADA34-0867-8783-9F70-2CA29216C7E4",
-        "notify_char_uuid": "55CA1E52-7354-25DE-6AFC-B7DF1E8816AC",
-        "write_char_uuid": "A010891D-F50F-44F0-901F-9A2421A9E050",
-        "device_name_prefix": "VTR-"
-    },
-    "auth": {
-        "_comment": "41-byte device IDs with proprietary checksums",
-        "iphone": "552904c90110000020004f6950686f6e6500000000000000000000000000000084ab1a5f29200172d8",
-        "ipad": "552904c90110000020004f69506164000000000000000000000000000000000084ab1a5f292001ea4f"
-    },
-    "init": {
-        "_comment": "Minimal 2-command init sequence (reduced from 22+ in Beyond+ app)",
-        "commands": [
-            "550f0801aad200002000ff00aa04194000",
-            "551f044eaa100000200027811065f8c6b9179047b797d3351c04bffb925cd64100"
-        ]
-    },
-    "workout": {
-        "_comment": "Workout control commands",
-        "prepare": "551204c7aa1014002000110100b04f01db10",
-        "setup": "55130403aa10150020000f02006a50823e8f2f",
-        "go": "55130403aa1016002000110100893e05008173",
-        "stop": "55130403aa101b002000110100893e040037dd"
-    },
-    "telemetry": {
-        "_comment": "Telemetry parsing configuration - message types, byte offsets, movement phases",
-        "message_types": {
-            "_comment": "First 4 bytes of notifications identify message type",
-            "stream": "553a0470",
-            "rep_summary": "554a04c6",
-            "set_summary": "554f0439",
-            "status_update": "553404ac"
-        },
-        "offsets": {
-            "_comment": "Byte offsets for parsing telemetry stream messages",
-            "sequence": 6,
-            "phase": 13,
-            "position": 24,
-            "force": 26,
-            "velocity": 28
-        },
-        "phases": {
-            "_comment": "Movement phase values (byte at offset 13)",
-            "idle": 0,
-            "concentric": 1,
-            "hold": 2,
-            "eccentric": 3
-        }
-    }
-}

package/dist/cjs/voltra/protocol/data/weights.json

@@ -1,62 +0,0 @@
-{
-    "_comment": "Weight commands (863e register) - 5 to 200 lbs in 5 lb increments",
-    "format": {
-        "description": "21-byte command structure",
-        "length": 21,
-        "structure": [
-            { "name": "prefix", "bytes": "0-5", "value": "55130403aa10", "constant": true },
-            { "name": "sequence", "bytes": "6-7", "value": "varies", "encoding": "uint16_le" },
-            { "name": "mode", "bytes": "8-12", "value": "2000110100", "constant": true },
-            { "name": "register", "bytes": "13-14", "value": "863e", "constant": true },
-            { "name": "value", "bytes": "15-16", "value": "weight_in_lbs", "encoding": "uint16_le" },
-            { "name": "checksum", "bytes": "17-19", "value": "varies", "encoding": "3_bytes_hex" },
-            { "name": "padding", "bytes": "20", "value": "00", "constant": true }
-        ],
-        "prefix": "55130403aa10",
-        "mode": "2000110100",
-        "register": "863e",
-        "padding": "00"
-    },
-    "values": {
-        "5": { "seq": "1500", "checksum": "cb3f37", "_full": "55130403aa1015002000110100863e0500cb3f3700" },
-        "10": { "seq": "1400", "checksum": "92e941", "_full": "55130403aa1014002000110100863e0a0092e94100" },
-        "15": { "seq": "1500", "checksum": "bbc234", "_full": "55130403aa1015002000110100863e0f00bbc23400" },
-        "20": { "seq": "1600", "checksum": "314d40", "_full": "55130403aa1016002000110100863e1400314d4000" },
-        "25": { "seq": "1700", "checksum": "d8a836", "_full": "55130403aa1017002000110100863e1900d8a83600" },
-        "30": { "seq": "1800", "checksum": "9cf934", "_full": "55130403aa1018002000110100863e1e009cf93400" },
-        "35": { "seq": "1900", "checksum": "d7aa37", "_full": "55130403aa1019002000110100863e2300d7aa3700" },
-        "40": { "seq": "1a00", "checksum": "ccb037", "_full": "55130403aa101a002000110100863e2800ccb03700" },
-        "45": { "seq": "1b00", "checksum": "e59b40", "_full": "55130403aa101b002000110100863e2d00e59b4000" },
-        "50": { "seq": "1c00", "checksum": "5a2d37", "_full": "55130403aa101c002000110100863e32005a2d3700" },
-        "55": { "seq": "1700", "checksum": "fb1112", "_full": "55130403aa1017002000110100863e3700fb111200" },
-        "60": { "seq": "1800", "checksum": "1fe937", "_full": "55130403aa1018002000110100863e3c001fe93700" },
-        "65": { "seq": "1900", "checksum": "32fc40", "_full": "55130403aa1019002000110100863e410032fc4000" },
-        "70": { "seq": "1a00", "checksum": "894f37", "_full": "55130403aa101a002000110100863e4600894f3700" },
-        "75": { "seq": "1b00", "checksum": "60aa12", "_full": "55130403aa101b002000110100863e4b0060aa1200" },
-        "80": { "seq": "1c00", "checksum": "bf7b43", "_full": "55130403aa101c002000110100863e5000bf7b4300" },
-        "85": { "seq": "1d00", "checksum": "965037", "_full": "55130403aa101d002000110100863e550096503700" },
-        "90": { "seq": "1e00", "checksum": "ed2d37", "_full": "55130403aa101e002000110100863e5a00ed2d3700" },
-        "95": { "seq": "1f00", "checksum": "c40634", "_full": "55130403aa101f002000110100863e5f00c4063400" },
-        "100": { "seq": "2000", "checksum": "4ddb12", "_full": "55130403aa1020002000110100863e64004ddb1200" },
-        "105": { "seq": "2100", "checksum": "a43e37", "_full": "55130403aa1021002000110100863e6900a43e3700" },
-        "110": { "seq": "3000", "checksum": "785740", "_full": "55130403aa1030002000110100863e6e0078574000" },
-        "115": { "seq": "3100", "checksum": "00272d", "_full": "55130403aa1031002000110100863e730000272d00" },
-        "120": { "seq": "3200", "checksum": "1b3d40", "_full": "55130403aa1032002000110100863e78001b3d4000" },
-        "125": { "seq": "3900", "checksum": "ba013f", "_full": "55130403aa1039002000110100863e7d00ba013f00" },
-        "130": { "seq": "3a00", "checksum": "c90037", "_full": "55130403aa103a002000110100863e8200c9003700" },
-        "135": { "seq": "3b00", "checksum": "e02b34", "_full": "55130403aa103b002000110100863e8700e02b3400" },
-        "140": { "seq": "3c00", "checksum": "ae6f12", "_full": "55130403aa103c002000110100863e8c00ae6f1200" },
-        "145": { "seq": "3d00", "checksum": "d61f37", "_full": "55130403aa103d002000110100863e9100d61f3700" },
-        "150": { "seq": "3e00", "checksum": "6dac2d", "_full": "55130403aa103e002000110100863e96006dac2d00" },
-        "155": { "seq": "3f00", "checksum": "844937", "_full": "55130403aa103f002000110100863e9b0084493700" },
-        "160": { "seq": "4000", "checksum": "085941", "_full": "55130403aa1040002000110100863ea00008594100" },
-        "165": { "seq": "4100", "checksum": "217237", "_full": "55130403aa1041002000110100863ea50021723700" },
-        "170": { "seq": "4200", "checksum": "5a0f43", "_full": "55130403aa1042002000110100863eaa005a0f4300" },
-        "175": { "seq": "4300", "checksum": "732434", "_full": "55130403aa1043002000110100863eaf0073243400" },
-        "180": { "seq": "4400", "checksum": "acf537", "_full": "55130403aa1044002000110100863eb400acf53700" },
-        "185": { "seq": "4500", "checksum": "451037", "_full": "55130403aa1045002000110100863eb90045103700" },
-        "190": { "seq": "4600", "checksum": "fea312", "_full": "55130403aa1046002000110100863ebe00fea31200" },
-        "195": { "seq": "4700", "checksum": "d3b637", "_full": "55130403aa1047002000110100863ec300d3b63700" },
-        "200": { "seq": "4800", "checksum": "374e41", "_full": "55130403aa1048002000110100863ec800374e4100" }
-    }
-}

package/dist/esm/voltra/protocol/constants.js

@@ -1,130 +0,0 @@
-/**
- * Voltra Protocol Constants
- *
- * BLE configuration, authentication, and command constants for
- * Beyond Power Voltra resistance training devices.
- */
-import { hexToBytes } from '../../shared/utils';
-import protocolData from './data/protocol.json';
-// =============================================================================
-// BLE Configuration
-// =============================================================================
-export const BLE = {
-    /** Main service UUID for Voltra devices */
-    SERVICE_UUID: protocolData.ble.service_uuid,
-    /** Characteristic for receiving notifications */
-    NOTIFY_CHAR_UUID: protocolData.ble.notify_char_uuid,
-    /** Characteristic for writing commands */
-    WRITE_CHAR_UUID: protocolData.ble.write_char_uuid,
-    /** Device name prefix for scanning (e.g., "VTR-") */
-    DEVICE_NAME_PREFIX: protocolData.ble.device_name_prefix,
-};
-// =============================================================================
-// Timing Configuration
-// =============================================================================
-export const Timing = {
-    /** Delay between init commands (ms) */
-    INIT_COMMAND_DELAY_MS: 20,
-    /** Delay between dual commands like chains/eccentric (ms) */
-    DUAL_COMMAND_DELAY_MS: 500,
-    /** Timeout for authentication response (ms) */
-    AUTH_TIMEOUT_MS: 3000,
-    /** Minimum responses expected during auth */
-    MIN_AUTH_RESPONSES: 2,
-    /** Minimum responses expected after commands */
-    MIN_COMMAND_RESPONSES: 4,
-};
-// =============================================================================
-// Authentication
-// =============================================================================
-/**
- * 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 const Auth = {
-    /** iPhone identity from Beyond+ app */
-    DEVICE_ID: hexToBytes(protocolData.auth.iphone),
-    /** iPad identity (alternative) */
-    DEVICE_ID_IPAD: hexToBytes(protocolData.auth.ipad),
-};
-// =============================================================================
-// Initialization
-// =============================================================================
-/**
- * Minimal 2-command init sequence (reduced from 22+ in Beyond+ app).
- */
-export const Init = {
-    SEQUENCE: protocolData.init.commands.map(hexToBytes),
-};
-// =============================================================================
-// Workout Commands
-// =============================================================================
-/**
- * Workout control commands.
- *
- * To start: set weight -> PREPARE -> SETUP -> GO
- * To stop: STOP
- */
-export const Workout = {
-    /** Prepare for workout (b04f=01) */
-    PREPARE: hexToBytes(protocolData.workout.prepare),
-    /** Setup workout mode (823e setup) */
-    SETUP: hexToBytes(protocolData.workout.setup),
-    /** Start resistance (893e=05) */
-    GO: hexToBytes(protocolData.workout.go),
-    /** Stop resistance (893e=04) */
-    STOP: hexToBytes(protocolData.workout.stop),
-};
-// =============================================================================
-// Telemetry Message Types (loaded from protocol.json)
-// =============================================================================
-/**
- * Message type identifiers (first 4 bytes of notifications).
- * Values loaded from protocol.json for single source of truth.
- */
-export const MessageTypes = {
-    /** Real-time telemetry stream (~11 Hz) */
-    TELEMETRY_STREAM: hexToBytes(protocolData.telemetry.message_types.stream),
-    /** Rep completion summary */
-    REP_SUMMARY: hexToBytes(protocolData.telemetry.message_types.rep_summary),
-    /** Set completion summary */
-    SET_SUMMARY: hexToBytes(protocolData.telemetry.message_types.set_summary),
-    /** Status update */
-    STATUS_UPDATE: hexToBytes(protocolData.telemetry.message_types.status_update),
-};
-/**
- * Byte offsets for parsing telemetry stream messages.
- * Values loaded from protocol.json for single source of truth.
- */
-export const TelemetryOffsets = {
-    SEQUENCE: protocolData.telemetry.offsets.sequence, // 2 bytes, little-endian
-    PHASE: protocolData.telemetry.offsets.phase, // 1 byte
-    POSITION: protocolData.telemetry.offsets.position, // 2 bytes, little-endian unsigned
-    FORCE: protocolData.telemetry.offsets.force, // 2 bytes, little-endian signed
-    VELOCITY: protocolData.telemetry.offsets.velocity, // 2 bytes, little-endian unsigned
-};
-/**
- * Movement phase during workout.
- * Values match protocol.json telemetry.phases.
- */
-export var MovementPhase;
-(function (MovementPhase) {
-    MovementPhase[MovementPhase["IDLE"] = 0] = "IDLE";
-    MovementPhase[MovementPhase["CONCENTRIC"] = 1] = "CONCENTRIC";
-    MovementPhase[MovementPhase["HOLD"] = 2] = "HOLD";
-    MovementPhase[MovementPhase["ECCENTRIC"] = 3] = "ECCENTRIC";
-    MovementPhase[MovementPhase["UNKNOWN"] = -1] = "UNKNOWN";
-})(MovementPhase || (MovementPhase = {}));
-/**
- * Human-readable phase names.
- */
-export const PhaseNames = {
-    [MovementPhase.IDLE]: 'Idle',
-    [MovementPhase.CONCENTRIC]: 'Pulling',
-    [MovementPhase.HOLD]: 'Hold',
-    [MovementPhase.ECCENTRIC]: 'Lowering',
-    [MovementPhase.UNKNOWN]: 'Unknown',
-};
-//# sourceMappingURL=constants.js.map

package/dist/esm/voltra/protocol/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/voltra/protocol/constants.ts"],"names":[],"mappings":"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"}