react-native-ble-mesh 2.0.0 → 2.1.2

package/src/protocol/header.js

@@ -16,6 +16,12 @@ const { randomBytes } = require('../utils/bytes');
  */
 const HEADER_SIZE = 48;
 
+// Pre-computed hex lookup table (avoids Array.from().map().join() per call)
+const HEX_TABLE = new Array(256);
+for (let i = 0; i < 256; i++) {
+  HEX_TABLE[i] = (i < 16 ? '0' : '') + i.toString(16);
+}
+
 /**
  * Message header class representing the 48-byte header structure.
  * @class MessageHeader
@@ -43,7 +49,6 @@ class MessageHeader {
     this.flags = options.flags ?? MESSAGE_FLAGS.NONE;
     this.hopCount = options.hopCount ?? 0;
     this.maxHops = options.maxHops ?? MESH_CONFIG.MAX_HOPS;
-    this.reserved = new Uint8Array(3);
     this.messageId = options.messageId;
     this.timestamp = options.timestamp;
     this.expiresAt = options.expiresAt;
@@ -143,9 +148,8 @@ class MessageHeader {
     view.setUint16(40, header.payloadLength, false);
     buffer[42] = header.fragmentIndex;
     buffer[43] = header.fragmentTotal;
-    // Calculate checksum over header without checksum field
-    const checksumData = buffer.slice(0, 44);
-    const checksum = crc32(checksumData);
+    // Calculate checksum over header without checksum field (subarray = zero-copy view)
+    const checksum = crc32(buffer.subarray(0, 44));
     view.setUint32(44, checksum, false);
     header.checksum = checksum;
 
@@ -204,9 +208,11 @@ function writeUint64BE(view, offset, value) {
  * @returns {string} Hex string
  */
 function bytesToHex(bytes) {
-  return Array.from(bytes)
-    .map(b => b.toString(16).padStart(2, '0'))
-    .join('');
+  let hex = '';
+  for (let i = 0; i < bytes.length; i++) {
+    hex += HEX_TABLE[bytes[i]];
+  }
+  return hex;
 }
 
 module.exports = {

package/src/protocol/message.js

@@ -9,6 +9,18 @@ const { MessageHeader, HEADER_SIZE, generateUuid } = require('./header');
 const { MESSAGE_FLAGS, MESH_CONFIG } = require('../constants');
 const { MessageError } = require('../errors');
 
+// Cached TextEncoder/TextDecoder singletons (avoids per-call allocation)
+/** @type {any} */ let _encoder = null;
+/** @type {any} */ let _decoder = null;
+function _getEncoder() {
+  if (!_encoder) { _encoder = new TextEncoder(); }
+  return _encoder;
+}
+function _getDecoder() {
+  if (!_decoder) { _decoder = new TextDecoder(); }
+  return _decoder;
+}
+
 /**
  * Message class representing a complete mesh network message.
  * @class Message
@@ -16,11 +28,11 @@ const { MessageError } = require('../errors');
 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;
@@ -28,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) {
@@ -44,7 +48,7 @@ class Message {
 
     // Convert string payload to bytes
     if (typeof payload === 'string') {
-      payload = new TextEncoder().encode(payload);
+      payload = _getEncoder().encode(payload);
     }
 
     if (!(payload instanceof Uint8Array)) {
@@ -99,7 +103,7 @@ class Message {
       });
     }
 
-    const payload = data.slice(HEADER_SIZE, HEADER_SIZE + header.payloadLength);
+    const payload = data.subarray(HEADER_SIZE, HEADER_SIZE + header.payloadLength);
 
     return new Message(header, payload);
   }
@@ -171,7 +175,7 @@ class Message {
    * @returns {string} Decoded payload content
    */
   getContent() {
-    return new TextDecoder().decode(this.payload);
+    return _getDecoder().decode(this.payload);
   }
 
   /**

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
  *
@@ -71,9 +71,8 @@ function serializeHeader(header) {
   // Byte 43: fragmentTotal
   buffer[43] = header.fragmentTotal ?? 1;
 
-  // Bytes 44-47: checksum (calculated over bytes 0-43)
-  const checksumData = buffer.slice(0, 44);
-  const checksum = crc32(checksumData);
+  // Bytes 44-47: checksum (calculated over bytes 0-43, subarray = zero-copy view)
+  const checksum = crc32(buffer.subarray(0, 44));
   view.setUint32(44, checksum, false);
 
   return buffer;
@@ -82,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
  *
@@ -110,7 +109,8 @@ function serialize(message) {
 
   // Convert string payload to bytes
   if (typeof payload === 'string') {
-    payload = new TextEncoder().encode(payload);
+    if (!(/** @type {any} */ (serialize))._encoder) { /** @type {any} */ (serialize)._encoder = new TextEncoder(); }
+    payload = /** @type {any} */ (serialize)._encoder.encode(payload);
   }
 
   // Default to empty payload
@@ -122,13 +122,10 @@ function serialize(message) {
     throw MessageError.invalidFormat(null, { reason: 'Payload must be Uint8Array or string' });
   }
 
-  // Update payloadLength in header
-  const headerWithLength = {
-    ...header,
-    payloadLength: payload.length
-  };
+  // Update payloadLength directly (avoids object spread allocation)
+  header.payloadLength = payload.length;
 
-  const headerBytes = serializeHeader(headerWithLength);
+  const headerBytes = serializeHeader(header);
   const result = new Uint8Array(headerBytes.length + payload.length);
 
   result.set(headerBytes, 0);

package/src/protocol/validator.js

@@ -13,12 +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[] }}
+ */
+// @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
@@ -102,8 +109,12 @@ function validateHeader(header) {
     errors.push(`Fragment index (${header.fragmentIndex}) >= total (${header.fragmentTotal})`);
   }
 
+  if (errors.length === 0) {
+    return VALID_RESULT;
+  }
+
   return {
-    valid: errors.length === 0,
+    valid: false,
     errors
   };
 }
@@ -111,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
@@ -152,8 +163,12 @@ function validateMessage(message) {
     }
   }
 
+  if (errors.length === 0) {
+    return VALID_RESULT;
+  }
+
   return {
-    valid: errors.length === 0,
+    valid: false,
     errors
   };
 }
@@ -171,7 +186,7 @@ function validateChecksum(headerBytes) {
 
   const view = new DataView(headerBytes.buffer, headerBytes.byteOffset, HEADER_SIZE);
   const storedChecksum = view.getUint32(44, false);
-  const checksumData = headerBytes.slice(0, 44);
+  const checksumData = headerBytes.subarray(0, 44);
   const calculatedChecksum = crc32(checksumData);
 
   return {
@@ -194,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) {
@@ -205,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) {
@@ -242,7 +257,7 @@ function validateRawMessage(data) {
   }
 
   // Validate checksum
-  const checksumResult = validateChecksum(data.slice(0, HEADER_SIZE));
+  const checksumResult = validateChecksum(data.subarray(0, HEADER_SIZE));
   if (!checksumResult.valid) {
     errors.push(
       `Checksum mismatch: expected 0x${checksumResult.expected.toString(16)}, ` +
@@ -259,8 +274,12 @@ function validateRawMessage(data) {
     errors.push(`Incomplete message: expected ${expectedTotal} bytes, got ${data.length}`);
   }
 
+  if (errors.length === 0) {
+    return VALID_RESULT;
+  }
+
   return {
-    valid: errors.length === 0,
+    valid: false,
     errors
   };
 }

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',
@@ -23,6 +23,9 @@ const BATTERY_MODE = Object.freeze({
   AUTO: 'auto'
 });
 
+/** Pre-computed Set of valid battery modes for O(1) lookup */
+const BATTERY_MODE_SET = new Set(Object.values(BATTERY_MODE));
+
 /**
  * Battery profile configuration
  * @typedef {Object} BatteryProfile
@@ -36,7 +39,7 @@ const BATTERY_MODE = Object.freeze({
 
 /**
  * Default battery profiles
- * @constant {Object.<string, BatteryProfile>}
+ * @constant {Record<string, BatteryProfile>}
  */
 const DEFAULT_PROFILES = Object.freeze({
   [BATTERY_MODE.HIGH_PERFORMANCE]: {
@@ -76,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
@@ -87,7 +90,7 @@ const BATTERY_THRESHOLDS = Object.freeze({
 
 /**
  * Default configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Initial battery mode */
@@ -125,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 };
@@ -181,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 = {
@@ -212,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;
@@ -224,7 +227,8 @@ class BatteryOptimizer extends EventEmitter {
      * @returns {Promise<void>}
      */
   async setMode(mode) {
-    if (!Object.values(BATTERY_MODE).includes(mode)) {
+    // @ts-ignore
+    if (!BATTERY_MODE_SET.has(mode)) {
       throw new Error(`Invalid battery mode: ${mode}`);
     }
 
@@ -259,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) {
@@ -270,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 };
@@ -347,7 +351,7 @@ class BatteryOptimizer extends EventEmitter {
 
   /**
      * Gets optimizer statistics.
-     * @returns {Object} Statistics
+     * @returns {any} Statistics
      */
   getStats() {
     return {
@@ -371,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) {
@@ -411,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
      */
@@ -442,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

package/src/service/EmergencyManager.js

@@ -13,7 +13,7 @@ const EventEmitter = require('../utils/EventEmitter');
 
 /**
  * Panic trigger types
- * @constant {Object}
+ * @constant {any}
  */
 const PANIC_TRIGGER = Object.freeze({
   TRIPLE_TAP: 'triple_tap',
@@ -24,7 +24,7 @@ const PANIC_TRIGGER = Object.freeze({
 
 /**
  * Default configuration
- * @constant {Object}
+ * @constant {any}
  */
 const DEFAULT_CONFIG = Object.freeze({
   /** Trigger type for panic mode */
@@ -63,18 +63,14 @@ const DEFAULT_CONFIG = Object.freeze({
 class EmergencyManager extends EventEmitter {
   /**
      * Creates a new EmergencyManager instance.
-     * @param {Object} [options={}] - Configuration options
-     * @param {string} [options.trigger='triple_tap'] - Panic trigger type
-     * @param {number} [options.tapWindowMs=500] - Time window for taps
-     * @param {number} [options.tapCount=3] - Required tap count
-     * @param {boolean} [options.requireConfirmation=false] - Require confirmation
+     * @param {any} [options] - Configuration options
      */
   constructor(options = {}) {
     super();
 
     /**
          * Configuration
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._config = { ...DEFAULT_CONFIG, ...options };
@@ -88,7 +84,7 @@ class EmergencyManager extends EventEmitter {
 
     /**
          * Tap tracking
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._tapState = {
@@ -98,7 +94,7 @@ class EmergencyManager extends EventEmitter {
 
     /**
          * Shake tracking
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._shakeState = {
@@ -122,7 +118,7 @@ class EmergencyManager extends EventEmitter {
 
     /**
          * Statistics
-         * @type {Object}
+         * @type {any}
          * @private
          */
     this._stats = {
@@ -134,9 +130,7 @@ class EmergencyManager extends EventEmitter {
 
   /**
      * Enables panic mode.
-     * @param {Object} [options={}] - Enable options
-     * @param {Function} [options.onWipe] - Callback after wipe
-     * @param {string} [options.trigger] - Override trigger type
+     * @param {any} [options] - Enable options
      */
   enablePanicMode(options = {}) {
     this._enabled = true;
@@ -208,10 +202,7 @@ class EmergencyManager extends EventEmitter {
 
   /**
      * Registers accelerometer data for shake detection.
-     * @param {Object} data - Accelerometer data
-     * @param {number} data.x - X acceleration
-     * @param {number} data.y - Y acceleration
-     * @param {number} data.z - Z acceleration
+     * @param {any} data - Accelerometer data
      */
   registerAccelerometer(data) {
     if (!this._enabled || this._config.trigger !== PANIC_TRIGGER.SHAKE) {
@@ -236,7 +227,7 @@ class EmergencyManager extends EventEmitter {
 
   /**
      * Manually triggers panic wipe.
-     * @returns {Promise<Object>} Wipe result
+     * @returns {Promise<any>} Wipe result
      */
   async triggerManualWipe() {
     return this._executeWipe(PANIC_TRIGGER.MANUAL);
@@ -244,7 +235,7 @@ class EmergencyManager extends EventEmitter {
 
   /**
      * Wipes all registered data.
-     * @returns {Promise<Object>} Wipe result with timing
+     * @returns {Promise<any>} Wipe result with timing
      */
   async wipeAllData() {
     return this._executeWipe(PANIC_TRIGGER.MANUAL);
@@ -252,7 +243,7 @@ class EmergencyManager extends EventEmitter {
 
   /**
      * Gets emergency statistics.
-     * @returns {Object} Statistics
+     * @returns {any} Statistics
      */
   getStats() {
     return { ...this._stats };
@@ -280,7 +271,7 @@ class EmergencyManager extends EventEmitter {
 
     try {
       await this._executeWipe(trigger);
-    } catch (error) {
+    } catch (/** @type {any} */ error) {
       this.emit('error', {
         message: 'Panic wipe failed',
         error: error.message,
@@ -292,7 +283,7 @@ class EmergencyManager extends EventEmitter {
   /**
      * Executes the data wipe.
      * @param {string} trigger - Trigger type
-     * @returns {Promise<Object>} Wipe result
+     * @returns {Promise<any>} Wipe result
      * @private
      */
   async _executeWipe(trigger) {
@@ -300,6 +291,7 @@ class EmergencyManager extends EventEmitter {
 
     this.emit('panic-wipe-started', { trigger, timestamp: startTime });
 
+    /** @type {any} */
     const results = {
       trigger,
       startTime,
@@ -308,12 +300,13 @@ class EmergencyManager extends EventEmitter {
     };
 
     // Execute all clearers in parallel for speed
+    /** @type {any[]} */
     const clearerResults = new Array(this._clearers.length);
     const promises = this._clearers.map(async (clearer, index) => {
       try {
         await clearer();
         clearerResults[index] = { index, success: true };
-      } catch (error) {
+      } catch (/** @type {any} */ error) {
         results.errors.push({ index, error: error.message });
         clearerResults[index] = { index, success: false, error: error.message };
       }
@@ -344,7 +337,7 @@ class EmergencyManager extends EventEmitter {
     if (this._onWipe) {
       try {
         this._onWipe(results);
-      } catch (error) {
+      } catch (/** @type {any} */ error) {
         // Ignore callback errors
       }
     }