@voltras/node-sdk 0.1.1 → 0.2.0

package/dist/types/voltra/protocol/constants/connection-commands.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Connection Commands
+ *
+ * Authentication, initialization, and workout control commands.
+ */
+/**
+ * Device authentication identifiers.
+ */
+export declare const Auth: {
+    /** Primary device identity */
+    readonly DEVICE_ID: Uint8Array<ArrayBufferLike>;
+    /** Alternative device identity */
+    readonly DEVICE_ID_IPAD: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * Device initialization sequence.
+ */
+export declare const Init: {
+    readonly SEQUENCE: Uint8Array<ArrayBufferLike>[];
+};
+/**
+ * Workout control commands.
+ *
+ * To start: set weight -> PREPARE -> SETUP -> GO
+ * To stop: STOP
+ */
+export declare const Workout: {
+    /** Prepare device for workout */
+    readonly PREPARE: Uint8Array<ArrayBufferLike>;
+    /** Configure workout mode */
+    readonly SETUP: Uint8Array<ArrayBufferLike>;
+    /** Start resistance/tracking */
+    readonly GO: Uint8Array<ArrayBufferLike>;
+    /** Stop resistance/tracking */
+    readonly STOP: Uint8Array<ArrayBufferLike>;
+};
+//# sourceMappingURL=connection-commands.d.ts.map

package/dist/types/voltra/protocol/constants/connection-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-commands.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/constants/connection-commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;GAEG;AACH,eAAO,MAAM,IAAI;IACf,8BAA8B;;IAE9B,kCAAkC;;CAE1B,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEP,CAAC;AAMX;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAClB,iCAAiC;;IAEjC,6BAA6B;;IAE7B,gCAAgC;;IAEhC,+BAA+B;;CAEvB,CAAC"}

package/dist/types/voltra/protocol/constants/enums.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Protocol Enums
+ *
+ * Movement phases, training modes, and parameter IDs with
+ * their human-readable name maps.
+ */
+/**
+ * Movement phase during workout.
+ * Values match protocol.json telemetry.phases.
+ */
+export declare enum MovementPhase {
+    IDLE = 0,// protocol.telemetry.phases.idle
+    CONCENTRIC = 1,// protocol.telemetry.phases.concentric - Pulling (muscle shortening)
+    HOLD = 2,// protocol.telemetry.phases.hold - Top of rep / transition
+    ECCENTRIC = 3,// protocol.telemetry.phases.eccentric - Releasing (muscle lengthening)
+    UNKNOWN = -1
+}
+/**
+ * Human-readable phase names.
+ */
+export declare const PhaseNames: Record<MovementPhase, string>;
+/**
+ * Parameter IDs for device commands.
+ * These identify which parameter is being set in 19-byte commands.
+ */
+export declare enum ParameterId {
+    /** Base weight setting */
+    BASE_WEIGHT = 34366,
+    /** Chains resistance */
+    CHAINS = 34622,
+    /** Eccentric adjustment */
+    ECCENTRIC = 34878,
+    /** Training mode */
+    TRAINING_MODE = 45135,
+    /** Inverse chains resistance */
+    INVERSE_CHAINS = 45139
+}
+/**
+ * Human-readable parameter names.
+ */
+export declare const ParameterNames: Record<ParameterId, string>;
+/**
+ * Training mode values for ParameterId.TRAINING_MODE.
+ * Values are 2-byte little-endian uint16.
+ */
+export declare enum TrainingMode {
+    /** Idle (0x0000) */
+    Idle = 0,
+    /** Weight Training (0x0001) */
+    WeightTraining = 1,
+    /** Resistance Band (0x0002) */
+    ResistanceBand = 2,
+    /** Rowing (0x0003) */
+    Rowing = 3,
+    /** Damper (0x0004) */
+    Damper = 4,
+    /** Custom Curves (0x0006) */
+    CustomCurves = 6,
+    /** Isokinetic (0x0007) */
+    Isokinetic = 7,
+    /** Isometric (0x0008) */
+    Isometric = 8
+}
+/**
+ * Human-readable training mode names.
+ */
+export declare const TrainingModeNames: Record<TrainingMode, string>;
+/**
+ * Valid training mode values (for validation).
+ */
+export declare const VALID_TRAINING_MODES: readonly TrainingMode[];
+//# sourceMappingURL=enums.d.ts.map

package/dist/types/voltra/protocol/constants/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/constants/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,oBAAY,aAAa;IACvB,IAAI,IAAI,CAAE,iCAAiC;IAC3C,UAAU,IAAI,CAAE,qEAAqE;IACrF,IAAI,IAAI,CAAE,2DAA2D;IACrE,SAAS,IAAI,CAAE,uEAAuE;IACtF,OAAO,KAAK;CACb;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAMpD,CAAC;AAMF;;;GAGG;AACH,oBAAY,WAAW;IACrB,0BAA0B;IAC1B,WAAW,QAAS;IACpB,wBAAwB;IACxB,MAAM,QAAS;IACf,2BAA2B;IAC3B,SAAS,QAAS;IAClB,oBAAoB;IACpB,aAAa,QAAS;IACtB,gCAAgC;IAChC,cAAc,QAAS;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMtD,CAAC;AAMF;;;GAGG;AACH,oBAAY,YAAY;IACtB,oBAAoB;IACpB,IAAI,IAAS;IACb,+BAA+B;IAC/B,cAAc,IAAS;IACvB,+BAA+B;IAC/B,cAAc,IAAS;IACvB,sBAAsB;IACtB,MAAM,IAAS;IACf,sBAAsB;IACtB,MAAM,IAAS;IACf,6BAA6B;IAC7B,YAAY,IAAS;IACrB,0BAA0B;IAC1B,UAAU,IAAS;IACnB,yBAAyB;IACzB,SAAS,IAAS;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAS1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,YAAY,EAS9C,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Protocol Constants
+ *
+ * Re-exports all protocol constants from focused modules.
+ * Import from this barrel to keep existing import paths working.
+ */
+export { BLE } from './ble-config';
+export { Timing } from './timing';
+export { Auth, Init, Workout } from './connection-commands';
+export { MessageTypes, TelemetryOffsets, NotificationConfigs, ParamIdHex, TrainingModeValues, } from './message-types';
+export { MovementPhase, PhaseNames, ParameterId, ParameterNames, TrainingMode, TrainingModeNames, VALID_TRAINING_MODES, } from './enums';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/types/voltra/protocol/constants/message-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Message Types & Telemetry Configuration
+ *
+ * Notification message identifiers, telemetry byte offsets,
+ * notification parsing configs, and parameter ID mappings.
+ * All values loaded from protocol.json for single source of truth.
+ */
+/**
+ * Message type identifiers (first 4 bytes of notifications).
+ */
+export declare const MessageTypes: {
+    /** Real-time telemetry stream (~11 Hz) */
+    readonly TELEMETRY_STREAM: Uint8Array<ArrayBufferLike>;
+    /** Rep completion summary */
+    readonly REP_SUMMARY: Uint8Array<ArrayBufferLike>;
+    /** Set completion summary */
+    readonly SET_SUMMARY: Uint8Array<ArrayBufferLike>;
+    /** Status update */
+    readonly STATUS_UPDATE: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * Byte offsets for parsing telemetry stream messages.
+ */
+export declare const TelemetryOffsets: {
+    readonly SEQUENCE: number;
+    readonly PHASE: number;
+    readonly POSITION: number;
+    readonly FORCE: number;
+    readonly VELOCITY: number;
+};
+/**
+ * Notification parsing configurations loaded from protocol.json.
+ * Used to parse various notification types from the device.
+ */
+export declare const NotificationConfigs: import("../types").NotificationsConfig;
+/**
+ * Parameter IDs as hex strings (for matching in notifications).
+ */
+export declare const ParamIdHex: {
+    readonly BASE_WEIGHT: string;
+    readonly CHAINS: string;
+    readonly ECCENTRIC: string;
+    readonly TRAINING_MODE: string;
+    readonly INVERSE_CHAINS: string;
+    readonly UNKNOWN_893E: string;
+};
+/**
+ * Training mode values from protocol.json.
+ * These map to the TrainingMode enum values.
+ */
+export declare const TrainingModeValues: import("../types").TrainingModesConfig;
+//# sourceMappingURL=message-types.d.ts.map

package/dist/types/voltra/protocol/constants/message-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-types.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/constants/message-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,0CAA0C;;IAE1C,6BAA6B;;IAE7B,6BAA6B;;IAE7B,oBAAoB;;CAEZ,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,wCAAmC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wCAAmC,CAAC"}

package/dist/types/voltra/protocol/constants/timing.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Timing Configuration
+ *
+ * Delays and timeouts for device communication.
+ */
+export declare const Timing: {
+    /** Delay between init commands (ms) */
+    readonly INIT_COMMAND_DELAY_MS: 20;
+    /** Delay between dual commands like chains/eccentric (ms) */
+    readonly DUAL_COMMAND_DELAY_MS: 500;
+    /** Timeout for authentication response (ms) */
+    readonly AUTH_TIMEOUT_MS: 3000;
+    /** Minimum responses expected during auth */
+    readonly MIN_AUTH_RESPONSES: 2;
+    /** Minimum responses expected after commands */
+    readonly MIN_COMMAND_RESPONSES: 4;
+};
+//# sourceMappingURL=timing.d.ts.map

package/dist/types/voltra/protocol/constants/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/constants/timing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,MAAM;IACjB,uCAAuC;;IAEvC,6DAA6D;;IAE7D,+CAA+C;;IAE/C,6CAA6C;;IAE7C,gDAAgD;;CAExC,CAAC"}

package/dist/types/voltra/protocol/data/protocol-data.generated.d.ts

@@ -0,0 +1,3 @@
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=protocol-data.generated.d.ts.map

package/dist/types/voltra/protocol/data/protocol-data.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-data.generated.d.ts","sourceRoot":"","sources":["../../../../../src/voltra/protocol/data/protocol-data.generated.ts"],"names":[],"mappings":";AAIA,wBAEE"}

package/dist/types/voltra/protocol/telemetry-decoder.d.ts

@@ -3,14 +3,18 @@
  *
  * Low-level protocol decoder for Voltra BLE telemetry notifications.
  * Only handles parsing bytes into typed data - no business logic.
+ * Uses offset-based lookups from protocol.json - no hardcoded byte positions.
  */
+import { TrainingMode } from './constants';
 import { type TelemetryFrame } from '../models/telemetry/frame';
+import type { DeviceSettings } from './types';
 /**
  * Types of messages that can be decoded.
  */
-export type MessageType = 'telemetry_stream' | 'rep_summary' | 'set_summary' | 'status_update' | 'unknown';
+export type MessageType = 'telemetry_stream' | 'rep_summary' | 'set_summary' | 'status_update' | 'mode_confirmation' | 'multi_param' | 'settings_update' | 'device_init' | 'unknown';
 /**
  * Identify the message type from raw bytes.
+ * Uses header matching from protocol.json configurations.
  */
 export declare function identifyMessageType(data: Uint8Array): MessageType;
 /**
@@ -24,7 +28,16 @@ export type DecodeResult = {
 } | {
     type: 'set_boundary';
 } | {
-    type: 'status';
+    type: 'mode_confirmation';
+    mode: TrainingMode;
+} | {
+    type: 'settings_update';
+    settings: DeviceSettings;
+} | {
+    type: 'device_status';
+    battery: number;
+} | {
+    type: 'unknown';
     data: Uint8Array;
 } | null;
 /**

package/dist/types/voltra/protocol/telemetry-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-decoder.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/telemetry-decoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA4C7E;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,eAAe,GACf,SAAS,CAAC;AAEd;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAgBjE;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACpC,IAAI,CAAC;AAMT;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAuB5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAuBjE;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAyBtE"}
+{"version":3,"file":"telemetry-decoder.d.ts","sourceRoot":"","sources":["../../../../src/voltra/protocol/telemetry-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAML,YAAY,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2C9C;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,SAAS,CAAC;AAEd;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAgCjE;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACrC,IAAI,CAAC;AAMT;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAuB5E;AAqGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CA+BjE;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CA0BtE"}

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

@@ -0,0 +1,247 @@
+/**
+ * TypeScript types for the consolidated protocol.json structure.
+ *
+ * These types define the shape of the public protocol data used for
+ * command lookup and notification parsing.
+ */
+import type { TrainingMode } from './constants';
+/**
+ * Root protocol data structure.
+ */
+export interface ProtocolData {
+    /** Protocol version (semver) */
+    version: string;
+    /** BLE configuration */
+    ble: BleConfig;
+    /** Command definitions */
+    commands: CommandConfig;
+    /** Telemetry parsing configuration */
+    telemetry: TelemetryConfig;
+}
+/**
+ * BLE service and characteristic UUIDs.
+ */
+export interface BleConfig {
+    /** Main service UUID for Voltra devices */
+    serviceUuid: string;
+    /** Characteristic UUID for receiving notifications */
+    notifyCharUuid: string;
+    /** Characteristic UUID for writing commands */
+    writeCharUuid: string;
+    /** Device name prefix for scanning (e.g., "VTR-") */
+    deviceNamePrefix: string;
+}
+/**
+ * All command definitions.
+ */
+export interface CommandConfig {
+    /** Authentication commands */
+    auth: AuthCommands;
+    /** Initialization sequence */
+    init: string[];
+    /** Workout control commands */
+    workout: WorkoutCommands;
+    /** Training mode commands (mode name -> hex string) */
+    modes: ModeCommands;
+    /** Weight commands (lbs -> hex string) */
+    weights: Record<string, string>;
+    /** Chains commands (lbs -> hex string) */
+    chains: Record<string, string>;
+    /** Eccentric commands (value -> hex string) */
+    eccentric: Record<string, string>;
+    /** Inverse chains commands (lbs -> hex string) */
+    inverseChains: Record<string, string>;
+}
+/**
+ * Training mode commands.
+ */
+export interface ModeCommands {
+    /** Idle mode (0x0000) */
+    idle: string;
+    /** Weight training mode (0x0001) */
+    weightTraining: string;
+    /** Resistance band mode (0x0002) */
+    resistanceBand: string;
+    /** Rowing mode (0x0003) */
+    rowing: string;
+    /** Damper mode (0x0004) */
+    damper: string;
+    /** Custom curves mode (0x0006) */
+    customCurves: string;
+    /** Isokinetic mode (0x0007) */
+    isokinetic: string;
+    /** Isometric mode (0x0008) */
+    isometric: string;
+}
+/**
+ * Authentication device IDs.
+ */
+export interface AuthCommands {
+    /** iPhone device ID (41-byte hex) */
+    iphone: string;
+    /** iPad device ID (41-byte hex) */
+    ipad: string;
+}
+/**
+ * Workout control commands.
+ */
+export interface WorkoutCommands {
+    /** Prepare for workout */
+    prepare: string;
+    /** Setup workout mode */
+    setup: string;
+    /** Start resistance (go) */
+    go: string;
+    /** Stop resistance */
+    stop: string;
+}
+/**
+ * Telemetry parsing configuration.
+ */
+export interface TelemetryConfig {
+    /** Message type identifiers (first 4 bytes) */
+    messageTypes: MessageTypeConfig;
+    /** Byte offsets for parsing telemetry stream */
+    offsets: OffsetConfig;
+    /** Movement phase values */
+    phases: PhaseConfig;
+    /** Notification type parsing configurations */
+    notifications: NotificationsConfig;
+    /** Known parameter IDs */
+    paramIds: ParamIdsConfig;
+    /** Training mode values */
+    trainingModes: TrainingModesConfig;
+}
+/**
+ * Message type header bytes (4-byte hex strings).
+ */
+export interface MessageTypeConfig {
+    /** Real-time telemetry stream (~11 Hz) */
+    stream: string;
+    /** Rep completion summary */
+    repSummary: string;
+    /** Set completion summary */
+    setSummary: string;
+    /** Status update */
+    statusUpdate: string;
+}
+/**
+ * Byte offsets for parsing telemetry stream messages.
+ */
+export interface OffsetConfig {
+    /** Sequence number (2 bytes, little-endian) */
+    sequence: number;
+    /** Movement phase (1 byte) */
+    phase: number;
+    /** Position (2 bytes, little-endian unsigned) */
+    position: number;
+    /** Force (2 bytes, little-endian signed) */
+    force: number;
+    /** Velocity (2 bytes, little-endian unsigned) */
+    velocity: number;
+}
+/**
+ * Movement phase byte values.
+ */
+export interface PhaseConfig {
+    /** Idle state */
+    idle: number;
+    /** Concentric phase (pulling/muscle shortening) */
+    concentric: number;
+    /** Hold phase (top of rep/transition) */
+    hold: number;
+    /** Eccentric phase (lowering/muscle lengthening) */
+    eccentric: number;
+}
+/**
+ * Configuration for parsing a specific notification type.
+ */
+export interface NotificationTypeConfig {
+    /** Header bytes to identify this notification type (hex string) */
+    header: string;
+    /** Expected message length in bytes */
+    length?: number;
+    /** Offset of parameter ID field */
+    paramIdOffset?: number;
+    /** Offset of value field */
+    valueOffset?: number;
+    /** Offset of integrity check value */
+    crcOffset?: number;
+    /** Offset of parameter count field (for multi-param messages) */
+    paramCountOffset?: number;
+    /** Offset of first parameter (for multi-param messages) */
+    firstParamOffset?: number;
+    /** Size of each param+value pair in bytes */
+    paramSize?: number;
+    /** Offset of battery level field */
+    batteryOffset?: number;
+}
+/**
+ * All notification type configurations.
+ */
+export interface NotificationsConfig {
+    /** Mode change confirmation (0x12) */
+    modeConfirmation: NotificationTypeConfig;
+    /** Multi-parameter message (0x16) */
+    multiParam: NotificationTypeConfig;
+    /** Settings update with all parameters (0x2e) */
+    settingsUpdate: NotificationTypeConfig;
+    /** Device initialization info (0x23) */
+    deviceInit: NotificationTypeConfig;
+    /** Status/battery update (0x34) */
+    statusBattery: NotificationTypeConfig;
+}
+/**
+ * Known parameter IDs (hex strings, little-endian).
+ */
+export interface ParamIdsConfig {
+    /** Base weight parameter (0x863e) */
+    baseWeight: string;
+    /** Chains weight parameter (0x873e) */
+    chains: string;
+    /** Eccentric setting parameter (0x883e) */
+    eccentric: string;
+    /** Training mode parameter (0xb04f) */
+    trainingMode: string;
+    /** Inverse chains parameter (0xb053) */
+    inverseChains: string;
+    /** Unknown parameter observed in notifications */
+    unknown893e: string;
+}
+/**
+ * Training mode values.
+ */
+export interface TrainingModesConfig {
+    /** Idle state */
+    idle: number;
+    /** Weight training mode */
+    weightTraining: number;
+    /** Resistance band mode */
+    resistanceBand: number;
+    /** Rowing mode */
+    rowing: number;
+    /** Damper mode */
+    damper: number;
+    /** Custom curves mode */
+    customCurves: number;
+    /** Isokinetic mode */
+    isokinetic: number;
+    /** Isometric mode */
+    isometric: number;
+}
+/**
+ * Parsed device settings from notifications.
+ */
+export interface DeviceSettings {
+    /** Base weight in lbs */
+    baseWeight?: number;
+    /** Chains weight in lbs */
+    chains?: number;
+    /** Eccentric setting */
+    eccentric?: number;
+    /** Current training mode */
+    trainingMode?: TrainingMode;
+    /** Inverse chains setting */
+    inverseChains?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltras/node-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "SDK for connecting to and controlling Voltra fitness devices",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -44,6 +44,7 @@
     "format:check": "prettier --check \"src/**/*.ts\"",
     "typecheck": "tsc --noEmit",
     "docs:api": "typedoc --out docs/api src/index.ts",
+    "generate:protocol": "npx tsx ../voltra-private/generators/encode-protocol.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build && npm run test",
     "prepare": "husky"
@@ -64,18 +65,18 @@
     "webbluetooth": "^3.4.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "^19.6.0",
-    "@commitlint/config-conventional": "^19.6.0",
-    "@types/node": "^20.0.0",
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@types/node": "^25.2.3",
     "@types/react": "^19.0.0",
     "@types/web-bluetooth": "^0.0.21",
     "@vitest/coverage-v8": "^4.0.0",
     "eslint": "^9.18.0",
     "husky": "^9.1.0",
-    "lint-staged": "^15.3.0",
+    "lint-staged": "^16.2.7",
     "prettier": "^3.4.0",
-    "typedoc": "^0.27.0",
-    "typescript": "~5.8.2",
+    "typedoc": "^0.28.17",
+    "typescript": "~5.9.3",
     "typescript-eslint": "^8.21.0",
     "vitest": "^4.0.17"
   },
@@ -106,6 +107,6 @@
   "author": "Voltra",
   "license": "MIT",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }