@voltras/node-sdk 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @voltras/node-sdk
+ *
+ * SDK for connecting to and controlling Voltra fitness devices.
+ *
+ * Use VoltraManager as the main entry point. It handles device discovery
+ * and returns VoltraClient instances for controlling individual devices.
+ *
+ * @example
+ * ```typescript
+ * import { VoltraManager } from '@voltras/node-sdk';
+ *
+ * // Create manager (auto-detects platform for web/node)
+ * const manager = new VoltraManager();
+ *
+ * // Scan and connect
+ * const devices = await manager.scan();
+ * const client = await manager.connect(devices[0]);
+ *
+ * // Or connect by name in one step
+ * const client = await manager.connectByName('VTR-123456');
+ *
+ * // Control the device
+ * await client.setWeight(50);
+ * client.onFrame((frame) => console.log('Position:', frame.position));
+ * await client.startRecording();
+ * ```
+ *
+ * For React Native, specify the platform:
+ * ```typescript
+ * const manager = VoltraManager.forNative();
+ * // or
+ * const manager = new VoltraManager({ platform: 'native' });
+ * ```
+ */
+export { VoltraClient, VoltraManager, type Platform, type VoltraClientOptions, type VoltraClientState, type VoltraClientEvent, type VoltraClientEventListener, type VoltraManagerOptions, type VoltraManagerEvent, type VoltraManagerEventListener, type ConnectByNameOptions, type AdapterFactory, type FrameListener, type ScanOptions, } from './sdk';
+export { WebBLEAdapter } from './bluetooth/adapters/web';
+export { NodeBLEAdapter, type DeviceChooser } from './bluetooth/adapters/node';
+export { NativeBLEAdapter } from './bluetooth/adapters/native';
+export { createBLEAdapter } from './bluetooth/adapters';
+export type { BLEAdapter, BLEServiceConfig, ConnectOptions, ConnectionState, NotificationCallback, ConnectionStateCallback, } from './bluetooth/adapters/types';
+export type { DiscoveredDevice } from './bluetooth/models/device';
+export { getDeviceDisplayName, sortBySignalStrength } from './bluetooth/models/device';
+export { VOLTRA_DEVICE_PREFIX, isVoltraDevice, filterVoltraDevices, } from './voltra/models/device-filter';
+export { VoltraDevice, DEFAULT_SETTINGS, type VoltraDeviceSettings, type VoltraRecordingState, type VoltraDeviceState, } from './voltra/models/device';
+export type { VoltraConnectionState } from './voltra/models/connection';
+export type { TelemetryFrame } from './voltra/models/telemetry';
+export { createFrame } from './voltra/models/telemetry';
+export { decodeTelemetryFrame, decodeNotification, encodeTelemetryFrame, identifyMessageType, type DecodeResult, type MessageType, } from './voltra/protocol/telemetry-decoder';
+export { MovementPhase, PhaseNames, MessageTypes, TelemetryOffsets, } from './voltra/protocol/constants';
+export { WeightCommands, ChainsCommands, EccentricCommands, type DualCommand, } from './voltra/protocol/commands';
+export { BLE, Timing, Auth, Init, Workout, } from './voltra/protocol/constants';
+export { VoltraSDKError, ConnectionError, AuthenticationError, TimeoutError, NotConnectedError, InvalidSettingError, BluetoothUnavailableError, CommandError, TelemetryError, ErrorCode, type ErrorCode as ErrorCodeType, } from './errors';
+export { delay } from './shared/utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,OAAO,CAAC;AAMf,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAMpC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMxE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EACL,GAAG,EACH,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,GACR,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,KAAK,SAAS,IAAI,aAAa,GAChC,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/react/hooks.d.ts

@@ -0,0 +1,130 @@
+/**
+ * React Hooks for Voltra SDK
+ *
+ * Clean, focused hooks for device scanning and state management.
+ *
+ * @example
+ * ```tsx
+ * import { VoltraManager } from '@voltras/node-sdk';
+ * import { useVoltraScanner, useVoltraDevice } from '@voltras/node-sdk/react';
+ *
+ * function WorkoutScreen() {
+ *   const manager = useMemo(() => new VoltraManager(), []);
+ *   const [client, setClient] = useState<VoltraClient | null>(null);
+ *
+ *   // Scanner state
+ *   const { devices, isScanning, scan } = useVoltraScanner(manager);
+ *
+ *   // Device state (when connected)
+ *   const { connectionState, currentFrame, settings } = useVoltraDevice(client);
+ *
+ *   const handleConnect = async (device: DiscoveredDevice) => {
+ *     const connected = await manager.connect(device);
+ *     setClient(connected);
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       <Button onPress={() => scan()}>
+ *         {isScanning ? 'Scanning...' : 'Scan'}
+ *       </Button>
+ *       {devices.map((d) => (
+ *         <Button key={d.id} onPress={() => handleConnect(d)}>
+ *           {d.name}
+ *         </Button>
+ *       ))}
+ *       {connectionState === 'connected' && (
+ *         <Text>Position: {currentFrame?.position}</Text>
+ *       )}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+import type { DiscoveredDevice } from '../bluetooth/models/device';
+import type { TelemetryFrame } from '../voltra/models/telemetry';
+import type { VoltraConnectionState } from '../voltra/models/connection';
+import type { VoltraDeviceSettings, VoltraRecordingState } from '../voltra/models/device';
+import type { VoltraManager } from '../sdk/voltra-manager';
+import type { VoltraClient } from '../sdk/voltra-client';
+import type { ScanOptions } from '../sdk/types';
+/**
+ * Scanner state and controls.
+ */
+export interface VoltraScannerState {
+    /** Devices discovered in the last scan */
+    devices: DiscoveredDevice[];
+    /** Whether a scan is in progress */
+    isScanning: boolean;
+    /** Error from the last scan, if any */
+    error: Error | null;
+    /** Start scanning for devices */
+    scan: (options?: ScanOptions) => Promise<DiscoveredDevice[]>;
+    /** Clear discovered devices */
+    clear: () => void;
+}
+/**
+ * Hook for scanning for Voltra devices.
+ *
+ * @param manager VoltraManager instance
+ * @returns Scanner state and controls
+ */
+export declare function useVoltraScanner(manager: VoltraManager | null): VoltraScannerState;
+/**
+ * Device state.
+ */
+export interface VoltraDeviceState {
+    /** Current connection state */
+    connectionState: VoltraConnectionState;
+    /** Whether connected */
+    isConnected: boolean;
+    /** Current recording state */
+    recordingState: VoltraRecordingState;
+    /** Whether recording is active */
+    isRecording: boolean;
+    /** Current device settings */
+    settings: VoltraDeviceSettings;
+    /** Most recent telemetry frame */
+    currentFrame: TelemetryFrame | null;
+    /** Last error, if any */
+    error: Error | null;
+}
+/**
+ * Hook for observing a Voltra device's state.
+ *
+ * @param client VoltraClient instance (or null if not connected)
+ * @returns Device state
+ */
+export declare function useVoltraDevice(client: VoltraClient | null): VoltraDeviceState;
+/**
+ * Combined state for simple single-device use cases.
+ */
+export interface UseVoltraState extends VoltraScannerState, VoltraDeviceState {
+    /** The connected client, if any */
+    client: VoltraClient | null;
+    /** Connect to a device */
+    connect: (device: DiscoveredDevice) => Promise<VoltraClient>;
+    /** Disconnect current device */
+    disconnect: () => Promise<void>;
+    /** Set weight (shorthand) */
+    setWeight: (lbs: number) => Promise<void>;
+    /** Set chains (shorthand) */
+    setChains: (lbs: number) => Promise<void>;
+    /** Set eccentric (shorthand) */
+    setEccentric: (percent: number) => Promise<void>;
+    /** Start recording (shorthand) */
+    startRecording: () => Promise<void>;
+    /** Stop recording (shorthand) */
+    stopRecording: () => Promise<void>;
+}
+/**
+ * All-in-one hook for simple single-device scenarios.
+ * Combines scanner and device state.
+ *
+ * For multi-device scenarios, use useVoltraScanner and useVoltraDevice separately.
+ *
+ * @param manager VoltraManager instance
+ * @returns Combined state and controls
+ */
+export declare function useVoltra(manager: VoltraManager | null): UseVoltraState;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/types/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iCAAiC;IACjC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7D,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,kBAAkB,CAsDlF;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,eAAe,EAAE,qBAAqB,CAAC;IACvC,wBAAwB;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,cAAc,EAAE,oBAAoB,CAAC;IACrC,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,kCAAkC;IAClC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,yBAAyB;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAkBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,iBAAiB,CAiE9E;AAMD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,iBAAiB;IAC3E,mCAAmC;IACnC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,0BAA0B;IAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,gCAAgC;IAChC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,6BAA6B;IAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,gCAAgC;IAChC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,kCAAkC;IAClC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,iCAAiC;IACjC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,cAAc,CA2FvE"}

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

@@ -0,0 +1,12 @@
+/**
+ * React Hooks for Voltra SDK
+ *
+ * Import from '@voltras/node-sdk/react'
+ *
+ * @example
+ * ```tsx
+ * import { useVoltraScanner, useVoltraDevice, useVoltra } from '@voltras/node-sdk/react';
+ * ```
+ */
+export { useVoltraScanner, useVoltraDevice, useVoltra, type VoltraScannerState, type VoltraDeviceState, type UseVoltraState, } from './hooks';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * SDK - High-level API
+ *
+ * VoltraManager is the main entry point. It handles device discovery and returns
+ * VoltraClient instances for controlling individual devices.
+ */
+export { VoltraClient } from './voltra-client';
+export { VoltraManager } from './voltra-manager';
+export type { VoltraClientOptions, VoltraClientState, VoltraClientEvent, VoltraClientEventListener, FrameListener, ScanOptions, DeviceChooser, } from './types';
+export type { Platform, VoltraManagerOptions, VoltraManagerEvent, VoltraManagerEventListener, ConnectByNameOptions, AdapterFactory, } from './voltra-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/types/sdk/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SDK Types
+ *
+ * Types for the high-level VoltraClient API.
+ */
+import type { BLEAdapter } from '../bluetooth/adapters/types';
+import type { DiscoveredDevice } from '../bluetooth/models/device';
+import type { TelemetryFrame } from '../voltra/models/telemetry';
+import type { VoltraConnectionState } from '../voltra/models/connection';
+import type { VoltraDeviceSettings, VoltraRecordingState } from '../voltra/models/device';
+/**
+ * Options for creating a VoltraClient.
+ */
+export interface VoltraClientOptions {
+    /**
+     * Pre-configured BLE adapter to use.
+     * If not provided, you must call setAdapter() before connecting.
+     */
+    adapter?: BLEAdapter;
+    /**
+     * Enable auto-reconnect on connection loss.
+     * Default: false
+     */
+    autoReconnect?: boolean;
+    /**
+     * Maximum number of reconnect attempts.
+     * Default: 3
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Delay between reconnect attempts in milliseconds.
+     * Default: 1000
+     */
+    reconnectDelayMs?: number;
+}
+/**
+ * Options for scanning for devices.
+ */
+export interface ScanOptions {
+    /**
+     * Scan timeout in milliseconds.
+     * Default: 10000 (10 seconds)
+     */
+    timeout?: number;
+    /**
+     * Only return Voltra devices (filter by name prefix).
+     * Default: true
+     */
+    filterVoltra?: boolean;
+}
+/**
+ * Client event types.
+ */
+export type VoltraClientEvent = {
+    type: 'connectionStateChanged';
+    state: VoltraConnectionState;
+} | {
+    type: 'connected';
+    deviceId: string;
+    deviceName: string | null;
+} | {
+    type: 'disconnected';
+    deviceId: string;
+} | {
+    type: 'reconnecting';
+    attempt: number;
+    maxAttempts: number;
+} | {
+    type: 'recordingStateChanged';
+    state: VoltraRecordingState;
+} | {
+    type: 'frame';
+    frame: TelemetryFrame;
+} | {
+    type: 'error';
+    error: Error;
+};
+/**
+ * Client event listener.
+ */
+export type VoltraClientEventListener = (event: VoltraClientEvent) => void;
+/**
+ * Frame listener (shorthand for subscribing to telemetry frames).
+ */
+export type FrameListener = (frame: TelemetryFrame) => void;
+/**
+ * State snapshot of the client.
+ */
+export interface VoltraClientState {
+    connectionState: VoltraConnectionState;
+    isConnected: boolean;
+    isReconnecting: boolean;
+    connectedDeviceId: string | null;
+    connectedDeviceName: string | null;
+    settings: VoltraDeviceSettings;
+    recordingState: VoltraRecordingState;
+    isRecording: boolean;
+    error: Error | null;
+}
+/**
+ * Device chooser function for programmatic device selection (Node.js).
+ */
+export type DeviceChooser = (devices: DiscoveredDevice[]) => DiscoveredDevice | null;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,qBAAqB,CAAC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,cAAc,EAAE,oBAAoB,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,GAAG,IAAI,CAAC"}

package/dist/types/sdk/voltra-client.d.ts

@@ -0,0 +1,221 @@
+/**
+ * VoltraClient
+ *
+ * High-level API for connecting to and controlling a single Voltra device.
+ * Handles connection lifecycle, authentication, device settings, and telemetry.
+ *
+ * @example
+ * ```typescript
+ * import { VoltraClient, WebBLEAdapter, BLE } from '@voltras/node-sdk';
+ *
+ * const adapter = new WebBLEAdapter({ ble: BLE });
+ * const client = new VoltraClient({ adapter });
+ *
+ * // Connect to device
+ * const devices = await client.scan();
+ * await client.connect(devices[0]);
+ *
+ * // Configure settings
+ * await client.setWeight(50);
+ *
+ * // Listen for telemetry
+ * client.onFrame((frame) => {
+ *   console.log('Position:', frame.position, 'Velocity:', frame.velocity);
+ * });
+ *
+ * // Start recording
+ * await client.startRecording();
+ * // ... workout ...
+ * await client.stopRecording();
+ *
+ * // Cleanup
+ * client.dispose();
+ * ```
+ */
+import type { BLEAdapter } from '../bluetooth/adapters/types';
+import type { DiscoveredDevice } from '../bluetooth/models/device';
+import type { VoltraConnectionState } from '../voltra/models/connection';
+import type { VoltraDeviceSettings, VoltraRecordingState } from '../voltra/models/device';
+import type { VoltraClientOptions, VoltraClientState, VoltraClientEventListener, FrameListener, ScanOptions } from './types';
+/**
+ * High-level client for connecting to and controlling a Voltra device.
+ */
+export declare class VoltraClient {
+    private readonly options;
+    private adapter;
+    private _connectionState;
+    private _connectedDeviceId;
+    private _connectedDeviceName;
+    private _settings;
+    private _recordingState;
+    private _isReconnecting;
+    private _reconnectAttempt;
+    private _error;
+    private _lastConnectedDevice;
+    private notificationUnsubscribe;
+    private listeners;
+    private frameListeners;
+    private disposed;
+    constructor(options?: VoltraClientOptions);
+    /**
+     * Get current connection state.
+     */
+    get connectionState(): VoltraConnectionState;
+    /**
+     * Check if connected to a device.
+     */
+    get isConnected(): boolean;
+    /**
+     * Check if currently reconnecting.
+     */
+    get isReconnecting(): boolean;
+    /**
+     * Get connected device ID.
+     */
+    get connectedDeviceId(): string | null;
+    /**
+     * Get connected device name.
+     */
+    get connectedDeviceName(): string | null;
+    /**
+     * Get current device settings.
+     */
+    get settings(): VoltraDeviceSettings;
+    /**
+     * Get current recording state.
+     */
+    get recordingState(): VoltraRecordingState;
+    /**
+     * Check if currently recording.
+     */
+    get isRecording(): boolean;
+    /**
+     * Get last error.
+     */
+    get error(): Error | null;
+    /**
+     * Get full state snapshot.
+     */
+    get state(): VoltraClientState;
+    /**
+     * Set the BLE adapter to use.
+     * Must be called before connect() if not provided in constructor.
+     */
+    setAdapter(adapter: BLEAdapter): void;
+    /**
+     * Get the current adapter.
+     */
+    getAdapter(): BLEAdapter | null;
+    /**
+     * Scan for Voltra devices.
+     *
+     * Note: In browser environments, this triggers the Web Bluetooth device picker.
+     * The returned array will contain only the user-selected device.
+     *
+     * @param options Scan options
+     * @returns Array of discovered Voltra devices
+     */
+    scan(options?: ScanOptions): Promise<DiscoveredDevice[]>;
+    /**
+     * Connect to a Voltra device.
+     * Handles BLE connection, authentication, and initialization.
+     *
+     * @param device Device to connect to
+     */
+    connect(device: DiscoveredDevice): Promise<void>;
+    /**
+     * Disconnect from the current device.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Set weight in pounds.
+     *
+     * @param lbs Weight (5-200 in increments of 5)
+     */
+    setWeight(lbs: number): Promise<void>;
+    /**
+     * Set chains (reverse resistance) in pounds.
+     *
+     * @param lbs Chains weight (0-100)
+     */
+    setChains(lbs: number): Promise<void>;
+    /**
+     * Set eccentric load adjustment.
+     *
+     * @param percent Eccentric adjustment (-195 to +195)
+     */
+    setEccentric(percent: number): Promise<void>;
+    /**
+     * Get available weight values.
+     */
+    getAvailableWeights(): number[];
+    /**
+     * Get available chains values.
+     */
+    getAvailableChains(): number[];
+    /**
+     * Get available eccentric values.
+     */
+    getAvailableEccentric(): number[];
+    /**
+     * Prepare for recording (sends PREPARE + SETUP commands).
+     * Call this before starting a set to minimize latency.
+     */
+    prepareRecording(): Promise<void>;
+    /**
+     * Start recording (engage motor).
+     * If not prepared, will prepare first.
+     */
+    startRecording(): Promise<void>;
+    /**
+     * Stop recording (disengage motor and exit workout mode).
+     */
+    stopRecording(): Promise<void>;
+    /**
+     * End the current set but stay in workout mode.
+     * Use this between sets when there are more sets to do.
+     */
+    endSet(): Promise<void>;
+    /**
+     * Subscribe to client events.
+     *
+     * @param listener Event listener
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: VoltraClientEventListener): () => void;
+    /**
+     * Subscribe to telemetry frames.
+     * Shorthand for subscribing to 'frame' events.
+     *
+     * @param listener Frame listener
+     * @returns Unsubscribe function
+     */
+    onFrame(listener: FrameListener): () => void;
+    /**
+     * Subscribe to connection state changes.
+     *
+     * @param listener State listener
+     * @returns Unsubscribe function
+     */
+    onConnectionStateChange(listener: (state: VoltraConnectionState) => void): () => void;
+    /**
+     * Dispose of the client and release all resources.
+     * After calling dispose(), the client cannot be used.
+     */
+    dispose(): void;
+    private authenticate;
+    private initialize;
+    private setupNotificationHandler;
+    private setupDisconnectHandler;
+    private handleUnexpectedDisconnect;
+    private cleanup;
+    private setConnectionState;
+    private setRecordingState;
+    private emit;
+    private ensureNotDisposed;
+    private ensureAdapter;
+    private ensureConnected;
+    private wrapError;
+    private getErrorMessage;
+}
+//# sourceMappingURL=voltra-client.d.ts.map

package/dist/types/sdk/voltra-client.d.ts.map

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