@voltras/node-sdk 0.1.2 → 0.2.0

package/dist/esm/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/esm/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/types/voltra/protocol/constants.d.ts

@@ -1,103 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}