@magicred-1/react-native-lxmf 0.2.0 → 0.2.2

package/example/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "example-app",
+  "main": "expo-router/entry",
+  "version": "1.0.0",
+  "scripts": {
+    "start": "expo start",
+    "reset-project": "node ./scripts/reset-project.js",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "web": "expo start --web",
+    "lint": "expo lint"
+  },
+  "dependencies": {
+    "@expo/vector-icons": "^15.0.3",
+    "@magicred-1/react-native-lxmf": "file:..",
+    "@react-native/virtualized-lists": "0.81.5",
+    "@react-navigation/bottom-tabs": "^7.4.0",
+    "@react-navigation/elements": "^2.6.3",
+    "@react-navigation/native": "^7.1.8",
+    "expo": "~54.0.33",
+    "expo-constants": "~18.0.13",
+    "expo-dev-client": "~6.0.20",
+    "expo-font": "~14.0.11",
+    "expo-haptics": "~15.0.8",
+    "expo-image": "~3.0.11",
+    "expo-linking": "~8.0.11",
+    "expo-router": "~6.0.23",
+    "expo-secure-store": "~15.0.7",
+    "expo-splash-screen": "~31.0.13",
+    "expo-status-bar": "~3.0.9",
+    "expo-symbols": "~1.0.8",
+    "expo-system-ui": "~6.0.9",
+    "expo-web-browser": "~15.0.10",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-reanimated": "~4.1.1",
+    "react-native-safe-area-context": "~5.6.0",
+    "react-native-screens": "~4.16.0",
+    "react-native-web": "~0.21.0",
+    "react-native-worklets": "0.5.1",
+    "semver": "^7.7.4"
+  },
+  "devDependencies": {
+    "@types/react": "~19.1.0",
+    "eslint": "^9.25.0",
+    "eslint-config-expo": "~10.0.0",
+    "typescript": "~5.9.2"
+  },
+  "private": true
+}

package/example/scripts/reset-project.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+/**
+ * This script is used to reset the project to a blank state.
+ * It deletes or moves the /app, /components, /hooks, /scripts, and /constants directories to /app-example based on user input and creates a new /app directory with an index.tsx and _layout.tsx file.
+ * You can remove the `reset-project` script from package.json and safely delete this file after running it.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+
+const root = process.cwd();
+const oldDirs = ["app", "components", "hooks", "constants", "scripts"];
+const exampleDir = "app-example";
+const newAppDir = "app";
+const exampleDirPath = path.join(root, exampleDir);
+
+const indexContent = `import { Text, View } from "react-native";
+
+export default function Index() {
+  return (
+    <View
+      style={{
+        flex: 1,
+        justifyContent: "center",
+        alignItems: "center",
+      }}
+    >
+      <Text>Edit app/index.tsx to edit this screen.</Text>
+    </View>
+  );
+}
+`;
+
+const layoutContent = `import { Stack } from "expo-router";
+
+export default function RootLayout() {
+  return <Stack />;
+}
+`;
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+const moveDirectories = async (userInput) => {
+  try {
+    if (userInput === "y") {
+      // Create the app-example directory
+      await fs.promises.mkdir(exampleDirPath, { recursive: true });
+      console.log(`📁 /${exampleDir} directory created.`);
+    }
+
+    // Move old directories to new app-example directory or delete them
+    for (const dir of oldDirs) {
+      const oldDirPath = path.join(root, dir);
+      if (fs.existsSync(oldDirPath)) {
+        if (userInput === "y") {
+          const newDirPath = path.join(root, exampleDir, dir);
+          await fs.promises.rename(oldDirPath, newDirPath);
+          console.log(`➡️ /${dir} moved to /${exampleDir}/${dir}.`);
+        } else {
+          await fs.promises.rm(oldDirPath, { recursive: true, force: true });
+          console.log(`❌ /${dir} deleted.`);
+        }
+      } else {
+        console.log(`➡️ /${dir} does not exist, skipping.`);
+      }
+    }
+
+    // Create new /app directory
+    const newAppDirPath = path.join(root, newAppDir);
+    await fs.promises.mkdir(newAppDirPath, { recursive: true });
+    console.log("\n📁 New /app directory created.");
+
+    // Create index.tsx
+    const indexPath = path.join(newAppDirPath, "index.tsx");
+    await fs.promises.writeFile(indexPath, indexContent);
+    console.log("📄 app/index.tsx created.");
+
+    // Create _layout.tsx
+    const layoutPath = path.join(newAppDirPath, "_layout.tsx");
+    await fs.promises.writeFile(layoutPath, layoutContent);
+    console.log("📄 app/_layout.tsx created.");
+
+    console.log("\n✅ Project reset complete. Next steps:");
+    console.log(
+      `1. Run \`npx expo start\` to start a development server.\n2. Edit app/index.tsx to edit the main screen.${
+        userInput === "y"
+          ? `\n3. Delete the /${exampleDir} directory when you're done referencing it.`
+          : ""
+      }`
+    );
+  } catch (error) {
+    console.error(`❌ Error during script execution: ${error.message}`);
+  }
+};
+
+rl.question(
+  "Do you want to move existing files to /app-example instead of deleting them? (Y/n): ",
+  (answer) => {
+    const userInput = answer.trim().toLowerCase() || "y";
+    if (userInput === "y" || userInput === "n") {
+      moveDirectories(userInput).finally(() => rl.close());
+    } else {
+      console.log("❌ Invalid input. Please enter 'Y' or 'N'.");
+      rl.close();
+    }
+  }
+);

package/example/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    ".expo/types/**/*.ts",
+    "expo-env.d.ts"
+  ]
+}

package/ios/BLEManager.swift

@@ -53,6 +53,10 @@ class BLEManager: NSObject {
 
     private var isRunning = false
 
+    /// Called when CoreBluetooth signals it is ready to accept more writes.
+    /// LxmfModule sets this to re-trigger drainOutgoing() without a timer.
+    var onReadyToSend: (() -> Void)?
+
     /// Per-launch random token embedded in our advertisement's local name, so
     /// our central role can detect and skip our own peripheral advertisement
     /// (CoreBluetooth does not auto-filter self when running both roles).
@@ -176,20 +180,30 @@ class BLEManager: NSObject {
     }
 
     /// Send data to a specific peer by 6-byte pseudo-MAC address.
-    /// Used by drainOutgoing() to route frames from lxmf_ble_poll_tx.
-    func sendToPeerAddr(_ addr: Data, data: Data) {
-        // Try peripheral role: send notification to a subscribed central
+    /// Returns false when CoreBluetooth's TX buffer is full — caller should stop
+    /// draining and wait for onReadyToSend before resuming.
+    @discardableResult
+    func sendToPeerAddr(_ addr: Data, data: Data) -> Bool {
+        // Peripheral role: push notification to subscribed central.
+        // updateValue returns false when the subscriber's buffer is full;
+        // peripheralManagerIsReady(toUpdateSubscribers:) fires when it drains.
         if let central = addrToCentral[addr], let txChar = txCharacteristic {
-            peripheralManager?.updateValue(data, for: txChar, onSubscribedCentrals: [central])
-            return
+            let ok = peripheralManager?.updateValue(data, for: txChar, onSubscribedCentrals: [central]) ?? false
+            return ok
         }
 
-        // Try central role: write to connected peripheral's RX characteristic
+        // Central role: write to peer's RX characteristic.
+        // canSendWriteWithoutResponse goes false when the internal queue is full;
+        // peripheral(_:isReadyToSendWriteWithoutResponse:) fires when it drains.
         if let peripheralUUID = addrToPeripheralUUID[addr],
            let peripheral = connectedPeripherals[peripheralUUID],
            let char = txCharacteristics[peripheralUUID] {
+            guard peripheral.canSendWriteWithoutResponse else { return false }
             peripheral.writeValue(data, for: char, type: .withoutResponse)
+            return true
         }
+
+        return true // peer not found — frame consumed, no retry needed
     }
 
     /// Write KISS-framed data to all connected RNodes via NUS TX characteristic.
@@ -427,6 +441,11 @@ extension BLEManager: CBPeripheralDelegate {
         addr.withUnsafeBytes { ptr in
             _ = lxmf_ble_connected(ptr.baseAddress?.assumingMemoryBound(to: UInt8.self))
         }
+        // Report negotiated write limit so Rust segments correctly for this peer.
+        let writeLimit = peripheral.maximumWriteValueLength(for: .withoutResponse)
+        addr.withUnsafeBytes { ptr in
+            _ = lxmf_ble_mtu_negotiated(ptr.baseAddress?.assumingMemoryBound(to: UInt8.self), UInt32(writeLimit))
+        }
 
         for char in chars {
             if char.uuid == BLEManager.rxCharUUID {
@@ -466,6 +485,12 @@ extension BLEManager: CBPeripheralDelegate {
             }
         }
     }
+
+    // Called when writeValue(.withoutResponse) exhausted the internal queue.
+    // Re-trigger TX drain so buffered frames get sent now that there's room.
+    func peripheralIsReady(toSendWriteWithoutResponse peripheral: CBPeripheral) {
+        onReadyToSend?()
+    }
 }
 
 // MARK: - CBPeripheralManagerDelegate
@@ -513,6 +538,11 @@ extension BLEManager: CBPeripheralManagerDelegate {
             addr.withUnsafeBytes { ptr in
                 _ = lxmf_ble_connected(ptr.baseAddress?.assumingMemoryBound(to: UInt8.self))
             }
+            // Report negotiated notification limit for this central.
+            let writeLimit = central.maximumUpdateValueLength
+            addr.withUnsafeBytes { ptr in
+                _ = lxmf_ble_mtu_negotiated(ptr.baseAddress?.assumingMemoryBound(to: UInt8.self), UInt32(writeLimit))
+            }
         }
     }
 
@@ -527,6 +557,11 @@ extension BLEManager: CBPeripheralManagerDelegate {
         }
     }
 
+    // Called when updateValue returned false and the subscriber buffer has drained.
+    func peripheralManagerIsReady(toUpdateSubscribers peripheral: CBPeripheralManager) {
+        onReadyToSend?()
+    }
+
     // Background restoration
     func peripheralManager(_ peripheral: CBPeripheralManager, willRestoreState dict: [String: Any]) {
         // Re-setup services on restoration

package/ios/LxmfModule.swift

@@ -111,6 +111,12 @@ func lxmf_ble_disconnected(
 @_silgen_name("lxmf_ble_peer_count")
 func lxmf_ble_peer_count() -> Int32
 
+@_silgen_name("lxmf_ble_mtu_negotiated")
+func lxmf_ble_mtu_negotiated(
+    _ peerAddr: UnsafePointer<UInt8>?,
+    _ writeLimit: UInt32
+) -> Int32
+
 // --- NUS Interface FFI (RNode BLE via Nordic UART Service) ---
 
 @_silgen_name("lxmf_nus_receive")
@@ -135,7 +141,11 @@ public class LxmfModule: Module {
     private var txDrainTimer: Timer?
 
     // BLE manager for phone-to-phone mesh
-    private lazy var bleManager = BLEManager()
+    private lazy var bleManager: BLEManager = {
+        let mgr = BLEManager()
+        mgr.onReadyToSend = { [weak self] in DispatchQueue.main.async { self?.drainOutgoing() } }
+        return mgr
+    }()
 
     public func definition() -> ModuleDefinition {
         Name("LxmfModule")
@@ -385,7 +395,8 @@ public class LxmfModule: Module {
 
             let frameData = Data(dataBuf[0..<Int(len)])
             let addr = Data(peerAddr)
-            bleManager.sendToPeerAddr(addr, data: frameData)
+            // Stop draining if CoreBluetooth buffer is full — onReadyToSend re-triggers us.
+            guard bleManager.sendToPeerAddr(addr, data: frameData) else { break }
         }
 
         // --- NUS: poll for KISS-framed RNode data ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicred-1/react-native-lxmf",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "LXMF Reticulum mesh networking for React Native + Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -73,6 +73,19 @@
     "LxmfReactNative.podspec",
     "expo-module.config.json",
     "app.plugin.js",
-    "README.md"
+    "README.md",
+    "example/app",
+    "example/assets",
+    "example/components",
+    "example/constants",
+    "example/hooks",
+    "example/scripts",
+    "example/app.json",
+    "example/package.json",
+    "example/metro.config.js",
+    "example/tsconfig.json",
+    "example/expo-env.d.ts",
+    "example/eslint.config.js",
+    "example/README.md"
   ]
 }