@voltras/node-sdk 0.1.0

package/dist/cjs/bluetooth/controllers/scanner-controller.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Scanner Controller
+ *
+ * Manages BLE device scanning with auto-scan functionality.
+ * This is a generic controller that can be configured with a device filter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScannerController = void 0;
+/**
+ * Controller for BLE device scanning.
+ */
+class ScannerController {
+    constructor(adapter, _environment, config, deviceFilter) {
+        this.adapter = adapter;
+        this._environment = _environment;
+        this.config = config;
+        this.deviceFilter = deviceFilter;
+        this._isScanning = false;
+        this._discoveredDevices = [];
+        this._lastScanTime = 0;
+        this._error = null;
+        this._autoScanInterval = null;
+        this._listeners = new Set();
+    }
+    /**
+     * Get current scanner state.
+     */
+    getState() {
+        return {
+            isScanning: this._isScanning,
+            discoveredDevices: this._discoveredDevices,
+            lastScanTime: this._lastScanTime,
+            error: this._error,
+        };
+    }
+    /**
+     * Subscribe to scanner events.
+     */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => this._listeners.delete(listener);
+    }
+    emit(event) {
+        this._listeners.forEach((listener) => listener(event));
+    }
+    /**
+     * Scan for devices.
+     */
+    async scan() {
+        // Don't scan if already scanning
+        if (this._isScanning) {
+            return this._discoveredDevices;
+        }
+        this._isScanning = true;
+        this._error = null;
+        this.emit({ type: 'scanStarted' });
+        try {
+            const devices = await this.adapter.scan(this.config.scanDurationMs / 1000);
+            // Apply device filter if provided, otherwise return all devices
+            const filteredDevices = this.deviceFilter
+                ? this.deviceFilter(devices)
+                : devices;
+            this._discoveredDevices = filteredDevices;
+            this._lastScanTime = Date.now();
+            this._isScanning = false;
+            this.emit({ type: 'scanCompleted', devices: filteredDevices });
+            return filteredDevices;
+        }
+        catch (e) {
+            this._isScanning = false;
+            const errorMsg = e instanceof Error ? e.message : String(e);
+            // User cancelled device picker (web) - not an error
+            if (errorMsg.includes('NotFoundError')) {
+                this._error = null;
+                this.emit({ type: 'scanCompleted', devices: [] });
+                return [];
+            }
+            // On web, "permission" errors are expected when scan is called without user gesture
+            // Don't show these as errors - user just needs to click the scan button
+            if (this._environment.requiresUserGesture && errorMsg.includes('permission')) {
+                this._error = null;
+                this.emit({ type: 'scanCompleted', devices: [] });
+                return [];
+            }
+            // Categorize errors
+            if (errorMsg.includes('permission') || errorMsg.includes('Unauthorized')) {
+                this._error = 'Bluetooth permission required. Please enable in Settings.';
+            }
+            else if (errorMsg.includes('Timeout') || errorMsg.includes('PoweredOff')) {
+                this._error = 'Please enable Bluetooth on your device.';
+            }
+            else {
+                this._error = `Scan failed: ${errorMsg}`;
+            }
+            this.emit({ type: 'scanFailed', error: this._error ?? 'Unknown error' });
+            return [];
+        }
+    }
+    /**
+     * Start auto-scanning.
+     * Returns cleanup function.
+     */
+    startAutoScan(isConnected) {
+        // Clear existing intervals
+        this.stopAutoScan();
+        // Initial scan after short delay
+        setTimeout(() => {
+            if (!isConnected()) {
+                this.scan();
+            }
+        }, 500);
+        // Periodic auto-scan when not connected
+        this._autoScanInterval = setInterval(() => {
+            if (!this._isScanning && !isConnected()) {
+                this.scan();
+            }
+        }, this.config.scanIntervalMs);
+        return () => this.stopAutoScan();
+    }
+    /**
+     * Stop auto-scanning.
+     */
+    stopAutoScan() {
+        if (this._autoScanInterval) {
+            clearInterval(this._autoScanInterval);
+            this._autoScanInterval = null;
+        }
+    }
+    /**
+     * Clear error state.
+     */
+    clearError() {
+        this._error = null;
+    }
+    /**
+     * Cleanup resources.
+     */
+    dispose() {
+        this.stopAutoScan();
+        this._listeners.clear();
+    }
+}
+exports.ScannerController = ScannerController;
+//# sourceMappingURL=scanner-controller.js.map

package/dist/cjs/bluetooth/controllers/scanner-controller.js.map

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

package/dist/cjs/bluetooth/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Bluetooth Domain
+ *
+ * Generic BLE connection management, device scanning, and environment detection.
+ * This domain provides reusable BLE infrastructure that can be configured
+ * for any BLE device.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBLEAdapter = exports.NativeBLEAdapter = exports.NodeBLEAdapter = exports.WebBLEAdapter = exports.createNativeEnvironmentInfo = exports.isBLEAvailable = exports.detectBLEEnvironment = exports.sortBySignalStrength = exports.getDeviceDisplayName = void 0;
+var device_1 = require("./models/device");
+Object.defineProperty(exports, "getDeviceDisplayName", { enumerable: true, get: function () { return device_1.getDeviceDisplayName; } });
+Object.defineProperty(exports, "sortBySignalStrength", { enumerable: true, get: function () { return device_1.sortBySignalStrength; } });
+var environment_1 = require("./models/environment");
+Object.defineProperty(exports, "detectBLEEnvironment", { enumerable: true, get: function () { return environment_1.detectBLEEnvironment; } });
+Object.defineProperty(exports, "isBLEAvailable", { enumerable: true, get: function () { return environment_1.isBLEAvailable; } });
+Object.defineProperty(exports, "createNativeEnvironmentInfo", { enumerable: true, get: function () { return environment_1.createNativeEnvironmentInfo; } });
+// Adapters
+var adapters_1 = require("./adapters");
+// Adapters
+Object.defineProperty(exports, "WebBLEAdapter", { enumerable: true, get: function () { return adapters_1.WebBLEAdapter; } });
+Object.defineProperty(exports, "NodeBLEAdapter", { enumerable: true, get: function () { return adapters_1.NodeBLEAdapter; } });
+Object.defineProperty(exports, "NativeBLEAdapter", { enumerable: true, get: function () { return adapters_1.NativeBLEAdapter; } });
+// Factory
+Object.defineProperty(exports, "createBLEAdapter", { enumerable: true, get: function () { return adapters_1.createBLEAdapter; } });
+// Note: ScannerController is internal - use VoltraClient/VoltraManager for scanning
+//# sourceMappingURL=index.js.map

package/dist/cjs/bluetooth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bluetooth/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH,0CAA6E;AAApE,8GAAA,oBAAoB,OAAA;AAAE,8GAAA,oBAAoB,OAAA;AAOnD,oDAAyG;AAAhG,mHAAA,oBAAoB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,0HAAA,2BAA2B,OAAA;AAE1E,WAAW;AACX,uCAeoB;AAPlB,WAAW;AACX,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,4GAAA,gBAAgB,OAAA;AAChB,UAAU;AACV,4GAAA,gBAAgB,OAAA;AAIlB,oFAAoF"}

package/dist/cjs/bluetooth/models/connection.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Bluetooth Connection Model
+ *
+ * Represents generic BLE connection state and transitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLEConnectionStateModel = void 0;
+exports.isValidBLETransition = isValidBLETransition;
+/**
+ * Valid state transitions for BLE connection.
+ */
+const VALID_BLE_TRANSITIONS = {
+    disconnected: ['connecting'],
+    connecting: ['connected', 'disconnected'],
+    connected: ['disconnecting', 'disconnected'],
+    disconnecting: ['disconnected'],
+};
+/**
+ * Check if a BLE state transition is valid.
+ */
+function isValidBLETransition(from, to) {
+    return VALID_BLE_TRANSITIONS[from].includes(to);
+}
+/**
+ * Generic BLE connection state model with validation.
+ */
+class BLEConnectionStateModel {
+    constructor() {
+        this._state = 'disconnected';
+    }
+    get state() {
+        return this._state;
+    }
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    get isConnecting() {
+        return this._state === 'connecting';
+    }
+    get isDisconnected() {
+        return this._state === 'disconnected';
+    }
+    /**
+     * Transition to a new state.
+     * @throws Error if transition is invalid
+     */
+    transitionTo(newState) {
+        if (!isValidBLETransition(this._state, newState)) {
+            throw new Error(`Invalid connection state transition: ${this._state} -> ${newState}`);
+        }
+        this._state = newState;
+    }
+    /**
+     * Force set state (for reconnection scenarios).
+     */
+    forceState(state) {
+        this._state = state;
+    }
+    /**
+     * Reset to disconnected state.
+     */
+    reset() {
+        this._state = 'disconnected';
+    }
+}
+exports.BLEConnectionStateModel = BLEConnectionStateModel;
+//# sourceMappingURL=connection.js.map

package/dist/cjs/bluetooth/models/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/bluetooth/models/connection.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAoBH,oDAEC;AAfD;;GAEG;AACH,MAAM,qBAAqB,GAAqD;IAC9E,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,UAAU,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;IACzC,SAAS,EAAE,CAAC,eAAe,EAAE,cAAc,CAAC;IAC5C,aAAa,EAAE,CAAC,cAAc,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAAC,IAAwB,EAAE,EAAsB;IACnF,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAa,uBAAuB;IAApC;QACU,WAAM,GAAuB,cAAc,CAAC;IA0CtD,CAAC;IAxCC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;IACrC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAA4B;QACvC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,MAAM,OAAO,QAAQ,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAyB;QAClC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;IAC/B,CAAC;CACF;AA3CD,0DA2CC"}

package/dist/cjs/bluetooth/models/device.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Bluetooth Device Model
+ *
+ * Represents a discovered BLE device from scanning.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeviceDisplayName = getDeviceDisplayName;
+exports.sortBySignalStrength = sortBySignalStrength;
+/**
+ * Get display name for a device.
+ */
+function getDeviceDisplayName(device) {
+    return device.name ?? `Device ${device.id.slice(0, 8)}`;
+}
+/**
+ * Sort devices by signal strength (strongest first).
+ */
+function sortBySignalStrength(devices) {
+    return [...devices].sort((a, b) => {
+        const rssiA = a.rssi ?? -100;
+        const rssiB = b.rssi ?? -100;
+        return rssiB - rssiA; // Higher (less negative) is better
+    });
+}
+//# sourceMappingURL=device.js.map

package/dist/cjs/bluetooth/models/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../../src/bluetooth/models/device.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAiBH,oDAEC;AAKD,oDAMC;AAhBD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAAwB;IAC3D,OAAO,MAAM,CAAC,IAAI,IAAI,UAAU,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,OAA2B;IAC9D,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC;QAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC;QAC7B,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,mCAAmC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/bluetooth/models/environment.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Bluetooth Environment Model
+ *
+ * Detects the current environment and BLE capabilities.
+ * This is a simplified version for the SDK that doesn't depend on Expo.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectBLEEnvironment = detectBLEEnvironment;
+exports.isBLEAvailable = isBLEAvailable;
+exports.createNativeEnvironmentInfo = createNativeEnvironmentInfo;
+/**
+ * Warning messages for unsupported environments.
+ */
+const WARNING_MESSAGES = {
+    'expo-go': 'Bluetooth is not available in Expo Go. Run "npx expo run:ios --device" to build with native BLE support.',
+    simulator: 'Bluetooth is not available in the simulator. Connect a physical device to test BLE.',
+};
+/**
+ * Check if running in a browser environment.
+ */
+function isBrowserEnvironment() {
+    return (typeof window !== 'undefined' &&
+        typeof document !== 'undefined' &&
+        typeof navigator !== 'undefined');
+}
+/**
+ * Check if running in Node.js environment.
+ */
+function isNodeEnvironment() {
+    return (typeof process !== 'undefined' && process.versions != null && process.versions.node != null);
+}
+/**
+ * Detect the current BLE environment.
+ *
+ * This is a simplified version that works without React Native/Expo dependencies.
+ * For full environment detection in React Native apps, use the app's environment detection.
+ */
+function detectBLEEnvironment() {
+    // Check for browser environment first
+    if (isBrowserEnvironment()) {
+        return {
+            environment: 'web',
+            bleSupported: true, // Via Web Bluetooth API
+            warningMessage: null,
+            isWeb: true,
+            requiresUserGesture: true, // Web Bluetooth requires user gesture for requestDevice()
+        };
+    }
+    // Check for Node.js environment
+    if (isNodeEnvironment()) {
+        return {
+            environment: 'node',
+            bleSupported: true, // Via webbluetooth npm package
+            warningMessage: null,
+            isWeb: false,
+            requiresUserGesture: false,
+        };
+    }
+    // Default to native (React Native apps should use their own environment detection)
+    return {
+        environment: 'native',
+        bleSupported: true,
+        warningMessage: null,
+        isWeb: false,
+        requiresUserGesture: false,
+    };
+}
+/**
+ * Check if BLE is available in the current environment.
+ */
+function isBLEAvailable(env) {
+    return env.bleSupported;
+}
+/**
+ * Create environment info for native React Native apps.
+ * Call this from your app with the detected environment.
+ */
+function createNativeEnvironmentInfo(options) {
+    if (options.isExpoGo) {
+        return {
+            environment: 'expo-go',
+            bleSupported: false,
+            warningMessage: WARNING_MESSAGES['expo-go'],
+            isWeb: false,
+            requiresUserGesture: false,
+        };
+    }
+    if (options.isSimulator) {
+        return {
+            environment: 'simulator',
+            bleSupported: false,
+            warningMessage: WARNING_MESSAGES['simulator'],
+            isWeb: false,
+            requiresUserGesture: false,
+        };
+    }
+    return {
+        environment: 'native',
+        bleSupported: true,
+        warningMessage: null,
+        isWeb: false,
+        requiresUserGesture: false,
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/cjs/bluetooth/models/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../src/bluetooth/models/environment.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA+DH,oDA+BC;AAKD,wCAEC;AAMD,kEA+BC;AA9GD;;GAEG;AACH,MAAM,gBAAgB,GAA4C;IAChE,SAAS,EACP,0GAA0G;IAC5G,SAAS,EAAE,qFAAqF;CACjG,CAAC;AAEF;;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;;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;;;;;GAKG;AACH,SAAgB,oBAAoB;IAClC,sCAAsC;IACtC,IAAI,oBAAoB,EAAE,EAAE,CAAC;QAC3B,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI,EAAE,wBAAwB;YAC5C,cAAc,EAAE,IAAI;YACpB,KAAK,EAAE,IAAI;YACX,mBAAmB,EAAE,IAAI,EAAE,0DAA0D;SACtF,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACxB,OAAO;YACL,WAAW,EAAE,MAAM;YACnB,YAAY,EAAE,IAAI,EAAE,+BAA+B;YACnD,cAAc,EAAE,IAAI;YACpB,KAAK,EAAE,KAAK;YACZ,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,OAAO;QACL,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,KAAK;QACZ,mBAAmB,EAAE,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAuB;IACpD,OAAO,GAAG,CAAC,YAAY,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B,CAAC,OAG3C;IACC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO;YACL,WAAW,EAAE,SAAS;YACtB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,gBAAgB,CAAC,SAAS,CAAE;YAC5C,KAAK,EAAE,KAAK;YACZ,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO;YACL,WAAW,EAAE,WAAW;YACxB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,gBAAgB,CAAC,WAAW,CAAE;YAC9C,KAAK,EAAE,KAAK;YACZ,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,KAAK;QACZ,mBAAmB,EAAE,KAAK;KAC3B,CAAC;AACJ,CAAC"}

package/dist/cjs/errors.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Custom SDK Error Types
+ *
+ * Provides typed errors for better error handling and developer experience.
+ * All SDK errors extend VoltraSDKError for easy catch-all handling.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.connect();
+ * } catch (error) {
+ *   if (error instanceof ConnectionError) {
+ *     console.log('Connection failed:', error.code);
+ *   } else if (error instanceof AuthenticationError) {
+ *     console.log('Auth failed - device may need reset');
+ *   } else if (error instanceof VoltraSDKError) {
+ *     console.log('SDK error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryError = exports.CommandError = exports.BluetoothUnavailableError = exports.InvalidSettingError = exports.NotConnectedError = exports.TimeoutError = exports.AuthenticationError = exports.ConnectionError = exports.VoltraSDKError = exports.ErrorCode = void 0;
+/**
+ * Error codes for SDK errors.
+ * Use these for programmatic error handling.
+ */
+exports.ErrorCode = {
+    // Connection errors
+    CONNECTION_FAILED: 'CONNECTION_FAILED',
+    CONNECTION_LOST: 'CONNECTION_LOST',
+    CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',
+    NOT_CONNECTED: 'NOT_CONNECTED',
+    ALREADY_CONNECTED: 'ALREADY_CONNECTED',
+    // Authentication errors
+    AUTH_FAILED: 'AUTH_FAILED',
+    AUTH_TIMEOUT: 'AUTH_TIMEOUT',
+    AUTH_INVALID_RESPONSE: 'AUTH_INVALID_RESPONSE',
+    // Bluetooth errors
+    BLUETOOTH_UNAVAILABLE: 'BLUETOOTH_UNAVAILABLE',
+    BLUETOOTH_PERMISSION_DENIED: 'BLUETOOTH_PERMISSION_DENIED',
+    BLUETOOTH_ADAPTER_ERROR: 'BLUETOOTH_ADAPTER_ERROR',
+    // Device errors
+    DEVICE_NOT_FOUND: 'DEVICE_NOT_FOUND',
+    DEVICE_DISCONNECTED: 'DEVICE_DISCONNECTED',
+    // Command errors
+    COMMAND_FAILED: 'COMMAND_FAILED',
+    COMMAND_TIMEOUT: 'COMMAND_TIMEOUT',
+    INVALID_SETTING: 'INVALID_SETTING',
+    // Telemetry errors
+    TELEMETRY_DECODE_ERROR: 'TELEMETRY_DECODE_ERROR',
+    // General
+    TIMEOUT: 'TIMEOUT',
+    UNKNOWN: 'UNKNOWN',
+};
+/**
+ * Base error class for all SDK errors.
+ * Provides a consistent error interface with error codes.
+ */
+class VoltraSDKError extends Error {
+    constructor(message, code = exports.ErrorCode.UNKNOWN, cause) {
+        super(message);
+        this.name = 'VoltraSDKError';
+        this.code = code;
+        this.cause = cause;
+        // Maintains proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.VoltraSDKError = VoltraSDKError;
+/**
+ * Thrown when a BLE connection fails or is lost.
+ */
+class ConnectionError extends VoltraSDKError {
+    constructor(message, code = exports.ErrorCode.CONNECTION_FAILED, cause) {
+        super(message, code, cause);
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Thrown when Voltra device authentication fails.
+ * This typically happens during the initial connection handshake.
+ */
+class AuthenticationError extends VoltraSDKError {
+    constructor(message, code = exports.ErrorCode.AUTH_FAILED, cause) {
+        super(message, code, cause);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Thrown when an operation times out.
+ */
+class TimeoutError extends VoltraSDKError {
+    constructor(message, timeoutMs, cause) {
+        super(message, exports.ErrorCode.TIMEOUT, cause);
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Thrown when an operation requires a connection but the device is not connected.
+ */
+class NotConnectedError extends VoltraSDKError {
+    constructor(message = 'Device is not connected') {
+        super(message, exports.ErrorCode.NOT_CONNECTED);
+        this.name = 'NotConnectedError';
+    }
+}
+exports.NotConnectedError = NotConnectedError;
+/**
+ * Thrown when an invalid setting value is provided.
+ * For example, setting weight to a value not supported by the device.
+ */
+class InvalidSettingError extends VoltraSDKError {
+    constructor(setting, value, validValues, message) {
+        const msg = message ??
+            `Invalid value for ${setting}: ${value}${validValues ? `. Valid values: ${validValues.join(', ')}` : ''}`;
+        super(msg, exports.ErrorCode.INVALID_SETTING);
+        this.name = 'InvalidSettingError';
+        this.setting = setting;
+        this.value = value;
+        this.validValues = validValues;
+    }
+}
+exports.InvalidSettingError = InvalidSettingError;
+/**
+ * Thrown when Bluetooth is not available on the current platform.
+ */
+class BluetoothUnavailableError extends VoltraSDKError {
+    constructor(reason) {
+        const message = reason
+            ? `Bluetooth is not available: ${reason}`
+            : 'Bluetooth is not available on this device';
+        super(message, exports.ErrorCode.BLUETOOTH_UNAVAILABLE);
+        this.name = 'BluetoothUnavailableError';
+        this.reason = reason;
+    }
+}
+exports.BluetoothUnavailableError = BluetoothUnavailableError;
+/**
+ * Thrown when a command fails to execute on the device.
+ */
+class CommandError extends VoltraSDKError {
+    constructor(message, command, cause) {
+        super(message, exports.ErrorCode.COMMAND_FAILED, cause);
+        this.name = 'CommandError';
+        this.command = command;
+    }
+}
+exports.CommandError = CommandError;
+/**
+ * Thrown when telemetry data cannot be decoded.
+ */
+class TelemetryError extends VoltraSDKError {
+    constructor(message, cause) {
+        super(message, exports.ErrorCode.TELEMETRY_DECODE_ERROR, cause);
+        this.name = 'TelemetryError';
+    }
+}
+exports.TelemetryError = TelemetryError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

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