@voltras/node-sdk 0.1.0

package/dist/esm/sdk/voltra-manager.js

@@ -0,0 +1,415 @@
+/**
+ * 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 { filterVoltraDevices } from '../voltra/models/device-filter';
+import { BLE } from '../voltra/protocol/constants';
+import { VoltraClient } from './voltra-client';
+/**
+ * Main entry point for the Voltra SDK.
+ */
+export class VoltraManager {
+    constructor(options = {}) {
+        // Connected devices
+        this.clients = new Map();
+        this.clientUnsubscribes = new Map();
+        // Discovered devices (from last scan)
+        this.discoveredDevices = [];
+        // Scanning state
+        this._isScanning = false;
+        this.scanAdapter = null;
+        // Event listeners
+        this.listeners = new Set();
+        // Disposed flag
+        this.disposed = false;
+        this.clientOptions = options.clientOptions ?? {};
+        if (options.adapterFactory) {
+            // Use provided factory
+            this.adapterFactory = options.adapterFactory;
+            this.platform = options.platform ?? 'web';
+        }
+        else if (options.platform) {
+            // Use specified platform
+            this.platform = options.platform;
+            this.adapterFactory = this.createAdapterFactory(options.platform);
+        }
+        else {
+            // Auto-detect platform
+            this.platform = this.detectPlatform();
+            this.adapterFactory = this.createAdapterFactory(this.platform);
+        }
+    }
+    // ===========================================================================
+    // Static Factory Methods
+    // ===========================================================================
+    /**
+     * Create a manager for web browsers.
+     */
+    static forWeb(options) {
+        return new VoltraManager({ ...options, platform: 'web' });
+    }
+    /**
+     * Create a manager for Node.js.
+     */
+    static forNode(options) {
+        return new VoltraManager({ ...options, platform: 'node' });
+    }
+    /**
+     * Create a manager for React Native.
+     * Note: Prefer importing from '@voltras/node-sdk/native' instead.
+     */
+    static forNative(options) {
+        return new VoltraManager({ ...options, platform: 'native' });
+    }
+    // ===========================================================================
+    // Public Getters
+    // ===========================================================================
+    /**
+     * Get all connected device IDs.
+     */
+    get connectedDeviceIds() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Get number of connected devices.
+     */
+    get connectedCount() {
+        return this.clients.size;
+    }
+    /**
+     * Check if scanning is in progress.
+     */
+    get isScanning() {
+        return this._isScanning;
+    }
+    /**
+     * Get devices discovered in last scan.
+     */
+    get devices() {
+        return [...this.discoveredDevices];
+    }
+    // ===========================================================================
+    // Device Access
+    // ===========================================================================
+    /**
+     * Get a connected device client by ID.
+     */
+    getClient(deviceId) {
+        return this.clients.get(deviceId);
+    }
+    /**
+     * Get all connected device clients.
+     */
+    getAllClients() {
+        return Array.from(this.clients.values());
+    }
+    /**
+     * Check if a device is connected.
+     */
+    isConnected(deviceId) {
+        return this.clients.has(deviceId);
+    }
+    // ===========================================================================
+    // Discovery
+    // ===========================================================================
+    /**
+     * Scan for Voltra devices.
+     *
+     * @param options Scan options
+     * @returns Array of discovered Voltra devices
+     */
+    async scan(options = {}) {
+        this.ensureNotDisposed();
+        const { timeout = 10000, filterVoltra = true } = options;
+        this._isScanning = true;
+        this.emit({ type: 'scanStarted' });
+        try {
+            // Create adapter for scanning if needed
+            if (!this.scanAdapter) {
+                this.scanAdapter = this.adapterFactory();
+            }
+            const devices = await this.scanAdapter.scan(timeout);
+            this.discoveredDevices = filterVoltra ? filterVoltraDevices(devices) : devices;
+            this.emit({ type: 'scanStopped', devices: this.discoveredDevices });
+            return this.discoveredDevices;
+        }
+        finally {
+            this._isScanning = false;
+        }
+    }
+    // ===========================================================================
+    // Connection
+    // ===========================================================================
+    /**
+     * Connect to a Voltra device.
+     *
+     * @param device Device to connect to
+     * @returns VoltraClient for the connected device
+     */
+    async connect(device) {
+        this.ensureNotDisposed();
+        // Check if already connected
+        if (this.clients.has(device.id)) {
+            return this.clients.get(device.id);
+        }
+        // Create new adapter and client
+        const adapter = this.adapterFactory();
+        const client = new VoltraClient({
+            ...this.clientOptions,
+            adapter,
+        });
+        try {
+            await client.connect(device);
+            // Store client
+            this.clients.set(device.id, client);
+            // Subscribe to client events
+            const unsubscribe = client.subscribe((event) => {
+                this.handleClientEvent(device.id, event);
+            });
+            this.clientUnsubscribes.set(device.id, unsubscribe);
+            // Emit connected event
+            this.emit({
+                type: 'deviceConnected',
+                deviceId: device.id,
+                deviceName: device.name ?? null,
+                client,
+            });
+            return client;
+        }
+        catch (error) {
+            client.dispose();
+            throw error;
+        }
+    }
+    /**
+     * 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' });
+     * ```
+     */
+    async connectByName(namePattern, options = {}) {
+        this.ensureNotDisposed();
+        const { matchMode = 'contains', timeout = 10000, filterVoltra = true } = options;
+        // Scan for devices
+        const devices = await this.scan({ timeout, filterVoltra });
+        // Find matching device
+        const device = devices.find((d) => {
+            if (!d.name)
+                return false;
+            switch (matchMode) {
+                case 'exact':
+                    return d.name === namePattern;
+                case 'startsWith':
+                    return d.name.startsWith(namePattern);
+                case 'contains':
+                default:
+                    return d.name.includes(namePattern);
+            }
+        });
+        if (!device) {
+            throw new Error(`No Voltra device found matching "${namePattern}". ` +
+                `Found ${devices.length} device(s): ${devices.map((d) => d.name ?? d.id).join(', ') || 'none'}`);
+        }
+        return this.connect(device);
+    }
+    /**
+     * 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
+     */
+    async connectFirst(options = {}) {
+        const devices = await this.scan(options);
+        if (devices.length === 0) {
+            throw new Error('No Voltra devices found. Make sure your device is powered on.');
+        }
+        return this.connect(devices[0]);
+    }
+    /**
+     * Disconnect a specific device.
+     */
+    async disconnect(deviceId) {
+        const client = this.clients.get(deviceId);
+        if (!client)
+            return;
+        const unsubscribe = this.clientUnsubscribes.get(deviceId);
+        unsubscribe?.();
+        this.clientUnsubscribes.delete(deviceId);
+        await client.disconnect();
+        client.dispose();
+        this.clients.delete(deviceId);
+        this.emit({ type: 'deviceDisconnected', deviceId });
+    }
+    /**
+     * Disconnect all devices.
+     */
+    async disconnectAll() {
+        const deviceIds = Array.from(this.clients.keys());
+        await Promise.all(deviceIds.map((id) => this.disconnect(id)));
+    }
+    // ===========================================================================
+    // Event Subscriptions
+    // ===========================================================================
+    /**
+     * Subscribe to manager events.
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Subscribe to device connected events.
+     */
+    onDeviceConnected(callback) {
+        const listener = (event) => {
+            if (event.type === 'deviceConnected') {
+                callback(event.client, event.deviceId, event.deviceName);
+            }
+        };
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Subscribe to device disconnected events.
+     */
+    onDeviceDisconnected(callback) {
+        const listener = (event) => {
+            if (event.type === 'deviceDisconnected') {
+                callback(event.deviceId);
+            }
+        };
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    /**
+     * Dispose of the manager and all connected devices.
+     */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.disconnectAll().catch(() => { });
+        this.listeners.clear();
+        this.clientUnsubscribes.clear();
+        this.scanAdapter = null;
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    detectPlatform() {
+        // Check for browser environment
+        if (typeof window !== 'undefined' &&
+            typeof navigator !== 'undefined' &&
+            'bluetooth' in navigator) {
+            return 'web';
+        }
+        // Check for Node.js environment
+        if (typeof process !== 'undefined' && process.versions?.node) {
+            return 'node';
+        }
+        // Default to native (React Native)
+        // Note: This fallback may not work well - users should specify platform
+        return 'native';
+    }
+    createAdapterFactory(platform) {
+        switch (platform) {
+            case 'web':
+                return () => {
+                    // Dynamic import to avoid bundling issues
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    const { WebBLEAdapter } = require('../bluetooth/adapters/web');
+                    return new WebBLEAdapter({ ble: BLE });
+                };
+            case 'node':
+                return () => {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    const { NodeBLEAdapter } = require('../bluetooth/adapters/node');
+                    return new NodeBLEAdapter({ ble: BLE });
+                };
+            case 'native':
+                return () => {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    const { NativeBLEAdapter } = require('../bluetooth/adapters/native');
+                    return new NativeBLEAdapter({ ble: BLE });
+                };
+            default:
+                throw new Error(`Unknown platform: ${platform}`);
+        }
+    }
+    handleClientEvent(deviceId, event) {
+        switch (event.type) {
+            case 'disconnected':
+                if (this.clients.has(deviceId)) {
+                    const unsubscribe = this.clientUnsubscribes.get(deviceId);
+                    unsubscribe?.();
+                    this.clientUnsubscribes.delete(deviceId);
+                    const client = this.clients.get(deviceId);
+                    client?.dispose();
+                    this.clients.delete(deviceId);
+                    this.emit({ type: 'deviceDisconnected', deviceId });
+                }
+                break;
+            case 'error':
+                this.emit({ type: 'deviceError', deviceId, error: event.error });
+                break;
+        }
+    }
+    emit(event) {
+        this.listeners.forEach((listener) => {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error('[VoltraManager] Event listener error:', e);
+            }
+        });
+    }
+    ensureNotDisposed() {
+        if (this.disposed) {
+            throw new Error('Manager has been disposed');
+        }
+    }
+}
+//# sourceMappingURL=voltra-manager.js.map

package/dist/esm/sdk/voltra-manager.js.map

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

package/dist/esm/shared/index.js

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Shared Utilities
+ *
+ * Common utilities used across SDK modules.
+ */
+/**
+ * Delay execution for a specified duration.
+ * @param ms Duration in milliseconds
+ */
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Convert hex string to Uint8Array.
+ * @param hex Hex string (e.g., "48656c6c6f")
+ */
+export function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.substr(i * 2, 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Convert Uint8Array to hex string.
+ * @param bytes Byte array
+ */
+export function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * Check if two byte arrays are equal.
+ */
+export function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,CAAa;IACrD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/voltra/index.js

@@ -0,0 +1,26 @@
+/**
+ * Voltra Domain
+ *
+ * Voltra device management, telemetry processing, and workout control.
+ */
+// =============================================================================
+// Models
+// =============================================================================
+// Device model
+export { VoltraDevice, DEFAULT_SETTINGS, } from './models/device';
+// Connection model
+export { isValidVoltraTransition, VoltraConnectionStateModel, } from './models/connection';
+// Device filter
+export { VOLTRA_DEVICE_PREFIX, isVoltraDevice, filterVoltraDevices } from './models/device-filter';
+// Telemetry models
+export { createFrame, isActivePhase, isConcentricPhase, isEccentricPhase, } from './models/telemetry';
+// =============================================================================
+// Protocol
+// =============================================================================
+// Command builders
+export { WeightCommands, ChainsCommands, EccentricCommands, } from './protocol/commands';
+// Protocol constants
+export { MessageTypes, TelemetryOffsets, Timing, Auth, Init, Workout, BLE, MovementPhase, PhaseNames, } from './protocol/constants';
+// Telemetry decoder (low-level)
+export { decodeNotification, decodeTelemetryFrame, encodeTelemetryFrame, identifyMessageType, } from './protocol/telemetry-decoder';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voltra/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,eAAe;AACf,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAEL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEnG,mBAAmB;AACnB,OAAO,EAEL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,GAAG,EACH,aAAa,EACb,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,gCAAgC;AAChC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,8BAA8B,CAAC"}

package/dist/esm/voltra/models/connection.js

@@ -0,0 +1,63 @@
+/**
+ * Voltra Connection Model
+ *
+ * Voltra-specific connection state that includes the authentication step.
+ */
+/**
+ * Valid state transitions for Voltra connection.
+ */
+const VALID_VOLTRA_TRANSITIONS = {
+    disconnected: ['connecting'],
+    connecting: ['authenticating', 'disconnected'],
+    authenticating: ['connected', 'disconnected'],
+    connected: ['disconnected'],
+};
+/**
+ * Check if a Voltra state transition is valid.
+ */
+export function isValidVoltraTransition(from, to) {
+    return VALID_VOLTRA_TRANSITIONS[from].includes(to);
+}
+/**
+ * Voltra connection state model with validation.
+ */
+export class VoltraConnectionStateModel {
+    constructor() {
+        this._state = 'disconnected';
+    }
+    get state() {
+        return this._state;
+    }
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    get isConnecting() {
+        return this._state === 'connecting' || this._state === 'authenticating';
+    }
+    get isDisconnected() {
+        return this._state === 'disconnected';
+    }
+    /**
+     * Transition to a new state.
+     * @throws Error if transition is invalid
+     */
+    transitionTo(newState) {
+        if (!isValidVoltraTransition(this._state, newState)) {
+            throw new Error(`Invalid connection state transition: ${this._state} -> ${newState}`);
+        }
+        this._state = newState;
+    }
+    /**
+     * Force set state (for reconnection scenarios).
+     */
+    forceState(state) {
+        this._state = state;
+    }
+    /**
+     * Reset to disconnected state.
+     */
+    reset() {
+        this._state = 'disconnected';
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/esm/voltra/models/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/voltra/models/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,wBAAwB,GAA2D;IACvF,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,UAAU,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;IAC9C,cAAc,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;IAC7C,SAAS,EAAE,CAAC,cAAc,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAA2B,EAC3B,EAAyB;IAEzB,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,WAAM,GAA0B,cAAc,CAAC;IA0CzD,CAAC;IAxCC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;IACrC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC;IAC1E,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAA+B;QAC1C,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,MAAM,OAAO,QAAQ,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAA4B;QACrC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/voltra/models/device-filter.js

@@ -0,0 +1,23 @@
+/**
+ * Voltra Device Filter
+ *
+ * Utility functions for filtering Voltra devices from BLE scan results.
+ */
+import { BLE } from '../protocol/constants';
+/**
+ * Voltra device name prefix.
+ */
+export const VOLTRA_DEVICE_PREFIX = BLE.DEVICE_NAME_PREFIX;
+/**
+ * Check if a device is a Voltra device.
+ */
+export function isVoltraDevice(device) {
+    return device.name?.startsWith(VOLTRA_DEVICE_PREFIX) ?? false;
+}
+/**
+ * Filter Voltra devices from a list.
+ */
+export function filterVoltraDevices(devices) {
+    return devices.filter(isVoltraDevice);
+}
+//# sourceMappingURL=device-filter.js.map

package/dist/esm/voltra/models/device-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-filter.js","sourceRoot":"","sources":["../../../../src/voltra/models/device-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,OAAO,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACxC,CAAC"}