react-native-ble-mesh 2.1.0 → 2.1.2

package/src/mesh/fragment/Assembler.js

@@ -31,6 +31,7 @@ class PendingFragmentSet {
   constructor(messageId, total, timeout) {
     this.messageId = messageId;
     this.total = total;
+    /** @type {Map<number, Uint8Array>} */
     this.received = new Map();
     this.createdAt = Date.now();
     this.expiresAt = this.createdAt + timeout;
@@ -97,7 +98,7 @@ class PendingFragmentSet {
 
   /**
    * Gets progress information
-   * @returns {Object} Progress { received, total, percent }
+   * @returns {any} Progress { received, total, percent }
    */
   getProgress() {
     return {
@@ -137,7 +138,7 @@ class Assembler {
 
     /**
      * Statistics
-     * @type {Object}
+     * @type {any}
      * @private
      */
     this._stats = {
@@ -236,7 +237,7 @@ class Assembler {
   /**
    * Gets progress for a pending message
    * @param {string} messageId - Message ID
-   * @returns {Object|null} Progress or null if not found
+   * @returns {any} Progress or null if not found
    */
   getProgress(messageId) {
     const pendingSet = this._pending.get(messageId);
@@ -254,7 +255,7 @@ class Assembler {
 
   /**
    * Gets assembler statistics
-   * @returns {Object} Statistics
+   * @returns {any} Statistics
    */
   getStats() {
     return {

package/src/mesh/fragment/Fragmenter.js

@@ -66,7 +66,7 @@ function createFragmentHeader(index, total, payloadLength) {
 /**
  * Parses a fragment header
  * @param {Uint8Array} data - Fragment data
- * @returns {Object} Parsed header { index, total, payloadLength }
+ * @returns {any} Parsed header { index, total, payloadLength }
  */
 function parseFragmentHeader(data) {
   if (data.length < FRAGMENT_HEADER_SIZE) {
@@ -139,7 +139,7 @@ function fragment(payload, messageId, maxSize = DEFAULT_FRAGMENT_SIZE) {
 /**
  * Gets fragment information without parsing full data
  * @param {Uint8Array} fragmentData - Fragment data
- * @returns {Object} Fragment info { index, total, payloadLength, payload }
+ * @returns {any} Fragment info { index, total, payloadLength, payload }
  */
 function getFragmentInfo(fragmentData) {
   const header = parseFragmentHeader(fragmentData);

package/src/mesh/monitor/ConnectionQuality.js

@@ -12,7 +12,7 @@ const EventEmitter = require('../../utils/EventEmitter');
 
 /**
  * Connection quality levels
- * @constant {Object}
+ * @constant {any}
  */
 const QUALITY_LEVEL = Object.freeze({
   EXCELLENT: 'excellent',
@@ -24,7 +24,7 @@ const QUALITY_LEVEL = Object.freeze({
 
 /**
  * Default quality configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** How often to recalculate quality (ms) */
@@ -50,8 +50,13 @@ const DEFAULT_CONFIG = Object.freeze({
  * @class PeerQualityTracker
  */
 class PeerQualityTracker {
+  /**
+   * @param {string} peerId
+   * @param {any} config
+   */
   constructor(peerId, config) {
     this.peerId = peerId;
+    /** @type {any} */
     this._config = config;
     // Circular buffer for RSSI samples
     this._rssiSamples = new Float64Array(config.sampleSize);
@@ -66,6 +71,7 @@ class PeerQualityTracker {
     this._packetsSent = 0;
     this._packetsAcked = 0;
     this._bytesTransferred = 0;
+    /** @type {number|null} */
     this._transferStartTime = null;
     this._lastActivity = Date.now();
     this._transport = 'ble';
@@ -193,7 +199,7 @@ class PeerQualityTracker {
   /**
    * Calculates quality score (0-1) for a metric
    * @param {number|null} value - Metric value
-   * @param {Object} thresholds - {excellent, good, fair}
+   * @param {any} thresholds - {excellent, good, fair}
    * @param {boolean} [higherIsBetter=false]
    * @returns {number}
    */
@@ -216,7 +222,7 @@ class PeerQualityTracker {
 
   /**
    * Calculates overall quality
-   * @returns {Object} Quality report
+   * @returns {any} Quality report
    */
   calculate() {
     if (this.isTimedOut()) {
@@ -251,6 +257,7 @@ class PeerQualityTracker {
     if (score >= 0.8) { level = QUALITY_LEVEL.EXCELLENT; } else if (score >= 0.6) { level = QUALITY_LEVEL.GOOD; } else if (score >= 0.4) { level = QUALITY_LEVEL.FAIR; } else { level = QUALITY_LEVEL.POOR; }
 
     const previousLevel = this._currentLevel;
+    // @ts-ignore
     this._currentLevel = level;
 
     return {
@@ -275,13 +282,15 @@ class PeerQualityTracker {
  */
 class ConnectionQuality extends EventEmitter {
   /**
-   * @param {Object} [config={}]
+   * @param {any} [config={}]
    */
   constructor(config = {}) {
     super();
+    /** @type {any} */
     this._config = { ...DEFAULT_CONFIG, ...config };
     /** @type {Map<string, PeerQualityTracker>} */
     this._peers = new Map();
+    /** @type {any} */
     this._updateTimer = null;
   }
 
@@ -321,7 +330,7 @@ class ConnectionQuality extends EventEmitter {
     if (!this._peers.has(peerId)) {
       this._peers.set(peerId, new PeerQualityTracker(peerId, this._config));
     }
-    return this._peers.get(peerId);
+    return /** @type {PeerQualityTracker} */ (this._peers.get(peerId));
   }
 
   /**
@@ -387,7 +396,7 @@ class ConnectionQuality extends EventEmitter {
   /**
    * Gets quality for a specific peer
    * @param {string} peerId
-   * @returns {Object|null}
+   * @returns {any}
    */
   getQuality(peerId) {
     const tracker = this._peers.get(peerId);
@@ -397,7 +406,7 @@ class ConnectionQuality extends EventEmitter {
 
   /**
    * Gets quality for all peers
-   * @returns {Object[]}
+   * @returns {any[]}
    */
   getAllQuality() {
     const results = [];

package/src/mesh/monitor/NetworkMonitor.js

@@ -12,7 +12,7 @@ const EventEmitter = require('../../utils/EventEmitter');
 
 /**
  * Health status levels
- * @constant {Object}
+ * @constant {any}
  */
 const HEALTH_STATUS = Object.freeze({
   GOOD: 'good',
@@ -23,7 +23,7 @@ const HEALTH_STATUS = Object.freeze({
 
 /**
  * Default monitoring configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Sample window size for latency calculations */
@@ -90,21 +90,21 @@ const DEFAULT_CONFIG = Object.freeze({
 class NetworkMonitor extends EventEmitter {
   /**
      * Creates a new NetworkMonitor instance.
-     * @param {Object} [options={}] - Configuration options
+     * @param {any} [options={}] - Configuration options
      */
   constructor(options = {}) {
     super();
 
     /**
          * Configuration
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._config = { ...DEFAULT_CONFIG, ...options };
 
     /**
          * Node health tracking
-         * @type {Map<string, NodeHealth>}
+         * @type {Map<string, any>}
          * @private
          */
     this._nodes = new Map();
@@ -146,7 +146,7 @@ class NetworkMonitor extends EventEmitter {
 
     /**
          * Global statistics
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._stats = {
@@ -158,7 +158,7 @@ class NetworkMonitor extends EventEmitter {
 
     /**
          * Health check timer
-         * @type {number|null}
+         * @type {any}
          * @private
          */
     this._healthCheckTimer = null;
@@ -170,6 +170,13 @@ class NetworkMonitor extends EventEmitter {
          */
     this._lastHealthReport = null;
 
+    /**
+         * Previous health status for change detection
+         * @type {string|null}
+         * @private
+         */
+    this._previousHealth = null;
+
     // Start health check timer
     this._startHealthCheck();
   }
@@ -351,7 +358,7 @@ class NetworkMonitor extends EventEmitter {
   /**
      * Gets detailed health for a specific node.
      * @param {string} peerId - Peer ID
-     * @returns {NodeHealth|null} Node health or null
+     * @returns {any} Node health or null
      */
   getNodeHealth(peerId) {
     const node = this._nodes.get(peerId);
@@ -368,13 +375,13 @@ class NetworkMonitor extends EventEmitter {
 
   /**
      * Gets health information for all nodes.
-     * @returns {NodeHealth[]} Array of node health
+     * @returns {any[]} Array of node health
      */
   getAllNodeHealth() {
     const now = Date.now();
     const timeout = this._config.nodeTimeoutMs;
 
-    return Array.from(this._nodes.values()).map(node => ({
+    return Array.from(this._nodes.values()).map((/** @type {any} */ node) => ({
       ...node,
       isActive: (now - node.lastSeen) < timeout
     }));
@@ -390,7 +397,7 @@ class NetworkMonitor extends EventEmitter {
 
   /**
      * Gets monitoring statistics.
-     * @returns {Object} Statistics
+     * @returns {any} Statistics
      */
   getStats() {
     return {
@@ -433,7 +440,7 @@ class NetworkMonitor extends EventEmitter {
   /**
      * Gets or creates a node entry.
      * @param {string} peerId - Peer ID
-     * @returns {NodeHealth} Node entry
+     * @returns {any} Node entry
      * @private
      */
   _getOrCreateNode(peerId) {
@@ -474,7 +481,7 @@ class NetworkMonitor extends EventEmitter {
 
   /**
      * Updates node latency with exponential moving average.
-     * @param {NodeHealth} node - Node to update
+     * @param {any} node - Node to update
      * @param {number} latency - New latency sample
      * @private
      */
@@ -489,7 +496,7 @@ class NetworkMonitor extends EventEmitter {
 
   /**
      * Updates node packet loss rate.
-     * @param {NodeHealth} node - Node to update
+     * @param {any} node - Node to update
      * @private
      */
   _updateNodePacketLoss(node) {
@@ -567,7 +574,7 @@ class NetworkMonitor extends EventEmitter {
           this._cleanupPendingMessages();
           const report = this.generateHealthReport();
           this.emit('health-report', report);
-        } catch (error) {
+        } catch (_error) {
           // Don't let health check errors crash the monitor
         }
       },

package/src/mesh/peer/Peer.js

@@ -18,12 +18,7 @@ const CONNECTION_STATE_SET = new Set(Object.values(CONNECTION_STATE));
 class Peer {
   /**
    * Creates a new Peer
-   * @param {Object} options - Peer options
-   * @param {string} options.id - Unique peer identifier
-   * @param {Uint8Array} [options.publicKey] - Peer's public key
-   * @param {string} [options.name] - Display name
-   * @param {number} [options.rssi] - Signal strength
-   * @param {number} [options.hopCount] - Distance in hops
+   * @param {any} options - Peer options   *
    */
   constructor(options) {
     if (!options || typeof options.id !== 'string' || options.id.length === 0) {
@@ -88,7 +83,7 @@ class Peer {
 
     /**
      * Additional metadata
-     * @type {Object}
+     * @type {any}
      */
     this.metadata = options.metadata || {};
   }
@@ -201,7 +196,7 @@ class Peer {
 
   /**
    * Converts peer to a JSON-serializable object
-   * @returns {Object} JSON representation
+   * @returns {any} JSON representation
    */
   toJSON() {
     return {
@@ -222,7 +217,7 @@ class Peer {
 
   /**
    * Creates a Peer from JSON data
-   * @param {Object} data - JSON data
+   * @param {any} data - JSON data
    * @returns {Peer} New Peer instance
    */
   static fromJSON(data) {

package/src/mesh/peer/PeerDiscovery.js

@@ -16,7 +16,7 @@ const { ValidationError } = require('../../errors');
  * @property {string} [name] - Display name
  * @property {number[]} [publicKey] - Public key bytes
  * @property {number} [hopCount] - Hop count
- * @property {Object} [capabilities] - Peer capabilities
+ * @property {any} [capabilities] - Peer capabilities
  */
 
 /**
@@ -27,10 +27,7 @@ const { ValidationError } = require('../../errors');
 class PeerDiscovery extends EventEmitter {
   /**
    * Creates a new PeerDiscovery handler
-   * @param {Object} options - Configuration options
-   * @param {string} options.localPeerId - Local peer's ID
-   * @param {Uint8Array} [options.publicKey] - Local peer's public key
-   * @param {string} [options.displayName] - Local display name
+   * @param {any} options - Configuration options   *
    */
   constructor(options = {}) {
     super();
@@ -59,13 +56,13 @@ class PeerDiscovery extends EventEmitter {
 
     /**
      * Capabilities advertised to peers
-     * @type {Object}
+     * @type {any}
      */
     this.capabilities = options.capabilities || {};
 
     /**
      * Discovery statistics
-     * @type {Object}
+     * @type {any}
      * @private
      */
     this._stats = {
@@ -80,9 +77,10 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Creates an announce message payload
-   * @returns {Object} Announce payload
+   * @returns {any} Announce payload
    */
   createAnnouncePayload() {
+    /** @type {any} */
     const payload = {
       peerId: this.localPeerId,
       name: this.displayName,
@@ -100,8 +98,9 @@ class PeerDiscovery extends EventEmitter {
   /**
    * Creates a peer request payload
    * @param {string} [targetPeerId] - Specific peer to request (null for broadcast)
-   * @returns {Object} Request payload
+   * @returns {any} Request payload
    */
+  // @ts-ignore
   createRequestPayload(targetPeerId = null) {
     return {
       requesterId: this.localPeerId,
@@ -113,7 +112,7 @@ class PeerDiscovery extends EventEmitter {
   /**
    * Creates a peer response payload
    * @param {string} requesterId - ID of requesting peer
-   * @returns {Object} Response payload
+   * @returns {any} Response payload
    */
   createResponsePayload(requesterId) {
     return {
@@ -129,9 +128,9 @@ class PeerDiscovery extends EventEmitter {
   /**
    * Processes an incoming discovery message
    * @param {number} type - Message type
-   * @param {Object} payload - Message payload
+   * @param {any} payload - Message payload
    * @param {string} sourcePeerId - Source peer ID
-   * @returns {Object|null} Response to send, or null
+   * @returns {any} Response to send, or null
    */
   processMessage(type, payload, sourcePeerId) {
     // Ignore our own messages
@@ -158,7 +157,7 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Handles a peer announce message
-   * @param {Object} payload - Announce payload
+   * @param {any} payload - Announce payload
    * @param {string} sourcePeerId - Source peer ID
    * @returns {null} No response needed
    * @private
@@ -181,9 +180,9 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Handles a peer request message
-   * @param {Object} payload - Request payload
-   * @param {string} sourcePeerId - Source peer ID
-   * @returns {Object|null} Response payload or null
+   * @param {any} payload - Request payload
+   * @param {string} _sourcePeerId - Source peer ID
+   * @returns {any} Response payload or null
    * @private
    */
   _handleRequest(payload, _sourcePeerId) {
@@ -203,7 +202,7 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Handles a peer response message
-   * @param {Object} payload - Response payload
+   * @param {any} payload - Response payload
    * @param {string} sourcePeerId - Source peer ID
    * @returns {null} No response needed
    * @private
@@ -230,7 +229,7 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Updates local peer information
-   * @param {Object} info - New info
+   * @param {any} info - New info
    */
   updateLocalInfo(info) {
     if (info.displayName !== undefined) { this.displayName = info.displayName; }
@@ -242,7 +241,7 @@ class PeerDiscovery extends EventEmitter {
 
   /**
    * Gets discovery statistics
-   * @returns {Object} Statistics
+   * @returns {any} Statistics
    */
   getStats() {
     return { ...this._stats };

package/src/mesh/peer/PeerManager.js

@@ -18,9 +18,9 @@ const { ValidationError, ConnectionError } = require('../../errors');
 class PeerManager extends EventEmitter {
   /**
    * Creates a new PeerManager
-   * @param {Object} [options] - Configuration options
-   * @param {number} [options.maxPeers] - Maximum number of peers
-   * @param {number} [options.peerTimeout] - Timeout for stale peers
+   * @param {any} [options] - Configuration options
+   *
+   *
    */
   constructor(options = {}) {
     super();
@@ -39,7 +39,7 @@ class PeerManager extends EventEmitter {
 
     /**
      * Peers by ID
-     * @type {Map<string, Peer>}
+     * @type {Map<string, any>}
      * @private
      */
     this._peers = new Map();
@@ -54,8 +54,8 @@ class PeerManager extends EventEmitter {
 
   /**
    * Adds or updates a peer
-   * @param {Object} info - Peer information
-   * @returns {Peer} The added or updated peer
+   * @param {any} info - Peer information
+   * @returns {any} The added or updated peer
    */
   addPeer(info) {
     if (!info || typeof info.id !== 'string') {
@@ -90,7 +90,7 @@ class PeerManager extends EventEmitter {
   /**
    * Gets a peer by ID
    * @param {string} id - Peer ID
-   * @returns {Peer|undefined} The peer or undefined
+   * @returns {any} The peer or undefined
    */
   getPeer(id) {
     return this._peers.get(id);
@@ -98,7 +98,7 @@ class PeerManager extends EventEmitter {
 
   /**
    * Gets all peers
-   * @returns {Peer[]} Array of all peers
+   * @returns {any[]} Array of all peers
    */
   getAllPeers() {
     return Array.from(this._peers.values());
@@ -106,7 +106,7 @@ class PeerManager extends EventEmitter {
 
   /**
    * Gets connected peers
-   * @returns {Peer[]} Array of connected peers
+   * @returns {any[]} Array of connected peers
    */
   getConnectedPeers() {
     const result = [];
@@ -118,7 +118,7 @@ class PeerManager extends EventEmitter {
 
   /**
    * Gets peers with secure sessions
-   * @returns {Peer[]} Array of secured peers
+   * @returns {any[]} Array of secured peers
    */
   getSecuredPeers() {
     const result = [];
@@ -130,7 +130,7 @@ class PeerManager extends EventEmitter {
 
   /**
    * Gets directly connected peers
-   * @returns {Peer[]} Array of direct peers
+   * @returns {any[]} Array of direct peers
    */
   getDirectPeers() {
     const result = [];
@@ -144,7 +144,7 @@ class PeerManager extends EventEmitter {
    * Updates a peer's connection state
    * @param {string} id - Peer ID
    * @param {string} state - New connection state
-   * @returns {Peer|undefined} Updated peer or undefined
+   * @returns {any} Updated peer or undefined
    */
   updateConnectionState(id, state) {
     const peer = this._peers.get(id);
@@ -166,7 +166,7 @@ class PeerManager extends EventEmitter {
   /**
    * Marks a peer as secured
    * @param {string} id - Peer ID
-   * @returns {Peer|undefined} Updated peer or undefined
+   * @returns {any} Updated peer or undefined
    */
   markSecured(id) {
     const peer = this._peers.get(id);
@@ -237,7 +237,7 @@ class PeerManager extends EventEmitter {
   /**
    * Cleans up stale peers
    * @param {number} [maxAge] - Maximum age in ms, defaults to peerTimeout
-   * @returns {Peer[]} Array of removed peers
+   * @returns {any[]} Array of removed peers
    */
   cleanup(maxAge = this.peerTimeout) {
     const removed = [];

package/src/mesh/router/MessageRouter.js

@@ -17,7 +17,7 @@ const { randomBytes } = require('../../utils/bytes');
  * @constant {string[]}
  * @private
  */
-const HEX = Array.from({ length: 256 }, (_, i) => (i < 16 ? '0' : '') + i.toString(16));
+const HEX = Array.from({ length: 256 }, (/** @type {any} */ _, /** @type {number} */ i) => (i < 16 ? '0' : '') + i.toString(16));
 
 /**
  * Generates a UUID v4 string
@@ -42,8 +42,8 @@ function generateUUID() {
 class MessageRouter extends EventEmitter {
   /**
    * Creates a new MessageRouter
-   * @param {Object} options - Configuration options
-   * @param {string} options.localPeerId - Local peer ID
+   * @param {any} options - Configuration options
+   *
    */
   constructor(options = {}) {
     super();
@@ -77,7 +77,7 @@ class MessageRouter extends EventEmitter {
 
     /**
      * Statistics
-     * @type {Object}
+     * @type {any}
      * @private
      */
     this._stats = {
@@ -134,9 +134,9 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Processes an incoming message
-   * @param {Object} message - Message object
+   * @param {any} message - Message object
    * @param {string} sourcePeerId - Peer ID that sent the message
-   * @returns {Object|null} Processed message or null if dropped
+   * @returns {any} Processed message or null if dropped
    */
   processIncoming(message, sourcePeerId) {
     this._stats.messagesReceived++;
@@ -196,7 +196,7 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Relays a message to other peers
-   * @param {Object} message - Message to relay
+   * @param {any} message - Message to relay
    * @param {string} excludePeerId - Peer to exclude from relay
    * @private
    */
@@ -214,7 +214,7 @@ class MessageRouter extends EventEmitter {
         try {
           sendFn(relayedMessage);
           this._stats.messagesRelayed++;
-        } catch (err) {
+        } catch (/** @type {any} */ err) {
           this.emit(EVENTS.ERROR, err);
         }
       }
@@ -230,7 +230,7 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Gets relay targets for a message
-   * @param {Object} message - Message
+   * @param {any} message - Message
    * @param {string} excludePeerId - Peer to exclude
    * @returns {string[]} Array of peer IDs
    * @private
@@ -238,7 +238,7 @@ class MessageRouter extends EventEmitter {
   _getRelayTargets(message, excludePeerId) {
     if (message.flags & MESSAGE_FLAGS.IS_BROADCAST) {
       // Broadcast: send to all except source
-      return Array.from(this._peers.keys()).filter(id => id !== excludePeerId);
+      return Array.from(this._peers.keys()).filter((/** @type {string} */ id) => id !== excludePeerId);
     }
 
     // Unicast: find route to recipient
@@ -248,7 +248,7 @@ class MessageRouter extends EventEmitter {
     }
 
     // No known route - use limited flooding (max 3 peers, prefer recently active)
-    const allPeers = Array.from(this._peers.keys()).filter(id => id !== excludePeerId);
+    const allPeers = Array.from(this._peers.keys()).filter((/** @type {string} */ id) => id !== excludePeerId);
     // Limit flood scope to prevent network storms
     const maxFloodPeers = Math.min(3, allPeers.length);
     return allPeers.slice(0, maxFloodPeers);
@@ -256,7 +256,7 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Sends a message
-   * @param {Object} options - Send options
+   * @param {any} options - Send options
    * @returns {string} Message ID
    */
   send(options) {
@@ -296,7 +296,7 @@ class MessageRouter extends EventEmitter {
         try {
           sendFn(message);
           anySent = true;
-        } catch (err) {
+        } catch (/** @type {any} */ err) {
           this.emit(EVENTS.ERROR, err);
         }
       }
@@ -314,7 +314,7 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Broadcasts a message to all peers
-   * @param {Object} options - Broadcast options
+   * @param {any} options - Broadcast options
    * @returns {string} Message ID
    */
   broadcast(options) {
@@ -327,7 +327,7 @@ class MessageRouter extends EventEmitter {
 
   /**
    * Gets router statistics
-   * @returns {Object} Statistics
+   * @returns {any} Statistics
    */
   getStats() {
     return {