@voltras/node-sdk 0.1.0

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

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

@@ -0,0 +1,62 @@
+{
+    "_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/index.js

@@ -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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/voltra/protocol/telemetry-decoder.js

@@ -0,0 +1,140 @@
+/**
+ * Telemetry Decoder
+ *
+ * Low-level protocol decoder for Voltra BLE telemetry notifications.
+ * Only handles parsing bytes into typed data - no business logic.
+ */
+import { MessageTypes, TelemetryOffsets, MovementPhase } from './constants';
+import { createFrame } from '../models/telemetry/frame';
+import { bytesEqual } from '../../shared/utils';
+// =============================================================================
+// Byte Parsing Helpers
+// =============================================================================
+/**
+ * Read a little-endian uint16 from a Uint8Array.
+ */
+function readUint16LE(data, offset) {
+    return data[offset] | (data[offset + 1] << 8);
+}
+/**
+ * Read a little-endian int16 from a Uint8Array.
+ */
+function readInt16LE(data, offset) {
+    const value = readUint16LE(data, offset);
+    return value > 0x7fff ? value - 0x10000 : value;
+}
+/**
+ * Write a little-endian uint16 to a Uint8Array.
+ */
+function writeUint16LE(data, offset, value) {
+    data[offset] = value & 0xff;
+    data[offset + 1] = (value >> 8) & 0xff;
+}
+/**
+ * Write a little-endian int16 to a Uint8Array.
+ */
+function writeInt16LE(data, offset, value) {
+    if (value < 0) {
+        value = value + 0x10000;
+    }
+    writeUint16LE(data, offset, value);
+}
+/**
+ * Identify the message type from raw bytes.
+ */
+export function identifyMessageType(data) {
+    if (data.length < 4)
+        return 'unknown';
+    const msgType = data.slice(0, 4);
+    if (bytesEqual(msgType, MessageTypes.TELEMETRY_STREAM)) {
+        return 'telemetry_stream';
+    }
+    else if (bytesEqual(msgType, MessageTypes.REP_SUMMARY)) {
+        return 'rep_summary';
+    }
+    else if (bytesEqual(msgType, MessageTypes.SET_SUMMARY)) {
+        return 'set_summary';
+    }
+    else if (bytesEqual(msgType, MessageTypes.STATUS_UPDATE)) {
+        return 'status_update';
+    }
+    return 'unknown';
+}
+// =============================================================================
+// Decoder
+// =============================================================================
+/**
+ * Decode a telemetry stream message into a TelemetryFrame.
+ */
+export function decodeTelemetryFrame(data) {
+    if (data.length < 30) {
+        return null;
+    }
+    // Sequence number
+    const sequence = readUint16LE(data, TelemetryOffsets.SEQUENCE);
+    // Phase
+    const phaseByte = data[TelemetryOffsets.PHASE];
+    let phase;
+    if (phaseByte >= 0 && phaseByte <= 3) {
+        phase = phaseByte;
+    }
+    else {
+        phase = MovementPhase.UNKNOWN;
+    }
+    // Sensor data
+    const position = readUint16LE(data, TelemetryOffsets.POSITION);
+    const force = readInt16LE(data, TelemetryOffsets.FORCE);
+    const velocity = readUint16LE(data, TelemetryOffsets.VELOCITY);
+    return createFrame(sequence, phase, position, force, velocity);
+}
+/**
+ * Decode a BLE notification.
+ * Returns structured data based on message type.
+ */
+export function decodeNotification(data) {
+    const msgType = identifyMessageType(data);
+    switch (msgType) {
+        case 'telemetry_stream': {
+            const frame = decodeTelemetryFrame(data);
+            return frame ? { type: 'frame', frame } : null;
+        }
+        case 'rep_summary':
+            // Device is signaling a rep boundary (end of concentric or eccentric)
+            return { type: 'rep_boundary' };
+        case 'set_summary':
+            // Device is signaling set completion
+            return { type: 'set_boundary' };
+        case 'status_update':
+            return { type: 'status', data };
+        default:
+            return null;
+    }
+}
+// =============================================================================
+// Encoder (for replay)
+// =============================================================================
+/**
+ * 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 function encodeTelemetryFrame(frame) {
+    const data = new Uint8Array(30);
+    // Message type header (telemetry stream)
+    data[0] = 0x55;
+    data[1] = 0x3a;
+    data[2] = 0x04;
+    data[3] = 0x70;
+    // Sequence (bytes 6-7)
+    writeUint16LE(data, TelemetryOffsets.SEQUENCE, frame.sequence);
+    // Phase (byte 13)
+    data[TelemetryOffsets.PHASE] = frame.phase;
+    // Position (bytes 24-25)
+    writeUint16LE(data, TelemetryOffsets.POSITION, frame.position);
+    // Force (bytes 26-27, signed)
+    writeInt16LE(data, TelemetryOffsets.FORCE, frame.force);
+    // Velocity (bytes 28-29)
+    writeUint16LE(data, TelemetryOffsets.VELOCITY, frame.velocity);
+    return data;
+}
+//# sourceMappingURL=telemetry-decoder.js.map

package/dist/esm/voltra/protocol/telemetry-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-decoder.js","sourceRoot":"","sources":["../../../../src/voltra/protocol/telemetry-decoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAuB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,YAAY,CAAC,IAAgB,EAAE,MAAc;IACpD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAgB,EAAE,MAAc;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAgB,EAAE,MAAc,EAAE,KAAa;IACpE,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAgB,EAAE,MAAc,EAAE,KAAa;IACnE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjC,IAAI,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;SAAM,IAAI,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC;IACvB,CAAC;SAAM,IAAI,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC;IACvB,CAAC;SAAM,IAAI,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3D,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAgBD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE/D,QAAQ;IACR,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAoB,CAAC;IACzB,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACrC,KAAK,GAAG,SAA0B,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,cAAc;IACd,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE/D,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE1C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC;QAED,KAAK,aAAa;YAChB,sEAAsE;YACtE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAElC,KAAK,aAAa;YAChB,qCAAqC;YACrC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAElC,KAAK,eAAe;YAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAElC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAEhC,yCAAyC;IACzC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACf,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACf,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACf,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAEf,uBAAuB;IACvB,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/D,kBAAkB;IAClB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;IAE3C,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/D,8BAA8B;IAC9B,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAExD,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types/bluetooth/adapters/base.d.ts

@@ -0,0 +1,85 @@
+/**
+ * BaseBLEAdapter
+ *
+ * Abstract base class for all BLE adapters. Provides shared implementation
+ * for connection state management and callback registration/notification.
+ *
+ * Subclasses implement the platform-specific BLE operations:
+ * - NativeBLEAdapter: react-native-ble-plx for iOS/Android
+ * - WebBLEAdapter: Web Bluetooth API for browsers
+ * - NodeBLEAdapter: webbluetooth npm for Node.js
+ * - ReplayBLEAdapter: Playback for testing/demos
+ */
+import type { BLEAdapter, Device, ConnectionState, NotificationCallback, ConnectionStateCallback, ConnectOptions } from './types';
+/**
+ * Abstract base class implementing shared BLE adapter functionality.
+ *
+ * Provides:
+ * - Connection state management with change notifications
+ * - Notification callback registration (supports multiple listeners)
+ * - State callback registration (supports multiple listeners)
+ * - Protected utilities for subclasses to emit events
+ */
+export declare abstract class BaseBLEAdapter implements BLEAdapter {
+    /** Current connection state */
+    protected connectionState: ConnectionState;
+    /** Registered notification callbacks */
+    protected notificationCallbacks: NotificationCallback[];
+    /** Registered connection state callbacks */
+    protected stateCallbacks: ConnectionStateCallback[];
+    /**
+     * Get the current connection state.
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Check if currently connected to a device.
+     */
+    isConnected(): boolean;
+    /**
+     * Register a callback for notifications from the device.
+     * @param callback Function called with notification data
+     * @returns Unsubscribe function
+     */
+    onNotification(callback: NotificationCallback): () => void;
+    /**
+     * Register a callback for connection state changes.
+     * @param callback Function called when state changes
+     * @returns Unsubscribe function
+     */
+    onConnectionStateChange(callback: ConnectionStateCallback): () => void;
+    /**
+     * Scan for devices.
+     * @param timeout Scan duration in seconds
+     * @returns List of discovered devices
+     */
+    abstract scan(timeout: number): Promise<Device[]>;
+    /**
+     * Connect to a device.
+     * @param deviceId Device identifier from scan results
+     * @param options Optional connection options
+     */
+    abstract connect(deviceId: string, options?: ConnectOptions): Promise<void>;
+    /**
+     * Disconnect from the current device.
+     */
+    abstract disconnect(): Promise<void>;
+    /**
+     * Write data to the device's write characteristic.
+     * @param data Bytes to write
+     */
+    abstract write(data: Uint8Array): Promise<void>;
+    /**
+     * Set connection state and notify all registered callbacks.
+     * Only notifies if state actually changed.
+     *
+     * @param state New connection state
+     */
+    protected setConnectionState(state: ConnectionState): void;
+    /**
+     * Emit notification data to all registered callbacks.
+     *
+     * @param data Notification data to emit
+     */
+    protected emitNotification(data: Uint8Array): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/bluetooth/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,8BAAsB,cAAe,YAAW,UAAU;IACxD,+BAA+B;IAC/B,SAAS,CAAC,eAAe,EAAE,eAAe,CAAkB;IAE5D,wCAAwC;IACxC,SAAS,CAAC,qBAAqB,EAAE,oBAAoB,EAAE,CAAM;IAE7D,4CAA4C;IAC5C,SAAS,CAAC,cAAc,EAAE,uBAAuB,EAAE,CAAM;IAMzD;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAU1D;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IActE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3E;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAa1D;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;CASnD"}

package/dist/types/bluetooth/adapters/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * BLE Abstraction Layer
+ *
+ * Provides a unified interface for BLE communication across platforms:
+ * - Native (iOS/Android): react-native-ble-plx
+ * - Browser: Web Bluetooth API
+ * - Node.js: webbluetooth npm package
+ */
+export type { BLEAdapter, Device, ConnectionState, NotificationCallback, ConnectionStateCallback, ConnectOptions, BLEServiceConfig, } from './types';
+export { WebBLEAdapter } from './web';
+export { NodeBLEAdapter, type NodeBLEConfig, type DeviceChooser } from './node';
+export { NativeBLEAdapter, type NativeAdapterConfig } from './native';
+import type { BLEAdapter, BLEServiceConfig } from './types';
+/**
+ * Full configuration for creating a BLE adapter.
+ */
+export interface CreateBLEAdapterConfig {
+    /** BLE service configuration (UUIDs, device name prefix) */
+    ble: BLEServiceConfig;
+}
+/**
+ * Create a BLE adapter based on the current environment.
+ *
+ * Environment detection:
+ * - Web browser: WebBLEAdapter (Web Bluetooth API)
+ * - Node.js: NodeBLEAdapter (webbluetooth package)
+ *
+ * NOTE: For React Native, import and instantiate NativeBLEAdapter directly.
+ * This factory is for web/Node.js environments only.
+ *
+ * @param config Adapter configuration including BLE service UUIDs
+ * @returns BLEAdapter instance appropriate for the current environment
+ */
+export declare function createBLEAdapter(config: CreateBLEAdapterConfig): BLEAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/bluetooth/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,UAAU,EACV,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAKtE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI5D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,UAAU,CAY3E"}

package/dist/types/bluetooth/adapters/native.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Native BLE Adapter
+ *
+ * Uses react-native-ble-plx for direct BLE communication on iOS/Android.
+ * Includes auto-reconnect functionality for seamless app resume.
+ *
+ * This adapter is generic and can be configured for any BLE device by
+ * providing the appropriate service/characteristic UUIDs.
+ *
+ * IMPORTANT: This adapter requires react-native-ble-plx as a peer dependency.
+ * Install it in your React Native project: npm install react-native-ble-plx
+ */
+import { BaseBLEAdapter } from './base';
+import type { Device, ConnectOptions, BLEServiceConfig } from './types';
+export type { BLEServiceConfig } from './types';
+/**
+ * Configuration for auto-reconnect behavior.
+ */
+export interface NativeAdapterConfig {
+    /** BLE service configuration */
+    ble: BLEServiceConfig;
+    /** Enable auto-reconnect when app returns to foreground */
+    autoReconnect?: boolean;
+    /** Max attempts for auto-reconnect */
+    maxReconnectAttempts?: number;
+    /** Delay between reconnect attempts (ms) */
+    reconnectDelayMs?: number;
+}
+/**
+ * BLE adapter using react-native-ble-plx for native device communication.
+ * Supports auto-reconnect when app resumes from background.
+ */
+export declare class NativeBLEAdapter extends BaseBLEAdapter {
+    private manager;
+    private device;
+    private notifySubscription;
+    private writeSubscription;
+    private bleConfig;
+    private autoReconnect;
+    private maxReconnectAttempts;
+    private reconnectDelayMs;
+    private lastConnectedDeviceId;
+    private lastConnectedDeviceName;
+    private isReconnecting;
+    private reconnectAttempts;
+    private appStateSubscription;
+    private isDisconnecting;
+    private disconnectSubscription;
+    private onReconnectStart?;
+    private onReconnectSuccess?;
+    private onReconnectFailed?;
+    constructor(config: NativeAdapterConfig);
+    /**
+     * Set up listener for app state changes (background/foreground).
+     */
+    private setupAppStateListener;
+    /**
+     * Handle app state changes for auto-reconnect.
+     */
+    private handleAppStateChange;
+    /**
+     * Attempt to reconnect to the last known device.
+     */
+    private attemptReconnect;
+    private waitForPoweredOn;
+    scan(timeout: number): Promise<Device[]>;
+    connect(deviceId: string, options?: ConnectOptions): Promise<void>;
+    private cleanupSubscriptions;
+    private cleanupAllSubscriptions;
+    disconnect(): Promise<void>;
+    write(data: Uint8Array): Promise<void>;
+    /**
+     * Override isConnected to also check if device exists.
+     */
+    isConnected(): boolean;
+    /**
+     * Get info about the currently connected device.
+     */
+    getConnectedDevice(): Device | null;
+    /**
+     * Get the last connected device ID (for reconnection).
+     */
+    getLastConnectedDeviceId(): string | null;
+    /**
+     * Set callbacks for reconnect events.
+     */
+    setReconnectCallbacks(callbacks: {
+        onStart?: () => void;
+        onSuccess?: () => void;
+        onFailed?: (error: Error) => void;
+    }): void;
+    /**
+     * Manually trigger a reconnect attempt.
+     */
+    reconnect(): Promise<void>;
+    /**
+     * Set the last connected device (for restoring from storage).
+     */
+    setLastConnectedDevice(deviceId: string, deviceName?: string): void;
+    /**
+     * Check if auto-reconnect is in progress.
+     */
+    isAutoReconnecting(): boolean;
+    /**
+     * Destroy the BLE manager (call when app is closing).
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=native.d.ts.map

package/dist/types/bluetooth/adapters/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAsEhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,GAAG,EAAE,gBAAgB,CAAC;IACtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAAS;IAGjC,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,oBAAoB,CAAuC;IAGnE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,sBAAsB,CAAuC;IAGrE,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAa;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAAyB;gBAEvC,MAAM,EAAE,mBAAmB;IAevC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;YACW,oBAAoB;IA2BlC;;OAEG;YACW,gBAAgB;YAqChB,gBAAgB;IA2BxB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkExC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwHxE,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,uBAAuB;IAYzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C;;OAEG;IACM,WAAW,IAAI,OAAO;IAI/B;;OAEG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI;IASnC;;OAEG;IACH,wBAAwB,IAAI,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE;QAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;QACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KACnC,GAAG,IAAI;IAMR;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnE;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/types/bluetooth/adapters/node.d.ts

@@ -0,0 +1,91 @@
+/**
+ * NodeBLEAdapter
+ *
+ * BLE adapter for Node.js using the webbluetooth npm package.
+ * Implements the same W3C Web Bluetooth API for server-side BLE.
+ *
+ * Requirements:
+ * - Node.js environment
+ * - webbluetooth npm package
+ * - Platform-specific Bluetooth support (macOS, Linux, Windows)
+ */
+import { WebBluetoothBase, type WebBluetoothConfig } from './web-bluetooth-base';
+import type { Device, ConnectOptions } from './types';
+/**
+ * Device chooser function type.
+ * Called during scan to programmatically select a device.
+ */
+export type DeviceChooser = (devices: Device[]) => Device | null;
+/**
+ * Configuration for Node.js BLE adapter.
+ */
+export interface NodeBLEConfig extends WebBluetoothConfig {
+    /**
+     * Optional device chooser function.
+     * If not provided, the first matching device is selected.
+     */
+    deviceChooser?: DeviceChooser;
+}
+/**
+ * BLE adapter for Node.js environments using webbluetooth package.
+ *
+ * Device selection flow:
+ * 1. Call scan() - starts BLE scan
+ * 2. Devices are discovered via deviceFound callback
+ * 3. deviceChooser function selects a device (or first match by default)
+ * 4. Call connect() to establish GATT connection
+ */
+export declare class NodeBLEAdapter extends WebBluetoothBase {
+    /** Device chooser function for programmatic selection */
+    private deviceChooser;
+    /** Device selected during scan, stored for connect() */
+    private selectedDevice;
+    /** List of discovered devices during current scan */
+    private discoveredDevices;
+    constructor(config: NodeBLEConfig);
+    /**
+     * Set the device chooser function.
+     * Called during scan to programmatically select a device.
+     *
+     * @param chooser Function that receives discovered devices and returns the chosen one
+     */
+    setDeviceChooser(chooser: DeviceChooser): void;
+    /**
+     * Ensure webbluetooth is loaded (lazy load to avoid bundler issues).
+     */
+    private ensureBluetoothLoaded;
+    /**
+     * Scan for devices programmatically.
+     *
+     * In Node.js, there's no browser picker. Devices are discovered via
+     * the deviceFound callback, and the deviceChooser function selects one.
+     *
+     * IMPORTANT: The webbluetooth package requires creating a new Bluetooth
+     * instance with deviceFound in the constructor for the callback to work
+     * reliably. Using the default singleton doesn't call the callback consistently.
+     *
+     * @param timeout Scan timeout in seconds
+     * @returns Array of discovered devices (selection happens via deviceChooser)
+     */
+    scan(timeout: number): Promise<Device[]>;
+    /**
+     * Connect to the selected device.
+     *
+     * @param deviceId Device ID (should match the selected device)
+     * @param options Connection options
+     */
+    connect(deviceId: string, options?: ConnectOptions): Promise<void>;
+    /**
+     * Override disconnect to also clear selected device.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get the list of devices discovered during the last scan.
+     */
+    getDiscoveredDevices(): Device[];
+    /**
+     * Check if running in a Node.js environment.
+     */
+    static isNodeEnvironment(): boolean;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/types/bluetooth/adapters/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMtD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,yDAAyD;IACzD,OAAO,CAAC,aAAa,CAAuB;IAE5C,wDAAwD;IACxD,OAAO,CAAC,cAAc,CAAgC;IAEtD,qDAAqD;IACrD,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,MAAM,EAAE,aAAa;IAKjC;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI9C;;OAEG;YACW,qBAAqB;IAcnC;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuF9C;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxE;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1C;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,OAAO;CAKpC"}