react-native-ble-mesh 2.1.0 → 2.1.3

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 {

package/src/mesh/router/PathFinder.js

@@ -28,10 +28,7 @@ const { ValidationError } = require('../../errors');
 class PathFinder extends EventEmitter {
   /**
    * Creates a new PathFinder
-   * @param {Object} options - Configuration options
-   * @param {string} options.localPeerId - Local peer ID
-   * @param {Object} options.routeTable - RouteTable instance
-   * @param {number} [options.discoveryTimeout] - Route discovery timeout
+   * @param {any} options - Configuration options   *
    */
   constructor(options = {}) {
     super();
@@ -51,7 +48,7 @@ class PathFinder extends EventEmitter {
 
     /**
      * Route table reference
-     * @type {Object}
+     * @type {any}
      */
     this.routeTable = options.routeTable;
 
@@ -63,7 +60,7 @@ class PathFinder extends EventEmitter {
 
     /**
      * Pending route requests
-     * @type {Map<string, RouteRequest>}
+     * @type {Map<string, any>}
      * @private
      */
     this._pendingRequests = new Map();
@@ -77,7 +74,7 @@ class PathFinder extends EventEmitter {
 
     /**
      * Statistics
-     * @type {Object}
+     * @type {any}
      * @private
      */
     this._stats = {
@@ -93,7 +90,7 @@ class PathFinder extends EventEmitter {
   /**
    * Finds a route to a destination
    * @param {string} destination - Target peer ID
-   * @returns {Promise<Object|null>} Route or null if not found
+   * @returns {Promise<any>} Route or null if not found
    */
   async findRoute(destination) {
     if (!destination || typeof destination !== 'string') {
@@ -113,7 +110,7 @@ class PathFinder extends EventEmitter {
   /**
    * Initiates route discovery for a destination
    * @param {string} destination - Target peer ID
-   * @returns {Promise<Object|null>} Discovered route or null
+   * @returns {Promise<any>} Discovered route or null
    * @private
    */
   _initiateDiscovery(destination) {
@@ -164,9 +161,9 @@ class PathFinder extends EventEmitter {
 
   /**
    * Processes an incoming route request
-   * @param {Object} request - Route request data
+   * @param {any} request - Route request data
    * @param {string} sourcePeerId - Source peer ID
-   * @returns {Object|null} Reply to send or null
+   * @returns {any} Reply to send or null
    */
   processRouteRequest(request, sourcePeerId) {
     this._stats.requestsReceived++;
@@ -219,7 +216,7 @@ class PathFinder extends EventEmitter {
 
   /**
    * Processes an incoming route reply
-   * @param {Object} reply - Route reply data
+   * @param {any} reply - Route reply data
    * @param {string} sourcePeerId - Source peer ID
    */
   processRouteReply(reply, sourcePeerId) {
@@ -295,7 +292,7 @@ class PathFinder extends EventEmitter {
 
   /**
    * Gets path finder statistics
-   * @returns {Object} Statistics
+   * @returns {any} Statistics
    */
   getStats() {
     return {

package/src/mesh/router/RouteTable.js

@@ -26,9 +26,9 @@ const { ValidationError } = require('../../errors');
 class RouteTable {
   /**
    * Creates a new RouteTable
-   * @param {Object} [options] - Configuration options
-   * @param {number} [options.routeTimeout] - Route expiration timeout
-   * @param {number} [options.maxRoutes] - Maximum routes to store
+   * @param {any} [options] - Configuration options
+   *
+   *
    */
   constructor(options = {}) {
     /**
@@ -45,7 +45,7 @@ class RouteTable {
 
     /**
      * Routes by destination peer ID
-     * @type {Map<string, RouteEntry>}
+     * @type {Map<string, any>}
      * @private
      */
     this._routes = new Map();
@@ -130,7 +130,7 @@ class RouteTable {
   /**
    * Gets a route to a destination
    * @param {string} destination - Destination peer ID
-   * @returns {RouteEntry|undefined} Route or undefined
+   * @returns {any} Route or undefined
    */
   getRoute(destination) {
     const route = this._routes.get(destination);
@@ -197,7 +197,7 @@ class RouteTable {
 
   /**
    * Gets all valid routes
-   * @returns {RouteEntry[]} Array of routes
+   * @returns {any[]} Array of routes
    */
   getAllRoutes() {
     const now = Date.now();
@@ -244,6 +244,7 @@ class RouteTable {
    * @private
    */
   _evictOldestRoute() {
+    /** @type {string|null} */
     let oldest = null;
     let oldestTime = Infinity;
 
@@ -278,7 +279,7 @@ class RouteTable {
 
   /**
    * Gets routing table statistics
-   * @returns {Object} Statistics
+   * @returns {any} Statistics
    */
   getStats() {
     const now = Date.now();

package/src/mesh/store/StoreAndForwardManager.js

@@ -18,11 +18,11 @@ 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));
 
 /**
  * Default configuration for store and forward
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Maximum number of cached messages per recipient */
@@ -68,26 +68,21 @@ const DEFAULT_CONFIG = Object.freeze({
 class StoreAndForwardManager extends EventEmitter {
   /**
      * Creates a new StoreAndForwardManager instance.
-     * @param {Object} [options={}] - Configuration options
-     * @param {number} [options.maxMessagesPerRecipient=100] - Max messages per recipient
-     * @param {number} [options.maxTotalMessages=1000] - Max total cached messages
-     * @param {number} [options.maxCacheSizeBytes=10485760] - Max cache size (10MB)
-     * @param {number} [options.retentionMs=86400000] - Message retention (24h)
-     * @param {number} [options.cleanupIntervalMs=300000] - Cleanup interval (5min)
+     * @param {any} [options={}] - Configuration options   *
      */
   constructor(options = {}) {
     super();
 
     /**
          * Configuration
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._config = { ...DEFAULT_CONFIG, ...options };
 
     /**
          * Message cache by recipient ID
-         * @type {Map<string, CachedMessage[]>}
+         * @type {Map<string, any[]>}
          * @private
          */
     this._cache = new Map();
@@ -108,14 +103,14 @@ class StoreAndForwardManager extends EventEmitter {
 
     /**
          * Cleanup timer
-         * @type {number|null}
+         * @type {any}
          * @private
          */
     this._cleanupTimer = null;
 
     /**
          * Statistics
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._stats = {
@@ -135,9 +130,9 @@ class StoreAndForwardManager extends EventEmitter {
      * Caches a message for an offline peer.
      * @param {string} recipientId - Recipient peer ID
      * @param {Uint8Array} encryptedPayload - Encrypted message payload
-     * @param {Object} [options={}] - Cache options
-     * @param {string} [options.messageId] - Message ID
-     * @param {number} [options.ttlMs] - Custom TTL in ms
+     * @param {any} [options={}] - Cache options
+   *
+   *
      * @returns {Promise<string>} Cached message ID
      */
   async cacheForOfflinePeer(recipientId, encryptedPayload, options = {}) {
@@ -173,7 +168,7 @@ class StoreAndForwardManager extends EventEmitter {
       this._cache.set(recipientId, []);
     }
 
-    const recipientCache = this._cache.get(recipientId);
+    const recipientCache = /** @type {any[]} */ (this._cache.get(recipientId));
 
     // Check per-recipient limit
     if (recipientCache.length >= this._config.maxMessagesPerRecipient) {
@@ -205,14 +200,15 @@ class StoreAndForwardManager extends EventEmitter {
      * Delivers all cached messages to a peer that came online.
      * @param {string} recipientId - Recipient peer ID
      * @param {Function} sendFn - Async function to send message: (payload) => Promise<void>
-     * @returns {Promise<Object>} Delivery result with counts
+     * @returns {Promise<any>} Delivery result with counts
      */
   async deliverCachedMessages(recipientId, sendFn) {
     if (!this._cache.has(recipientId)) {
       return { delivered: 0, failed: 0 };
     }
 
-    const messages = this._cache.get(recipientId);
+    const messages = /** @type {any[]} */ (this._cache.get(recipientId));
+    /** @type {any} */
     const results = { delivered: 0, failed: 0, remaining: [] };
 
     for (const msg of messages) {
@@ -238,7 +234,7 @@ class StoreAndForwardManager extends EventEmitter {
           messageId: msg.id,
           recipientId
         });
-      } catch (error) {
+      } catch (/** @type {any} */ error) {
         results.failed++;
         this._stats.deliveryFailures++;
         results.remaining.push(msg);
@@ -305,7 +301,7 @@ class StoreAndForwardManager extends EventEmitter {
     }
 
     const count = cache.length;
-    const size = cache.reduce((sum, m) => sum + m.size, 0);
+    const size = cache.reduce((/** @type {number} */ sum, /** @type {any} */ m) => sum + m.size, 0);
 
     this._cache.delete(recipientId);
     this._totalSize -= size;
@@ -323,7 +319,7 @@ class StoreAndForwardManager extends EventEmitter {
     let pruned = 0;
 
     for (const [recipientId, messages] of this._cache) {
-      const validMessages = messages.filter(msg => {
+      const validMessages = messages.filter((/** @type {any} */ msg) => {
         if (msg.expiresAt <= now) {
           this._totalSize -= msg.size;
           this._totalCount--;
@@ -350,7 +346,7 @@ class StoreAndForwardManager extends EventEmitter {
 
   /**
      * Gets store and forward statistics.
-     * @returns {Object} Statistics
+     * @returns {any} Statistics
      */
   getStats() {
     return {
@@ -418,6 +414,7 @@ class StoreAndForwardManager extends EventEmitter {
      */
   _removeOldestMessage() {
     let oldestTime = Infinity;
+    /** @type {string|null} */
     let oldestRecipient = null;
 
     for (const [recipientId, messages] of this._cache) {
@@ -428,7 +425,7 @@ class StoreAndForwardManager extends EventEmitter {
     }
 
     if (oldestRecipient) {
-      const messages = this._cache.get(oldestRecipient);
+      const messages = /** @type {any[]} */ (this._cache.get(oldestRecipient));
       const oldest = messages.shift();
       if (oldest) {
         this._totalSize -= oldest.size;

package/src/protocol/message.js

@@ -10,8 +10,8 @@ const { MESSAGE_FLAGS, MESH_CONFIG } = require('../constants');
 const { MessageError } = require('../errors');
 
 // Cached TextEncoder/TextDecoder singletons (avoids per-call allocation)
-let _encoder = null;
-let _decoder = null;
+/** @type {any} */ let _encoder = null;
+/** @type {any} */ let _decoder = null;
 function _getEncoder() {
   if (!_encoder) { _encoder = new TextEncoder(); }
   return _encoder;
@@ -28,11 +28,11 @@ function _getDecoder() {
 class Message {
   /**
    * Creates a new Message instance.
-   * @param {MessageHeader} header - Message header
+   * @param {any} header - Message header
    * @param {Uint8Array} payload - Message payload
    */
   constructor(header, payload) {
-    /** @type {MessageHeader} */
+    /** @type {any} */
     this.header = header;
     /** @type {Uint8Array} */
     this.payload = payload;
@@ -40,15 +40,7 @@ class Message {
 
   /**
    * Creates a new message with the given options.
-   * @param {Object} options - Message options
-   * @param {number} options.type - Message type from MESSAGE_TYPE
-   * @param {Uint8Array|string} options.payload - Message payload
-   * @param {number} [options.flags=0] - Message flags
-   * @param {number} [options.maxHops=7] - Maximum hops
-   * @param {number} [options.ttlMs] - Time-to-live in ms
-   * @param {number} [options.fragmentIndex=0] - Fragment index
-   * @param {number} [options.fragmentTotal=1] - Total fragments
-   * @param {Uint8Array} [options.messageId] - Optional message ID
+   * @param {any} options - Message options   *
    * @returns {Message} New message instance
    */
   static create(options) {

package/src/protocol/serializer.js

@@ -15,7 +15,7 @@ const { MessageError } = require('../errors');
  * Serializes a message header to bytes.
  * Calculates CRC32 checksum and includes it in the output.
  *
- * @param {MessageHeader|Object} header - Header to serialize
+ * @param {any} header - Header to serialize
  * @returns {Uint8Array} 48-byte serialized header
  * @throws {MessageError} If header is invalid
  *
@@ -81,7 +81,7 @@ function serializeHeader(header) {
 /**
  * Serializes a complete message (header + payload) to bytes.
  *
- * @param {Message|Object} message - Message to serialize
+ * @param {any} message - Message to serialize
  * @returns {Uint8Array} Serialized message bytes
  * @throws {MessageError} If message is invalid
  *
@@ -109,8 +109,8 @@ function serialize(message) {
 
   // Convert string payload to bytes
   if (typeof payload === 'string') {
-    if (!serialize._encoder) { serialize._encoder = new TextEncoder(); }
-    payload = serialize._encoder.encode(payload);
+    if (!(/** @type {any} */ (serialize))._encoder) { /** @type {any} */ (serialize)._encoder = new TextEncoder(); }
+    payload = /** @type {any} */ (serialize)._encoder.encode(payload);
   }
 
   // Default to empty payload

package/src/protocol/validator.js

@@ -13,18 +13,19 @@ const { PROTOCOL_VERSION, MESSAGE_TYPE, MESH_CONFIG } = require('../constants');
  * Set of valid message type values for fast lookup.
  * @type {Set<number>}
  */
-const VALID_MESSAGE_TYPES = new Set(Object.values(MESSAGE_TYPE));
+const VALID_MESSAGE_TYPES = new Set(/** @type {number[]} */ (Object.values(MESSAGE_TYPE)));
 
 /**
  * Cached frozen result for valid validations to avoid repeated allocations.
  * @type {{ valid: boolean, errors: string[] }}
  */
-const VALID_RESULT = Object.freeze({ valid: true, errors: Object.freeze([]) });
+// @ts-ignore
+const VALID_RESULT = /** @type {{ valid: boolean, errors: string[] }} */ (Object.freeze({ valid: true, errors: Object.freeze([]) }));
 
 /**
  * Validates a message header.
  *
- * @param {MessageHeader|Object} header - Header to validate
+ * @param {any} header - Header to validate
  * @returns {{ valid: boolean, errors: string[] }} Validation result
  *
  * @example
@@ -121,7 +122,7 @@ function validateHeader(header) {
 /**
  * Validates a complete message (header + payload).
  *
- * @param {Message|Object} message - Message to validate
+ * @param {any} message - Message to validate
  * @returns {{ valid: boolean, errors: string[] }} Validation result
  *
  * @example
@@ -208,7 +209,7 @@ function isValidMessageType(type) {
 /**
  * Checks if a message is expired.
  *
- * @param {Message|MessageHeader|Object} messageOrHeader - Message or header
+ * @param {any} messageOrHeader - Message or header
  * @returns {boolean} True if expired
  */
 function isExpired(messageOrHeader) {
@@ -219,7 +220,7 @@ function isExpired(messageOrHeader) {
 /**
  * Checks if hop count has exceeded maximum.
  *
- * @param {Message|MessageHeader|Object} messageOrHeader - Message or header
+ * @param {any} messageOrHeader - Message or header
  * @returns {boolean} True if exceeded
  */
 function hasExceededMaxHops(messageOrHeader) {

package/src/service/BatteryOptimizer.js

@@ -14,7 +14,7 @@ const EventEmitter = require('../utils/EventEmitter');
 
 /**
  * Battery mode constants
- * @constant {Object}
+ * @constant {any}
  */
 const BATTERY_MODE = Object.freeze({
   HIGH_PERFORMANCE: 'high',
@@ -39,7 +39,7 @@ const BATTERY_MODE_SET = new Set(Object.values(BATTERY_MODE));
 
 /**
  * Default battery profiles
- * @constant {Object.<string, BatteryProfile>}
+ * @constant {Record<string, BatteryProfile>}
  */
 const DEFAULT_PROFILES = Object.freeze({
   [BATTERY_MODE.HIGH_PERFORMANCE]: {
@@ -79,7 +79,7 @@ const DEFAULT_PROFILES = Object.freeze({
 
 /**
  * Battery level thresholds for auto mode
- * @constant {Object}
+ * @constant {any}
  */
 const BATTERY_THRESHOLDS = Object.freeze({
   HIGH: 50, // Above 50%: high performance
@@ -90,7 +90,7 @@ const BATTERY_THRESHOLDS = Object.freeze({
 
 /**
  * Default configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Initial battery mode */
@@ -128,21 +128,21 @@ const DEFAULT_CONFIG = Object.freeze({
 class BatteryOptimizer extends EventEmitter {
   /**
      * Creates a new BatteryOptimizer 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 };
 
     /**
          * Battery profiles
-         * @type {Object.<string, BatteryProfile>}
+         * @type {Record<string, any>}
          * @private
          */
     this._profiles = { ...DEFAULT_PROFILES };
@@ -184,21 +184,21 @@ class BatteryOptimizer extends EventEmitter {
 
     /**
          * Battery check timer
-         * @type {number|null}
+         * @type {any}
          * @private
          */
     this._batteryCheckTimer = null;
 
     /**
          * Transport reference for applying settings
-         * @type {Object|null}
+         * @type {any}
          * @private
          */
     this._transport = null;
 
     /**
          * Statistics
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._stats = {
@@ -215,7 +215,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Sets the transport to control.
-     * @param {Object} transport - Transport instance
+     * @param {any} transport - Transport instance
      */
   setTransport(transport) {
     this._transport = transport;
@@ -227,6 +227,7 @@ class BatteryOptimizer extends EventEmitter {
      * @returns {Promise<void>}
      */
   async setMode(mode) {
+    // @ts-ignore
     if (!BATTERY_MODE_SET.has(mode)) {
       throw new Error(`Invalid battery mode: ${mode}`);
     }
@@ -262,7 +263,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Gets the current active profile.
-     * @returns {BatteryProfile} Active profile
+     * @returns {any} Active profile
      */
   getCurrentProfile() {
     if (this._currentMode === BATTERY_MODE.AUTO) {
@@ -273,7 +274,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Gets all available profiles.
-     * @returns {Object.<string, BatteryProfile>} Profiles
+     * @returns {Record<string, any>} Profiles
      */
   getProfiles() {
     return { ...this._profiles };
@@ -350,7 +351,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Gets optimizer statistics.
-     * @returns {Object} Statistics
+     * @returns {any} Statistics
      */
   getStats() {
     return {
@@ -374,7 +375,7 @@ class BatteryOptimizer extends EventEmitter {
   /**
      * Gets the appropriate profile for a battery level.
      * @param {number} level - Battery level
-     * @returns {BatteryProfile} Profile
+     * @returns {any} Profile
      * @private
      */
   _getProfileForBatteryLevel(level) {
@@ -414,7 +415,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Applies a battery profile to the transport.
-     * @param {BatteryProfile} profile - Profile to apply
+     * @param {any} profile - Profile to apply
      * @returns {Promise<void>}
      * @private
      */
@@ -445,7 +446,7 @@ class BatteryOptimizer extends EventEmitter {
       }
 
       this.emit('profile-applied', { profile });
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       this.emit('error', {
         message: 'Failed to apply battery profile',
         error: error.message