@voltras/node-sdk 0.1.0

package/dist/cjs/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/cjs/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/cjs/voltra/protocol/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Voltra Protocol Module
+ *
+ * Complete TypeScript implementation of the Voltra BLE protocol.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./commands"), exports);
+__exportStar(require("./telemetry-decoder"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,8CAA4B;AAC5B,6CAA2B;AAC3B,sDAAoC"}

package/dist/cjs/voltra/protocol/telemetry-decoder.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Telemetry Decoder
+ *
+ * Low-level protocol decoder for Voltra BLE telemetry notifications.
+ * Only handles parsing bytes into typed data - no business logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identifyMessageType = identifyMessageType;
+exports.decodeTelemetryFrame = decodeTelemetryFrame;
+exports.decodeNotification = decodeNotification;
+exports.encodeTelemetryFrame = encodeTelemetryFrame;
+const constants_1 = require("./constants");
+const frame_1 = require("../models/telemetry/frame");
+const utils_1 = require("../../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.
+ */
+function identifyMessageType(data) {
+    if (data.length < 4)
+        return 'unknown';
+    const msgType = data.slice(0, 4);
+    if ((0, utils_1.bytesEqual)(msgType, constants_1.MessageTypes.TELEMETRY_STREAM)) {
+        return 'telemetry_stream';
+    }
+    else if ((0, utils_1.bytesEqual)(msgType, constants_1.MessageTypes.REP_SUMMARY)) {
+        return 'rep_summary';
+    }
+    else if ((0, utils_1.bytesEqual)(msgType, constants_1.MessageTypes.SET_SUMMARY)) {
+        return 'set_summary';
+    }
+    else if ((0, utils_1.bytesEqual)(msgType, constants_1.MessageTypes.STATUS_UPDATE)) {
+        return 'status_update';
+    }
+    return 'unknown';
+}
+// =============================================================================
+// Decoder
+// =============================================================================
+/**
+ * Decode a telemetry stream message into a TelemetryFrame.
+ */
+function decodeTelemetryFrame(data) {
+    if (data.length < 30) {
+        return null;
+    }
+    // Sequence number
+    const sequence = readUint16LE(data, constants_1.TelemetryOffsets.SEQUENCE);
+    // Phase
+    const phaseByte = data[constants_1.TelemetryOffsets.PHASE];
+    let phase;
+    if (phaseByte >= 0 && phaseByte <= 3) {
+        phase = phaseByte;
+    }
+    else {
+        phase = constants_1.MovementPhase.UNKNOWN;
+    }
+    // Sensor data
+    const position = readUint16LE(data, constants_1.TelemetryOffsets.POSITION);
+    const force = readInt16LE(data, constants_1.TelemetryOffsets.FORCE);
+    const velocity = readUint16LE(data, constants_1.TelemetryOffsets.VELOCITY);
+    return (0, frame_1.createFrame)(sequence, phase, position, force, velocity);
+}
+/**
+ * Decode a BLE notification.
+ * Returns structured data based on message type.
+ */
+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.
+ */
+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, constants_1.TelemetryOffsets.SEQUENCE, frame.sequence);
+    // Phase (byte 13)
+    data[constants_1.TelemetryOffsets.PHASE] = frame.phase;
+    // Position (bytes 24-25)
+    writeUint16LE(data, constants_1.TelemetryOffsets.POSITION, frame.position);
+    // Force (bytes 26-27, signed)
+    writeInt16LE(data, constants_1.TelemetryOffsets.FORCE, frame.force);
+    // Velocity (bytes 28-29)
+    writeUint16LE(data, constants_1.TelemetryOffsets.VELOCITY, frame.velocity);
+    return data;
+}
+//# sourceMappingURL=telemetry-decoder.js.map

package/dist/cjs/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":"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"}

package/dist/esm/bluetooth/adapters/base.js

@@ -0,0 +1,112 @@
+/**
+ * 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
+ */
+/**
+ * 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 class BaseBLEAdapter {
+    constructor() {
+        /** Current connection state */
+        this.connectionState = 'disconnected';
+        /** Registered notification callbacks */
+        this.notificationCallbacks = [];
+        /** Registered connection state callbacks */
+        this.stateCallbacks = [];
+    }
+    // ===========================================================================
+    // BLEAdapter interface - implemented
+    // ===========================================================================
+    /**
+     * Get the current connection state.
+     */
+    getConnectionState() {
+        return this.connectionState;
+    }
+    /**
+     * Check if currently connected to a device.
+     */
+    isConnected() {
+        return this.connectionState === 'connected';
+    }
+    /**
+     * Register a callback for notifications from the device.
+     * @param callback Function called with notification data
+     * @returns Unsubscribe function
+     */
+    onNotification(callback) {
+        this.notificationCallbacks.push(callback);
+        return () => {
+            const index = this.notificationCallbacks.indexOf(callback);
+            if (index >= 0) {
+                this.notificationCallbacks.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Register a callback for connection state changes.
+     * @param callback Function called when state changes
+     * @returns Unsubscribe function
+     */
+    onConnectionStateChange(callback) {
+        this.stateCallbacks.push(callback);
+        return () => {
+            const index = this.stateCallbacks.indexOf(callback);
+            if (index >= 0) {
+                this.stateCallbacks.splice(index, 1);
+            }
+        };
+    }
+    // ===========================================================================
+    // Protected utilities for subclasses
+    // ===========================================================================
+    /**
+     * Set connection state and notify all registered callbacks.
+     * Only notifies if state actually changed.
+     *
+     * @param state New connection state
+     */
+    setConnectionState(state) {
+        if (this.connectionState !== state) {
+            this.connectionState = state;
+            for (const callback of this.stateCallbacks) {
+                try {
+                    callback(state);
+                }
+                catch (e) {
+                    console.error('[BaseBLEAdapter] State callback error:', e);
+                }
+            }
+        }
+    }
+    /**
+     * Emit notification data to all registered callbacks.
+     *
+     * @param data Notification data to emit
+     */
+    emitNotification(data) {
+        for (const callback of this.notificationCallbacks) {
+            try {
+                callback(data);
+            }
+            catch (e) {
+                console.error('[BaseBLEAdapter] Notification callback error:', e);
+            }
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/bluetooth/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;;;;;GAQG;AACH,MAAM,OAAgB,cAAc;IAApC;QACE,+BAA+B;QACrB,oBAAe,GAAoB,cAAc,CAAC;QAE5D,wCAAwC;QAC9B,0BAAqB,GAA2B,EAAE,CAAC;QAE7D,4CAA4C;QAClC,mBAAc,GAA8B,EAAE,CAAC;IAoH3D,CAAC;IAlHC,8EAA8E;IAC9E,qCAAqC;IACrC,8EAA8E;IAE9E;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,eAAe,KAAK,WAAW,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,QAA8B;QAC3C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,uBAAuB,CAAC,QAAiC;QACvD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IA+BD,8EAA8E;IAC9E,qCAAqC;IACrC,8EAA8E;IAE9E;;;;;OAKG;IACO,kBAAkB,CAAC,KAAsB;QACjD,IAAI,IAAI,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,gBAAgB,CAAC,IAAgB;QACzC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/esm/bluetooth/adapters/index.js

@@ -0,0 +1,51 @@
+/**
+ * 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
+ */
+// Platform adapters
+export { WebBLEAdapter } from './web';
+export { NodeBLEAdapter } from './node';
+export { NativeBLEAdapter } from './native';
+import { WebBLEAdapter } from './web';
+import { NodeBLEAdapter } from './node';
+/**
+ * Detect if running in Node.js environment.
+ */
+function isNodeEnvironment() {
+    return (typeof process !== 'undefined' && process.versions != null && process.versions.node != null);
+}
+/**
+ * Detect if running in browser environment.
+ */
+function isBrowserEnvironment() {
+    return (typeof window !== 'undefined' &&
+        typeof document !== 'undefined' &&
+        typeof navigator !== 'undefined');
+}
+/**
+ * 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 function createBLEAdapter(config) {
+    if (isNodeEnvironment() && !isBrowserEnvironment()) {
+        return new NodeBLEAdapter({ ble: config.ble });
+    }
+    if (isBrowserEnvironment()) {
+        return new WebBLEAdapter({ ble: config.ble });
+    }
+    throw new Error('Unknown environment. For React Native, import NativeBLEAdapter directly from @voltras/node-sdk/react-native');
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/bluetooth/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAA0C,MAAM,QAAQ,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAA4B,MAAM,UAAU,CAAC;AAMtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAUxC;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO,CACL,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAC5F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB;IAC3B,OAAO,CACL,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,QAAQ,KAAK,WAAW;QAC/B,OAAO,SAAS,KAAK,WAAW,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,IAAI,iBAAiB,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QACnD,OAAO,IAAI,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,oBAAoB,EAAE,EAAE,CAAC;QAC3B,OAAO,IAAI,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;AACJ,CAAC"}