react-native-ble-nitro 1.0.0-beta.9 → 1.0.0

package/ios/BlePeripheralDelegate.swift

@@ -0,0 +1,174 @@
+import Foundation
+import CoreBluetooth
+import NitroModules
+
+/**
+ * Helper class to handle CBPeripheralDelegate operations
+ * Manages callbacks for characteristic operations and service discovery
+ */
+class BlePeripheralDelegate: NSObject, CBPeripheralDelegate {
+    
+    // MARK: - Properties
+    let deviceId: String
+    weak var manager: BleNitroBleManager?
+    
+    // Callback storage
+    var connectionCallback: ((Bool, String, String) -> Void)?
+    var disconnectionCallback: ((Bool, String) -> Void)?
+    var disconnectEventCallback: ((String, Bool, String) -> Void)?
+    var serviceDiscoveryCallback: ((Bool, String) -> Void)?
+    var characteristicDiscoveryCallbacks: [String: (Bool, String) -> Void] = [:]
+    
+    // Operation callbacks - using CBUUID as key for reliable UUID matching
+    var readCallbacks: [CBUUID: (Bool, [Double], String) -> Void] = [:]
+    var writeCallbacks: [CBUUID: (Bool, String) -> Void] = [:]
+    var subscriptionCallbacks: [CBUUID: (Bool, String) -> Void] = [:]
+    var unsubscriptionCallbacks: [CBUUID: (Bool, String) -> Void] = [:]
+    
+    // Notification callbacks
+    var notificationCallbacks: [CBUUID: (String, [Double]) -> Void] = [:]
+    
+    // MARK: - Initialization
+    init(deviceId: String, manager: BleNitroBleManager) {
+        self.deviceId = deviceId
+        self.manager = manager
+        super.init()
+    }
+    
+    // MARK: - CBPeripheralDelegate - Service Discovery
+    func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {
+        if let error = error {
+            serviceDiscoveryCallback?(false, error.localizedDescription)
+        } else {
+            serviceDiscoveryCallback?(true, "")
+            
+            // Automatically discover characteristics for all services
+            peripheral.services?.forEach { service in
+                peripheral.discoverCharacteristics(nil, for: service)
+            }
+        }
+        serviceDiscoveryCallback = nil
+    }
+    
+    func peripheral(
+        _ peripheral: CBPeripheral,
+        didDiscoverCharacteristicsFor service: CBService,
+        error: Error?
+    ) {
+        let serviceId = service.uuid.uuidString
+        
+        if let error = error {
+            characteristicDiscoveryCallbacks[serviceId]?(false, error.localizedDescription)
+        } else {
+            characteristicDiscoveryCallbacks[serviceId]?(true, "")
+        }
+        characteristicDiscoveryCallbacks.removeValue(forKey: serviceId)
+    }
+    
+    // MARK: - CBPeripheralDelegate - Characteristic Read
+    func peripheral(
+        _ peripheral: CBPeripheral,
+        didUpdateValueFor characteristic: CBCharacteristic,
+        error: Error?
+    ) {
+        let characteristicUUID = characteristic.uuid
+        
+        // Handle read callback using CBUUID - no normalization needed
+        if let readCallback = readCallbacks[characteristicUUID] {
+            if let error = error {
+                readCallback(false, [], error.localizedDescription)
+            } else if let data = characteristic.value {
+                let doubleArray = data.map { Double($0) }
+                readCallback(true, doubleArray, "")
+            } else {
+                readCallback(false, [], "No data received")
+            }
+            readCallbacks.removeValue(forKey: characteristicUUID)
+        }
+        
+        // Handle notification callback using CBUUID
+        if let notificationCallback = notificationCallbacks[characteristicUUID],
+           let data = characteristic.value {
+            let doubleArray = data.map { Double($0) }
+            notificationCallback(characteristicUUID.uuidString, doubleArray)
+        }
+    }
+    
+    // MARK: - CBPeripheralDelegate - Characteristic Write
+    func peripheral(
+        _ peripheral: CBPeripheral,
+        didWriteValueFor characteristic: CBCharacteristic,
+        error: Error?
+    ) {
+        let characteristicUUID = characteristic.uuid
+        
+        // Handle write callback using CBUUID
+        if let writeCallback = writeCallbacks[characteristicUUID] {
+            if let error = error {
+                writeCallback(false, error.localizedDescription)
+            } else {
+                writeCallback(true, "")
+            }
+            writeCallbacks.removeValue(forKey: characteristicUUID)
+        }
+    }
+    
+    // MARK: - CBPeripheralDelegate - Notifications
+    func peripheral(
+        _ peripheral: CBPeripheral,
+        didUpdateNotificationStateFor characteristic: CBCharacteristic,
+        error: Error?
+    ) {
+        let characteristicUUID = characteristic.uuid
+        
+        // Handle subscription callback using CBUUID
+        if let subscriptionCallback = subscriptionCallbacks[characteristicUUID] {
+            if let error = error {
+                subscriptionCallback(false, error.localizedDescription)
+            } else {
+                subscriptionCallback(characteristic.isNotifying, "")
+            }
+            subscriptionCallbacks.removeValue(forKey: characteristicUUID)
+        }
+        
+        // Handle unsubscription callback using CBUUID
+        if let unsubscriptionCallback = unsubscriptionCallbacks[characteristicUUID] {
+            if let error = error {
+                unsubscriptionCallback(false, error.localizedDescription)
+            } else {
+                unsubscriptionCallback(!characteristic.isNotifying, "")
+            }
+            unsubscriptionCallbacks.removeValue(forKey: characteristicUUID)
+        }
+    }
+    
+    // MARK: - CBPeripheralDelegate - Connection Events
+    func peripheral(_ peripheral: CBPeripheral, didReadRSSI RSSI: NSNumber, error: Error?) {
+        // Optional: Handle RSSI updates if needed
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didModifyServices invalidatedServices: [CBService]) {
+        // Handle service modifications
+        // This might require re-discovery of services
+    }
+    
+    func peripheralIsReady(toSendWriteWithoutResponse peripheral: CBPeripheral) {
+        // Handle write without response ready state
+        // Can be used to implement queuing for write operations
+    }
+    
+    // MARK: - Cleanup
+    func cleanup() {
+        // Clear all callbacks to prevent memory leaks
+        connectionCallback = nil
+        disconnectionCallback = nil
+        disconnectEventCallback = nil
+        serviceDiscoveryCallback = nil
+        characteristicDiscoveryCallbacks.removeAll()
+        readCallbacks.removeAll()
+        writeCallbacks.removeAll()
+        subscriptionCallbacks.removeAll()
+        unsubscriptionCallbacks.removeAll()
+        notificationCallbacks.removeAll()
+    }
+}

package/lib/commonjs/index.d.ts

@@ -1,11 +1,175 @@
-export * from './compatibility/constants';
-export * from './utils/index';
-export { BleManagerCompat as BleManager, createBleManagerCompat as createBleManager } from './BleManagerCompatFactory';
-export { getCustomErrorMessage, getStoredCallbacks } from './BleManagerFactory';
-export * from './errors/BleError';
-export { DeviceWrapper as Device } from './compatibility/deviceWrapper';
-export type { BleManagerOptions, ScanOptions, ConnectionOptions, NativeBleError, NativeDevice, NativeService, NativeCharacteristic, NativeDescriptor, Subscription } from './specs/types';
-export { State, LogLevel } from './compatibility/enums';
-export type { CharacteristicSubscriptionType, RefreshGattMoment } from './compatibility/enums';
-export { fullUUID } from './utils/uuid';
+export interface ScanFilter {
+    serviceUUIDs?: string[];
+    rssiThreshold?: number;
+    allowDuplicates?: boolean;
+}
+export interface ManufacturerDataEntry {
+    id: string;
+    data: number[];
+}
+export interface ManufacturerData {
+    companyIdentifiers: ManufacturerDataEntry[];
+}
+export interface BLEDevice {
+    id: string;
+    name: string;
+    rssi: number;
+    manufacturerData: ManufacturerData;
+    serviceUUIDs: string[];
+    isConnectable: boolean;
+}
+export type ScanCallback = (device: BLEDevice) => void;
+export type ConnectionCallback = (success: boolean, deviceId: string, error: string) => void;
+export type DisconnectEventCallback = (deviceId: string, interrupted: boolean, error: string) => void;
+export type OperationCallback = (success: boolean, error: string) => void;
+export type CharacteristicUpdateCallback = (characteristicId: string, data: number[]) => void;
+export type Subscription = {
+    remove: () => Promise<void>;
+};
+export declare enum BLEState {
+    Unknown = "Unknown",
+    Resetting = "Resetting",
+    Unsupported = "Unsupported",
+    Unauthorized = "Unauthorized",
+    PoweredOff = "PoweredOff",
+    PoweredOn = "PoweredOn"
+}
+export declare class BleNitro {
+    private _isScanning;
+    private _connectedDevices;
+    static instance(): BleNitro;
+    /**
+     * Converts a 16- oder 32-Bit UUID to a 128-Bit UUID
+     *
+     * @param uuid 16-, 32- or 128-Bit UUID as string
+     * @returns Full 128-Bit UUID
+     */
+    static normalizeGattUUID(uuid: string): string;
+    static normalizeGattUUIDs(uuids: string[]): string[];
+    /**
+     * Start scanning for Bluetooth devices
+     * @param filter Optional scan filter
+     * @param callback Callback function called when a device is found
+     * @returns Promise resolving to success state
+     */
+    startScan(filter: ScanFilter | undefined, callback: ScanCallback): Promise<boolean>;
+    /**
+     * Stop scanning for Bluetooth devices
+     * @returns Promise resolving to success state
+     */
+    stopScan(): Promise<boolean>;
+    /**
+     * Check if currently scanning for devices
+     * @returns Promise resolving to scanning state
+     */
+    isScanning(): Promise<boolean>;
+    /**
+     * Get all currently connected devices
+     * @returns Promise resolving to array of connected devices
+     */
+    getConnectedDevices(): Promise<BLEDevice[]>;
+    /**
+     * Connect to a Bluetooth device
+     * @param deviceId ID of the device to connect to
+     * @param onDisconnect Optional callback for disconnect events
+     * @returns Promise resolving when connected
+     */
+    connect(deviceId: string, onDisconnect?: DisconnectEventCallback): Promise<string>;
+    /**
+     * Disconnect from a Bluetooth device
+     * @param deviceId ID of the device to disconnect from
+     * @returns Promise resolving when disconnected
+     */
+    disconnect(deviceId: string): Promise<boolean>;
+    /**
+     * Check if connected to a device
+     * @param deviceId ID of the device to check
+     * @returns Promise resolving to connection state
+     */
+    isConnected(deviceId: string): Promise<boolean>;
+    /**
+     * Discover services for a connected device
+     * @param deviceId ID of the device
+     * @returns Promise resolving when services are discovered
+     */
+    discoverServices(deviceId: string): Promise<boolean>;
+    /**
+     * Get services for a connected device
+     * @param deviceId ID of the device
+     * @returns Promise resolving to array of service UUIDs
+     */
+    getServices(deviceId: string): Promise<string[]>;
+    /**
+     * Get characteristics for a service
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @returns Promise resolving to array of characteristic UUIDs
+     */
+    getCharacteristics(deviceId: string, serviceId: string): Promise<string[]>;
+    /**
+     * Read a characteristic value
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @returns Promise resolving to the characteristic data as byte array
+     */
+    readCharacteristic(deviceId: string, serviceId: string, characteristicId: string): Promise<number[]>;
+    /**
+     * Write a value to a characteristic
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @param data Data to write as an array of bytes
+     * @param withResponse Whether to wait for response
+     * @returns Promise resolving when write is complete
+     */
+    writeCharacteristic(deviceId: string, serviceId: string, characteristicId: string, data: number[], withResponse?: boolean): Promise<boolean>;
+    /**
+     * Subscribe to characteristic notifications
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @param callback Callback function called when notification is received
+     * @returns Promise resolving when subscription is complete
+     */
+    subscribeToCharacteristic(deviceId: string, serviceId: string, characteristicId: string, callback: CharacteristicUpdateCallback): Promise<Subscription>;
+    /**
+     * Unsubscribe from characteristic notifications
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @returns Promise resolving when unsubscription is complete
+     */
+    unsubscribeFromCharacteristic(deviceId: string, serviceId: string, characteristicId: string): Promise<void>;
+    /**
+     * Check if Bluetooth is enabled
+     * @returns Promise resolving to Bluetooth state
+     */
+    isBluetoothEnabled(): Promise<boolean>;
+    /**
+     * Request to enable Bluetooth
+     * @returns Promise resolving when Bluetooth is enabled
+     */
+    requestBluetoothEnable(): Promise<boolean>;
+    /**
+     * Get the current Bluetooth state
+     * @returns Promise resolving to Bluetooth state
+     * @see BLEState
+     */
+    state(): Promise<BLEState>;
+    /**
+     * Subscribe to Bluetooth state changes
+     * @param callback Callback function called when state changes
+     * @param emitInitial Whether to emit initial state callback
+     * @returns Promise resolving when subscription is complete
+     * @see BLEState
+     */
+    subscribeToStateChange(callback: (state: BLEState) => void, emitInitial?: boolean): Promise<Subscription>;
+    /**
+     * Open Bluetooth settings
+     * @returns Promise resolving when settings are opened
+     */
+    openSettings(): Promise<void>;
+}
+export declare const ble: BleNitro;
 //# sourceMappingURL=index.d.ts.map

package/lib/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAG1C,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,sBAAsB,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGvH,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAGxE,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,EACL,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,8BAA8B,EAC9B,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}