react-native-sdk-ble-middleware-v2 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 ananthu07
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Middleware.podspec

@@ -0,0 +1,21 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Middleware"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/ananthu07/react-native-middleware.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,187 @@
+# react-native-middleware
+
+A React Native middleware library that provides a simplified, context-based API for BLE (Bluetooth Low Energy) operations. This middleware wraps `react-native-sdk-ble` and handles all the complexity of BLE communication, so your demo app only needs to install this middleware.
+
+## ✨ Features
+
+- 🔌 **Simplified BLE Operations** - Easy-to-use API for scanning, connecting, and managing BLE devices
+- 📡 **Automatic Event Handling** - Built-in state management for devices, connections, and notifications
+- 🎣 **React Hooks** - Custom hooks for seamless integration with React components
+- 🔔 **Notification Support** - Automatic handling of characteristic notifications (FF21, FF31, FF41, FF02)
+- � **Infusion Control** - Built-in methods for controlling infusion devices (start/stop commands)
+- �🛡️ **Type-Safe** - Full TypeScript support with comprehensive type definitions
+- 📱 **Cross-Platform** - Works on both Android and iOS
+
+## 📦 Installation
+
+### In Your Demo App
+
+**Step 1:** Install the middleware package
+
+```sh
+npm install react-native-middleware
+```
+
+or
+
+```sh
+yarn add react-native-middleware
+```
+
+**Step 2:** Install the required peer dependency
+
+```sh
+npm install react-native-sdk-ble
+```
+
+or
+
+```sh
+yarn add react-native-sdk-ble
+```
+
+**Step 3:** Link native dependencies (if not using auto-linking)
+
+```sh
+npx pod-install  # iOS only
+```
+
+> **Note:** `react-native-sdk-ble` is a peer dependency. You need to install it in your demo app so that the native modules are properly linked to your app's binary.
+
+### In the Middleware Package (For Development)
+
+```sh
+cd react-native-middleware
+npm install
+npm run prepare
+```
+
+## 🚀 Quick Start
+
+### 1. Wrap Your App with BLEProvider
+
+```tsx
+import { BLEProvider } from 'react-native-middleware';
+
+export default function App() {
+  return (
+    <BLEProvider>
+      <YourApp />
+    </BLEProvider>
+  );
+}
+```
+
+### 2. Use BLE Hooks in Your Components
+
+```tsx
+import { useBLE } from 'react-native-middleware';
+
+function DeviceScanner() {
+  const {
+    bluetoothEnabled,
+    isScanning,
+    discoveredDevices,
+    connectedDeviceId,
+    startScan,
+    stopScan,
+    connectToDevice,
+  } = useBLE();
+
+  return (
+    <View>
+      <Button
+        title={isScanning ? 'Stop Scan' : 'Start Scan'}
+        onPress={isScanning ? stopScan : startScan}
+      />
+
+      {discoveredDevices.map((device) => (
+        <TouchableOpacity
+          key={device.id}
+          onPress={() => connectToDevice(device)}
+        >
+          <Text>{device.name || 'Unknown Device'}</Text>
+        </TouchableOpacity>
+      ))}
+    </View>
+  );
+}
+```
+
+## 📚 Documentation
+
+- [Installation Guide](INSTALLATION.md) - Detailed installation instructions and troubleshooting
+- [Migration Guide](MIGRATION_GUIDE.md) - Guide for migrating to peer dependency setup
+- [Quick Start Guide](QUICK_START.md) - Step-by-step setup instructions
+- [API Documentation](MIDDLEWARE_USAGE.md) - Complete API reference and usage examples
+- [Infusion Control Guide](INFUSION_USAGE.md) - Guide for using infusion start/stop functions
+- [Example App](example/) - Full working example application
+
+## 🎯 Architecture
+
+```
+┌─────────────────┐
+│   Demo App      │  ← Only installs react-native-middleware
+│                 │
+└────────┬────────┘
+         │ Uses
+         ▼
+┌─────────────────┐
+│   Middleware    │  ← Provides BLEProvider, hooks, and utilities
+│                 │
+└────────┬────────┘
+         │ Wraps
+         ▼
+┌─────────────────┐
+│ react-native-   │  ← Only installed in middleware package
+│   sdk-ble       │
+└─────────────────┘
+```
+
+## 🔧 Available Hooks
+
+### `useBLE()`
+
+Complete BLE functionality with all state and operations, including infusion control.
+
+### `useBLEDevices()`
+
+Device scanning and discovery functionality.
+
+### `useBLEConnection()`
+
+Connection status and disconnect operation.
+
+### `useBLENotifications()`
+
+Access to characteristic notifications.
+
+### `useBLEInfusion()`
+
+Infusion control operations (enableBluetooth, startInfusion, stopInfusion).
+
+## 📱 Supported Platforms
+
+- ✅ iOS 13.0+
+- ✅ Android SDK 21+
+
+## 🛠️ Requirements
+
+- React Native >= 0.70
+- React >= 18.0
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## 🐛 Issues
+
+If you find a bug or have a feature request, please open an issue on [GitHub](https://github.com/ananthu07/react-native-middleware/issues).
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,77 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['Middleware_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Middleware_" + name]).toInteger()
+}
+
+android {
+  namespace "com.middleware"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Middleware_kotlinVersion=2.0.21
+Middleware_minSdkVersion=24
+Middleware_targetSdkVersion=34
+Middleware_compileSdkVersion=35
+Middleware_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/middleware/MiddlewareModule.kt

@@ -0,0 +1,23 @@
+package com.middleware
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+
+@ReactModule(name = MiddlewareModule.NAME)
+class MiddlewareModule(reactContext: ReactApplicationContext) :
+  NativeMiddlewareSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  // Example method
+  // See https://reactnative.dev/docs/native-modules-android
+  override fun multiply(a: Double, b: Double): Double {
+    return a * b
+  }
+
+  companion object {
+    const val NAME = "Middleware"
+  }
+}

package/android/src/main/java/com/middleware/MiddlewarePackage.kt

@@ -0,0 +1,33 @@
+package com.middleware
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class MiddlewarePackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == MiddlewareModule.NAME) {
+      MiddlewareModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[MiddlewareModule.NAME] = ReactModuleInfo(
+        MiddlewareModule.NAME,
+        MiddlewareModule.NAME,
+        false,  // canOverrideExistingModule
+        false,  // needsEagerInit
+        false,  // isCxxModule
+        true // isTurboModule
+      )
+      moduleInfos
+    }
+  }
+}

package/ios/Middleware.h

@@ -0,0 +1,5 @@
+#import <MiddlewareSpec/MiddlewareSpec.h>
+
+@interface Middleware : NSObject <NativeMiddlewareSpec>
+
+@end

package/ios/Middleware.mm

@@ -0,0 +1,21 @@
+#import "Middleware.h"
+
+@implementation Middleware
+- (NSNumber *)multiply:(double)a b:(double)b {
+    NSNumber *result = @(a * b);
+
+    return result;
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeMiddlewareSpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+  return @"Middleware";
+}
+
+@end

package/lib/module/NativeMiddleware.js

@@ -0,0 +1,3 @@
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('Middleware');
+//# sourceMappingURL=NativeMiddleware.js.map

package/lib/module/NativeMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sources":["NativeMiddleware.ts"],"sourcesContent":["import { TurboModuleRegistry, type TurboModule } from 'react-native';\n\nexport interface Spec extends TurboModule {\n  multiply(a: number, b: number): number;\n}\n\nexport default TurboModuleRegistry.getEnforcing<Spec>('Middleware');\n"],"mappings":"AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAMpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,YAAY,CAAC","ignoreList":[]}