react-native-ble-mesh 2.0.0 → 2.1.2

package/src/constants/audio.js

@@ -7,7 +7,7 @@
 
 /**
  * LC3 codec configuration
- * @constant {Object}
+ * @constant {any}
  */
 const LC3_CONFIG = Object.freeze({
   /** Supported sample rates (Hz) */
@@ -62,7 +62,7 @@ const AUDIO_QUALITY = Object.freeze({
 
 /**
  * Voice message configuration
- * @constant {Object}
+ * @constant {any}
  */
 const VOICE_MESSAGE_CONFIG = Object.freeze({
   /** Maximum voice message duration in seconds */
@@ -79,7 +79,7 @@ const VOICE_MESSAGE_CONFIG = Object.freeze({
 
 /**
  * Audio streaming configuration
- * @constant {Object}
+ * @constant {any}
  */
 const AUDIO_STREAM_CONFIG = Object.freeze({
   /** Default jitter buffer size in frames */
@@ -98,7 +98,7 @@ const AUDIO_STREAM_CONFIG = Object.freeze({
 
 /**
  * Audio session states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const AUDIO_SESSION_STATE = Object.freeze({
   IDLE: 'idle',

package/src/constants/ble.js

@@ -77,7 +77,7 @@ const POWER_MODE = Object.freeze({
 
 /**
  * Bluetooth adapter states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const BLUETOOTH_STATE = Object.freeze({
   UNKNOWN: 'unknown',

package/src/constants/crypto.js

@@ -35,7 +35,7 @@ const NOISE_PROTOCOL_NAME = 'Noise_XX_25519_ChaChaPoly_SHA256';
 
 /**
  * Noise handshake states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const NOISE_HANDSHAKE_STATE = Object.freeze({
   INITIAL: 'initial',

package/src/constants/errors.js

@@ -7,7 +7,7 @@
 
 /**
  * Error codes organized by category
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const ERROR_CODE = Object.freeze({
   // Initialization errors (E0xx)
@@ -108,7 +108,7 @@ const ERROR_CODE = Object.freeze({
 
 /**
  * Error messages for each error code
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const ERROR_MESSAGES = Object.freeze({
   E001: 'Initialization failed',

package/src/constants/events.js

@@ -7,7 +7,7 @@
 
 /**
  * Event names for the mesh network
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const EVENTS = Object.freeze({
   // Lifecycle events

package/src/constants/protocol.js

@@ -115,7 +115,7 @@ const MESH_CONFIG = Object.freeze({
 
 /**
  * Connection states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const CONNECTION_STATE = Object.freeze({
   DISCONNECTED: 'disconnected',
@@ -129,7 +129,7 @@ const CONNECTION_STATE = Object.freeze({
 
 /**
  * Service states
- * @constant {Object.<string, string>}
+ * @type {Record<string, string>}
  */
 const SERVICE_STATE = Object.freeze({
   UNINITIALIZED: 'uninitialized',

package/src/crypto/AutoCrypto.js

@@ -14,25 +14,36 @@ const QuickCryptoProvider = require('./providers/QuickCryptoProvider');
 const ExpoCryptoProvider = require('./providers/ExpoCryptoProvider');
 const TweetNaClProvider = require('./providers/TweetNaClProvider');
 
+/** @type {import('./CryptoProvider')|null} Cached singleton provider */
+let _cachedProvider = null;
+
 /**
  * Detects and returns the best available crypto provider.
+ * The result is cached as a singleton for subsequent calls.
  * @returns {import('./CryptoProvider')} Best available provider
  * @throws {Error} If no crypto provider is available
  */
 function detectProvider() {
+  if (_cachedProvider) {
+    return _cachedProvider;
+  }
+
   // 1. Native speed (react-native-quick-crypto)
   if (QuickCryptoProvider.isAvailable()) {
-    return new QuickCryptoProvider();
+    _cachedProvider = new QuickCryptoProvider();
+    return _cachedProvider;
   }
 
   // 2. Expo (expo-crypto + tweetnacl)
   if (ExpoCryptoProvider.isAvailable()) {
-    return new ExpoCryptoProvider();
+    _cachedProvider = new ExpoCryptoProvider();
+    return _cachedProvider;
   }
 
   // 3. Universal (tweetnacl)
   if (TweetNaClProvider.isAvailable()) {
-    return new TweetNaClProvider();
+    _cachedProvider = new TweetNaClProvider();
+    return _cachedProvider;
   }
 
   throw new Error(
@@ -53,7 +64,9 @@ function createProvider(config) {
     return detectProvider();
   }
 
+  // @ts-ignore
   if (typeof config === 'object' && typeof config.generateKeyPair === 'function') {
+    // @ts-ignore
     return config; // Already a provider instance
   }
 

package/src/crypto/CryptoProvider.js

@@ -37,53 +37,53 @@ class CryptoProvider {
 
   /**
    * Computes X25519 shared secret
-   * @param {Uint8Array} secretKey - Our secret key (32 bytes)
-   * @param {Uint8Array} publicKey - Their public key (32 bytes)
+   * @param {Uint8Array} _secretKey - Our secret key (32 bytes)
+   * @param {Uint8Array} _publicKey - Their public key (32 bytes)
    * @returns {Uint8Array} Shared secret (32 bytes)
    */
-  sharedSecret(_secretKey, _publicKey) {
+  sharedSecret(/** @type {any} */ _secretKey, _publicKey) {
     throw new Error('CryptoProvider.sharedSecret() must be implemented');
   }
 
   /**
    * AEAD encrypt (XSalsa20-Poly1305 or ChaCha20-Poly1305)
-   * @param {Uint8Array} key - Encryption key (32 bytes)
-   * @param {Uint8Array} nonce - Nonce (24 bytes for XSalsa20, 12 for ChaCha20)
-   * @param {Uint8Array} plaintext - Data to encrypt
-   * @param {Uint8Array} [ad] - Additional authenticated data (optional)
+   * @param {Uint8Array} _key - Encryption key (32 bytes)
+   * @param {Uint8Array} _nonce - Nonce (24 bytes for XSalsa20, 12 for ChaCha20)
+   * @param {Uint8Array} _plaintext - Data to encrypt
+   * @param {Uint8Array} [_ad] - Additional authenticated data (optional)
    * @returns {Uint8Array} Ciphertext with authentication tag
    */
-  encrypt(_key, _nonce, _plaintext, _ad) {
+  encrypt(/** @type {any} */ _key, _nonce, _plaintext, _ad) {
     throw new Error('CryptoProvider.encrypt() must be implemented');
   }
 
   /**
    * AEAD decrypt
-   * @param {Uint8Array} key - Encryption key (32 bytes)
-   * @param {Uint8Array} nonce - Nonce
-   * @param {Uint8Array} ciphertext - Ciphertext with auth tag
-   * @param {Uint8Array} [ad] - Additional authenticated data (optional)
+   * @param {Uint8Array} _key - Encryption key (32 bytes)
+   * @param {Uint8Array} _nonce - Nonce
+   * @param {Uint8Array} _ciphertext - Ciphertext with auth tag
+   * @param {Uint8Array} [_ad] - Additional authenticated data (optional)
    * @returns {Uint8Array|null} Plaintext or null if authentication fails
    */
-  decrypt(_key, _nonce, _ciphertext, _ad) {
+  decrypt(/** @type {any} */ _key, _nonce, _ciphertext, _ad) {
     throw new Error('CryptoProvider.decrypt() must be implemented');
   }
 
   /**
    * Computes SHA-256 hash
-   * @param {Uint8Array} data - Data to hash
+   * @param {Uint8Array} _data - Data to hash
    * @returns {Uint8Array} Hash (32 bytes)
    */
-  hash(_data) {
+  hash(/** @type {any} */ _data) {
     throw new Error('CryptoProvider.hash() must be implemented');
   }
 
   /**
    * Generates cryptographically secure random bytes
-   * @param {number} length - Number of bytes
+   * @param {number} _length - Number of bytes
    * @returns {Uint8Array} Random bytes
    */
-  randomBytes(_length) {
+  randomBytes(/** @type {any} */ _length) {
     throw new Error('CryptoProvider.randomBytes() must be implemented');
   }
 

package/src/crypto/providers/ExpoCryptoProvider.js

@@ -23,8 +23,10 @@ const CryptoProvider = require('../CryptoProvider');
 class ExpoCryptoProvider extends CryptoProvider {
   constructor(options = {}) {
     super();
-    this._expoCrypto = options.expoCrypto || null;
-    this._nacl = options.nacl || null;
+    /** @type {any} */
+    const opts = options;
+    this._expoCrypto = opts.expoCrypto || null;
+    this._nacl = opts.nacl || null;
   }
 
   get name() {
@@ -34,6 +36,7 @@ class ExpoCryptoProvider extends CryptoProvider {
   _getExpoCrypto() {
     if (!this._expoCrypto) {
       try {
+        // @ts-ignore
         this._expoCrypto = require('expo-crypto');
       } catch (e) {
         throw new Error('expo-crypto is required. Install: npx expo install expo-crypto');
@@ -45,6 +48,7 @@ class ExpoCryptoProvider extends CryptoProvider {
   _getNacl() {
     if (!this._nacl) {
       try {
+        // @ts-ignore
         this._nacl = require('tweetnacl');
       } catch (e) {
         throw new Error('tweetnacl is required with ExpoCryptoProvider. Install: npm install tweetnacl');
@@ -61,13 +65,13 @@ class ExpoCryptoProvider 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();
 
     // Ensure 24-byte nonce (pad short nonces with zeros)
@@ -81,7 +85,7 @@ class ExpoCryptoProvider 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)
@@ -95,17 +99,18 @@ class ExpoCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  hash(data) {
+  hash(/** @type {any} */ data) {
     // expo-crypto's digestStringAsync is async — for sync compat, use tweetnacl
     const nacl = this._getNacl();
-    return nacl.hash(data).slice(0, 32);
+    return nacl.hash(data).subarray(0, 32);
   }
 
   /** @inheritdoc */
-  randomBytes(length) {
+  randomBytes(/** @type {any} */ length) {
     const expoCrypto = this._getExpoCrypto();
     if (expoCrypto.getRandomBytes) {
-      return new Uint8Array(expoCrypto.getRandomBytes(length));
+      const bytes = expoCrypto.getRandomBytes(length);
+      return bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
     }
     // Fallback to tweetnacl
     const nacl = this._getNacl();
@@ -114,6 +119,7 @@ class ExpoCryptoProvider extends CryptoProvider {
 
   static isAvailable() {
     try {
+      // @ts-ignore
       require('expo-crypto');
       return true;
     } catch (e) {

package/src/crypto/providers/QuickCryptoProvider.js

@@ -10,6 +10,11 @@
 
 const CryptoProvider = require('../CryptoProvider');
 
+/** DER header for PKCS8 private key wrapping (X25519) */
+const PKCS8_HEADER = Buffer.from('302e020100300506032b656e04220420', 'hex');
+/** DER header for SPKI public key wrapping (X25519) */
+const SPKI_HEADER = Buffer.from('302a300506032b656e032100', 'hex');
+
 /**
  * Crypto provider using react-native-quick-crypto.
  * Provides native-speed crypto on React Native (JSI binding).
@@ -20,7 +25,10 @@ const CryptoProvider = require('../CryptoProvider');
 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;
   }
 
   get name() {
@@ -30,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(
@@ -51,11 +60,11 @@ 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([
-        Buffer.from('302e020100300506032b656e04220420', 'hex'),
+        PKCS8_HEADER,
         Buffer.from(secretKey)
       ]),
       format: 'der',
@@ -63,7 +72,7 @@ class QuickCryptoProvider extends CryptoProvider {
     });
     const pubKey = crypto.createPublicKey({
       key: Buffer.concat([
-        Buffer.from('302a300506032b656e032100', 'hex'),
+        SPKI_HEADER,
         Buffer.from(publicKey)
       ]),
       format: 'der',
@@ -73,11 +82,30 @@ class QuickCryptoProvider extends CryptoProvider {
     return new Uint8Array(shared);
   }
 
+  /**
+   * Lazily loads tweetnacl (cached)
+   * @returns {any} nacl module
+   * @private
+   */
+  _getNacl() {
+    if (!this._nacl) {
+      try {
+        // @ts-ignore
+        this._nacl = require('tweetnacl');
+      } catch (e) {
+        throw new Error(
+          'tweetnacl is required for QuickCryptoProvider encrypt/decrypt/hash. Install: npm install tweetnacl'
+        );
+      }
+    }
+    return this._nacl;
+  }
+
   /** @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 = require('tweetnacl');
+    const nacl = this._getNacl();
 
     // Ensure 24-byte nonce for XSalsa20-Poly1305
     let fullNonce = nonce;
@@ -90,8 +118,8 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  decrypt(key, nonce, ciphertext, _ad) {
-    const nacl = require('tweetnacl');
+  decrypt(/** @type {any} */ key, /** @type {any} */ nonce, /** @type {any} */ ciphertext, /** @type {any} */ _ad) {
+    const nacl = this._getNacl();
 
     // Ensure 24-byte nonce for XSalsa20-Poly1305
     let fullNonce = nonce;
@@ -108,21 +136,22 @@ class QuickCryptoProvider extends CryptoProvider {
   }
 
   /** @inheritdoc */
-  hash(data) {
+  hash(/** @type {any} */ data) {
     // Use SHA-512 truncated to 32 bytes for cross-provider compatibility
-    const nacl = require('tweetnacl');
+    const nacl = this._getNacl();
     const full = nacl.hash(data); // SHA-512
-    return full.slice(0, 32);
+    return full.subarray(0, 32);
   }
 
   /** @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,15 +95,15 @@ 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);
-    return full.slice(0, 32);
+    return full.subarray(0, 32);
   }
 
   /** @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 {