react-native-ble-mesh 2.1.0 → 2.1.3

package/src/service/audio/AudioManager.js

@@ -18,7 +18,7 @@ const { unpackFrame, createStreamFrame } = require('./transport/AudioFramer');
 
 /**
  * Audio manager states
- * @constant {Object}
+ * @constant {any}
  */
 const MANAGER_STATE = Object.freeze({
   UNINITIALIZED: 'uninitialized',
@@ -37,28 +37,29 @@ const MANAGER_STATE = Object.freeze({
 class AudioManager extends EventEmitter {
   /**
    * Creates a new AudioManager
-   * @param {Object} [options] - Manager options
-   * @param {string} [options.quality='MEDIUM'] - Audio quality preset
+   * @param {any} [options] - Manager options
    */
   constructor(options = {}) {
     super();
 
-    /** @private */
+    /** @type {string} @private */
     this._quality = options.quality || 'MEDIUM';
-    /** @private */
+    /** @type {string} @private */
     this._state = MANAGER_STATE.UNINITIALIZED;
-    /** @private */
+    /** @type {any} @private */
     this._meshService = null;
-    /** @private */
+    /** @type {any} @private */
     this._codec = null;
-    /** @private */
+    /** @type {Map<string, any>} @private */
     this._sessions = new Map(); // peerId -> AudioSession
-    /** @private */
+    /** @type {Map<string, any>} @private */
     this._pendingRequests = new Map(); // peerId -> { resolve, reject, timeout }
     /** @private */
     this._voiceAssembler = new AudioAssembler();
-    /** @private */
+    /** @type {any} @private */
     this._senderId = null;
+    /** @type {string|undefined} @private */
+    this._lastVoiceMessagePeerId = undefined;
 
     this._setupAssemblerEvents();
   }
@@ -68,15 +69,15 @@ class AudioManager extends EventEmitter {
    * @private
    */
   _setupAssemblerEvents() {
-    this._voiceAssembler.on('complete', (data) => {
+    this._voiceAssembler.on('complete', (/** @type {any} */ data) => {
       this._handleVoiceMessageComplete(data);
     });
 
-    this._voiceAssembler.on('progress', (data) => {
+    this._voiceAssembler.on('progress', (/** @type {any} */ data) => {
       this.emit(EVENTS.VOICE_MESSAGE_PROGRESS, data);
     });
 
-    this._voiceAssembler.on('timeout', (data) => {
+    this._voiceAssembler.on('timeout', (/** @type {any} */ data) => {
       this.emit(EVENTS.VOICE_MESSAGE_FAILED, {
         ...data,
         error: AudioError.voiceMessageTimeout(data.messageId)
@@ -86,7 +87,7 @@ class AudioManager extends EventEmitter {
 
   /**
    * Initializes the audio manager
-   * @param {MeshService} meshService - Mesh service instance
+   * @param {any} meshService - Mesh service instance
    * @returns {Promise<void>}
    */
   async initialize(meshService) {
@@ -104,13 +105,13 @@ class AudioManager extends EventEmitter {
       this._senderId = identity.publicKey || new Uint8Array(32);
 
       // Initialize codec
-      const qualityConfig = AUDIO_QUALITY[this._quality];
+      const qualityConfig = /** @type {any} */ (AUDIO_QUALITY)[this._quality];
       this._codec = new LC3Codec(qualityConfig);
       await this._codec.initialize();
 
       this._setState(MANAGER_STATE.READY);
       this.emit('initialized', { quality: this._quality, codec: this._codec.getConfig() });
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       this._setState(MANAGER_STATE.ERROR);
       throw AudioError.codecInitFailed({ reason: error.message });
     }
@@ -122,6 +123,7 @@ class AudioManager extends EventEmitter {
    */
   async destroy() {
     // End all sessions and wait for completion
+    /** @type {Promise<void>[]} */
     const endPromises = [];
     for (const [, session] of this._sessions) {
       if (session && typeof session.end === 'function') {
@@ -156,7 +158,8 @@ class AudioManager extends EventEmitter {
    * @param {string} quality - Quality preset (LOW, MEDIUM, HIGH)
    */
   setQuality(quality) {
-    if (!AUDIO_QUALITY[quality]) {
+    const qualities = /** @type {any} */ (AUDIO_QUALITY);
+    if (!qualities[quality]) {
       throw AudioError.invalidConfig(`Unknown quality: ${quality}`);
     }
     this._quality = quality;
@@ -172,7 +175,7 @@ class AudioManager extends EventEmitter {
 
   /**
    * Returns codec info
-   * @returns {Object|null}
+   * @returns {any}
    */
   getCodecInfo() {
     return this._codec ? this._codec.getConfig() : null;
@@ -181,7 +184,7 @@ class AudioManager extends EventEmitter {
   /**
    * Requests an audio stream with a peer
    * @param {string} peerId - Remote peer ID
-   * @returns {Promise<AudioSession>}
+   * @returns {Promise<any>}
    */
   async requestStream(peerId) {
     this._validateReady();
@@ -194,7 +197,7 @@ class AudioManager extends EventEmitter {
       peerId,
       codec: this._codec,
       isInitiator: true,
-      sendCallback: (data) => this._sendStreamData(data)
+      sendCallback: (/** @type {any} */ data) => this._sendStreamData(data)
     });
 
     session.setRequesting();
@@ -219,7 +222,7 @@ class AudioManager extends EventEmitter {
   /**
    * Accepts an incoming stream request
    * @param {string} peerId - Remote peer ID
-   * @returns {Promise<AudioSession>}
+   * @returns {Promise<any>}
    */
   async acceptStream(peerId) {
     this._validateReady();
@@ -270,7 +273,7 @@ class AudioManager extends EventEmitter {
   /**
    * Gets a session by peer ID
    * @param {string} peerId - Peer ID
-   * @returns {AudioSession|undefined}
+   * @returns {any}
    */
   getSession(peerId) {
     return this._sessions.get(peerId);
@@ -278,11 +281,11 @@ class AudioManager extends EventEmitter {
 
   /**
    * Gets all active sessions
-   * @returns {AudioSession[]}
+   * @returns {any[]}
    */
   getActiveSessions() {
     return Array.from(this._sessions.values())
-      .filter(s => s.getState() === AUDIO_SESSION_STATE.ACTIVE);
+      .filter((/** @type {any} */ s) => s.getState() === AUDIO_SESSION_STATE.ACTIVE);
   }
 
   /**
@@ -301,7 +304,7 @@ class AudioManager extends EventEmitter {
   /**
    * Sends a voice message to a peer
    * @param {string} peerId - Remote peer ID
-   * @param {VoiceMessage} message - Voice message to send
+   * @param {any} message - Voice message to send
    * @returns {Promise<string>} Message ID
    */
   async sendVoiceMessage(peerId, message) {
@@ -353,7 +356,10 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @private
+   */
   _handleStreamRequest(peerId) {
     if (this._sessions.has(peerId)) { return; }
 
@@ -361,7 +367,7 @@ class AudioManager extends EventEmitter {
       peerId,
       codec: this._codec,
       isInitiator: false,
-      sendCallback: (data) => this._sendStreamData(data)
+      sendCallback: (/** @type {any} */ data) => this._sendStreamData(data)
     });
 
     session.setPending();
@@ -370,7 +376,10 @@ class AudioManager extends EventEmitter {
     this.emit(EVENTS.AUDIO_STREAM_REQUEST, { peerId });
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @private
+   */
   _handleStreamAccept(peerId) {
     const request = this._pendingRequests.get(peerId);
     if (request) {
@@ -383,7 +392,11 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @param {Uint8Array} payload
+   * @private
+   */
   _handleStreamReject(peerId, payload) {
     const request = this._pendingRequests.get(peerId);
     if (request) {
@@ -395,20 +408,27 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @param {Uint8Array} payload
+   * @private
+   */
   _handleStreamData(peerId, payload) {
     const session = this._sessions.get(peerId);
     if (session && session.getState() === AUDIO_SESSION_STATE.ACTIVE) {
       try {
         const { frame, sequenceNumber, timestampDelta } = unpackFrame(payload);
         session.receiveAudio(frame, sequenceNumber, timestampDelta);
-      } catch (error) {
+      } catch (/** @type {any} */ error) {
         this.emit('error', error);
       }
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @private
+   */
   _handleStreamEnd(peerId) {
     const session = this._sessions.get(peerId);
     if (session) {
@@ -418,7 +438,11 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @param {Uint8Array} payload
+   * @private
+   */
   _handleVoiceMessageFragment(peerId, payload) {
     const fullPayload = new Uint8Array(payload.length + 1);
     fullPayload[0] = payload[0]; // type is already in payload for fragments
@@ -431,7 +455,10 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {any} param0
+   * @private
+   */
   _handleVoiceMessageComplete({ messageId, size }) {
     // Note: The actual voice message data comes from the assembler
     this.emit(EVENTS.VOICE_MESSAGE_RECEIVED, {
@@ -441,13 +468,21 @@ class AudioManager extends EventEmitter {
     });
   }
 
-  /** @private */
+  /**
+   * @param {any} param0
+   * @private
+   */
   async _sendStreamData({ peerId, frame, sequenceNumber, timestampDelta }) {
     const packed = createStreamFrame(frame, sequenceNumber, timestampDelta);
     await this._sendRaw(peerId, packed);
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @param {number} type
+   * @param {Uint8Array} payload
+   * @private
+   */
   async _sendMessage(peerId, type, payload) {
     const data = new Uint8Array(1 + payload.length);
     data[0] = type;
@@ -455,7 +490,11 @@ class AudioManager extends EventEmitter {
     await this._sendRaw(peerId, data);
   }
 
-  /** @private */
+  /**
+   * @param {string} peerId
+   * @param {Uint8Array} data
+   * @private
+   */
   async _sendRaw(peerId, data) {
     if (this._meshService && typeof this._meshService._sendRaw === 'function') {
       await this._meshService._sendRaw(peerId, data);
@@ -474,7 +513,10 @@ class AudioManager extends EventEmitter {
     }
   }
 
-  /** @private */
+  /**
+   * @param {string} newState
+   * @private
+   */
   _setState(newState) {
     this._state = newState;
   }

package/src/service/audio/buffer/FrameBuffer.js

@@ -14,18 +14,16 @@ const { VOICE_MESSAGE_CONFIG } = require('../../../constants/audio');
 class FrameBuffer {
   /**
    * Creates a new FrameBuffer
-   * @param {Object} [options] - Buffer options
-   * @param {number} [options.maxFrames=30000] - Maximum frames to store
-   * @param {number} [options.maxBytes] - Maximum bytes to store
+   * @param {any} [options] - Buffer options
    */
   constructor(options = {}) {
-    /** @private */
+    /** @type {number} @private */
     this._maxFrames = options.maxFrames || 30000;
-    /** @private */
+    /** @type {number} @private */
     this._maxBytes = options.maxBytes || VOICE_MESSAGE_CONFIG.MAX_SIZE_BYTES;
-    /** @private */
+    /** @type {Uint8Array[]} @private */
     this._frames = [];
-    /** @private */
+    /** @type {number} @private */
     this._totalBytes = 0;
   }
 
@@ -99,6 +97,7 @@ class FrameBuffer {
    */
   serialize() {
     // Format: [frameCount(4)] + [frameLen(2) + frameData]...
+    /** @type {Uint8Array[]} */
     const parts = [];
     const countBytes = new Uint8Array(4);
     new DataView(countBytes.buffer).setUint32(0, this._frames.length, false);
@@ -111,7 +110,7 @@ class FrameBuffer {
       parts.push(frame);
     }
 
-    const totalLen = parts.reduce((sum, p) => sum + p.length, 0);
+    const totalLen = parts.reduce((/** @type {number} */ sum, /** @type {Uint8Array} */ p) => sum + p.length, 0);
     const result = new Uint8Array(totalLen);
     let offset = 0;
 

package/src/service/audio/buffer/JitterBuffer.js

@@ -149,7 +149,7 @@ class JitterBuffer extends EventEmitter {
 
   /**
    * Returns buffer statistics
-   * @returns {Object}
+   * @returns {any}
    */
   getStats() {
     return {

package/src/service/audio/codec/LC3Codec.js

@@ -1,4 +1,5 @@
 'use strict';
+/* global __DEV__ */
 
 /**
  * @fileoverview LC3 codec wrapper for React Native
@@ -17,30 +18,27 @@ const { LC3_CONFIG, AUDIO_QUALITY } = require('../../../constants/audio');
 class LC3Codec extends EventEmitter {
   /**
    * Creates a new LC3Codec instance
-   * @param {Object} [options] - Codec configuration
-   * @param {number} [options.sampleRate=16000] - Sample rate in Hz
-   * @param {number} [options.frameMs=10] - Frame duration in milliseconds
-   * @param {number} [options.bitRate=24000] - Bit rate in bps
-   * @param {number} [options.channels=1] - Number of audio channels
+   * @param {any} [options] - Codec configuration
    */
   constructor(options = {}) {
     super();
 
-    const quality = options.quality ? AUDIO_QUALITY[options.quality] : null;
+    /** @type {any} */
+    const quality = options.quality ? /** @type {any} */ (AUDIO_QUALITY)[options.quality] : null;
 
-    /** @private */
+    /** @type {number} @private */
     this._sampleRate = quality?.sampleRate || options.sampleRate || LC3_CONFIG.DEFAULT_SAMPLE_RATE;
-    /** @private */
+    /** @type {number} @private */
     this._frameMs = quality?.frameMs || options.frameMs || LC3_CONFIG.DEFAULT_FRAME_DURATION_MS;
-    /** @private */
+    /** @type {number} @private */
     this._bitRate = quality?.bitRate || options.bitRate || LC3_CONFIG.DEFAULT_BIT_RATE;
-    /** @private */
+    /** @type {number} @private */
     this._channels = quality?.channels || options.channels || LC3_CONFIG.DEFAULT_CHANNELS;
-    /** @private */
+    /** @type {boolean} @private */
     this._initialized = false;
-    /** @private */
+    /** @type {any} @private */
     this._nativeModule = null;
-    /** @private */
+    /** @type {boolean} @private */
     this._useMock = false;
 
     this._validateConfig();
@@ -82,12 +80,14 @@ class LC3Codec extends EventEmitter {
       } else {
         // Use mock implementation for testing
         this._useMock = true;
-        console.warn('LC3Codec: Native module not available, using mock implementation');
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.warn('LC3Codec: Native module not available, using mock implementation');
+        }
       }
 
       this._initialized = true;
       this.emit('initialized', this.getConfig());
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       throw AudioError.codecInitFailed({ reason: error.message });
     }
   }
@@ -95,7 +95,7 @@ class LC3Codec extends EventEmitter {
   /**
    * Attempts to load the native LC3 module
    * @private
-   * @returns {Object|null}
+   * @returns {any}
    */
   _loadNativeModule() {
     try {
@@ -150,7 +150,7 @@ class LC3Codec extends EventEmitter {
     try {
       const result = await this._nativeModule.encode(Array.from(pcmSamples));
       return new Uint8Array(result);
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       throw AudioError.encodingFailed({ reason: error.message });
     }
   }
@@ -172,7 +172,7 @@ class LC3Codec extends EventEmitter {
     try {
       const result = await this._nativeModule.decode(Array.from(lc3Frame));
       return new Int16Array(result);
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       throw AudioError.decodingFailed({ reason: error.message });
     }
   }
@@ -193,13 +193,14 @@ class LC3Codec extends EventEmitter {
     try {
       const result = await this._nativeModule.decodePLC();
       return new Int16Array(result);
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       throw AudioError.decodingFailed({ reason: error.message });
     }
   }
 
   /**
    * Mock encode implementation for testing
+   * @param {Int16Array} pcmSamples
    * @private
    */
   _mockEncode(pcmSamples) {
@@ -217,6 +218,7 @@ class LC3Codec extends EventEmitter {
 
   /**
    * Mock decode implementation for testing
+   * @param {Uint8Array} lc3Frame
    * @private
    */
   _mockDecode(lc3Frame) {
@@ -261,7 +263,7 @@ class LC3Codec extends EventEmitter {
 
   /**
    * Returns the current codec configuration
-   * @returns {Object}
+   * @returns {any}
    */
   getConfig() {
     return {

package/src/service/audio/codec/LC3Decoder.js

@@ -16,7 +16,7 @@ const AudioError = require('../../../errors/AudioError');
 class LC3Decoder extends EventEmitter {
   /**
    * Creates a new LC3Decoder
-   * @param {LC3Codec} codec - Initialized LC3 codec instance
+   * @param {any} codec - Initialized LC3 codec instance
    */
   constructor(codec) {
     super();
@@ -25,17 +25,17 @@ class LC3Decoder extends EventEmitter {
       throw AudioError.codecInitFailed({ reason: 'Codec must be initialized' });
     }
 
-    /** @private */
+    /** @type {any} @private */
     this._codec = codec;
-    /** @private */
+    /** @type {number} @private */
     this._frameSamples = codec.getFrameSamples();
-    /** @private */
+    /** @type {number} @private */
     this._framesDecoded = 0;
-    /** @private */
+    /** @type {number} @private */
     this._plcFrames = 0;
-    /** @private */
+    /** @type {number} @private */
     this._errors = 0;
-    /** @private */
+    /** @type {number} @private */
     this._lastSequence = -1;
   }
 
@@ -63,7 +63,7 @@ class LC3Decoder extends EventEmitter {
       this._framesDecoded++;
       this.emit('samples', { samples, index: this._framesDecoded });
       return samples;
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       this._errors++;
       this.emit('error', error);
       throw error;
@@ -80,7 +80,7 @@ class LC3Decoder extends EventEmitter {
       this._plcFrames++;
       this.emit('plc', { samples, plcCount: this._plcFrames });
       return samples;
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       this._errors++;
       this.emit('error', error);
       // Return silence on PLC failure
@@ -106,7 +106,7 @@ class LC3Decoder extends EventEmitter {
 
   /**
    * Returns decoder statistics
-   * @returns {Object}
+   * @returns {any}
    */
   getStats() {
     return {

package/src/service/audio/codec/LC3Encoder.js

@@ -16,7 +16,7 @@ const AudioError = require('../../../errors/AudioError');
 class LC3Encoder extends EventEmitter {
   /**
    * Creates a new LC3Encoder
-   * @param {LC3Codec} codec - Initialized LC3 codec instance
+   * @param {any} codec - Initialized LC3 codec instance
    */
   constructor(codec) {
     super();
@@ -25,17 +25,17 @@ class LC3Encoder extends EventEmitter {
       throw AudioError.codecInitFailed({ reason: 'Codec must be initialized' });
     }
 
-    /** @private */
+    /** @type {any} @private */
     this._codec = codec;
-    /** @private */
+    /** @type {number} @private */
     this._frameSamples = codec.getFrameSamples();
     /** @private */
     this._sampleBuffer = new Int16Array(this._frameSamples * 2);
-    /** @private */
+    /** @type {number} @private */
     this._bufferOffset = 0;
-    /** @private */
+    /** @type {number} @private */
     this._framesEncoded = 0;
-    /** @private */
+    /** @type {number} @private */
     this._errors = 0;
   }
 
@@ -45,6 +45,7 @@ class LC3Encoder extends EventEmitter {
    * @returns {Promise<Uint8Array[]>} Array of encoded LC3 frames
    */
   async pushSamples(samples) {
+    /** @type {Uint8Array[]} */
     const frames = [];
     let offset = 0;
 
@@ -68,7 +69,7 @@ class LC3Encoder extends EventEmitter {
           frames.push(encoded);
           this._framesEncoded++;
           this.emit('frame', { frame: encoded, index: this._framesEncoded });
-        } catch (error) {
+        } catch (/** @type {any} */ error) {
           this._errors++;
           this.emit('error', error);
         }
@@ -84,6 +85,7 @@ class LC3Encoder extends EventEmitter {
    * @returns {Promise<Uint8Array[]>} Array of encoded LC3 frames
    */
   async flush() {
+    /** @type {Uint8Array[]} */
     const frames = [];
 
     if (this._bufferOffset > 0) {
@@ -96,7 +98,7 @@ class LC3Encoder extends EventEmitter {
         frames.push(encoded);
         this._framesEncoded++;
         this.emit('frame', { frame: encoded, index: this._framesEncoded, padded: true });
-      } catch (error) {
+      } catch (/** @type {any} */ error) {
         this._errors++;
         this.emit('error', error);
       }
@@ -117,7 +119,7 @@ class LC3Encoder extends EventEmitter {
 
   /**
    * Returns encoder statistics
-   * @returns {Object}
+   * @returns {any}
    */
   getStats() {
     return {