react-native-ble-mesh 2.1.0 → 2.1.3

package/src/crypto/providers/QuickCryptoProvider.js

@@ -10,10 +10,40 @@
 
 const CryptoProvider = require('../CryptoProvider');
 
+/**
+ * Converts a hex string to Uint8Array (Buffer-free for React Native compatibility)
+ * @param {string} hex - Hex string
+ * @returns {Uint8Array}
+ */
+function hexToBytes(hex) {
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < hex.length; i += 2) {
+    bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
+  }
+  return bytes;
+}
+
+/**
+ * Concatenates multiple Uint8Arrays into a single Uint8Array
+ * @param {...Uint8Array} arrays
+ * @returns {Uint8Array}
+ */
+function concatBytes(...arrays) {
+  let totalLength = 0;
+  for (const arr of arrays) { totalLength += arr.length; }
+  const result = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const arr of arrays) {
+    result.set(arr, offset);
+    offset += arr.length;
+  }
+  return result;
+}
+
 /** DER header for PKCS8 private key wrapping (X25519) */
-const PKCS8_HEADER = Buffer.from('302e020100300506032b656e04220420', 'hex');
+const PKCS8_HEADER = hexToBytes('302e020100300506032b656e04220420');
 /** DER header for SPKI public key wrapping (X25519) */
-const SPKI_HEADER = Buffer.from('302a300506032b656e032100', 'hex');
+const SPKI_HEADER = hexToBytes('302a300506032b656e032100');
 
 /**
  * Crypto provider using react-native-quick-crypto.
@@ -25,7 +55,9 @@ const SPKI_HEADER = Buffer.from('302a300506032b656e032100', 'hex');
 class QuickCryptoProvider extends CryptoProvider {
   constructor(options = {}) {
     super();
-    this._crypto = options.crypto || null;
+    /** @type {any} */
+    const opts = options;
+    this._crypto = opts.crypto || null;
     this._nacl = null;
   }
 
@@ -36,6 +68,7 @@ class QuickCryptoProvider extends CryptoProvider {
   _getCrypto() {
     if (!this._crypto) {
       try {
+        // @ts-ignore
         this._crypto = require('react-native-quick-crypto');
       } catch (e) {
         throw new Error(
@@ -57,21 +90,21 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  sharedSecret(secretKey, publicKey) {
+  sharedSecret(/** @type {any} */ secretKey, /** @type {any} */ publicKey) {
     const crypto = this._getCrypto();
     const privKey = crypto.createPrivateKey({
-      key: Buffer.concat([
+      key: concatBytes(
         PKCS8_HEADER,
-        Buffer.from(secretKey)
-      ]),
+        new Uint8Array(secretKey)
+      ),
       format: 'der',
       type: 'pkcs8'
     });
     const pubKey = crypto.createPublicKey({
-      key: Buffer.concat([
+      key: concatBytes(
         SPKI_HEADER,
-        Buffer.from(publicKey)
-      ]),
+        new Uint8Array(publicKey)
+      ),
       format: 'der',
       type: 'spki'
     });
@@ -81,12 +114,13 @@ class QuickCryptoProvider extends CryptoProvider {
 
   /**
    * Lazily loads tweetnacl (cached)
-   * @returns {Object} nacl module
+   * @returns {any} nacl module
    * @private
    */
   _getNacl() {
     if (!this._nacl) {
       try {
+        // @ts-ignore
         this._nacl = require('tweetnacl');
       } catch (e) {
         throw new Error(
@@ -98,7 +132,7 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  encrypt(key, nonce, plaintext, _ad) {
+  encrypt(/** @type {any} */ key, /** @type {any} */ nonce, /** @type {any} */ plaintext, /** @type {any} */ _ad) {
     // Use tweetnacl for encryption to ensure cross-provider compatibility
     // QuickCrypto's advantage is in fast native key generation (X25519), not AEAD
     const nacl = this._getNacl();
@@ -114,7 +148,7 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  decrypt(key, nonce, ciphertext, _ad) {
+  decrypt(/** @type {any} */ key, /** @type {any} */ nonce, /** @type {any} */ ciphertext, /** @type {any} */ _ad) {
     const nacl = this._getNacl();
 
     // Ensure 24-byte nonce for XSalsa20-Poly1305
@@ -132,7 +166,7 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  hash(data) {
+  hash(/** @type {any} */ data) {
     // Use SHA-512 truncated to 32 bytes for cross-provider compatibility
     const nacl = this._getNacl();
     const full = nacl.hash(data); // SHA-512
@@ -140,13 +174,14 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  randomBytes(length) {
+  randomBytes(/** @type {any} */ length) {
     const crypto = this._getCrypto();
     return new Uint8Array(crypto.randomBytes(length));
   }
 
   static isAvailable() {
     try {
+      // @ts-ignore
       require('react-native-quick-crypto');
       return true;
     } catch (e) {

package/src/crypto/providers/TweetNaClProvider.js

@@ -20,7 +20,7 @@ const CryptoProvider = require('../CryptoProvider');
 class TweetNaClProvider extends CryptoProvider {
   /**
    * @param {Object} [options={}]
-   * @param {Object} [options.nacl] - Injected tweetnacl instance (for testing)
+   * @param {any} [options.nacl] - Injected tweetnacl instance (for testing)
    */
   constructor(options = {}) {
     super();
@@ -33,12 +33,13 @@ class TweetNaClProvider extends CryptoProvider {
 
   /**
    * Lazily loads tweetnacl
-   * @returns {Object} nacl module
+   * @returns {any} nacl module
    * @private
    */
   _getNacl() {
     if (!this._nacl) {
       try {
+        // @ts-ignore
         this._nacl = require('tweetnacl');
       } catch (e) {
         throw new Error(
@@ -57,13 +58,13 @@ class TweetNaClProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  sharedSecret(secretKey, publicKey) {
+  sharedSecret(/** @type {any} */ secretKey, /** @type {any} */ publicKey) {
     const nacl = this._getNacl();
     return nacl.box.before(publicKey, secretKey);
   }
 
   /** @inheritdoc */
-  encrypt(key, nonce, plaintext, _ad) {
+  encrypt(/** @type {any} */ key, /** @type {any} */ nonce, /** @type {any} */ plaintext, /** @type {any} */ _ad) {
     const nacl = this._getNacl();
     // tweetnacl uses XSalsa20-Poly1305 with 24-byte nonce
     // nacl.secretbox includes authentication
@@ -79,7 +80,7 @@ class TweetNaClProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  decrypt(key, nonce, ciphertext, _ad) {
+  decrypt(/** @type {any} */ key, /** @type {any} */ nonce, /** @type {any} */ ciphertext, /** @type {any} */ _ad) {
     const nacl = this._getNacl();
 
     // Ensure 24-byte nonce (pad short nonces with zeros)
@@ -94,7 +95,7 @@ class TweetNaClProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  hash(data) {
+  hash(/** @type {any} */ data) {
     const nacl = this._getNacl();
     // tweetnacl provides SHA-512; we return first 32 bytes for SHA-256 compatibility
     const full = nacl.hash(data);
@@ -102,7 +103,7 @@ class TweetNaClProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  randomBytes(length) {
+  randomBytes(/** @type {any} */ length) {
     const nacl = this._getNacl();
     return nacl.randomBytes(length);
   }
@@ -113,6 +114,7 @@ class TweetNaClProvider extends CryptoProvider {
    */
   static isAvailable() {
     try {
+      // @ts-ignore
       require('tweetnacl');
       return true;
     } catch (e) {

package/src/errors/AudioError.js

@@ -32,7 +32,7 @@ class AudioError extends MeshError {
    * @returns {AudioError}
    */
   static fromCode(code, details = null) {
-    const message = ERROR_MESSAGES[code] || 'Audio operation failed';
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || 'Audio operation failed';
     return new AudioError(message, code, details);
   }
 
@@ -73,6 +73,7 @@ class AudioError extends MeshError {
     return new AudioError(
       `Audio session failed with peer ${peerId}`,
       'EA04',
+      // @ts-ignore
       { peerId, ...details }
     );
   }

package/src/errors/ConnectionError.js

@@ -40,7 +40,7 @@ class ConnectionError extends MeshError {
    * @returns {ConnectionError} New ConnectionError instance
    */
   static fromCode(code, peerId = null, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E200;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E200;
     return new ConnectionError(message, code, peerId, details);
   }
 
@@ -96,7 +96,7 @@ class ConnectionError extends MeshError {
 
   /**
    * Converts error to a JSON-serializable object
-   * @returns {Object} JSON representation of the error
+   * @returns {any} JSON representation of the error
    */
   toJSON() {
     return {

package/src/errors/CryptoError.js

@@ -32,7 +32,7 @@ class CryptoError extends MeshError {
    * @returns {CryptoError} New CryptoError instance
    */
   static fromCode(code, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E400;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E400;
     return new CryptoError(message, code, details);
   }
 

package/src/errors/HandshakeError.js

@@ -48,7 +48,7 @@ class HandshakeError extends MeshError {
    * @returns {HandshakeError} New HandshakeError instance
    */
   static fromCode(code, peerId = null, step = null, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E300;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E300;
     return new HandshakeError(message, code, peerId, step, details);
   }
 
@@ -108,7 +108,7 @@ class HandshakeError extends MeshError {
 
   /**
    * Converts error to a JSON-serializable object
-   * @returns {Object} JSON representation of the error
+   * @returns {any} JSON representation of the error
    */
   toJSON() {
     return {

package/src/errors/MeshError.js

@@ -37,7 +37,7 @@ class MeshError extends Error {
 
     /**
      * Additional error details
-     * @type {Object|null}
+     * @type {any}
      */
     this.details = details;
 
@@ -60,7 +60,7 @@ class MeshError extends Error {
    * @returns {MeshError} New MeshError instance
    */
   static fromCode(code, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E900;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E900;
     return new MeshError(message, code, details);
   }
 
@@ -69,12 +69,12 @@ class MeshError extends Error {
    * @returns {string} Error type name
    */
   getTypeName() {
-    return ERROR_CODE[this.code] || 'UNKNOWN_ERROR';
+    return /** @type {Record<string, string>} */ (ERROR_CODE)[this.code] || 'UNKNOWN_ERROR';
   }
 
   /**
    * Converts error to a JSON-serializable object
-   * @returns {Object} JSON representation of the error
+   * @returns {any} JSON representation of the error
    */
   toJSON() {
     return {

package/src/errors/MessageError.js

@@ -40,7 +40,7 @@ class MessageError extends MeshError {
    * @returns {MessageError} New MessageError instance
    */
   static fromCode(code, messageId = null, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E500;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E500;
     return new MessageError(message, code, messageId, details);
   }
 
@@ -116,7 +116,7 @@ class MessageError extends MeshError {
 
   /**
    * Converts error to a JSON-serializable object
-   * @returns {Object} JSON representation of the error
+   * @returns {any} JSON representation of the error
    */
   toJSON() {
     return {

package/src/errors/ValidationError.js

@@ -87,7 +87,7 @@ class ValidationError extends MeshError {
    * @returns {ValidationError} New ValidationError instance
    */
   static fromCode(code, field = null, value = undefined, details = null) {
-    const message = ERROR_MESSAGES[code] || ERROR_MESSAGES.E800;
+    const message = /** @type {Record<string, string>} */ (ERROR_MESSAGES)[code] || /** @type {Record<string, string>} */ (ERROR_MESSAGES).E800;
     return new ValidationError(message, code, field, value, details);
   }
 
@@ -127,7 +127,7 @@ class ValidationError extends MeshError {
    * Creates an out of range error
    * @param {string} field - Name of the field
    * @param {*} value - The invalid value
-   * @param {Object} range - Expected range { min, max }
+   * @param {any} range - Expected range { min, max }
    * @returns {ValidationError} New ValidationError instance
    */
   static outOfRange(field, value, range) {
@@ -136,7 +136,7 @@ class ValidationError extends MeshError {
 
   /**
    * Converts error to a JSON-serializable object
-   * @returns {Object} JSON representation of the error
+   * @returns {any} JSON representation of the error
    */
   toJSON() {
     return {

package/src/expo/withBLEMesh.js

@@ -22,7 +22,7 @@
 
 /**
  * Default configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_OPTIONS = {
   /** iOS NSBluetoothAlwaysUsageDescription */
@@ -40,9 +40,9 @@ const DEFAULT_OPTIONS = {
 
 /**
  * Modifies the iOS Info.plist for BLE permissions.
- * @param {Object} config - Expo config
- * @param {Object} options - Plugin options
- * @returns {Object} Modified config
+ * @param {any} config - Expo config
+ * @param {any} options - Plugin options
+ * @returns {any} Modified config
  */
 function withBLEMeshIOS(config, options) {
   const opts = { ...DEFAULT_OPTIONS, ...options };
@@ -64,9 +64,9 @@ function withBLEMeshIOS(config, options) {
 
 /**
  * Modifies the Android manifest for BLE permissions.
- * @param {Object} config - Expo config
- * @param {Object} options - Plugin options
- * @returns {Object} Modified config
+ * @param {any} config - Expo config
+ * @param {any} options - Plugin options
+ * @returns {any} Modified config
  */
 function withBLEMeshAndroid(config, options) {
   const opts = { ...DEFAULT_OPTIONS, ...options };
@@ -86,9 +86,9 @@ function withBLEMeshAndroid(config, options) {
 
 /**
  * Main Expo config plugin.
- * @param {Object} config - Expo config
- * @param {Object} [options={}] - Plugin options
- * @returns {Object} Modified config
+ * @param {any} config - Expo config
+ * @param {any} [options={}] - Plugin options
+ * @returns {any} Modified config
  */
 function withBLEMesh(config, options = {}) {
   config = withBLEMeshIOS(config, options);

package/src/hooks/AppStateManager.js

@@ -1,4 +1,5 @@
 'use strict';
+/* global __DEV__ */
 
 /**
  * @fileoverview React Native app state management for mesh service
@@ -22,7 +23,7 @@
 class AppStateManager {
   /**
    * Creates a new AppStateManager
-   * @param {MeshService} mesh - MeshService instance to manage
+   * @param {any} mesh - MeshService instance to manage
    * @param {Object} [options] - Configuration options
    * @param {string} [options.backgroundMode='ULTRA_POWER_SAVER'] - Power mode for background
    * @param {string} [options.foregroundMode='BALANCED'] - Power mode for foreground
@@ -58,11 +59,12 @@ class AppStateManager {
 
     // Try to get AppState from React Native
     try {
+      // @ts-ignore
       const { AppState } = require('react-native');
       this._AppState = AppState;
     } catch (e) {
       // React Native not available (Node.js environment)
-      console.warn('AppStateManager: React Native AppState not available');
+      // React Native not available (Node.js or test environment) — silently skip
       return false;
     }
 
@@ -121,7 +123,9 @@ class AppStateManager {
         this._mesh._saveState();
       }
     } catch (e) {
-      console.warn('AppStateManager: Error handling background transition', e);
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.warn('AppStateManager: Error handling background transition', e);
+      }
     }
   }
 
@@ -143,7 +147,9 @@ class AppStateManager {
         this._mesh._restoreState();
       }
     } catch (e) {
-      console.warn('AppStateManager: Error handling foreground transition', e);
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.warn('AppStateManager: Error handling foreground transition', e);
+      }
     }
   }
 

package/src/hooks/useMesh.js

@@ -9,10 +9,8 @@
  * React hook for managing MeshService lifecycle in React Native apps.
  * Handles initialization, cleanup, and state management.
  *
- * @param {Object} [config] - MeshService configuration
- * @param {string} [config.displayName] - Display name for this node
- * @param {Object} [config.storage] - Storage adapter
- * @returns {Object} Mesh state and controls
+ * @param {any} [config] - MeshService configuration
+ * @returns {any} Mesh state and controls
  *
  * @example
  * function App() {
@@ -35,6 +33,7 @@ function useMesh(config = {}) {
   // This hook requires React - check if available
   let React;
   try {
+    // @ts-ignore
     React = require('react');
   } catch (e) {
     throw new Error('useMesh requires React. Install react as a dependency.');
@@ -65,7 +64,7 @@ function useMesh(config = {}) {
   }, [config.displayName]);
 
   // Initialize mesh
-  const initialize = useCallback(async (transport) => {
+  const initialize = useCallback(async (/** @type {any} */ transport) => {
     try {
       if (!mountedRef.current) { return; }
       setState('initializing');
@@ -82,13 +81,14 @@ function useMesh(config = {}) {
       }
 
       // Setup state change listener
+      // @ts-ignore
       stateHandlerRef.current = ({ newState }) => {
         if (mountedRef.current) {
           setState(newState);
         }
       };
 
-      errorHandlerRef.current = (err) => {
+      errorHandlerRef.current = (/** @type {any} */ err) => {
         if (mountedRef.current) {
           setError(err);
         }
@@ -118,7 +118,7 @@ function useMesh(config = {}) {
   }, [getMesh, config.storage]);
 
   // Start with transport
-  const start = useCallback(async (transport) => {
+  const start = useCallback(async (/** @type {any} */ transport) => {
     const mesh = getMesh();
     try {
       await mesh.start(transport);

package/src/hooks/useMessages.js

@@ -9,10 +9,10 @@
  * React hook for sending and receiving messages in the mesh network.
  * Manages message state and provides send functions.
  *
- * @param {MeshService} mesh - MeshService instance
- * @param {Object} [options] - Options
- * @param {number} [options.maxMessages=100] - Maximum messages to keep in state
- * @returns {Object} Messages state and send functions
+ * @param {any} mesh - MeshService instance
+ * @param {any} [options] - Options
+   *
+ * @returns {any} Messages state and send functions
  *
  * @example
  * function Chat({ mesh, peerId }) {
@@ -38,6 +38,7 @@ function useMessages(mesh, options = {}) {
   // This hook requires React
   let React;
   try {
+    // @ts-ignore
     React = require('react');
   } catch (e) {
     throw new Error('useMessages requires React. Install react as a dependency.');
@@ -52,11 +53,11 @@ function useMessages(mesh, options = {}) {
   const messageIdRef = useRef(new Set());
 
   // Add message to state (with dedup)
-  const addMessage = useCallback((msg) => {
+  const addMessage = useCallback((/** @type {any} */ msg) => {
     if (messageIdRef.current.has(msg.id)) { return; }
     messageIdRef.current.add(msg.id);
 
-    setMessages(prev => {
+    setMessages((/** @type {any} */ prev) => {
       const updated = [msg, ...prev];
       if (updated.length > maxMessages) {
         for (let i = maxMessages; i < updated.length; i++) {
@@ -72,7 +73,7 @@ function useMessages(mesh, options = {}) {
   useEffect(() => {
     if (!mesh) { return; }
 
-    const handleBroadcast = (data) => {
+    const handleBroadcast = (/** @type {any} */ data) => {
       addMessage({
         id: data.messageId,
         type: 'broadcast',
@@ -83,7 +84,7 @@ function useMessages(mesh, options = {}) {
       });
     };
 
-    const handlePrivate = (data) => {
+    const handlePrivate = (/** @type {any} */ data) => {
       addMessage({
         id: data.messageId,
         type: 'private',
@@ -94,7 +95,7 @@ function useMessages(mesh, options = {}) {
       });
     };
 
-    const handleChannel = (data) => {
+    const handleChannel = (/** @type {any} */ data) => {
       addMessage({
         id: data.messageId,
         type: 'channel',
@@ -120,7 +121,7 @@ function useMessages(mesh, options = {}) {
   }, [mesh, addMessage]);
 
   // Send broadcast message
-  const sendBroadcast = useCallback((content) => {
+  const sendBroadcast = useCallback((/** @type {any} */ content) => {
     if (!mesh) { throw new Error('Mesh not initialized'); }
     setError(null);
 
@@ -142,7 +143,7 @@ function useMessages(mesh, options = {}) {
   }, [mesh, addMessage]);
 
   // Send private message
-  const sendPrivate = useCallback(async (peerId, content) => {
+  const sendPrivate = useCallback(async (/** @type {any} */ peerId, /** @type {any} */ content) => {
     if (!mesh) { throw new Error('Mesh not initialized'); }
     setError(null);
     setSending(true);
@@ -168,7 +169,7 @@ function useMessages(mesh, options = {}) {
   }, [mesh, addMessage]);
 
   // Send channel message
-  const sendToChannel = useCallback((channelId, content) => {
+  const sendToChannel = useCallback((/** @type {any} */ channelId, /** @type {any} */ content) => {
     if (!mesh) { throw new Error('Mesh not initialized'); }
     setError(null);
 

package/src/hooks/usePeers.js

@@ -9,8 +9,8 @@
  * React hook for managing and observing peers in the mesh network.
  * Automatically updates when peers connect, disconnect, or change state.
  *
- * @param {MeshService} mesh - MeshService instance
- * @returns {Object} Peers state and utilities
+ * @param {any} mesh - MeshService instance
+ * @returns {any} Peers state and utilities
  *
  * @example
  * function PeerList({ mesh }) {
@@ -30,6 +30,7 @@ function usePeers(mesh) {
   // This hook requires React
   let React;
   try {
+    // @ts-ignore
     React = require('react');
   } catch (e) {
     throw new Error('usePeers requires React. Install react as a dependency.');
@@ -45,8 +46,8 @@ function usePeers(mesh) {
     if (mesh) {
       try {
         const allPeers = mesh.getPeers();
-        setPeers(prev => {
-          if (prev.length === allPeers.length && prev.every((p, i) => p.id === allPeers[i]?.id && p.connectionState === allPeers[i]?.connectionState)) {
+        setPeers((/** @type {any} */ prev) => {
+          if (prev.length === allPeers.length && prev.every((/** @type {any} */ p, /** @type {any} */ i) => p.id === allPeers[i]?.id && p.connectionState === allPeers[i]?.connectionState)) {
             return prev;
           }
           return allPeers;
@@ -82,19 +83,19 @@ function usePeers(mesh) {
 
   // Computed values
   const connectedPeers = useMemo(() => {
-    return peers.filter(p => p.connectionState === 'connected' || p.connectionState === 'secured');
+    return peers.filter((/** @type {any} */ p) => p.connectionState === 'connected' || p.connectionState === 'secured');
   }, [peers]);
 
   const securedPeers = useMemo(() => {
-    return peers.filter(p => p.connectionState === 'secured');
+    return peers.filter((/** @type {any} */ p) => p.connectionState === 'secured');
   }, [peers]);
 
   // Get single peer by ID (O(1) lookup via peerMap)
-  const peerMap = useMemo(() => new Map(peers.map(p => [p.id, p])), [peers]);
-  const getPeer = useCallback((peerId) => peerMap.get(peerId), [peerMap]);
+  const peerMap = useMemo(() => new Map(peers.map((/** @type {any} */ p) => [p.id, p])), [peers]);
+  const getPeer = useCallback((/** @type {any} */ peerId) => peerMap.get(peerId), [peerMap]);
 
   // Check if peer is connected
-  const isConnected = useCallback((peerId) => {
+  const isConnected = useCallback((/** @type {any} */ peerId) => {
     const peer = getPeer(peerId);
     return peer && (peer.connectionState === 'connected' || peer.connectionState === 'secured');
   }, [getPeer]);