react-native-ble-mesh 1.1.1 → 2.0.0

package/src/expo/withBLEMesh.js

@@ -0,0 +1,102 @@
+'use strict';
+
+/**
+ * @fileoverview Expo config plugin for react-native-ble-mesh
+ * @module expo/withBLEMesh
+ *
+ * Automatically configures BLE permissions and background modes
+ * for iOS and Android when used with Expo.
+ *
+ * Usage in app.json:
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       ["react-native-ble-mesh", {
+ *         "bluetoothAlwaysPermission": "Chat with nearby devices via Bluetooth",
+ *         "backgroundModes": ["bluetooth-central", "bluetooth-peripheral"]
+ *       }]
+ *     ]
+ *   }
+ * }
+ */
+
+/**
+ * Default configuration
+ * @constant {Object}
+ */
+const DEFAULT_OPTIONS = {
+  /** iOS NSBluetoothAlwaysUsageDescription */
+  bluetoothAlwaysPermission: 'This app uses Bluetooth to communicate with nearby devices',
+  /** iOS UIBackgroundModes */
+  backgroundModes: ['bluetooth-central', 'bluetooth-peripheral'],
+  /** Android permissions */
+  androidPermissions: [
+    'android.permission.BLUETOOTH_SCAN',
+    'android.permission.BLUETOOTH_CONNECT',
+    'android.permission.BLUETOOTH_ADVERTISE',
+    'android.permission.ACCESS_FINE_LOCATION'
+  ]
+};
+
+/**
+ * Modifies the iOS Info.plist for BLE permissions.
+ * @param {Object} config - Expo config
+ * @param {Object} options - Plugin options
+ * @returns {Object} Modified config
+ */
+function withBLEMeshIOS(config, options) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+
+  if (!config.ios) { config.ios = {}; }
+  if (!config.ios.infoPlist) { config.ios.infoPlist = {}; }
+
+  // Add Bluetooth usage description
+  config.ios.infoPlist.NSBluetoothAlwaysUsageDescription = opts.bluetoothAlwaysPermission;
+  config.ios.infoPlist.NSBluetoothPeripheralUsageDescription = opts.bluetoothAlwaysPermission;
+
+  // Add background modes
+  const existingModes = config.ios.infoPlist.UIBackgroundModes || [];
+  const newModes = new Set([...existingModes, ...opts.backgroundModes]);
+  config.ios.infoPlist.UIBackgroundModes = Array.from(newModes);
+
+  return config;
+}
+
+/**
+ * Modifies the Android manifest for BLE permissions.
+ * @param {Object} config - Expo config
+ * @param {Object} options - Plugin options
+ * @returns {Object} Modified config
+ */
+function withBLEMeshAndroid(config, options) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+
+  if (!config.android) { config.android = {}; }
+  if (!config.android.permissions) { config.android.permissions = []; }
+
+  // Add BLE permissions (avoid duplicates)
+  const existingPerms = new Set(config.android.permissions);
+  for (const perm of opts.androidPermissions) {
+    existingPerms.add(perm);
+  }
+  config.android.permissions = Array.from(existingPerms);
+
+  return config;
+}
+
+/**
+ * Main Expo config plugin.
+ * @param {Object} config - Expo config
+ * @param {Object} [options={}] - Plugin options
+ * @returns {Object} Modified config
+ */
+function withBLEMesh(config, options = {}) {
+  config = withBLEMeshIOS(config, options);
+  config = withBLEMeshAndroid(config, options);
+  return config;
+}
+
+module.exports = withBLEMesh;
+module.exports.withBLEMeshIOS = withBLEMeshIOS;
+module.exports.withBLEMeshAndroid = withBLEMeshAndroid;
+module.exports.DEFAULT_OPTIONS = DEFAULT_OPTIONS;

package/src/hooks/useMesh.js

@@ -46,6 +46,7 @@ function useMesh(config = {}) {
 
   // Create mesh instance ref (persists across renders)
   const meshRef = useRef(null);
+  const mountedRef = useRef(true);
 
   // State
   const [state, setState] = useState('uninitialized');
@@ -64,6 +65,7 @@ function useMesh(config = {}) {
   // Initialize mesh
   const initialize = useCallback(async (transport) => {
     try {
+      if (!mountedRef.current) { return; }
       setState('initializing');
       setError(null);
 
@@ -71,11 +73,15 @@ function useMesh(config = {}) {
 
       // Setup state change listener
       mesh.on('state-changed', ({ newState }) => {
-        setState(newState);
+        if (mountedRef.current) {
+          setState(newState);
+        }
       });
 
       mesh.on('error', (err) => {
-        setError(err);
+        if (mountedRef.current) {
+          setError(err);
+        }
       });
 
       // Initialize with storage
@@ -90,8 +96,10 @@ function useMesh(config = {}) {
 
       return mesh;
     } catch (err) {
-      setState('error');
-      setError(err);
+      if (mountedRef.current) {
+        setState('error');
+        setError(err);
+      }
       throw err;
     }
   }, [getMesh, config.storage]);
@@ -102,7 +110,9 @@ function useMesh(config = {}) {
     try {
       await mesh.start(transport);
     } catch (err) {
-      setError(err);
+      if (mountedRef.current) {
+        setError(err);
+      }
       throw err;
     }
   }, [getMesh]);
@@ -114,7 +124,9 @@ function useMesh(config = {}) {
       try {
         await mesh.stop();
       } catch (err) {
-        setError(err);
+        if (mountedRef.current) {
+          setError(err);
+        }
       }
     }
   }, []);
@@ -129,16 +141,25 @@ function useMesh(config = {}) {
         // Ignore destroy errors
       }
       meshRef.current = null;
-      setState('destroyed');
+      if (mountedRef.current) {
+        setState('destroyed');
+      }
     }
   }, []);
 
   // Cleanup on unmount
   useEffect(() => {
     return () => {
+      // Immediately mark as unmounted to prevent state updates
+      mountedRef.current = false;
+
       if (meshRef.current) {
-        meshRef.current.destroy().catch(() => {});
-        meshRef.current = null;
+        const mesh = meshRef.current;
+        meshRef.current = null; // Null ref immediately to prevent new operations
+
+        mesh.destroy().catch(() => {
+          // Ignore cleanup errors
+        });
       }
     };
   }, []);

package/src/hooks/useMessages.js

@@ -114,6 +114,8 @@ function useMessages(mesh, options = {}) {
       mesh.off('broadcast-received', handleBroadcast);
       mesh.off('private-message-received', handlePrivate);
       mesh.off('channel-message-received', handleChannel);
+      // Clear dedup Set on unmount
+      messageIdRef.current.clear();
     };
   }, [mesh, addMessage]);
 

package/src/index.js

@@ -2,8 +2,8 @@
  * @fileoverview BLE Mesh Network Library
  * @module rn-ble-mesh
  * @description Production-ready BLE Mesh Network with Noise Protocol security
- * 
- * This is the definitive React Native library for BitChat-compatible 
+ *
+ * This is the definitive React Native library for BitChat-compatible
  * decentralized mesh networking.
  */
 
@@ -16,9 +16,7 @@ const { MeshNetwork, BATTERY_MODE, PANIC_TRIGGER, HEALTH_STATUS } = require('./M
 const {
   MeshService,
   EmergencyManager,
-  BatteryOptimizer,
-  SessionManager,
-  HandshakeManager,
+  BatteryOptimizer
 } = require('./service');
 
 // Constants
@@ -27,7 +25,7 @@ const constants = require('./constants');
 // Errors
 const errors = require('./errors');
 
-// Crypto
+// Crypto — pluggable provider system (tweetnacl / quick-crypto / expo-crypto)
 const crypto = require('./crypto');
 
 // Protocol
@@ -51,6 +49,10 @@ const audio = require('./service/audio');
 // Text (from service module)
 const text = require('./service/text');
 
+// File transfer
+const file = require('./service/file');
+const { FileManager, FileChunker, FileAssembler, FileMessage, FILE_MESSAGE_TYPE, FILE_TRANSFER_STATE } = file;
+
 // React Native hooks
 const hooks = require('./hooks');
 
@@ -133,7 +135,7 @@ const { useMesh, usePeers, useMessages, AppStateManager } = hooks;
 
 // New PRD-specified components
 const { StoreAndForwardManager } = mesh;
-const { NetworkMonitor } = mesh;
+const { NetworkMonitor, ConnectionQuality, QUALITY_LEVEL } = mesh;
 const { MessageCompressor, compress, decompress } = utils;
 
 module.exports = {
@@ -156,6 +158,10 @@ module.exports = {
   // Store and Forward
   StoreAndForwardManager,
 
+  // Connection Quality
+  ConnectionQuality,
+  QUALITY_LEVEL,
+
   // Compression
   MessageCompressor,
   compress,
@@ -186,7 +192,7 @@ module.exports = {
   // Errors
   ...errors,
 
-  // Crypto primitives and Noise Protocol
+  // Crypto provider system
   crypto,
 
   // Protocol serialization
@@ -229,6 +235,15 @@ module.exports = {
   useMessages,
   AppStateManager,
 
+  // File transfer
+  FileManager,
+  FileChunker,
+  FileAssembler,
+  FileMessage,
+  FILE_MESSAGE_TYPE,
+  FILE_TRANSFER_STATE,
+  file,
+
   // Hooks module
   hooks
 };

package/src/mesh/dedup/DedupManager.js

@@ -55,6 +55,13 @@ class DedupManager {
      */
     this._cache = new MessageCache(config.cacheSize);
 
+    /**
+     * Old Bloom filter kept during grace period after reset
+     * @type {BloomFilter|null}
+     * @private
+     */
+    this._oldBloomFilter = null;
+
     /**
      * Auto-reset threshold for Bloom filter
      * @type {number}
@@ -85,20 +92,25 @@ class DedupManager {
   isDuplicate(messageId) {
     this._stats.checks++;
 
-    // Quick check with Bloom filter
-    if (!this._bloomFilter.mightContain(messageId)) {
-      return false;
-    }
-    this._stats.bloomPositives++;
-
-    // Confirm with exact cache lookup (handles false positives)
+    // Check cache first (most accurate)
     if (this._cache.has(messageId)) {
       this._stats.cacheHits++;
       this._stats.duplicates++;
       return true;
     }
 
-    // Bloom filter false positive
+    // Check current bloom filter
+    if (this._bloomFilter.mightContain(messageId)) {
+      this._stats.bloomPositives++;
+      return true;
+    }
+
+    // Check old bloom filter if in grace period
+    if (this._oldBloomFilter && this._oldBloomFilter.mightContain(messageId)) {
+      this._stats.bloomPositives++;
+      return true;
+    }
+
     return false;
   }
 
@@ -135,14 +147,28 @@ class DedupManager {
    * @private
    */
   _resetBloomFilter() {
-    this._bloomFilter.clear();
+    // Create a new bloom filter instead of clearing the old one
+    // Keep the old filter active for checking during transition
+    const oldFilter = this._bloomFilter;
+    this._bloomFilter = new BloomFilter(
+      oldFilter.size || MESH_CONFIG.BLOOM_FILTER_SIZE,
+      oldFilter.hashCount || MESH_CONFIG.BLOOM_HASH_COUNT
+    );
     this._stats.resets++;
 
-    // Re-add all cached entries to Bloom filter
+    // Re-add all cached entries to new filter
     const entries = this._cache.getAll();
     for (const messageId of entries) {
       this._bloomFilter.add(messageId);
     }
+
+    // Keep old filter for a grace period by checking both
+    this._oldBloomFilter = oldFilter;
+
+    // Clear old filter after grace period
+    setTimeout(() => {
+      this._oldBloomFilter = null;
+    }, 60000); // 1 minute grace
   }
 
   /**

package/src/mesh/fragment/Assembler.js

@@ -73,6 +73,11 @@ class PendingFragmentSet {
    * @returns {Uint8Array} Complete assembled payload
    */
   assemble() {
+    const MAX_ASSEMBLY_SIZE = 500 * 1024; // 500KB max for mesh messages
+    if (this.totalPayloadLength > MAX_ASSEMBLY_SIZE) {
+      throw new Error(`Fragment assembly too large: ${this.totalPayloadLength} bytes exceeds ${MAX_ASSEMBLY_SIZE} byte limit`);
+    }
+
     const result = new Uint8Array(this.totalPayloadLength);
     let offset = 0;
 

package/src/mesh/index.js

@@ -18,5 +18,5 @@ module.exports = {
   ...peer,
   ...router,
   ...store,
-  ...monitor,
+  ...monitor
 };