@voltras/node-sdk 0.1.0

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

@@ -0,0 +1,102 @@
+/**
+ * BLE Abstraction Layer Types
+ *
+ * Defines interfaces for BLE operations implemented by platform-specific adapters:
+ * - Native (iOS/Android): react-native-ble-plx
+ * - Browser: Web Bluetooth API
+ * - Node.js: webbluetooth npm package
+ */
+import { type DiscoveredDevice } from '../models/device';
+/**
+ * Device alias - uses the canonical DiscoveredDevice type from models.
+ */
+export type Device = DiscoveredDevice;
+/**
+ * Connection state for the BLE adapter.
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'disconnecting';
+/**
+ * Callback for receiving BLE notifications.
+ */
+export type NotificationCallback = (data: Uint8Array) => void;
+/**
+ * Callback for connection state changes.
+ */
+export type ConnectionStateCallback = (state: ConnectionState) => void;
+/**
+ * Options for BLE connection.
+ */
+export interface ConnectOptions {
+    /**
+     * Data to write immediately after raw connection, before service discovery.
+     * Used for authentication that must happen within a tight time window.
+     */
+    immediateWrite?: Uint8Array;
+}
+/**
+ * BLE service configuration for adapters.
+ * Defines the UUIDs and device name prefix for BLE operations.
+ */
+export interface BLEServiceConfig {
+    /** Main service UUID */
+    serviceUUID: string;
+    /** Characteristic UUID for receiving notifications */
+    notifyCharUUID: string;
+    /** Characteristic UUID for writing commands */
+    writeCharUUID: string;
+    /** Optional device name prefix for filtering during scan */
+    deviceNamePrefix?: string;
+}
+/**
+ * Abstract interface for BLE operations.
+ *
+ * Implemented by:
+ * - NativeBLEAdapter: Uses react-native-ble-plx (iOS/Android)
+ * - WebBLEAdapter: Uses Web Bluetooth API (browser)
+ * - NodeBLEAdapter: Uses webbluetooth package (Node.js)
+ * - ReplayBLEAdapter: Plays back recorded samples (testing/demo)
+ */
+export interface BLEAdapter {
+    /**
+     * Scan for devices.
+     * @param timeout Scan duration in seconds
+     * @returns List of discovered devices
+     */
+    scan(timeout: number): Promise<Device[]>;
+    /**
+     * Connect to a device.
+     * @param deviceId Device identifier from scan results
+     * @param options Optional connection options
+     */
+    connect(deviceId: string, options?: ConnectOptions): Promise<void>;
+    /**
+     * Disconnect from the current device.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Write data to the device's write characteristic.
+     * @param data Bytes to write
+     */
+    write(data: Uint8Array): Promise<void>;
+    /**
+     * 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;
+    /**
+     * Get current connection state.
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Check if currently connected to a device.
+     */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAE3D;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAAC;IAEvE;;OAEG;IACH,kBAAkB,IAAI,eAAe,CAAC;IAEtC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;CACxB"}

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

@@ -0,0 +1,90 @@
+/**
+ * WebBluetoothBase
+ *
+ * Abstract base class for W3C Web Bluetooth API adapters.
+ * Provides shared GATT operations for both browser and Node.js environments.
+ *
+ * Subclasses:
+ * - WebBLEAdapter: Browser using navigator.bluetooth
+ * - NodeBLEAdapter: Node.js using webbluetooth npm package
+ */
+import { BaseBLEAdapter } from './base';
+import type { Device, ConnectOptions, BLEServiceConfig } from './types';
+/**
+ * Configuration for Web Bluetooth adapters.
+ */
+export interface WebBluetoothConfig {
+    /** BLE service configuration (UUIDs, device name prefix) */
+    ble: BLEServiceConfig;
+}
+/**
+ * Abstract base class for Web Bluetooth adapters.
+ *
+ * Implements shared GATT operations:
+ * - Service/characteristic discovery
+ * - Write operations
+ * - Notification subscription
+ * - Disconnect cleanup
+ *
+ * Subclasses implement platform-specific device selection (scan/connect).
+ */
+export declare abstract class WebBluetoothBase extends BaseBLEAdapter {
+    /** Connected Bluetooth device */
+    protected device: BluetoothDevice | null;
+    /** GATT server connection */
+    protected server: BluetoothRemoteGATTServer | null;
+    /** Write characteristic */
+    protected writeChar: BluetoothRemoteGATTCharacteristic | null;
+    /** Notify characteristic */
+    protected notifyChar: BluetoothRemoteGATTCharacteristic | null;
+    /** BLE service configuration */
+    protected config: BLEServiceConfig;
+    /** Bound notification handler for cleanup */
+    private boundNotificationHandler;
+    constructor(config: WebBluetoothConfig);
+    /**
+     * Scan for devices.
+     * Browser: Shows native device picker
+     * Node.js: Programmatic device selection
+     */
+    abstract scan(timeout: number): Promise<Device[]>;
+    /**
+     * Connect to a device by ID.
+     * Subclasses may need to handle device lookup differently.
+     */
+    abstract connect(deviceId: string, options?: ConnectOptions): Promise<void>;
+    /**
+     * Connect to a Bluetooth device's GATT server and set up characteristics.
+     * Called by subclasses after device selection.
+     */
+    protected connectToDevice(device: BluetoothDevice): Promise<void>;
+    /**
+     * Discover service and characteristics, set up notifications.
+     */
+    protected setupCharacteristics(): Promise<void>;
+    /**
+     * Handle incoming notification data.
+     */
+    protected handleNotification(event: Event): void;
+    /**
+     * Handle device disconnection.
+     */
+    protected handleDisconnect(): void;
+    /**
+     * Clean up resources.
+     */
+    protected cleanup(): void;
+    /**
+     * Disconnect from the device.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Write data to the device.
+     */
+    write(data: Uint8Array): Promise<void>;
+    /**
+     * Get info about the currently connected device.
+     */
+    getConnectedDevice(): Device | null;
+}
+//# sourceMappingURL=web-bluetooth-base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-bluetooth-base.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/web-bluetooth-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,8BAAsB,gBAAiB,SAAQ,cAAc;IAC3D,iCAAiC;IACjC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEhD,6BAA6B;IAC7B,SAAS,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAQ;IAE1D,2BAA2B;IAC3B,SAAS,CAAC,SAAS,EAAE,iCAAiC,GAAG,IAAI,CAAQ;IAErE,4BAA4B;IAC5B,SAAS,CAAC,UAAU,EAAE,iCAAiC,GAAG,IAAI,CAAQ;IAEtE,gCAAgC;IAChC,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAEnC,6CAA6C;IAC7C,OAAO,CAAC,wBAAwB,CAAyC;gBAE7D,MAAM,EAAE,kBAAkB;IAetC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEjD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E;;;OAGG;cACa,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvE;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BrD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQhD;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAKlC;;OAEG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAmCzB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C;;OAEG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI;CAQpC"}

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

@@ -0,0 +1,57 @@
+/**
+ * WebBLEAdapter
+ *
+ * BLE adapter for web browsers using the native Web Bluetooth API.
+ * Uses the browser's built-in device picker for device selection.
+ *
+ * Requirements:
+ * - Chrome, Edge, or Opera browser (Safari/Firefox don't support Web Bluetooth)
+ * - HTTPS or localhost
+ * - User gesture required to trigger device picker
+ */
+import { WebBluetoothBase, type WebBluetoothConfig } from './web-bluetooth-base';
+import type { Device, ConnectOptions } from './types';
+/**
+ * BLE adapter using the browser's native Web Bluetooth API.
+ *
+ * Device selection flow:
+ * 1. Call scan() - triggers browser's device picker
+ * 2. User selects device from browser UI
+ * 3. scan() returns with the selected device
+ * 4. Call connect() to establish GATT connection
+ */
+export declare class WebBLEAdapter extends WebBluetoothBase {
+    /** Device selected from browser picker, stored for connect() */
+    private selectedDevice;
+    constructor(config: WebBluetoothConfig);
+    /**
+     * Scan for devices using the browser's device picker.
+     *
+     * Note: This triggers the browser's native Bluetooth device picker UI.
+     * The user must select a device from the picker. Returns when user
+     * selects a device or cancels.
+     *
+     * @param _timeout Ignored - browser controls the picker timeout
+     * @returns Array with single selected device, or empty if cancelled
+     */
+    scan(_timeout: number): Promise<Device[]>;
+    /**
+     * Connect to the selected device.
+     *
+     * Note: In Web Bluetooth, the device is already "selected" during scan().
+     * This method establishes the GATT connection.
+     *
+     * @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>;
+    /**
+     * Check if Web Bluetooth is supported in this browser.
+     */
+    static isSupported(): boolean;
+}
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/adapters/web.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;AAEtD;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,gEAAgE;IAChE,OAAO,CAAC,cAAc,CAAgC;gBAE1C,MAAM,EAAE,kBAAkB;IAItC;;;;;;;;;OASG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiC/C;;;;;;;;OAQG;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;IAK1C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;CAG9B"}

package/dist/types/bluetooth/controllers/scanner-controller.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Scanner Controller
+ *
+ * Manages BLE device scanning with auto-scan functionality.
+ * This is a generic controller that can be configured with a device filter.
+ */
+import type { BLEAdapter } from '../adapters';
+import { type DiscoveredDevice } from '../models/device';
+import type { BLEEnvironmentInfo } from '../models/environment';
+/**
+ * Device filter function type.
+ * Used to filter discovered devices (e.g., by name prefix).
+ */
+export type DeviceFilter = (devices: DiscoveredDevice[]) => DiscoveredDevice[];
+/**
+ * Scanner state snapshot.
+ */
+export interface ScannerState {
+    isScanning: boolean;
+    discoveredDevices: DiscoveredDevice[];
+    lastScanTime: number;
+    error: string | null;
+}
+/**
+ * Scanner event types.
+ */
+export type ScannerEvent = {
+    type: 'scanStarted';
+} | {
+    type: 'scanCompleted';
+    devices: DiscoveredDevice[];
+} | {
+    type: 'scanFailed';
+    error: string;
+};
+/**
+ * Scanner event listener.
+ */
+export type ScannerEventListener = (event: ScannerEvent) => void;
+/**
+ * Scanner configuration.
+ */
+export interface ScannerConfig {
+    scanDurationMs: number;
+    scanIntervalMs: number;
+}
+/**
+ * Controller for BLE device scanning.
+ */
+export declare class ScannerController {
+    private adapter;
+    private _environment;
+    private config;
+    private deviceFilter?;
+    private _isScanning;
+    private _discoveredDevices;
+    private _lastScanTime;
+    private _error;
+    private _autoScanInterval;
+    private _listeners;
+    constructor(adapter: BLEAdapter, _environment: BLEEnvironmentInfo, config: ScannerConfig, deviceFilter?: DeviceFilter | undefined);
+    /**
+     * Get current scanner state.
+     */
+    getState(): ScannerState;
+    /**
+     * Subscribe to scanner events.
+     */
+    subscribe(listener: ScannerEventListener): () => void;
+    private emit;
+    /**
+     * Scan for devices.
+     */
+    scan(): Promise<DiscoveredDevice[]>;
+    /**
+     * Start auto-scanning.
+     * Returns cleanup function.
+     */
+    startAutoScan(isConnected: () => boolean): () => void;
+    /**
+     * Stop auto-scanning.
+     */
+    stopAutoScan(): void;
+    /**
+     * Clear error state.
+     */
+    clearError(): void;
+    /**
+     * Cleanup resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=scanner-controller.d.ts.map

package/dist/types/bluetooth/controllers/scanner-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-controller.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/controllers/scanner-controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAU1B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY,CAAC;IAZvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,UAAU,CAAwC;gBAGhD,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,YAAY,YAAA;IAGrC;;OAEG;IACH,QAAQ,IAAI,YAAY;IASxB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAKrD,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwDzC;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI;IAqBrD;;OAEG;IACH,YAAY,IAAI,IAAI;IAOpB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

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

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+export type { DiscoveredDevice } from './models/device';
+export { getDeviceDisplayName, sortBySignalStrength } from './models/device';
+export type { BLEConnectionState } from './models/connection';
+export type { BLEEnvironment, BLEEnvironmentInfo } from './models/environment';
+export { detectBLEEnvironment, isBLEAvailable, createNativeEnvironmentInfo } from './models/environment';
+export { type BLEAdapter, type BLEServiceConfig, type ConnectionState, type ConnectOptions, type NotificationCallback, type ConnectionStateCallback, WebBLEAdapter, NodeBLEAdapter, NativeBLEAdapter, createBLEAdapter, type CreateBLEAdapterConfig, } from './adapters';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bluetooth/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGzG,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE5B,aAAa,EACb,cAAc,EACd,gBAAgB,EAEhB,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}

package/dist/types/bluetooth/models/connection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Bluetooth Connection Model
+ *
+ * Represents generic BLE connection state and transitions.
+ */
+/**
+ * BLE adapter connection states.
+ */
+export type BLEConnectionState = 'disconnected' | 'connecting' | 'connected' | 'disconnecting';
+/**
+ * Check if a BLE state transition is valid.
+ */
+export declare function isValidBLETransition(from: BLEConnectionState, to: BLEConnectionState): boolean;
+/**
+ * Generic BLE connection state model with validation.
+ */
+export declare class BLEConnectionStateModel {
+    private _state;
+    get state(): BLEConnectionState;
+    get isConnected(): boolean;
+    get isConnecting(): boolean;
+    get isDisconnected(): boolean;
+    /**
+     * Transition to a new state.
+     * @throws Error if transition is invalid
+     */
+    transitionTo(newState: BLEConnectionState): void;
+    /**
+     * Force set state (for reconnection scenarios).
+     */
+    forceState(state: BLEConnectionState): void;
+    /**
+     * Reset to disconnected state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/types/bluetooth/models/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/models/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;AAY/F;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAE9F;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAsC;IAEpD,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAOhD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/bluetooth/models/device.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Bluetooth Device Model
+ *
+ * Represents a discovered BLE device from scanning.
+ */
+/**
+ * A discovered BLE device.
+ */
+export interface DiscoveredDevice {
+    /** Device identifier (address on Android, UUID on iOS) */
+    id: string;
+    /** Device name */
+    name: string | null;
+    /** Signal strength in dBm */
+    rssi: number | null;
+}
+/**
+ * Get display name for a device.
+ */
+export declare function getDeviceDisplayName(device: DiscoveredDevice): string;
+/**
+ * Sort devices by signal strength (strongest first).
+ */
+export declare function sortBySignalStrength(devices: DiscoveredDevice[]): DiscoveredDevice[];
+//# sourceMappingURL=device.d.ts.map

package/dist/types/bluetooth/models/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/models/device.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAErE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAMpF"}

package/dist/types/bluetooth/models/environment.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Bluetooth Environment Model
+ *
+ * Detects the current environment and BLE capabilities.
+ * This is a simplified version for the SDK that doesn't depend on Expo.
+ */
+/**
+ * BLE environment types.
+ */
+export type BLEEnvironment = 'native' | 'simulator' | 'expo-go' | 'web' | 'node';
+/**
+ * BLE environment information.
+ */
+export interface BLEEnvironmentInfo {
+    /** Current environment type */
+    environment: BLEEnvironment;
+    /** Whether BLE is supported in this environment */
+    bleSupported: boolean;
+    /** Warning message if BLE is not supported */
+    warningMessage: string | null;
+    /** Whether this is running on web */
+    isWeb: boolean;
+    /** Whether scanning requires a user gesture (click/tap) - true for Web Bluetooth */
+    requiresUserGesture: boolean;
+}
+/**
+ * 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.
+ */
+export declare function detectBLEEnvironment(): BLEEnvironmentInfo;
+/**
+ * Check if BLE is available in the current environment.
+ */
+export declare function isBLEAvailable(env: BLEEnvironmentInfo): boolean;
+/**
+ * Create environment info for native React Native apps.
+ * Call this from your app with the detected environment.
+ */
+export declare function createNativeEnvironmentInfo(options: {
+    isExpoGo?: boolean;
+    isSimulator?: boolean;
+}): BLEEnvironmentInfo;
+//# sourceMappingURL=environment.d.ts.map

package/dist/types/bluetooth/models/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/bluetooth/models/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,SAAS,GACT,KAAK,GACL,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,oFAAoF;IACpF,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AA+BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CA+BzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,kBAAkB,CA4BrB"}

package/dist/types/errors.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 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);
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Error codes for SDK errors.
+ * Use these for programmatic error handling.
+ */
+export declare const ErrorCode: {
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    readonly CONNECTION_LOST: "CONNECTION_LOST";
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    readonly NOT_CONNECTED: "NOT_CONNECTED";
+    readonly ALREADY_CONNECTED: "ALREADY_CONNECTED";
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    readonly AUTH_TIMEOUT: "AUTH_TIMEOUT";
+    readonly AUTH_INVALID_RESPONSE: "AUTH_INVALID_RESPONSE";
+    readonly BLUETOOTH_UNAVAILABLE: "BLUETOOTH_UNAVAILABLE";
+    readonly BLUETOOTH_PERMISSION_DENIED: "BLUETOOTH_PERMISSION_DENIED";
+    readonly BLUETOOTH_ADAPTER_ERROR: "BLUETOOTH_ADAPTER_ERROR";
+    readonly DEVICE_NOT_FOUND: "DEVICE_NOT_FOUND";
+    readonly DEVICE_DISCONNECTED: "DEVICE_DISCONNECTED";
+    readonly COMMAND_FAILED: "COMMAND_FAILED";
+    readonly COMMAND_TIMEOUT: "COMMAND_TIMEOUT";
+    readonly INVALID_SETTING: "INVALID_SETTING";
+    readonly TELEMETRY_DECODE_ERROR: "TELEMETRY_DECODE_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Base error class for all SDK errors.
+ * Provides a consistent error interface with error codes.
+ */
+export declare class VoltraSDKError extends Error {
+    readonly code: ErrorCode;
+    readonly cause?: Error;
+    constructor(message: string, code?: ErrorCode, cause?: Error);
+}
+/**
+ * Thrown when a BLE connection fails or is lost.
+ */
+export declare class ConnectionError extends VoltraSDKError {
+    constructor(message: string, code?: ErrorCode, cause?: Error);
+}
+/**
+ * Thrown when Voltra device authentication fails.
+ * This typically happens during the initial connection handshake.
+ */
+export declare class AuthenticationError extends VoltraSDKError {
+    constructor(message: string, code?: ErrorCode, cause?: Error);
+}
+/**
+ * Thrown when an operation times out.
+ */
+export declare class TimeoutError extends VoltraSDKError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, cause?: Error);
+}
+/**
+ * Thrown when an operation requires a connection but the device is not connected.
+ */
+export declare class NotConnectedError extends VoltraSDKError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when an invalid setting value is provided.
+ * For example, setting weight to a value not supported by the device.
+ */
+export declare class InvalidSettingError extends VoltraSDKError {
+    readonly setting: string;
+    readonly value: unknown;
+    readonly validValues?: readonly unknown[];
+    constructor(setting: string, value: unknown, validValues?: readonly unknown[], message?: string);
+}
+/**
+ * Thrown when Bluetooth is not available on the current platform.
+ */
+export declare class BluetoothUnavailableError extends VoltraSDKError {
+    readonly reason?: string;
+    constructor(reason?: string);
+}
+/**
+ * Thrown when a command fails to execute on the device.
+ */
+export declare class CommandError extends VoltraSDKError {
+    readonly command?: string;
+    constructor(message: string, command?: string, cause?: Error);
+}
+/**
+ * Thrown when telemetry data cannot be decoded.
+ */
+export declare class TelemetryError extends VoltraSDKError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;CAiCZ,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAA6B,EAAE,KAAK,CAAC,EAAE,KAAK;CAWhF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;gBAE/C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAuC,EAC7C,KAAK,CAAC,EAAE,KAAK;CAKhB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAiC,EAAE,KAAK,CAAC,EAAE,KAAK;CAIpF;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK9D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,OAAO,GAAE,MAAkC;CAIxD;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,KAAK,EAAE,OAAO,CAAC;IAC/B,SAAgB,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;gBAG/C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,EAChC,OAAO,CAAC,EAAE,MAAM;CAWnB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,cAAc;IAC3D,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,MAAM,CAAC,EAAE,MAAM;CAQ5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK7D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C"}