react-native-ble-mesh 2.1.0 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-ble-mesh",
-  "version": "2.1.0",
+  "version": "2.1.3",
   "description": "React Native Bluetooth Low Energy (BLE) mesh networking library with end-to-end encryption, offline messaging, peer-to-peer communication, and Noise Protocol security for iOS and Android",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -78,7 +78,8 @@
   "peerDependencies": {
     "react-native": ">=0.60.0",
     "react-native-get-random-values": ">=1.8.0",
-    "react-native-ble-plx": ">=2.0.0"
+    "react-native-ble-plx": ">=2.0.0",
+    "tweetnacl": ">=1.0.0"
   },
   "peerDependenciesMeta": {
     "react-native": {
@@ -86,6 +87,12 @@
     },
     "react-native-ble-plx": {
       "optional": true
+    },
+    "react-native-get-random-values": {
+      "optional": true
+    },
+    "tweetnacl": {
+      "optional": true
     }
   },
   "files": [

package/src/MeshNetwork.js

@@ -30,7 +30,7 @@ const _decoder = new TextDecoder();
 
 /**
  * Default MeshNetwork configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Display name for this node */
@@ -88,21 +88,21 @@ class MeshNetwork extends EventEmitter {
      * @param {Object} [config.encryption] - Encryption settings
      * @param {Object} [config.routing] - Routing settings
      * @param {Object} [config.compression] - Compression settings
-     * @param {Object} [config.storeAndForward] - Store and forward settings
+     * @param {any} [config.storeAndForward] - Store and forward settings
      */
   constructor(config = {}) {
     super();
 
     /**
          * Configuration
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._config = this._mergeConfig(DEFAULT_CONFIG, config);
 
     /**
          * Underlying MeshService
-         * @type {MeshService}
+         * @type {InstanceType<typeof MeshService>}
          * @private
          */
     this._service = new MeshService({
@@ -111,7 +111,7 @@ class MeshNetwork extends EventEmitter {
 
     /**
          * Transport layer
-         * @type {Transport|null}
+         * @type {any}
          * @private
          */
     this._transport = null;
@@ -180,7 +180,7 @@ class MeshNetwork extends EventEmitter {
 
     /**
          * Channel manager reference
-         * @type {Object|null}
+         * @type {any}
          * @private
          */
     this._channels = null;
@@ -202,7 +202,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Starts the mesh network.
-     * @param {Object} [transport] - Optional custom transport
+     * @param {any} [transport] - Optional custom transport
      * @returns {Promise<void>}
      */
   async start(transport) {
@@ -216,7 +216,7 @@ class MeshNetwork extends EventEmitter {
         const { RNBLEAdapter } = require('./transport/adapters');
         const adapter = new RNBLEAdapter();
         this._transport = new BLETransport(adapter);
-      } catch (e) {
+      } catch (/** @type {any} */ e) {
         throw new MeshError(
           'No transport provided and BLE adapter not available. ' +
           'Either pass a transport to start(), install react-native-ble-plx for BLE, ' +
@@ -252,15 +252,15 @@ class MeshNetwork extends EventEmitter {
     }
 
     // Setup file transfer events
-    this._fileManager.on('sendProgress', (info) => this.emit('fileSendProgress', info));
-    this._fileManager.on('receiveProgress', (info) => this.emit('fileReceiveProgress', info));
-    this._fileManager.on('fileReceived', (info) => this.emit('fileReceived', info));
-    this._fileManager.on('transferFailed', (info) => this.emit('fileTransferFailed', info));
-    this._fileManager.on('transferCancelled', (info) => this.emit('fileTransferCancelled', info));
+    this._fileManager.on('sendProgress', (/** @type {any} */ info) => this.emit('fileSendProgress', info));
+    this._fileManager.on('receiveProgress', (/** @type {any} */ info) => this.emit('fileReceiveProgress', info));
+    this._fileManager.on('fileReceived', (/** @type {any} */ info) => this.emit('fileReceived', info));
+    this._fileManager.on('transferFailed', (/** @type {any} */ info) => this.emit('fileTransferFailed', info));
+    this._fileManager.on('transferCancelled', (/** @type {any} */ info) => this.emit('fileTransferCancelled', info));
 
     // Start connection quality monitoring
     this._connectionQuality.start();
-    this._connectionQuality.on('qualityChanged', (quality) => {
+    this._connectionQuality.on('qualityChanged', (/** @type {any} */ quality) => {
       this.emit('connectionQualityChanged', quality);
     });
 
@@ -352,9 +352,9 @@ class MeshNetwork extends EventEmitter {
       // If peer is offline and store-forward is enabled, cache the message
       if (this._storeForward && this._isPeerOffline(peerId)) {
         const payload = this._encodeMessage(text);
-        await this._storeForward.cacheForOfflinePeer(peerId, payload, {
+        await this._storeForward.cacheForOfflinePeer(peerId, payload, /** @type {any} */ ({
           needsEncryption: true
-        });
+        }));
         this.emit('messageCached', { peerId, text });
         return 'cached';
       }
@@ -410,7 +410,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets list of joined channels.
-     * @returns {Object[]} Channels
+     * @returns {any[]} Channels
      */
   getChannels() {
     return this._service.getChannels();
@@ -422,7 +422,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets all known peers.
-     * @returns {Object[]} Array of peers
+     * @returns {any[]} Array of peers
      */
   getPeers() {
     return this._service.getPeers();
@@ -430,7 +430,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets connected peers.
-     * @returns {Object[]} Connected peers
+     * @returns {any[]} Connected peers
      */
   getConnectedPeers() {
     return this._service.getConnectedPeers();
@@ -438,7 +438,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets peers with secure sessions.
-     * @returns {Object[]} Secured peers
+     * @returns {any[]} Secured peers
      */
   getSecuredPeers() {
     return this._service.getSecuredPeers();
@@ -468,7 +468,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets network health metrics.
-     * @returns {Object} Health report
+     * @returns {any} Health report
      */
   getNetworkHealth() {
     return this._monitor.generateHealthReport();
@@ -477,7 +477,7 @@ class MeshNetwork extends EventEmitter {
   /**
      * Gets detailed health for a specific peer.
      * @param {string} peerId - Peer ID
-     * @returns {Object|null} Node health
+     * @returns {any} Node health
      */
   getPeerHealth(peerId) {
     return this._monitor.getNodeHealth(peerId);
@@ -562,7 +562,7 @@ class MeshNetwork extends EventEmitter {
      * @param {Uint8Array} fileInfo.data - File data
      * @param {string} fileInfo.name - File name
      * @param {string} [fileInfo.mimeType] - MIME type
-     * @returns {Object} Transfer info with id and event emitter
+     * @returns {Promise<any>} Transfer info with id and event emitter
      */
   async sendFile(peerId, fileInfo) {
     this._validateRunning();
@@ -572,6 +572,7 @@ class MeshNetwork extends EventEmitter {
       throw new ValidationError('File must have data and name', 'E800');
     }
 
+    /** @type {any} */
     const transfer = this._fileManager.prepareSend(peerId, fileInfo);
 
     // Send offer (JSON is OK for metadata, but use binary type marker)
@@ -611,14 +612,14 @@ class MeshNetwork extends EventEmitter {
       // Add per-chunk timeout (10 seconds)
       const sendPromise = this._service._sendRaw(peerId, payload);
       let timeoutId;
-      const timeoutPromise = new Promise((_, reject) => {
+      const timeoutPromise = new Promise((/** @type {any} */ _, /** @type {any} */ reject) => {
         timeoutId = setTimeout(() => reject(new Error('Chunk send timeout')), 10000);
       });
 
       try {
         await Promise.race([sendPromise, timeoutPromise]);
         clearTimeout(timeoutId);
-      } catch (err) {
+      } catch (/** @type {any} */ err) {
         clearTimeout(timeoutId);
         this._fileManager.cancelTransfer(transfer.id);
         this.emit('fileTransferFailed', {
@@ -635,7 +636,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets active file transfers
-     * @returns {Object} { outgoing: [], incoming: [] }
+     * @returns {any} { outgoing: [], incoming: [] }
      */
   getActiveTransfers() {
     return this._fileManager.getActiveTransfers();
@@ -656,7 +657,7 @@ class MeshNetwork extends EventEmitter {
   /**
      * Gets connection quality for a specific peer.
      * @param {string} peerId - Peer ID
-     * @returns {Object|null} Quality report
+     * @returns {any} Quality report
      */
   getConnectionQuality(peerId) {
     return this._connectionQuality.getQuality(peerId);
@@ -664,7 +665,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets connection quality for all peers.
-     * @returns {Object[]} Array of quality reports
+     * @returns {any[]} Array of quality reports
      */
   getAllConnectionQuality() {
     return this._connectionQuality.getAllQuality();
@@ -676,7 +677,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets the network status.
-     * @returns {Object} Status
+     * @returns {any} Status
      */
   getStatus() {
     const identity = this._state === 'running' ? this._service.getIdentity() : null;
@@ -693,7 +694,7 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Gets the identity information.
-     * @returns {Object} Identity
+     * @returns {any} Identity
      */
   getIdentity() {
     return this._service.getIdentity();
@@ -714,9 +715,9 @@ class MeshNetwork extends EventEmitter {
 
   /**
      * Merges configuration with defaults.
-     * @param {Object} defaults - Default config
-     * @param {Object} custom - Custom config
-     * @returns {Object} Merged config
+     * @param {any} defaults - Default config
+     * @param {any} custom - Custom config
+     * @returns {any} Merged config
      * @private
      */
   _mergeConfig(defaults, custom) {
@@ -738,12 +739,12 @@ class MeshNetwork extends EventEmitter {
      */
   _setupEventForwarding() {
     // Forward service events with PRD-style naming
-    this._service.on(EVENTS.PEER_DISCOVERED, (peer) => {
+    this._service.on(EVENTS.PEER_DISCOVERED, (/** @type {any} */ peer) => {
       this._monitor.trackPeerDiscovered(peer.id);
       this.emit('peerDiscovered', peer);
     });
 
-    this._service.on(EVENTS.PEER_CONNECTED, (peer) => {
+    this._service.on(EVENTS.PEER_CONNECTED, (/** @type {any} */ peer) => {
       if (peer.rssi) {
         this._connectionQuality.recordRssi(peer.id, peer.rssi);
       }
@@ -754,13 +755,13 @@ class MeshNetwork extends EventEmitter {
       }
     });
 
-    this._service.on(EVENTS.PEER_DISCONNECTED, (peer) => {
+    this._service.on(EVENTS.PEER_DISCONNECTED, (/** @type {any} */ peer) => {
       this._monitor.trackPeerDisconnected(peer.id);
       this._connectionQuality.removePeer(peer.id);
       this.emit('peerDisconnected', peer);
     });
 
-    this._service.on('message', (message) => {
+    this._service.on('message', (/** @type {any} */ message) => {
       this._monitor.trackMessageReceived(message.senderId);
       this.emit('messageReceived', {
         from: message.senderId,
@@ -770,7 +771,7 @@ class MeshNetwork extends EventEmitter {
       });
     });
 
-    this._service.on('private-message', (message) => {
+    this._service.on('private-message', (/** @type {any} */ message) => {
       this.emit('directMessage', {
         from: message.senderId,
         text: message.content,
@@ -778,7 +779,7 @@ class MeshNetwork extends EventEmitter {
       });
     });
 
-    this._service.on('channel-message', (message) => {
+    this._service.on('channel-message', (/** @type {any} */ message) => {
       this.emit('channelMessage', {
         channel: message.channelId,
         from: message.senderId,
@@ -787,22 +788,22 @@ class MeshNetwork extends EventEmitter {
       });
     });
 
-    this._service.on('message-delivered', (info) => {
+    this._service.on('message-delivered', (/** @type {any} */ info) => {
       this._monitor.trackMessageDelivered(info.messageId);
       this.emit('messageDelivered', info);
     });
 
-    this._service.on('error', (error) => {
+    this._service.on('error', (/** @type {any} */ error) => {
       this.emit('error', error);
     });
 
     // Forward monitor events
-    this._monitor.on('health-changed', (info) => {
+    this._monitor.on('health-changed', (/** @type {any} */ info) => {
       this.emit('networkHealthChanged', info);
     });
 
     // Forward emergency events
-    this._emergencyManager.on('panic-wipe-completed', (result) => {
+    this._emergencyManager.on('panic-wipe-completed', (/** @type {any} */ result) => {
       this.emit('dataWiped', result);
     });
   }
@@ -823,17 +824,18 @@ class MeshNetwork extends EventEmitter {
   async _deliverCachedMessages(peerId) {
     if (!this._storeForward) { return; }
 
-    const sendFn = async (payload) => {
+    const sendFn = async (/** @type {any} */ payload) => {
       // Re-encrypt and send via the proper encrypted channel
       try {
         const text = _decoder.decode(payload);
         await this._service.sendPrivateMessage(peerId, text);
-      } catch (e) {
+      } catch (/** @type {any} */ e) {
         // Fallback to raw send if encryption fails
         await this._service._sendRaw(peerId, payload);
       }
     };
 
+    /** @type {any} */
     const result = await this._storeForward.deliverCachedMessages(peerId, sendFn);
 
     if (result.delivered > 0) {
@@ -857,7 +859,7 @@ class MeshNetwork extends EventEmitter {
     // Clear store and forward cache
     if (this._storeForward) {
       this._emergencyManager.registerClearer(async () => {
-        this._storeForward.clear();
+        this._storeForward?.clear();
       });
     }
 

package/src/constants/audio.js

@@ -7,7 +7,7 @@
 
 /**
  * LC3 codec configuration
- * @constant {Object}
+ * @constant {any}
  */
 const LC3_CONFIG = Object.freeze({
   /** Supported sample rates (Hz) */
@@ -62,7 +62,7 @@ const AUDIO_QUALITY = Object.freeze({
 
 /**
  * Voice message configuration
- * @constant {Object}
+ * @constant {any}
  */
 const VOICE_MESSAGE_CONFIG = Object.freeze({
   /** Maximum voice message duration in seconds */
@@ -79,7 +79,7 @@ const VOICE_MESSAGE_CONFIG = Object.freeze({
 
 /**
  * Audio streaming configuration
- * @constant {Object}
+ * @constant {any}
  */
 const AUDIO_STREAM_CONFIG = Object.freeze({
   /** Default jitter buffer size in frames */
@@ -98,7 +98,7 @@ const AUDIO_STREAM_CONFIG = Object.freeze({
 
 /**
  * Audio session states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const AUDIO_SESSION_STATE = Object.freeze({
   IDLE: 'idle',

package/src/constants/ble.js

@@ -77,7 +77,7 @@ const POWER_MODE = Object.freeze({
 
 /**
  * Bluetooth adapter states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const BLUETOOTH_STATE = Object.freeze({
   UNKNOWN: 'unknown',

package/src/constants/crypto.js

@@ -35,7 +35,7 @@ const NOISE_PROTOCOL_NAME = 'Noise_XX_25519_ChaChaPoly_SHA256';
 
 /**
  * Noise handshake states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const NOISE_HANDSHAKE_STATE = Object.freeze({
   INITIAL: 'initial',

package/src/constants/errors.js

@@ -7,7 +7,7 @@
 
 /**
  * Error codes organized by category
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const ERROR_CODE = Object.freeze({
   // Initialization errors (E0xx)
@@ -108,7 +108,7 @@ const ERROR_CODE = Object.freeze({
 
 /**
  * Error messages for each error code
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const ERROR_MESSAGES = Object.freeze({
   E001: 'Initialization failed',

package/src/constants/events.js

@@ -7,7 +7,7 @@
 
 /**
  * Event names for the mesh network
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const EVENTS = Object.freeze({
   // Lifecycle events

package/src/constants/protocol.js

@@ -115,7 +115,7 @@ const MESH_CONFIG = Object.freeze({
 
 /**
  * Connection states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const CONNECTION_STATE = Object.freeze({
   DISCONNECTED: 'disconnected',
@@ -129,7 +129,7 @@ const CONNECTION_STATE = Object.freeze({
 
 /**
  * Service states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const SERVICE_STATE = Object.freeze({
   UNINITIALIZED: 'uninitialized',

package/src/crypto/AutoCrypto.js

@@ -64,7 +64,9 @@ function createProvider(config) {
     return detectProvider();
   }
 
+  // @ts-ignore
   if (typeof config === 'object' && typeof config.generateKeyPair === 'function') {
+    // @ts-ignore
     return config; // Already a provider instance
   }
 

package/src/crypto/CryptoProvider.js

@@ -37,53 +37,53 @@ class CryptoProvider {
 
   /**
    * Computes X25519 shared secret
-   * @param {Uint8Array} secretKey - Our secret key (32 bytes)
-   * @param {Uint8Array} publicKey - Their public key (32 bytes)
+   * @param {Uint8Array} _secretKey - Our secret key (32 bytes)
+   * @param {Uint8Array} _publicKey - Their public key (32 bytes)
    * @returns {Uint8Array} Shared secret (32 bytes)
    */
-  sharedSecret(_secretKey, _publicKey) {
+  sharedSecret(/** @type {any} */ _secretKey, _publicKey) {
     throw new Error('CryptoProvider.sharedSecret() must be implemented');
   }
 
   /**
    * AEAD encrypt (XSalsa20-Poly1305 or ChaCha20-Poly1305)
-   * @param {Uint8Array} key - Encryption key (32 bytes)
-   * @param {Uint8Array} nonce - Nonce (24 bytes for XSalsa20, 12 for ChaCha20)
-   * @param {Uint8Array} plaintext - Data to encrypt
-   * @param {Uint8Array} [ad] - Additional authenticated data (optional)
+   * @param {Uint8Array} _key - Encryption key (32 bytes)
+   * @param {Uint8Array} _nonce - Nonce (24 bytes for XSalsa20, 12 for ChaCha20)
+   * @param {Uint8Array} _plaintext - Data to encrypt
+   * @param {Uint8Array} [_ad] - Additional authenticated data (optional)
    * @returns {Uint8Array} Ciphertext with authentication tag
    */
-  encrypt(_key, _nonce, _plaintext, _ad) {
+  encrypt(/** @type {any} */ _key, _nonce, _plaintext, _ad) {
     throw new Error('CryptoProvider.encrypt() must be implemented');
   }
 
   /**
    * AEAD decrypt
-   * @param {Uint8Array} key - Encryption key (32 bytes)
-   * @param {Uint8Array} nonce - Nonce
-   * @param {Uint8Array} ciphertext - Ciphertext with auth tag
-   * @param {Uint8Array} [ad] - Additional authenticated data (optional)
+   * @param {Uint8Array} _key - Encryption key (32 bytes)
+   * @param {Uint8Array} _nonce - Nonce
+   * @param {Uint8Array} _ciphertext - Ciphertext with auth tag
+   * @param {Uint8Array} [_ad] - Additional authenticated data (optional)
    * @returns {Uint8Array|null} Plaintext or null if authentication fails
    */
-  decrypt(_key, _nonce, _ciphertext, _ad) {
+  decrypt(/** @type {any} */ _key, _nonce, _ciphertext, _ad) {
     throw new Error('CryptoProvider.decrypt() must be implemented');
   }
 
   /**
    * Computes SHA-256 hash
-   * @param {Uint8Array} data - Data to hash
+   * @param {Uint8Array} _data - Data to hash
    * @returns {Uint8Array} Hash (32 bytes)
    */
-  hash(_data) {
+  hash(/** @type {any} */ _data) {
     throw new Error('CryptoProvider.hash() must be implemented');
   }
 
   /**
    * Generates cryptographically secure random bytes
-   * @param {number} length - Number of bytes
+   * @param {number} _length - Number of bytes
    * @returns {Uint8Array} Random bytes
    */
-  randomBytes(_length) {
+  randomBytes(/** @type {any} */ _length) {
     throw new Error('CryptoProvider.randomBytes() must be implemented');
   }
 

package/src/crypto/providers/ExpoCryptoProvider.js

@@ -23,8 +23,10 @@ const CryptoProvider = require('../CryptoProvider');
 class ExpoCryptoProvider extends CryptoProvider {
   constructor(options = {}) {
     super();
-    this._expoCrypto = options.expoCrypto || null;
-    this._nacl = options.nacl || null;
+    /** @type {any} */
+    const opts = options;
+    this._expoCrypto = opts.expoCrypto || null;
+    this._nacl = opts.nacl || null;
   }
 
   get name() {
@@ -34,6 +36,7 @@ class ExpoCryptoProvider extends CryptoProvider {
   _getExpoCrypto() {
     if (!this._expoCrypto) {
       try {
+        // @ts-ignore
         this._expoCrypto = require('expo-crypto');
       } catch (e) {
         throw new Error('expo-crypto is required. Install: npx expo install expo-crypto');
@@ -45,6 +48,7 @@ class ExpoCryptoProvider extends CryptoProvider {
   _getNacl() {
     if (!this._nacl) {
       try {
+        // @ts-ignore
         this._nacl = require('tweetnacl');
       } catch (e) {
         throw new Error('tweetnacl is required with ExpoCryptoProvider. Install: npm install tweetnacl');
@@ -61,13 +65,13 @@ class ExpoCryptoProvider 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();
 
     // Ensure 24-byte nonce (pad short nonces with zeros)
@@ -81,7 +85,7 @@ class ExpoCryptoProvider 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)
@@ -95,14 +99,14 @@ class ExpoCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  hash(data) {
+  hash(/** @type {any} */ data) {
     // expo-crypto's digestStringAsync is async — for sync compat, use tweetnacl
     const nacl = this._getNacl();
     return nacl.hash(data).subarray(0, 32);
   }
 
   /** @inheritdoc */
-  randomBytes(length) {
+  randomBytes(/** @type {any} */ length) {
     const expoCrypto = this._getExpoCrypto();
     if (expoCrypto.getRandomBytes) {
       const bytes = expoCrypto.getRandomBytes(length);
@@ -115,6 +119,7 @@ class ExpoCryptoProvider extends CryptoProvider {
 
   static isAvailable() {
     try {
+      // @ts-ignore
       require('expo-crypto');
       return true;
     } catch (e) {