@voltras/node-sdk 0.1.0

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

@@ -0,0 +1,226 @@
+/**
+ * VoltraManager
+ *
+ * Main entry point for the Voltra SDK. Handles device discovery and connection.
+ * Returns VoltraClient instances for controlling individual devices.
+ *
+ * @example
+ * ```typescript
+ * import { VoltraManager } from '@voltras/node-sdk';
+ *
+ * const manager = new VoltraManager();
+ *
+ * // Scan for devices
+ * const devices = await manager.scan();
+ *
+ * // Connect to a device (returns a VoltraClient)
+ * const client = await manager.connect(devices[0]);
+ *
+ * // Or connect by name (scans + connects in one step)
+ * const client = await manager.connectByName('VTR-123456');
+ *
+ * // Use the client
+ * await client.setWeight(50);
+ * client.onFrame((frame) => console.log(frame.position));
+ *
+ * // Cleanup
+ * manager.dispose();
+ * ```
+ */
+import type { BLEAdapter } from '../bluetooth/adapters/types';
+import type { DiscoveredDevice } from '../bluetooth/models/device';
+import { VoltraClient } from './voltra-client';
+import type { VoltraClientOptions, ScanOptions } from './types';
+/**
+ * Supported platforms for BLE.
+ */
+export type Platform = 'web' | 'node' | 'native';
+/**
+ * Factory function to create a BLE adapter.
+ */
+export type AdapterFactory = () => BLEAdapter;
+/**
+ * Options for creating a VoltraManager.
+ */
+export interface VoltraManagerOptions {
+    /**
+     * Platform to use. If not specified, auto-detects (web/node).
+     * For React Native, use 'native' or import from '@voltras/node-sdk/native'.
+     */
+    platform?: Platform;
+    /**
+     * Custom adapter factory. Overrides platform detection.
+     * Use this for advanced scenarios or custom adapters.
+     */
+    adapterFactory?: AdapterFactory;
+    /**
+     * Options to pass to each VoltraClient.
+     */
+    clientOptions?: Omit<VoltraClientOptions, 'adapter'>;
+}
+/**
+ * Options for connectByName.
+ */
+export interface ConnectByNameOptions extends ScanOptions {
+    /**
+     * Match mode for device name.
+     * - 'exact': Name must match exactly
+     * - 'contains': Name must contain the string (default)
+     * - 'startsWith': Name must start with the string
+     */
+    matchMode?: 'exact' | 'contains' | 'startsWith';
+}
+/**
+ * Manager event types.
+ */
+export type VoltraManagerEvent = {
+    type: 'deviceConnected';
+    deviceId: string;
+    deviceName: string | null;
+    client: VoltraClient;
+} | {
+    type: 'deviceDisconnected';
+    deviceId: string;
+} | {
+    type: 'deviceError';
+    deviceId: string;
+    error: Error;
+} | {
+    type: 'scanStarted';
+} | {
+    type: 'scanStopped';
+    devices: DiscoveredDevice[];
+};
+/**
+ * Manager event listener.
+ */
+export type VoltraManagerEventListener = (event: VoltraManagerEvent) => void;
+/**
+ * Main entry point for the Voltra SDK.
+ */
+export declare class VoltraManager {
+    private adapterFactory;
+    private readonly clientOptions;
+    private readonly platform;
+    private clients;
+    private clientUnsubscribes;
+    private discoveredDevices;
+    private _isScanning;
+    private scanAdapter;
+    private listeners;
+    private disposed;
+    constructor(options?: VoltraManagerOptions);
+    /**
+     * Create a manager for web browsers.
+     */
+    static forWeb(options?: Omit<VoltraManagerOptions, 'platform'>): VoltraManager;
+    /**
+     * Create a manager for Node.js.
+     */
+    static forNode(options?: Omit<VoltraManagerOptions, 'platform'>): VoltraManager;
+    /**
+     * Create a manager for React Native.
+     * Note: Prefer importing from '@voltras/node-sdk/native' instead.
+     */
+    static forNative(options?: Omit<VoltraManagerOptions, 'platform'>): VoltraManager;
+    /**
+     * Get all connected device IDs.
+     */
+    get connectedDeviceIds(): string[];
+    /**
+     * Get number of connected devices.
+     */
+    get connectedCount(): number;
+    /**
+     * Check if scanning is in progress.
+     */
+    get isScanning(): boolean;
+    /**
+     * Get devices discovered in last scan.
+     */
+    get devices(): DiscoveredDevice[];
+    /**
+     * Get a connected device client by ID.
+     */
+    getClient(deviceId: string): VoltraClient | undefined;
+    /**
+     * Get all connected device clients.
+     */
+    getAllClients(): VoltraClient[];
+    /**
+     * Check if a device is connected.
+     */
+    isConnected(deviceId: string): boolean;
+    /**
+     * Scan for Voltra devices.
+     *
+     * @param options Scan options
+     * @returns Array of discovered Voltra devices
+     */
+    scan(options?: ScanOptions): Promise<DiscoveredDevice[]>;
+    /**
+     * Connect to a Voltra device.
+     *
+     * @param device Device to connect to
+     * @returns VoltraClient for the connected device
+     */
+    connect(device: DiscoveredDevice): Promise<VoltraClient>;
+    /**
+     * Scan for a device by name and connect to it.
+     * This is a convenience method that combines scan() and connect().
+     *
+     * @param namePattern Name or partial name to search for
+     * @param options Connection options
+     * @returns VoltraClient for the connected device
+     * @throws Error if no matching device is found
+     *
+     * @example
+     * ```typescript
+     * // Connect to device containing "VTR-123" in its name
+     * const client = await manager.connectByName('VTR-123');
+     *
+     * // Connect to exact name match
+     * const client = await manager.connectByName('VTR-123456', { matchMode: 'exact' });
+     * ```
+     */
+    connectByName(namePattern: string, options?: ConnectByNameOptions): Promise<VoltraClient>;
+    /**
+     * Connect to the first available Voltra device.
+     * Convenience method for single-device scenarios.
+     *
+     * @param options Scan options
+     * @returns VoltraClient for the connected device
+     * @throws Error if no devices are found
+     */
+    connectFirst(options?: ScanOptions): Promise<VoltraClient>;
+    /**
+     * Disconnect a specific device.
+     */
+    disconnect(deviceId: string): Promise<void>;
+    /**
+     * Disconnect all devices.
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Subscribe to manager events.
+     */
+    subscribe(listener: VoltraManagerEventListener): () => void;
+    /**
+     * Subscribe to device connected events.
+     */
+    onDeviceConnected(callback: (client: VoltraClient, deviceId: string, deviceName: string | null) => void): () => void;
+    /**
+     * Subscribe to device disconnected events.
+     */
+    onDeviceDisconnected(callback: (deviceId: string) => void): () => void;
+    /**
+     * Dispose of the manager and all connected devices.
+     */
+    dispose(): void;
+    private detectPlatform;
+    private createAdapterFactory;
+    private handleClientEvent;
+    private emit;
+    private ensureNotDisposed;
+}
+//# sourceMappingURL=voltra-manager.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Shared Utilities
+ */
+export { delay, hexToBytes, bytesToHex, bytesEqual } from './utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/shared/utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared Utilities
+ *
+ * Common utilities used across SDK modules.
+ */
+/**
+ * Delay execution for a specified duration.
+ * @param ms Duration in milliseconds
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Convert hex string to Uint8Array.
+ * @param hex Hex string (e.g., "48656c6c6f")
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Convert Uint8Array to hex string.
+ * @param bytes Byte array
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Check if two byte arrays are equal.
+ */
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE"}

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

@@ -0,0 +1,13 @@
+/**
+ * Voltra Domain
+ *
+ * Voltra device management, telemetry processing, and workout control.
+ */
+export { VoltraDevice, DEFAULT_SETTINGS, type VoltraDeviceSettings, type VoltraRecordingState, type VoltraDeviceState, } from './models/device';
+export { type VoltraConnectionState, isValidVoltraTransition, VoltraConnectionStateModel, } from './models/connection';
+export { VOLTRA_DEVICE_PREFIX, isVoltraDevice, filterVoltraDevices } from './models/device-filter';
+export { type TelemetryFrame, createFrame, isActivePhase, isConcentricPhase, isEccentricPhase, } from './models/telemetry';
+export { WeightCommands, ChainsCommands, EccentricCommands, type DualCommand, } from './protocol/commands';
+export { MessageTypes, TelemetryOffsets, Timing, Auth, Init, Workout, BLE, MovementPhase, PhaseNames, } from './protocol/constants';
+export { decodeNotification, decodeTelemetryFrame, encodeTelemetryFrame, identifyMessageType, type DecodeResult, type MessageType, } from './protocol/telemetry-decoder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voltra/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,qBAAqB,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGnG,OAAO,EACL,KAAK,cAAc,EACnB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,GAAG,EACH,aAAa,EACb,UAAU,GACX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,8BAA8B,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Voltra Connection Model
+ *
+ * Voltra-specific connection state that includes the authentication step.
+ */
+/**
+ * Voltra-specific connection states (includes auth step).
+ */
+export type VoltraConnectionState = 'disconnected' | 'connecting' | 'authenticating' | 'connected';
+/**
+ * Check if a Voltra state transition is valid.
+ */
+export declare function isValidVoltraTransition(from: VoltraConnectionState, to: VoltraConnectionState): boolean;
+/**
+ * Voltra connection state model with validation.
+ */
+export declare class VoltraConnectionStateModel {
+    private _state;
+    get state(): VoltraConnectionState;
+    get isConnected(): boolean;
+    get isConnecting(): boolean;
+    get isDisconnected(): boolean;
+    /**
+     * Transition to a new state.
+     * @throws Error if transition is invalid
+     */
+    transitionTo(newState: VoltraConnectionState): void;
+    /**
+     * Force set state (for reconnection scenarios).
+     */
+    forceState(state: VoltraConnectionState): void;
+    /**
+     * Reset to disconnected state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/voltra/models/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAYnG;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,EAAE,EAAE,qBAAqB,GACxB,OAAO,CAET;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAyC;IAEvD,IAAI,KAAK,IAAI,qBAAqB,CAEjC;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,qBAAqB,GAAG,IAAI;IAOnD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/voltra/models/device-filter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Voltra Device Filter
+ *
+ * Utility functions for filtering Voltra devices from BLE scan results.
+ */
+import { type DiscoveredDevice } from '../../bluetooth/models/device';
+/**
+ * Voltra device name prefix.
+ */
+export declare const VOLTRA_DEVICE_PREFIX: string;
+/**
+ * Check if a device is a Voltra device.
+ */
+export declare function isVoltraDevice(device: DiscoveredDevice): boolean;
+/**
+ * Filter Voltra devices from a list.
+ */
+export declare function filterVoltraDevices(devices: DiscoveredDevice[]): DiscoveredDevice[];
+//# sourceMappingURL=device-filter.d.ts.map

package/dist/types/voltra/models/device-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-filter.d.ts","sourceRoot":"","sources":["../../../../src/voltra/models/device-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAEnF"}

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

@@ -0,0 +1,105 @@
+/**
+ * Voltra Device Model
+ *
+ * Represents a Voltra device with its identity, settings, and connection state.
+ */
+import { type VoltraConnectionState } from './connection';
+/**
+ * Voltra device settings.
+ */
+export interface VoltraDeviceSettings {
+    /** Weight in pounds (5-200 in increments of 5) */
+    weight: number;
+    /** Chains (reverse resistance) in pounds (0-100) */
+    chains: number;
+    /** Eccentric load adjustment (-195 to +195) */
+    eccentric: number;
+}
+/**
+ * Recording state for a Voltra device.
+ *
+ * A "recording" is when the device is actively streaming telemetry data,
+ * typically during a single set. This is distinct from a "workout" which
+ * refers to the full training session containing multiple sets/exercises.
+ */
+export type VoltraRecordingState = 'idle' | 'preparing' | 'ready' | 'active' | 'stopping';
+/**
+ * Voltra device state snapshot.
+ */
+export interface VoltraDeviceState {
+    deviceId: string;
+    deviceName: string | null;
+    connectionState: VoltraConnectionState;
+    isReconnecting: boolean;
+    settings: VoltraDeviceSettings;
+    recordingState: VoltraRecordingState;
+    recordingStartTime: number | null;
+    error: string | null;
+}
+/**
+ * Default settings for a new device.
+ */
+export declare const DEFAULT_SETTINGS: VoltraDeviceSettings;
+/**
+ * Voltra device model.
+ *
+ * Represents a single Voltra device with its state and settings.
+ * This is a pure model with no async operations.
+ */
+export declare class VoltraDevice {
+    private _deviceId;
+    private _deviceName;
+    private _settings;
+    private _connectionState;
+    private _isReconnecting;
+    private _recordingState;
+    private _recordingStartTime;
+    private _error;
+    constructor(deviceId: string, deviceName?: string | null);
+    get deviceId(): string;
+    get deviceName(): string | null;
+    get settings(): VoltraDeviceSettings;
+    get weight(): number;
+    get chains(): number;
+    get eccentric(): number;
+    get connectionState(): VoltraConnectionState;
+    get isConnected(): boolean;
+    get isReconnecting(): boolean;
+    get recordingState(): VoltraRecordingState;
+    get isRecording(): boolean;
+    get recordingStartTime(): number | null;
+    get error(): string | null;
+    /**
+     * Update device settings.
+     */
+    updateSettings(settings: Partial<VoltraDeviceSettings>): void;
+    /**
+     * Set connection state.
+     */
+    setConnectionState(state: VoltraConnectionState): void;
+    /**
+     * Set reconnecting flag.
+     */
+    setReconnecting(value: boolean): void;
+    /**
+     * Set recording state.
+     */
+    setRecordingState(state: VoltraRecordingState): void;
+    /**
+     * Set error message.
+     */
+    setError(error: string | null): void;
+    /**
+     * Clear error.
+     */
+    clearError(): void;
+    /**
+     * Get a snapshot of the device state.
+     */
+    toState(): VoltraDeviceState;
+    /**
+     * Reset device to initial state (keeps identity).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../src/voltra/models/device.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,eAAe,EAAE,qBAAqB,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;IAGxB,QAAQ,EAAE,oBAAoB,CAAC;IAG/B,cAAc,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAGlC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAI9B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,MAAM,CAAgB;gBAElB,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAexD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,oBAAoB,CAEnC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,eAAe,IAAI,qBAAqB,CAE3C;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,cAAc,IAAI,oBAAoB,CAEzC;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAMD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAItD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIrC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IASpD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,OAAO,IAAI,iBAAiB;IAa5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/types/voltra/models/telemetry/frame.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Telemetry Frame Model
+ *
+ * Represents a single telemetry data point from the Voltra device.
+ */
+import { MovementPhase } from '../../protocol/constants';
+/**
+ * Real-time telemetry data from a single BLE notification.
+ * Received at ~11 Hz during active workouts.
+ */
+export interface TelemetryFrame {
+    /** Incrementing sequence number from device */
+    sequence: number;
+    /** Current movement phase */
+    phase: MovementPhase;
+    /** Cable extension (0=rest, ~600=full pull) */
+    position: number;
+    /** Force reading in lbs (positive=concentric, negative=eccentric) */
+    force: number;
+    /** Movement velocity */
+    velocity: number;
+    /** When frame was received (ms since epoch) */
+    timestamp: number;
+}
+/**
+ * Create a telemetry frame from parsed values.
+ */
+export declare function createFrame(sequence: number, phase: MovementPhase, position: number, force: number, velocity: number): TelemetryFrame;
+/**
+ * Check if a frame represents active movement.
+ */
+export declare function isActivePhase(frame: TelemetryFrame): boolean;
+/**
+ * Check if frame is concentric (pulling) phase.
+ */
+export declare function isConcentricPhase(frame: TelemetryFrame): boolean;
+/**
+ * Check if frame is eccentric (lowering) phase.
+ */
+export declare function isEccentricPhase(frame: TelemetryFrame): boolean;
+//# sourceMappingURL=frame.d.ts.map

package/dist/types/voltra/models/telemetry/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/models/telemetry/frame.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,cAAc,CAShB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAM5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE/D"}

package/dist/types/voltra/models/telemetry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Telemetry Models
+ *
+ * Data structures for workout telemetry.
+ */
+export type { TelemetryFrame } from './frame';
+export { createFrame, isActivePhase, isConcentricPhase, isEccentricPhase } from './frame';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/voltra/models/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/models/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/voltra/protocol/commands.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Voltra Protocol Command Builders
+ *
+ * Builds commands for setting weight, chains, and eccentric resistance.
+ */
+interface ChainsValue {
+    step1_seq: string;
+    step1_checksum: string;
+    step2_seq: string;
+    step2_checksum: string;
+}
+interface ChainsData {
+    format: {
+        step1: {
+            prefix: string;
+            mode: string;
+            register: string;
+            padding: string;
+        };
+        step2: {
+            prefix: string;
+            mode: string;
+            register: string;
+            padding: string;
+        };
+    };
+    values: Record<string, ChainsValue>;
+}
+/**
+ * Weight command builder for 5-200 lbs in 5 lb increments.
+ */
+export declare const WeightCommands: {
+    MIN: number;
+    MAX: number;
+    INCREMENT: number;
+    /** Get available weight values */
+    getAvailable(): number[];
+    /** Check if a weight value is valid */
+    isValid(pounds: number): boolean;
+    /**
+     * Get the command to set a specific weight.
+     * @param pounds Weight in pounds (5-200 in increments of 5)
+     * @returns 21-byte command, or null if weight not available
+     */
+    get(pounds: number): Uint8Array | null;
+    _build(pounds: number, seq: string, checksum: string, format: {
+        prefix: string;
+        mode: string;
+        register: string;
+        padding: string;
+    }): Uint8Array;
+};
+/**
+ * Dual command result for chains and eccentric.
+ */
+export interface DualCommand {
+    step1: Uint8Array;
+    step2: Uint8Array;
+}
+/**
+ * Chains (reverse resistance) command builder for 0-100 lbs.
+ * Requires dual commands: send step1, wait 500ms, send step2.
+ */
+export declare const ChainsCommands: {
+    MIN: number;
+    MAX: number;
+    /** Get available chains values */
+    getAvailable(): number[];
+    /** Check if a chains value is valid */
+    isValid(pounds: number): boolean;
+    /**
+     * Get dual commands to set chains weight.
+     * @param pounds Chains weight (0-100)
+     * @returns Tuple of (step1, step2) commands, or null if not available
+     */
+    get(pounds: number): DualCommand | null;
+    _build(pounds: number, step: 1 | 2, seq: string, checksum: string, format: ChainsData["format"]): Uint8Array;
+};
+/**
+ * Eccentric load adjustment command builder for -195 to +195.
+ * Requires dual commands: send step1, wait 500ms, send step2.
+ */
+export declare const EccentricCommands: {
+    MIN: number;
+    MAX: number;
+    /** Get available eccentric values */
+    getAvailable(): number[];
+    /** Check if an eccentric value is valid */
+    isValid(value: number): boolean;
+    /**
+     * Get dual commands to set eccentric load.
+     * @param value Eccentric adjustment (-195 to +195)
+     * @returns Tuple of (step1, step2) commands, or null if not available
+     */
+    get(value: number): DualCommand | null;
+    _build(value: number, step: 1 | 2): Uint8Array;
+};
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/types/voltra/protocol/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE;QACN,KAAK,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,KAAK,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5E,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAoBD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,kCAAkC;oBAClB,MAAM,EAAE;IAMxB,uCAAuC;oBACvB,MAAM,GAAG,OAAO;IAIhC;;;;OAIG;gBACS,MAAM,GAAG,UAAU,GAAG,IAAI;mBAc5B,MAAM,OACT,MAAM,YACD,MAAM,UACR;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC1E,UAAU;CAwCd,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;IAIzB,kCAAkC;oBAClB,MAAM,EAAE;IAMxB,uCAAuC;oBACvB,MAAM,GAAG,OAAO;IAIhC;;;;OAIG;gBACS,MAAM,GAAG,WAAW,GAAG,IAAI;mBAkB7B,MAAM,QACR,CAAC,GAAG,CAAC,OACN,MAAM,YACD,MAAM,UACR,UAAU,CAAC,QAAQ,CAAC,GAC3B,UAAU;CAyCd,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;IAI5B,qCAAqC;oBACrB,MAAM,EAAE;IAMxB,2CAA2C;mBAC5B,MAAM,GAAG,OAAO;IAI/B;;;;OAIG;eACQ,MAAM,GAAG,WAAW,GAAG,IAAI;kBAaxB,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,UAAU;CA8C/C,CAAC"}