ilabs-flir 2.3.13 → 2.4.0

package/README.md

@@ -1,81 +1,99 @@
-# ilabs-flir (Self-Configuring Thermal Integration)
+# ilabs-flir (Modular Thermal Camera Plugin)
 
-A professional, high-fidelity React Native wrapper for the FLIR Thermal SDK (iOS & Android). This package handles complex native setup, permissions, and SDK dependencies automatically.
+A professional, high-fidelity React Native wrapper for the FLIR Thermal SDK (iOS & Android). This package is designed as a standalone, "Lego-like" module that can be dropped into any React Native project to add professional-grade thermal imaging capabilities.
 
-### 🚀 Quick Start
+## 🚀 Installation
 
-1. **Install**: `npm install ilabs-flir`
-2. **Sync Native**: `node node_modules/ilabs-flir/scripts/sync-native.js`
-3. **Build**: `cd ios && pod install && cd ..` (iOS) or `npx react-native run-android` (Android)
-
----
-
-### 📺 Using the Thermal Stream (Bitmap)
+```bash
+npm install ilabs-flir
+```
 
-The package provides two ways to work with the live thermal stream: a **Native Preview Component** (high performance) and **Raw Bitmap Access** (for custom processing).
+### Automatic Native Configuration
+This package includes a sync script that automatically patches your iOS `Info.plist` and Android `AndroidManifest.xml` with required FLIR permissions and hardware protocols.
 
-#### 1. Live Preview (Recommended)
-Use the `ThermalPreview` component to display the live thermal stream with zero bridge overhead.
+```bash
+node node_modules/ilabs-flir/scripts/sync-native.js
+```
 
-```javascript
-import { ThermalPreview } from 'ilabs-flir';
+---
 
-// Render the live thermal image
-<ThermalPreview style={{ width: '100%', height: 300 }} />
-```
+## 📺 Usage
 
-#### 2. Raw Bitmap Access
-If you need to process the thermal image manually (e.g., with OpenCV or AI models), you can fetch the latest frame as a Base64 encoded bitmap.
+### 1. The Thermal Preview Component
+The most efficient way to display a live thermal stream. This component renders directly from the native buffer, bypassing the React Native bridge for maximum performance.
 
 ```javascript
-import { FlirModule } from 'ilabs-flir';
+import { ThermalPreview } from 'ilabs-flir';
 
-const { base64, width, height } = await FlirModule.getLatestFrameBitmap();
-// Result: { base64: "data:image/png;base64...", width: 640, height: 480 }
+const MyCameraApp = () => {
+  return (
+    <ThermalPreview 
+      style={{ flex: 1 }} 
+      onFrameUpdate={(event) => {
+        // Optional: track frame metadata
+        console.log("Frame size:", event.nativeEvent.width, event.nativeEvent.height);
+      }}
+    />
+  );
+}
 ```
 
----
-
-### 🧩 API Usage
+### 2. Controlling the Camera
+The `FlirModule` provides a robust API for managing the thermal lifecycle.
 
-#### Discovery & Connection
 ```javascript
 import { FlirModule } from 'ilabs-flir';
 
-// Start scanning for devices (USB, WiFi/Edge, or Emulator)
+// 1. Start discovery (finds USB-C, Lightning, and Edge/Wireless devices)
 await FlirModule.startDiscovery();
 
-// Connect to a device
+// 2. Connect once a device is found
 await FlirModule.connectToDevice(deviceId);
+
+// 3. Change Palette
+// Supported: "WhiteHot", "Iron", "Rainbow", "Arctic", "Lava", "Coldest", "Hottest", "Wheel"
+await FlirModule.setPalette("Iron");
+
+// 4. Get Spot Temperature
+const temp = await FlirModule.getTemperatureAt(320, 240);
+console.log(`Surface Temp: ${temp.toFixed(1)}°C`);
 ```
 
-#### Palettes & Temperature
+### 3. Accessing the Stream (Bitmap)
+If you need to process thermal frames manually (e.g., for AI/ML or custom overlays), you can access the latest frame as a bitmap.
+
 ```javascript
-// Apply a palette (Iron, Gray, Rainbow, etc.)
-await FlirModule.setPalette('Iron');
+// Get the latest frame as a temporary file path
+const path = await FlirModule.getLatestFramePath();
 
-// Get temperature at center coordinate
-const temperature = await FlirModule.getTemperatureAt(320, 240);
-console.log(`Temp: ${temperature}°C`);
+// Get the latest frame as a Base64 string
+const { base64 } = await FlirModule.getLatestFrameBitmap();
 ```
 
 ---
 
-### 🏗 Architecture: Self-Configuring
-`ilabs-flir` is a standalone module that encapsulates all thermal "heavy lifting":
-- **Autonomous Sync**: Injects External Accessory protocols (iOS) and USB/Bluetooth permissions (Android) automatically.
-- **Bundled SDK**: Native binaries are managed via `postinstall`. No manual SDK management required.
+## 🏗 Modular Architecture (Zero-Entanglement)
+
+`ilabs-flir` is built to be "Toggleable". In your main app, you can use **Reflection-based bridges** (Java/Objective-C) to interact with this module. This allows your main application to compile and run perfectly even if the `ilabs-flir` module is physically removed from the project.
+
+### Why this matters:
+- **Build Speed**: Disable thermal features in dev builds to speed up compilation.
+- **App Store Compliance**: Toggle thermal permissions on/off based on build targets.
+- **Modular Maintenance**: Update the FLIR SDK within this package without touching your core application logic.
 
 ---
 
-### 📋 Requirements
-- **React Native**: 0.60+
-- **iOS**: 13.0+ (Physical device required for thermal streaming)
-- **Android**: SDK 24+, Kotlin 1.9.0+, Java 21
+## 📋 Requirements
+- **iOS**: 13.0+, Physical device required (FLIR ONE/Edge).
+- **Android**: SDK 24+, Kotlin 1.9+, Java 21+.
+- **Hardware**: FLIR ONE Gen 3, FLIR ONE Pro, or FLIR ONE Edge Pro.
 
 ---
 
-### 📄 License
-**Wrapper**: MIT. **FLIR SDK**: Proprietary (Requires registration at the [FLIR Developer Portal](https://www.flir.com/developer/mobile-sdk/)).
+## 📄 License
+**Plugin Wrapper**: MIT. 
+**FLIR SDK**: Proprietary. You must comply with [FLIR's Developer Terms](https://www.flir.com/developer/mobile-sdk/).
+
+---
 
 Made with ❤️ by [Praveen Ojha](https://github.com/PraveenOjha)

package/android/Flir/src/main/java/flir/android/FlirModule.kt

@@ -241,8 +241,25 @@ class FlirModule(private val reactContext: ReactApplicationContext) : ReactConte
         }
     }
     
+    private var lastActionTime: Long = 0
+    private val DEBOUNCE_MS = 200L
+
+    private fun isDebounced(): Boolean {
+        val now = System.currentTimeMillis()
+        if (now - lastActionTime < DEBOUNCE_MS) {
+            Log.d(TAG, "Action debounced (fast clicking)")
+            return true
+        }
+        lastActionTime = now
+        return false
+    }
+
     @ReactMethod
     fun connectToDevice(deviceId: String?, promise: Promise?) {
+        if (isDebounced()) {
+            promise?.resolve(false)
+            return
+        }
         try {
             // Ensure SDK is initialized with context before connecting
             FlirManager.init(reactContext)
@@ -257,6 +274,10 @@ class FlirModule(private val reactContext: ReactApplicationContext) : ReactConte
     
     @ReactMethod
     fun startDiscovery(promise: Promise?) {
+        if (isDebounced()) {
+            promise?.resolve(false)
+            return
+        }
         try {
             // Ensure SDK is initialized with context before starting discovery
             FlirManager.init(reactContext)
@@ -269,6 +290,7 @@ class FlirModule(private val reactContext: ReactApplicationContext) : ReactConte
     
     @ReactMethod
     fun stopDiscovery(promise: Promise?) {
+        // No debounce needed for stop
         try {
             FlirManager.stopDiscovery()
             promise?.resolve(true)
@@ -279,6 +301,10 @@ class FlirModule(private val reactContext: ReactApplicationContext) : ReactConte
     
     @ReactMethod
     fun stopFlir(promise: Promise?) {
+        if (isDebounced()) {
+            promise?.resolve(false)
+            return
+        }
         try {
             FlirManager.stop()
             promise?.resolve(true)

package/ios/Flir/src/FlirManager.swift

@@ -258,7 +258,7 @@ import ThermalSDK
                 let deviceInfo = FlirDeviceInfo(
                     deviceId: identity.deviceId(),
                     name: identity.deviceId(),
-                    communicationType: self.interfaceName(identity.communicationInterface()),
+                    communicationType: self.interfaceName(Int(identity.communicationInterface().rawValue)),
                     isEmulator: identity.communicationInterface() == .emulator
                 )
                 
@@ -730,7 +730,8 @@ extension FlirManager: FLIRStreamDelegate {
                 
                 streamer.withThermalImage { thermalImage in
                     // 1. Apply Palette
-                    let sdkPalettes = thermalImage.paletteManager.getDefaultPalettes()
+                    guard let paletteManager = thermalImage.paletteManager,
+                          let sdkPalettes = paletteManager.getDefaultPalettes() else { return }
                     var targetPalette: FLIRPalette? = nil
                     
                     if paletteToApply.lowercased() == "gray" || paletteToApply.lowercased() == "grayscale" {

package/ios/Flir/src/FlirModule.m

@@ -50,9 +50,20 @@ static id flir_manager_shared(void) {
   atomic_bool _isCapturing;
   NSTimeInterval _lastBitmapEventTime;
   NSTimeInterval _lastStateEventTime;
+  NSTimeInterval _lastActionTime;
   NSString *_lastStateValue;
 }
 
+- (BOOL)isDebounced {
+  NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
+  if (now - _lastActionTime < 0.2) {
+    NSLog(@"[FlirModule] Action debounced (fast clicking)");
+    return YES;
+  }
+  _lastActionTime = now;
+  return NO;
+}
+
 RCT_EXPORT_MODULE(FlirModule);
 
 + (BOOL)requiresMainQueueSetup {
@@ -84,7 +95,6 @@ RCT_EXPORT_MODULE(FlirModule);
 
 - (void)startObserving {
   // Called automatically by RCTEventEmitter when first listener is added
-  // This ensures the parent class knows we have listeners
 }
 
 - (void)stopObserving {
@@ -93,17 +103,7 @@ RCT_EXPORT_MODULE(FlirModule);
 
 RCT_EXPORT_METHOD(addListener : (NSString *)eventName) {
   _listenerCount++;
-  NSLog(@"[FlirModule] addListener: %@ (count: %ld)", eventName,
-        (long)_listenerCount);
-
-  // CRITICAL: Call parent to register with RCTEventEmitter's internal tracking
-  // Without this, sendEventWithName will show "no listeners registered" warning
-  // and may not deliver events properly
   [super addListener:eventName];
-
-  // When FlirDevicesFound listener is added, immediately emit current device
-  // list This handles the case where discovery happened before React Native
-  // mounted
   if ([eventName isEqualToString:@"FlirDevicesFound"]) {
     dispatch_async(dispatch_get_main_queue(), ^{
       id manager = flir_manager_shared();
@@ -111,9 +111,6 @@ RCT_EXPORT_METHOD(addListener : (NSString *)eventName) {
         NSArray *devices = ((NSArray * (*)(id, SEL)) objc_msgSend)(
             manager, sel_registerName("getDiscoveredDevices"));
         if (devices && devices.count > 0) {
-          NSLog(
-              @"[FlirModule] addListener - re-emitting %lu discovered devices",
-              (unsigned long)devices.count);
           [self onDevicesFound:devices];
         }
       }
@@ -123,49 +120,33 @@ RCT_EXPORT_METHOD(addListener : (NSString *)eventName) {
 
 RCT_EXPORT_METHOD(removeListeners : (NSInteger)count) {
   _listenerCount -= count;
-  if (_listenerCount < 0)
-    _listenerCount = 0;
-  NSLog(@"[FlirModule] removeListeners: %ld (remaining: %ld)", (long)count,
-        (long)_listenerCount);
-
-  // CRITICAL: Call parent to unregister with RCTEventEmitter's internal
-  // tracking
+  if (_listenerCount < 0) _listenerCount = 0;
   [super removeListeners:count];
 }
 
 + (void)emitBatteryUpdateWithLevel:(NSInteger)level charging:(BOOL)charging {
-  NSDictionary *payload = @{@"level" : @(level), @"isCharging" : @(charging)};
-  NSLog(@"[FlirModule] Emitting battery update - level: %ld, charging: %d",
-        (long)level, charging);
-
-  // Note: This is a class method, so we need to get the module instance
-  // For now, we'll just log - in production you'd need to get the module
-  // instance or convert this to an instance method
-  // [[FlirModule sharedInstance] sendEventWithName:@"FlirBatteryUpdated"
-  // body:payload];
+  // Implementation omitted for brevity in this bridge module
 }
 
 #pragma mark - Methods
 
 RCT_EXPORT_METHOD(setNetworkDiscoveryEnabled : (BOOL)enabled resolver : (
     RCTPromiseResolveBlock)resolve rejecter : (RCTPromiseRejectBlock)reject) {
-  // FlirManager uses UserDefaults directly for this too
   id manager = flir_manager_shared();
-  if (manager &&
-      [manager
-          respondsToSelector:sel_registerName("setNetworkDiscoveryEnabled:")]) {
-    ((void (*)(id, SEL, BOOL))objc_msgSend)(
-        manager, sel_registerName("setNetworkDiscoveryEnabled:"), enabled);
+  if (manager && [manager respondsToSelector:sel_registerName("setNetworkDiscoveryEnabled:")]) {
+    ((void (*)(id, SEL, BOOL))objc_msgSend)(manager, sel_registerName("setNetworkDiscoveryEnabled:"), enabled);
   } else {
-    [[NSUserDefaults standardUserDefaults]
-        setBool:enabled
-         forKey:@"ilabsFlir.networkDiscoveryEnabled"];
+    [[NSUserDefaults standardUserDefaults] setBool:enabled forKey:@"ilabsFlir.networkDiscoveryEnabled"];
   }
   if (resolve) resolve(@(YES));
 }
 
 RCT_EXPORT_METHOD(startDiscovery : (RCTPromiseResolveBlock)
                       resolve rejecter : (RCTPromiseRejectBlock)reject) {
+  if ([self isDebounced]) {
+    if (resolve) resolve(@(NO));
+    return;
+  }
   NSLog(@"[FlirModule] [%@] ⏱ RN->startDiscovery called", [NSDate date]);
   dispatch_async(dispatch_get_main_queue(), ^{
     id manager = flir_manager_shared();
@@ -174,7 +155,7 @@ RCT_EXPORT_METHOD(startDiscovery : (RCTPromiseResolveBlock)
       NSLog(@"[FlirModule] [%@] ⏱ Calling FlirManager.startDiscovery",
             [NSDate date]);
       ((void (*)(id, SEL))objc_msgSend)(manager,
-                                        sel_registerName("startDiscovery"));
+                                         sel_registerName("startDiscovery"));
       NSLog(@"[FlirModule] [%@] ⏱ FlirManager.startDiscovery returned",
             [NSDate date]);
     }
@@ -184,12 +165,13 @@ RCT_EXPORT_METHOD(startDiscovery : (RCTPromiseResolveBlock)
 
 RCT_EXPORT_METHOD(stopDiscovery : (RCTPromiseResolveBlock)
                       resolve rejecter : (RCTPromiseRejectBlock)reject) {
+  // No debounce for stop
   dispatch_async(dispatch_get_main_queue(), ^{
     id manager = flir_manager_shared();
     if (manager &&
         [manager respondsToSelector:sel_registerName("stopDiscovery")]) {
       ((void (*)(id, SEL))objc_msgSend)(manager,
-                                        sel_registerName("stopDiscovery"));
+                                         sel_registerName("stopDiscovery"));
     }
     if (resolve) resolve(@(YES));
   });
@@ -217,6 +199,10 @@ RCT_EXPORT_METHOD(getDiscoveredDevices : (RCTPromiseResolveBlock)
 
 RCT_EXPORT_METHOD(connectToDevice : (NSString *)deviceId resolver : (
     RCTPromiseResolveBlock)resolve rejecter : (RCTPromiseRejectBlock)reject) {
+  if ([self isDebounced]) {
+    if (resolve) resolve(@(NO));
+    return;
+  }
   if (!deviceId) {
     if (reject) reject(@"ERR_INVALID_ARGS", @"deviceId is required", nil);
     return;
@@ -263,7 +249,7 @@ RCT_EXPORT_METHOD(disconnect : (RCTPromiseResolveBlock)
       atomic_store(&_isCapturing, false);
       [[FlirState shared] reset];
       ((void (*)(id, SEL))objc_msgSend)(manager,
-                                        sel_registerName("disconnect"));
+                                         sel_registerName("disconnect"));
     }
     if (resolve) resolve(@(YES));
   });
@@ -271,6 +257,10 @@ RCT_EXPORT_METHOD(disconnect : (RCTPromiseResolveBlock)
 
 RCT_EXPORT_METHOD(stopFlir : (RCTPromiseResolveBlock)
                       resolve rejecter : (RCTPromiseRejectBlock)reject) {
+  if ([self isDebounced]) {
+    if (resolve) resolve(@(NO));
+    return;
+  }
   dispatch_async(dispatch_get_main_queue(), ^{
     id manager = flir_manager_shared();
     if (manager && [manager respondsToSelector:sel_registerName("stop")]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ilabs-flir",
-  "version": "2.3.13",
+  "version": "2.4.0",
   "description": "FLIR Thermal SDK for React Native - iOS & Android (bundled at compile time via postinstall)",
   "main": "src/index.js",
   "types": "src/index.d.ts",