react-native-ble-mesh 2.1.0 → 2.1.2

package/src/crypto/providers/QuickCryptoProvider.js

@@ -25,7 +25,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 +38,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,7 +60,7 @@ 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([
@@ -81,12 +84,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 +102,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 +118,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 +136,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 +144,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

@@ -22,7 +22,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,6 +58,7 @@ class AppStateManager {
 
     // Try to get AppState from React Native
     try {
+      // @ts-ignore
       const { AppState } = require('react-native');
       this._AppState = AppState;
     } catch (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]);

package/src/index.js

@@ -69,7 +69,7 @@ function createMeshNetwork(config) {
 
 /**
  * Create a new MeshService instance
- * @param {Object} [config] - Configuration options
+ * @param {any} [config] - Configuration options
  * @returns {MeshService}
  */
 function createMeshService(config) {
@@ -80,7 +80,7 @@ function createMeshService(config) {
  * Create and initialize a MeshService for Node.js usage
  * @param {Object} [options] - Configuration options
  * @param {string} [options.displayName='MeshNode'] - Display name for this node
- * @param {Object} [options.storage=null] - Storage adapter (null for MemoryStorage)
+ * @param {any} [options.storage=null] - Storage adapter (null for MemoryStorage)
  * @returns {Promise<MeshService>} Initialized MeshService
  * @example
  * const mesh = await createNodeMesh({ displayName: 'Alice' });

package/src/mesh/dedup/BloomFilter.js

@@ -14,6 +14,7 @@ const FNV_PRIME = 0x01000193;
 const FNV_OFFSET = 0x811c9dc5;
 
 // Cached TextEncoder singleton (avoids per-call allocation)
+/** @type {any} */
 let _encoder = null;
 function _getEncoder() {
   if (!_encoder && typeof TextEncoder !== 'undefined') {

package/src/mesh/dedup/DedupManager.js

@@ -29,13 +29,10 @@ const DEFAULT_CONFIG = {
 class DedupManager {
   /**
    * Creates a new DedupManager
-   * @param {Object} [options] - Configuration options
-   * @param {number} [options.bloomFilterSize] - Size of Bloom filter in bits
-   * @param {number} [options.bloomHashCount] - Number of hash functions
-   * @param {number} [options.cacheSize] - Maximum LRU cache entries
-   * @param {number} [options.autoResetThreshold] - Fill ratio for auto reset
+   * @param {any} [options] - Configuration options   *
    */
   constructor(options = {}) {
+    /** @type {any} */
     const config = { ...DEFAULT_CONFIG, ...options };
 
     /**
@@ -78,7 +75,7 @@ class DedupManager {
 
     /**
      * Statistics for monitoring
-     * @type {Object}
+     * @type {any}
      * @private
      */
     this._stats = {
@@ -200,7 +197,7 @@ class DedupManager {
 
   /**
    * Gets deduplication statistics
-   * @returns {Object} Statistics object
+   * @returns {any} Statistics object
    */
   getStats() {
     return {

package/src/mesh/dedup/MessageCache.js

@@ -19,7 +19,9 @@ class CacheNode {
   constructor(key, timestamp) {
     this.key = key;
     this.timestamp = timestamp;
+    /** @type {CacheNode|null} */
     this.prev = null;
+    /** @type {CacheNode|null} */
     this.next = null;
   }
 }
@@ -207,6 +209,7 @@ class MessageCache {
    */
   getAll() {
     const result = [];
+    /** @type {CacheNode|null} */
     let node = this._head;
     while (node) {
       result.push(node.key);