@voltras/node-sdk 0.1.0

package/dist/esm/react/hooks.js

@@ -0,0 +1,257 @@
+/**
+ * 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 { useState, useEffect, useCallback } from 'react';
+/**
+ * Hook for scanning for Voltra devices.
+ *
+ * @param manager VoltraManager instance
+ * @returns Scanner state and controls
+ */
+export function useVoltraScanner(manager) {
+    const [devices, setDevices] = useState([]);
+    const [isScanning, setIsScanning] = useState(false);
+    const [error, setError] = useState(null);
+    // Sync with manager's scan state
+    useEffect(() => {
+        if (!manager)
+            return;
+        const unsubscribe = manager.subscribe((event) => {
+            switch (event.type) {
+                case 'scanStarted':
+                    setIsScanning(true);
+                    setError(null);
+                    break;
+                case 'scanStopped':
+                    setIsScanning(false);
+                    setDevices(event.devices);
+                    break;
+            }
+        });
+        // Sync initial state
+        setDevices(manager.devices);
+        setIsScanning(manager.isScanning);
+        return unsubscribe;
+    }, [manager]);
+    const scan = useCallback(async (options) => {
+        if (!manager) {
+            const err = new Error('No manager provided');
+            setError(err);
+            throw err;
+        }
+        try {
+            return await manager.scan(options);
+        }
+        catch (e) {
+            const err = e instanceof Error ? e : new Error(String(e));
+            setError(err);
+            throw err;
+        }
+    }, [manager]);
+    const clear = useCallback(() => {
+        setDevices([]);
+        setError(null);
+    }, []);
+    return { devices, isScanning, error, scan, clear };
+}
+const DEFAULT_SETTINGS = {
+    weight: 0,
+    chains: 0,
+    eccentric: 0,
+};
+const DEFAULT_STATE = {
+    connectionState: 'disconnected',
+    isConnected: false,
+    recordingState: 'idle',
+    isRecording: false,
+    settings: DEFAULT_SETTINGS,
+    currentFrame: null,
+    error: null,
+};
+/**
+ * Hook for observing a Voltra device's state.
+ *
+ * @param client VoltraClient instance (or null if not connected)
+ * @returns Device state
+ */
+export function useVoltraDevice(client) {
+    const [state, setState] = useState(DEFAULT_STATE);
+    useEffect(() => {
+        if (!client) {
+            setState(DEFAULT_STATE);
+            return;
+        }
+        // Initial state from client
+        setState({
+            connectionState: client.connectionState,
+            isConnected: client.isConnected,
+            recordingState: client.recordingState,
+            isRecording: client.isRecording,
+            settings: client.settings,
+            currentFrame: null,
+            error: client.error,
+        });
+        // Subscribe to client events
+        const unsubscribe = client.subscribe((event) => {
+            switch (event.type) {
+                case 'connectionStateChanged':
+                    setState((prev) => ({
+                        ...prev,
+                        connectionState: event.state,
+                        isConnected: event.state === 'connected',
+                    }));
+                    break;
+                case 'recordingStateChanged':
+                    setState((prev) => ({
+                        ...prev,
+                        recordingState: event.state,
+                        isRecording: event.state === 'active',
+                    }));
+                    break;
+                case 'frame':
+                    setState((prev) => ({ ...prev, currentFrame: event.frame }));
+                    break;
+                case 'error':
+                    setState((prev) => ({ ...prev, error: event.error }));
+                    break;
+                case 'connected':
+                    setState((prev) => ({
+                        ...prev,
+                        settings: client.settings,
+                        error: null,
+                    }));
+                    break;
+                case 'disconnected':
+                    setState(DEFAULT_STATE);
+                    break;
+            }
+        });
+        return unsubscribe;
+    }, [client]);
+    return state;
+}
+/**
+ * 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 function useVoltra(manager) {
+    const [client, setClient] = useState(null);
+    const scanner = useVoltraScanner(manager);
+    const device = useVoltraDevice(client);
+    // Listen for device connections/disconnections
+    useEffect(() => {
+        if (!manager)
+            return;
+        const unsubConnect = manager.onDeviceConnected((connectedClient) => {
+            setClient(connectedClient);
+        });
+        const unsubDisconnect = manager.onDeviceDisconnected(() => {
+            setClient(null);
+        });
+        return () => {
+            unsubConnect();
+            unsubDisconnect();
+        };
+    }, [manager]);
+    const connect = useCallback(async (deviceToConnect) => {
+        if (!manager)
+            throw new Error('No manager provided');
+        const connectedClient = await manager.connect(deviceToConnect);
+        setClient(connectedClient);
+        return connectedClient;
+    }, [manager]);
+    const disconnect = useCallback(async () => {
+        if (!client)
+            return;
+        await client.disconnect();
+        setClient(null);
+    }, [client]);
+    // Shorthand methods
+    const setWeight = useCallback(async (lbs) => {
+        if (!client)
+            throw new Error('Not connected');
+        await client.setWeight(lbs);
+    }, [client]);
+    const setChains = useCallback(async (lbs) => {
+        if (!client)
+            throw new Error('Not connected');
+        await client.setChains(lbs);
+    }, [client]);
+    const setEccentric = useCallback(async (percent) => {
+        if (!client)
+            throw new Error('Not connected');
+        await client.setEccentric(percent);
+    }, [client]);
+    const startRecording = useCallback(async () => {
+        if (!client)
+            throw new Error('Not connected');
+        await client.startRecording();
+    }, [client]);
+    const stopRecording = useCallback(async () => {
+        if (!client)
+            throw new Error('Not connected');
+        await client.stopRecording();
+    }, [client]);
+    return {
+        // Scanner state
+        ...scanner,
+        // Device state
+        ...device,
+        // Client reference
+        client,
+        // Actions
+        connect,
+        disconnect,
+        setWeight,
+        setChains,
+        setEccentric,
+        startRecording,
+        stopRecording,
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/esm/react/hooks.js.map

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

package/dist/esm/react/index.js

@@ -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, } from './hooks';
+//# sourceMappingURL=index.js.map

package/dist/esm/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,GAIV,MAAM,SAAS,CAAC"}

package/dist/esm/sdk/index.js

@@ -0,0 +1,9 @@
+/**
+ * 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';
+//# sourceMappingURL=index.js.map

package/dist/esm/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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"}

package/dist/esm/sdk/types.js

@@ -0,0 +1,7 @@
+/**
+ * SDK Types
+ *
+ * Types for the high-level VoltraClient API.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}