react-native-ble-mesh 1.0.1 → 1.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 > Inspired by [Bitchat](https://github.com/permissionlesstech/bitchat) - this is the React Native version.
 
-A **production-ready BLE Mesh Network library** for Node.js and React Native with Noise Protocol security. This library enables peer-to-peer communication over Bluetooth Low Energy with end-to-end encryption, multi-hop routing, and offline-first capabilities.
+A **production-ready BLE Mesh Network library** for React Native with Noise Protocol security. This library enables peer-to-peer communication over Bluetooth Low Energy with end-to-end encryption, multi-hop routing, and offline-first capabilities.
 
 [![npm version](https://img.shields.io/npm/v/react-native-ble-mesh.svg)](https://www.npmjs.com/package/react-native-ble-mesh)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -32,24 +32,55 @@ A **production-ready BLE Mesh Network library** for Node.js and React Native wit
 ## Installation
 
 ```bash
-npm install react-native-ble-mesh
+npm install react-native-ble-mesh react-native-get-random-values react-native-ble-plx
+cd ios && pod install
 ```
 
-### React Native
+### Required Setup
 
-For React Native projects, you also need to install the BLE dependency:
+**IMPORTANT:** You must import `react-native-get-random-values` at the very top of your entry file (index.js or App.js) **before any other imports**:
 
-```bash
-npm install react-native-ble-plx
-cd ios && pod install
+```javascript
+// index.js or App.js - This MUST be the first import!
+import 'react-native-get-random-values';
+
+// Now you can import other modules
+import { AppRegistry } from 'react-native';
+import App from './App';
+import { name as appName } from './app.json';
+
+AppRegistry.registerComponent(appName, () => App);
 ```
 
-### Node.js
+This polyfill provides the Web Crypto API (`crypto.getRandomValues`) which is required for cryptographic operations in the mesh network.
 
-For Node.js projects using Noble:
+### iOS Setup
 
-```bash
-npm install @abandonware/noble
+Add Bluetooth permissions to your `Info.plist`:
+
+```xml
+<key>NSBluetoothAlwaysUsageDescription</key>
+<string>This app uses Bluetooth to communicate with nearby devices</string>
+<key>NSBluetoothPeripheralUsageDescription</key>
+<string>This app uses Bluetooth to communicate with nearby devices</string>
+<key>UIBackgroundModes</key>
+<array>
+  <string>bluetooth-central</string>
+  <string>bluetooth-peripheral</string>
+</array>
+```
+
+### Android Setup
+
+Add Bluetooth permissions to your `AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.BLUETOOTH" />
+<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
+<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
+<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 ```
 
 ## Quick Start

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-ble-mesh",
-  "version": "1.0.1",
-  "description": "Production-ready BLE Mesh Network with Noise Protocol security",
+  "version": "1.0.3",
+  "description": "Production-ready React Native BLE Mesh Network with Noise Protocol security",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "exports": {
@@ -14,10 +14,6 @@
       "require": "./src/transport/adapters/index.js",
       "default": "./src/transport/adapters/index.js"
     },
-    "./errors": {
-      "require": "./src/errors/index.js",
-      "default": "./src/errors/index.js"
-    },
     "./crypto": {
       "require": "./src/crypto/index.js",
       "default": "./src/crypto/index.js"
@@ -29,35 +25,20 @@
     "./hooks": {
       "require": "./src/hooks/index.js",
       "default": "./src/hooks/index.js"
-    },
-    "./package.json": "./package.json"
+    }
   },
   "sideEffects": false,
-  "engines": {
-    "node": ">=18.0.0"
-  },
+  "react-native": "src/index.js",
   "scripts": {
     "test": "jest",
     "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch",
-    "test:ci": "jest --ci --coverage --reporters=default --reporters=jest-junit",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "typecheck": "tsc --noEmit",
-    "docs": "jsdoc -c jsdoc.json",
-    "validate": "npm run lint && npm test",
-    "prepublishOnly": "npm run validate",
-    "preversion": "npm run validate",
-    "version": "npm run docs && git add -A docs",
-    "postversion": "git push && git push --tags",
-    "release": "npm version patch && npm publish",
-    "release:minor": "npm version minor && npm publish",
-    "release:major": "npm version major && npm publish",
-    "size": "node -e \"const s=require('fs').statSync('src/index.js');console.log('Index size:',s.size,'bytes')\"",
-    "example:node": "node examples/node-quickstart/index.js",
-    "example:chat": "node examples/node-chat/chat.js"
+    "validate": "npm run lint && npm test"
   },
   "keywords": [
+    "react-native",
     "bluetooth",
     "ble",
     "mesh",
@@ -65,8 +46,6 @@
     "peer-to-peer",
     "noise-protocol",
     "encryption",
-    "react-native",
-    "node",
     "offline-first",
     "x25519",
     "chacha20-poly1305"
@@ -76,29 +55,26 @@
   "devDependencies": {
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
-    "jest-junit": "^16.0.0",
-    "jsdoc": "^4.0.4",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@abandonware/noble": ">=1.9.0",
+    "react-native": ">=0.60.0",
+    "react-native-get-random-values": ">=1.8.0",
     "react-native-ble-plx": ">=2.0.0"
   },
   "peerDependenciesMeta": {
-    "react-native-ble-plx": {
+    "react-native": {
       "optional": true
     },
-    "@abandonware/noble": {
+    "react-native-ble-plx": {
       "optional": true
     }
   },
   "files": [
     "src",
     "docs",
-    "examples",
     "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
+    "LICENSE"
   ],
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -1,9 +1,37 @@
 /**
  * TypeScript definitions for react-native-ble-mesh
  * BLE Mesh Network Library with Noise Protocol Security
+ *
+ * This library is designed for React Native applications.
+ * Required setup:
+ *   npm install react-native-get-random-values
+ *   // In your entry file (index.js or App.js), add at the TOP:
+ *   import 'react-native-get-random-values';
  */
 
-import { EventEmitter } from 'events';
+// ============================================================================
+// EventEmitter (React Native compatible)
+// ============================================================================
+
+/**
+ * React Native compatible EventEmitter interface.
+ * This replaces the Node.js 'events' module which is not available in React Native.
+ */
+export interface EventEmitter {
+  on(event: string, listener: (...args: unknown[]) => void): this;
+  once(event: string, listener: (...args: unknown[]) => void): this;
+  off(event: string, listener: (...args: unknown[]) => void): this;
+  emit(event: string, ...args: unknown[]): boolean;
+  removeAllListeners(event?: string): this;
+  listenerCount(event: string): number;
+  eventNames(): string[];
+  setMaxListeners(n: number): this;
+  getMaxListeners(): number;
+}
+
+export class EventEmitter implements EventEmitter {
+  constructor(options?: { maxListeners?: number });
+}
 
 // ============================================================================
 // Constants

package/src/mesh/peer/PeerDiscovery.js

@@ -5,7 +5,7 @@
  * @module mesh/peer/PeerDiscovery
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../utils/EventEmitter');
 const { MESSAGE_TYPE, EVENTS } = require('../../constants');
 const { ValidationError } = require('../../errors');
 

package/src/mesh/peer/PeerManager.js

@@ -5,7 +5,7 @@
  * @module mesh/peer/PeerManager
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../utils/EventEmitter');
 const Peer = require('./Peer');
 const { CONNECTION_STATE, MESH_CONFIG, EVENTS } = require('../../constants');
 const { ValidationError, ConnectionError } = require('../../errors');

package/src/mesh/router/MessageRouter.js

@@ -5,7 +5,7 @@
  * @module mesh/router/MessageRouter
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../utils/EventEmitter');
 const { MESH_CONFIG, MESSAGE_TYPE, MESSAGE_FLAGS, EVENTS } = require('../../constants');
 const { ValidationError } = require('../../errors');
 const { DedupManager } = require('../dedup');

package/src/mesh/router/PathFinder.js

@@ -5,7 +5,7 @@
  * @module mesh/router/PathFinder
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../utils/EventEmitter');
 const { MESH_CONFIG } = require('../../constants');
 const { ValidationError } = require('../../errors');
 

package/src/protocol/header.js

@@ -8,6 +8,7 @@
 const { crc32 } = require('./crc32');
 const { PROTOCOL_VERSION, MESSAGE_FLAGS, MESH_CONFIG } = require('../constants');
 const { MessageError } = require('../errors');
+const { randomBytes } = require('../utils/bytes');
 
 /**
  * Header size in bytes.
@@ -161,18 +162,11 @@ class MessageHeader {
 }
 
 /**
- * Generates a random 16-byte UUID.
+ * Generates a random 16-byte UUID (v4).
  * @returns {Uint8Array} 16-byte UUID
  */
 function generateUuid() {
-  const uuid = new Uint8Array(16);
-  if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues) {
-    globalThis.crypto.getRandomValues(uuid);
-  } else {
-    const nodeCrypto = require('crypto');
-    const randomBuffer = nodeCrypto.randomBytes(16);
-    uuid.set(randomBuffer);
-  }
+  const uuid = randomBytes(16);
   // Set version 4 (random) and variant bits
   uuid[6] = (uuid[6] & 0x0f) | 0x40;
   uuid[8] = (uuid[8] & 0x3f) | 0x80;

package/src/service/HandshakeManager.js

@@ -5,7 +5,7 @@
  * @module service/HandshakeManager
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../utils/EventEmitter');
 const { HandshakeError } = require('../errors');
 const { MESSAGE_TYPE, MESH_CONFIG, EVENTS } = require('../constants');
 

package/src/service/MeshService.js

@@ -5,7 +5,7 @@
  * @module service/MeshService
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../utils/EventEmitter');
 const { MeshError, ValidationError, AudioError } = require('../errors');
 const { SERVICE_STATE, MESSAGE_TYPE, EVENTS, ERROR_CODE } = require('../constants');
 const SessionManager = require('./SessionManager');

package/src/service/text/TextManager.js

@@ -5,7 +5,7 @@
  * @module service/text/TextManager
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../utils/EventEmitter');
 const { MeshError } = require('../../errors');
 const { MESSAGE_TYPE, EVENTS, ERROR_CODE } = require('../../constants');
 const TextMessage = require('./message/TextMessage');

package/src/service/text/broadcast/BroadcastManager.js

@@ -5,7 +5,7 @@
  * @module service/text/broadcast/BroadcastManager
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../../utils/EventEmitter');
 const TextMessage = require('../message/TextMessage');
 
 /**

package/src/service/text/channel/ChannelManager.js

@@ -5,7 +5,7 @@
  * @module service/text/channel/ChannelManager
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../../../utils/EventEmitter');
 const { MeshError } = require('../../../errors');
 const { EVENTS, ERROR_CODE } = require('../../../constants');
 const Channel = require('./Channel');

package/src/transport/Transport.js

@@ -5,7 +5,7 @@
  * @module transport/Transport
  */
 
-const EventEmitter = require('events');
+const EventEmitter = require('../utils/EventEmitter');
 
 /**
  * Transport states

package/src/transport/adapters/index.js

@@ -3,14 +3,26 @@
 /**
  * @fileoverview BLE adapter exports
  * @module transport/adapters
+ *
+ * Note: NodeBLEAdapter uses Node.js-specific APIs (Buffer) and is NOT
+ * auto-loaded to maintain React Native compatibility. Use getNodeBLEAdapter()
+ * for lazy loading in Node.js environments.
  */
 
 const BLEAdapter = require('./BLEAdapter');
 const RNBLEAdapter = require('./RNBLEAdapter');
-const NodeBLEAdapter = require('./NodeBLEAdapter');
 
 module.exports = {
+  // React Native compatible adapters
   BLEAdapter,
   RNBLEAdapter,
-  NodeBLEAdapter
+
+  /**
+   * Get the NodeBLEAdapter for Node.js environments.
+   * This is lazy-loaded to prevent issues in React Native.
+   * @returns {typeof import('./NodeBLEAdapter')}
+   */
+  getNodeBLEAdapter() {
+    return require('./NodeBLEAdapter');
+  }
 };

package/src/transport/index.js

@@ -9,25 +9,19 @@ const Transport = require('./Transport');
 const MockTransport = require('./MockTransport');
 const BLETransport = require('./BLETransport');
 
-// Adapters (now flat in transport folder)
-const BLEAdapter = require('./BLEAdapter');
-const RNBLEAdapter = require('./RNBLEAdapter');
-const NodeBLEAdapter = require('./NodeBLEAdapter');
-
-// Legacy: keep adapters object for backward compatibility
-const adapters = require('./adapters');
+// React Native compatible adapters (from adapters subdirectory)
+const BLEAdapter = require('./adapters/BLEAdapter');
+const RNBLEAdapter = require('./adapters/RNBLEAdapter');
 
 module.exports = {
-  // Core transports
   Transport,
   MockTransport,
   BLETransport,
-
-  // Adapters (flat exports for easy imports)
   BLEAdapter,
   RNBLEAdapter,
-  NodeBLEAdapter,
 
-  // Legacy adapters namespace
-  adapters
+  /** Lazy-load NodeBLEAdapter for Node.js environments */
+  getNodeBLEAdapter() {
+    return require('./adapters/NodeBLEAdapter');
+  }
 };

package/src/utils/bytes.js

@@ -51,6 +51,14 @@ function constantTimeEqual(a, b) {
 
 /**
  * Generates cryptographically secure random bytes
+ *
+ * For React Native, you must install and import 'react-native-get-random-values'
+ * at the top of your entry file (index.js or App.js) BEFORE any other imports:
+ *
+ * ```javascript
+ * import 'react-native-get-random-values';
+ * ```
+ *
  * @param {number} length - Number of bytes to generate
  * @returns {Uint8Array} Random bytes
  * @throws {Error} If crypto is not available
@@ -66,29 +74,25 @@ function randomBytes(length) {
 
   const bytes = new Uint8Array(length);
 
-  // Try Web Crypto API (browser and modern Node.js)
+  // Try Web Crypto API (browser, React Native with polyfill, modern Node.js)
   if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
     crypto.getRandomValues(bytes);
     return bytes;
   }
 
-  // Try globalThis.crypto (Node.js 19+, browsers)
-  if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues) {
+  // Try globalThis.crypto (Node.js 19+, browsers, React Native with polyfill)
+  if (typeof globalThis !== 'undefined' &&
+      typeof globalThis.crypto !== 'undefined' &&
+      globalThis.crypto.getRandomValues) {
     globalThis.crypto.getRandomValues(bytes);
     return bytes;
   }
 
-  // Try Node.js crypto module
-  try {
-    const nodeCrypto = require('crypto');
-    const nodeBytes = nodeCrypto.randomBytes(length);
-    bytes.set(nodeBytes);
-    return bytes;
-  } catch (e) {
-    // Ignore and throw error below
-  }
-
-  throw new Error('No secure random number generator available');
+  throw new Error(
+    'No secure random number generator available. ' +
+    'For React Native, install and import "react-native-get-random-values" ' +
+    'at the top of your entry file before any other imports.'
+  );
 }
 
 /**

package/src/utils/encoding.js

@@ -5,10 +5,6 @@
  * @module utils/encoding
  */
 
-/**
- * Lookup tables for hex encoding
- * @private
- */
 const HEX_CHARS = '0123456789abcdef';
 const HEX_LOOKUP = new Uint8Array(256);
 
@@ -36,14 +32,12 @@ function bytesToHex(bytes) {
  * Converts a hexadecimal string to a byte array
  * @param {string} hex - Hexadecimal string
  * @returns {Uint8Array} Byte array
- * @throws {Error} If hex string has invalid length or characters
  */
 function hexToBytes(hex) {
   if (typeof hex !== 'string') {
     throw new Error('Input must be a string');
   }
 
-  // Remove optional 0x prefix
   if (hex.startsWith('0x') || hex.startsWith('0X')) {
     hex = hex.slice(2);
   }
@@ -53,107 +47,15 @@ function hexToBytes(hex) {
   }
 
   const bytes = new Uint8Array(hex.length / 2);
-
   for (let i = 0; i < bytes.length; i++) {
     const hi = HEX_LOOKUP[hex.charCodeAt(i * 2)];
     const lo = HEX_LOOKUP[hex.charCodeAt(i * 2 + 1)];
-
-    if (hi === undefined || lo === undefined) {
-      throw new Error(`Invalid hex character at position ${i * 2}`);
-    }
-
     bytes[i] = (hi << 4) | lo;
   }
 
   return bytes;
 }
 
-/**
- * Base64 character set
- * @private
- */
-const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-const BASE64_LOOKUP = new Uint8Array(256);
-
-// Initialize base64 lookup table
-for (let i = 0; i < BASE64_CHARS.length; i++) {
-  BASE64_LOOKUP[BASE64_CHARS.charCodeAt(i)] = i;
-}
-
-/**
- * Converts a byte array to a Base64 string
- * @param {Uint8Array} bytes - Bytes to convert
- * @returns {string} Base64 string
- */
-function bytesToBase64(bytes) {
-  let result = '';
-  const len = bytes.length;
-  const remainder = len % 3;
-
-  // Process 3 bytes at a time
-  for (let i = 0; i < len - remainder; i += 3) {
-    const n = (bytes[i] << 16) | (bytes[i + 1] << 8) | bytes[i + 2];
-    result += BASE64_CHARS[(n >> 18) & 0x3f];
-    result += BASE64_CHARS[(n >> 12) & 0x3f];
-    result += BASE64_CHARS[(n >> 6) & 0x3f];
-    result += BASE64_CHARS[n & 0x3f];
-  }
-
-  // Handle remainder
-  if (remainder === 1) {
-    const n = bytes[len - 1];
-    result += BASE64_CHARS[(n >> 2) & 0x3f];
-    result += BASE64_CHARS[(n << 4) & 0x3f];
-    result += '==';
-  } else if (remainder === 2) {
-    const n = (bytes[len - 2] << 8) | bytes[len - 1];
-    result += BASE64_CHARS[(n >> 10) & 0x3f];
-    result += BASE64_CHARS[(n >> 4) & 0x3f];
-    result += BASE64_CHARS[(n << 2) & 0x3f];
-    result += '=';
-  }
-
-  return result;
-}
-
-/**
- * Converts a Base64 string to a byte array
- * @param {string} base64 - Base64 string
- * @returns {Uint8Array} Byte array
- * @throws {Error} If base64 string is invalid
- */
-function base64ToBytes(base64) {
-  if (typeof base64 !== 'string') {
-    throw new Error('Input must be a string');
-  }
-
-  // Remove padding and calculate length
-  let paddingLength = 0;
-  if (base64.endsWith('==')) {
-    paddingLength = 2;
-  } else if (base64.endsWith('=')) {
-    paddingLength = 1;
-  }
-
-  const len = base64.length;
-  const outputLength = (len * 3) / 4 - paddingLength;
-  const bytes = new Uint8Array(outputLength);
-
-  let j = 0;
-  for (let i = 0; i < len; i += 4) {
-    const a = BASE64_LOOKUP[base64.charCodeAt(i)];
-    const b = BASE64_LOOKUP[base64.charCodeAt(i + 1)];
-    const c = BASE64_LOOKUP[base64.charCodeAt(i + 2)];
-    const d = BASE64_LOOKUP[base64.charCodeAt(i + 3)];
-
-    bytes[j++] = (a << 2) | (b >> 4);
-    if (j < outputLength) { bytes[j++] = ((b & 0x0f) << 4) | (c >> 2); }
-    if (j < outputLength) { bytes[j++] = ((c & 0x03) << 6) | d; }
-  }
-
-  return bytes;
-}
-
 /**
  * Converts a UTF-8 string to a byte array
  * @param {string} str - String to convert
@@ -179,7 +81,6 @@ function stringToBytes(str) {
       bytes.push(0x80 | ((code >> 6) & 0x3f));
       bytes.push(0x80 | (code & 0x3f));
     } else {
-      // Surrogate pair
       i++;
       code = 0x10000 + (((code & 0x3ff) << 10) | (str.charCodeAt(i) & 0x3ff));
       bytes.push(0xf0 | (code >> 18));
@@ -229,7 +130,6 @@ function bytesToString(bytes) {
         ((byte2 & 0x3f) << 12) |
         ((byte3 & 0x3f) << 6) |
         (byte4 & 0x3f);
-      // Convert to surrogate pair
       const adjusted = codePoint - 0x10000;
       result += String.fromCharCode(0xd800 + (adjusted >> 10), 0xdc00 + (adjusted & 0x3ff));
     }
@@ -241,8 +141,6 @@ function bytesToString(bytes) {
 module.exports = {
   bytesToHex,
   hexToBytes,
-  bytesToBase64,
-  base64ToBytes,
   stringToBytes,
   bytesToString
 };