react-native-ble-nitro 1.0.0-alpha.1

package/lib/specs/Service.nitro.d.ts

@@ -0,0 +1,19 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { Identifier, UUID, DeviceId, Base64, TransactionId, CharacteristicSubscriptionType, NativeCharacteristic, NativeDescriptor, CharacteristicMonitorListener, Subscription } from './types';
+export interface Service extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    readonly id: Identifier;
+    readonly uuid: UUID;
+    readonly deviceID: DeviceId;
+    readonly isPrimary: boolean;
+    characteristics(): Promise<NativeCharacteristic[]>;
+    readCharacteristic(characteristicUUID: UUID, transactionId?: TransactionId): Promise<NativeCharacteristic>;
+    writeCharacteristicWithResponse(characteristicUUID: UUID, valueBase64: Base64, transactionId?: TransactionId): Promise<NativeCharacteristic>;
+    writeCharacteristicWithoutResponse(characteristicUUID: UUID, valueBase64: Base64, transactionId?: TransactionId): Promise<NativeCharacteristic>;
+    monitorCharacteristic(characteristicUUID: UUID, listener: CharacteristicMonitorListener, transactionId?: TransactionId, subscriptionType?: CharacteristicSubscriptionType): Subscription;
+    descriptorsForCharacteristic(characteristicUUID: UUID): Promise<NativeDescriptor[]>;
+    readDescriptorForCharacteristic(characteristicUUID: UUID, descriptorUUID: UUID, transactionId?: TransactionId): Promise<NativeDescriptor>;
+    writeDescriptorForCharacteristic(characteristicUUID: UUID, descriptorUUID: UUID, valueBase64: Base64, transactionId?: TransactionId): Promise<NativeDescriptor>;
+}

package/lib/specs/Service.nitro.js

@@ -0,0 +1 @@
+export {};

package/lib/specs/types.d.ts

@@ -0,0 +1,228 @@
+export type Base64 = string;
+export type UUID = string;
+export type Identifier = number;
+export type DeviceId = string;
+export type TransactionId = string;
+export declare enum RefreshGattMoment {
+    OnConnected = 0
+}
+export declare enum CharacteristicSubscriptionType {
+    Notification = 0,
+    Indication = 1
+}
+export interface ServiceDataEntry {
+    uuid: UUID;
+    data: Base64;
+}
+export declare enum State {
+    Unknown = 0,
+    Resetting = 1,
+    Unsupported = 2,
+    Unauthorized = 3,
+    PoweredOff = 4,
+    PoweredOn = 5
+}
+export declare enum LogLevel {
+    None = 0,
+    Verbose = 1,
+    Debug = 2,
+    Info = 3,
+    Warning = 4,
+    Error = 5
+}
+export declare enum ScanMode {
+    Opportunistic = -1,
+    LowPower = 0,
+    Balanced = 1,
+    LowLatency = 2
+}
+export declare enum ScanCallbackType {
+    AllMatches = 1,
+    FirstMatch = 2,
+    MatchLost = 4
+}
+export declare enum ConnectionPriority {
+    Balanced = 0,
+    High = 1,
+    LowPower = 2
+}
+export declare enum BleErrorCode {
+    UnknownError = 0,
+    BluetoothManagerDestroyed = 1,
+    OperationCancelled = 2,
+    OperationTimedOut = 3,
+    OperationStartFailed = 4,
+    InvalidIdentifiers = 5,
+    BluetoothUnsupported = 100,
+    BluetoothUnauthorized = 101,
+    BluetoothPoweredOff = 102,
+    BluetoothInUnknownState = 103,
+    BluetoothResetting = 104,
+    BluetoothStateChangeFailed = 105,
+    DeviceConnectionFailed = 200,
+    DeviceDisconnected = 201,
+    DeviceRSSIReadFailed = 202,
+    DeviceAlreadyConnected = 203,
+    DeviceNotFound = 204,
+    DeviceNotConnected = 205,
+    DeviceMTUChangeFailed = 206,
+    ServicesDiscoveryFailed = 300,
+    IncludedServicesDiscoveryFailed = 301,
+    ServiceNotFound = 302,
+    ServicesNotDiscovered = 303,
+    CharacteristicsDiscoveryFailed = 400,
+    CharacteristicWriteFailed = 401,
+    CharacteristicReadFailed = 402,
+    CharacteristicNotifyChangeFailed = 403,
+    CharacteristicNotFound = 404,
+    CharacteristicsNotDiscovered = 405,
+    CharacteristicInvalidDataFormat = 406,
+    DescriptorsDiscoveryFailed = 500,
+    DescriptorWriteFailed = 501,
+    DescriptorReadFailed = 502,
+    DescriptorNotFound = 503,
+    DescriptorsNotDiscovered = 504,
+    DescriptorInvalidDataFormat = 505,
+    DescriptorWriteNotAllowed = 506,
+    ScanStartFailed = 600,
+    LocationServicesDisabled = 601
+}
+export declare enum BleATTErrorCode {
+    Success = 0,
+    InvalidHandle = 1,
+    ReadNotPermitted = 2,
+    WriteNotPermitted = 3,
+    InvalidPdu = 4,
+    InsufficientAuthentication = 5,
+    RequestNotSupported = 6,
+    InvalidOffset = 7,
+    InsufficientAuthorization = 8,
+    PrepareQueueFull = 9,
+    AttributeNotFound = 10,
+    AttributeNotLong = 11,
+    InsufficientEncryptionKeySize = 12,
+    InvalidAttributeValueLength = 13,
+    UnlikelyError = 14,
+    InsufficientEncryption = 15,
+    UnsupportedGroupType = 16,
+    InsufficientResources = 17
+}
+export declare enum BleIOSErrorCode {
+    Unknown = 0,
+    InvalidParameters = 1,
+    InvalidHandle = 2,
+    NotConnected = 3,
+    OutOfSpace = 4,
+    OperationCancelled = 5,
+    ConnectionTimeout = 6,
+    PeripheralDisconnected = 7,
+    UuidNotAllowed = 8,
+    AlreadyAdvertising = 9,
+    ConnectionFailed = 10,
+    ConnectionLimitReached = 11,
+    UnknownDevice = 12
+}
+export declare enum BleAndroidErrorCode {
+    NoResources = 128,
+    InternalError = 129,
+    WrongState = 130,
+    DbFull = 131,
+    Busy = 132,
+    Error = 133,
+    CmdStarted = 134,
+    IllegalParameter = 135,
+    Pending = 136,
+    AuthFail = 137,
+    More = 138,
+    InvalidCfg = 139,
+    ServiceStarted = 140,
+    EncrypedNoMitm = 141,
+    NotEncrypted = 142,
+    Congested = 143
+}
+export interface ScanOptions {
+    allowDuplicates?: boolean;
+    scanMode?: ScanMode;
+    callbackType?: ScanCallbackType;
+    legacyScan?: boolean;
+}
+export interface ConnectionOptions {
+    autoConnect: boolean;
+    requestMTU: number;
+    timeout: number;
+}
+export interface BleManagerOptions {
+    restoreStateIdentifier?: string;
+    restoreStateFunction?: (restoredState: BleRestoredState | null) => void;
+    errorCodesToMessagesMapping?: BleErrorCodeMessageMapping;
+}
+export interface BleRestoredState {
+    connectedPeripherals: NativeDevice[];
+}
+export type BleErrorCodeMessageMapping = {
+    [key in BleErrorCode]: string;
+};
+export interface NativeDevice {
+    id: DeviceId;
+    name: string | null;
+    rssi: number | null;
+    mtu: number;
+    manufacturerData: Base64 | null;
+    rawScanRecord: Base64;
+    serviceData: ServiceDataEntry[] | null;
+    serviceUUIDs: UUID[] | null;
+    localName: string | null;
+    txPowerLevel: number | null;
+    solicitedServiceUUIDs: UUID[] | null;
+    isConnectable: boolean | null;
+    overflowServiceUUIDs: UUID[] | null;
+}
+export interface NativeService {
+    id: Identifier;
+    uuid: UUID;
+    deviceID: DeviceId;
+    isPrimary: boolean;
+}
+export interface NativeCharacteristic {
+    id: Identifier;
+    uuid: UUID;
+    serviceID: Identifier;
+    serviceUUID: UUID;
+    deviceID: DeviceId;
+    isReadable: boolean;
+    isWritableWithResponse: boolean;
+    isWritableWithoutResponse: boolean;
+    isNotifiable: boolean;
+    isNotifying: boolean;
+    isIndicatable: boolean;
+    value: Base64 | null;
+}
+export interface NativeDescriptor {
+    id: Identifier;
+    uuid: UUID;
+    characteristicID: Identifier;
+    characteristicUUID: UUID;
+    serviceID: Identifier;
+    serviceUUID: UUID;
+    deviceID: DeviceId;
+    value: Base64 | null;
+}
+export interface NativeBleError {
+    errorCode: BleErrorCode;
+    attErrorCode: BleATTErrorCode | null;
+    iosErrorCode: BleIOSErrorCode | null;
+    androidErrorCode: BleAndroidErrorCode | null;
+    reason: string | null;
+    deviceID?: string;
+    serviceUUID?: string;
+    characteristicUUID?: string;
+    descriptorUUID?: string;
+    internalMessage?: string;
+}
+export interface Subscription {
+    remove(): void;
+}
+export type StateListener = (newState: State) => void;
+export type DeviceScanListener = (error: NativeBleError | null, scannedDevice: NativeDevice | null) => void;
+export type DeviceDisconnectedListener = (error: NativeBleError | null, device: NativeDevice | null) => void;
+export type CharacteristicMonitorListener = (error: NativeBleError | null, characteristic: NativeCharacteristic | null) => void;

package/lib/specs/types.js

@@ -0,0 +1,146 @@
+export var RefreshGattMoment;
+(function (RefreshGattMoment) {
+    RefreshGattMoment[RefreshGattMoment["OnConnected"] = 0] = "OnConnected";
+})(RefreshGattMoment || (RefreshGattMoment = {}));
+export var CharacteristicSubscriptionType;
+(function (CharacteristicSubscriptionType) {
+    CharacteristicSubscriptionType[CharacteristicSubscriptionType["Notification"] = 0] = "Notification";
+    CharacteristicSubscriptionType[CharacteristicSubscriptionType["Indication"] = 1] = "Indication";
+})(CharacteristicSubscriptionType || (CharacteristicSubscriptionType = {}));
+// Enums
+export var State;
+(function (State) {
+    State[State["Unknown"] = 0] = "Unknown";
+    State[State["Resetting"] = 1] = "Resetting";
+    State[State["Unsupported"] = 2] = "Unsupported";
+    State[State["Unauthorized"] = 3] = "Unauthorized";
+    State[State["PoweredOff"] = 4] = "PoweredOff";
+    State[State["PoweredOn"] = 5] = "PoweredOn";
+})(State || (State = {}));
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["None"] = 0] = "None";
+    LogLevel[LogLevel["Verbose"] = 1] = "Verbose";
+    LogLevel[LogLevel["Debug"] = 2] = "Debug";
+    LogLevel[LogLevel["Info"] = 3] = "Info";
+    LogLevel[LogLevel["Warning"] = 4] = "Warning";
+    LogLevel[LogLevel["Error"] = 5] = "Error";
+})(LogLevel || (LogLevel = {}));
+export var ScanMode;
+(function (ScanMode) {
+    ScanMode[ScanMode["Opportunistic"] = -1] = "Opportunistic";
+    ScanMode[ScanMode["LowPower"] = 0] = "LowPower";
+    ScanMode[ScanMode["Balanced"] = 1] = "Balanced";
+    ScanMode[ScanMode["LowLatency"] = 2] = "LowLatency";
+})(ScanMode || (ScanMode = {}));
+export var ScanCallbackType;
+(function (ScanCallbackType) {
+    ScanCallbackType[ScanCallbackType["AllMatches"] = 1] = "AllMatches";
+    ScanCallbackType[ScanCallbackType["FirstMatch"] = 2] = "FirstMatch";
+    ScanCallbackType[ScanCallbackType["MatchLost"] = 4] = "MatchLost";
+})(ScanCallbackType || (ScanCallbackType = {}));
+export var ConnectionPriority;
+(function (ConnectionPriority) {
+    ConnectionPriority[ConnectionPriority["Balanced"] = 0] = "Balanced";
+    ConnectionPriority[ConnectionPriority["High"] = 1] = "High";
+    ConnectionPriority[ConnectionPriority["LowPower"] = 2] = "LowPower";
+})(ConnectionPriority || (ConnectionPriority = {}));
+// Complex error code enums
+export var BleErrorCode;
+(function (BleErrorCode) {
+    BleErrorCode[BleErrorCode["UnknownError"] = 0] = "UnknownError";
+    BleErrorCode[BleErrorCode["BluetoothManagerDestroyed"] = 1] = "BluetoothManagerDestroyed";
+    BleErrorCode[BleErrorCode["OperationCancelled"] = 2] = "OperationCancelled";
+    BleErrorCode[BleErrorCode["OperationTimedOut"] = 3] = "OperationTimedOut";
+    BleErrorCode[BleErrorCode["OperationStartFailed"] = 4] = "OperationStartFailed";
+    BleErrorCode[BleErrorCode["InvalidIdentifiers"] = 5] = "InvalidIdentifiers";
+    BleErrorCode[BleErrorCode["BluetoothUnsupported"] = 100] = "BluetoothUnsupported";
+    BleErrorCode[BleErrorCode["BluetoothUnauthorized"] = 101] = "BluetoothUnauthorized";
+    BleErrorCode[BleErrorCode["BluetoothPoweredOff"] = 102] = "BluetoothPoweredOff";
+    BleErrorCode[BleErrorCode["BluetoothInUnknownState"] = 103] = "BluetoothInUnknownState";
+    BleErrorCode[BleErrorCode["BluetoothResetting"] = 104] = "BluetoothResetting";
+    BleErrorCode[BleErrorCode["BluetoothStateChangeFailed"] = 105] = "BluetoothStateChangeFailed";
+    BleErrorCode[BleErrorCode["DeviceConnectionFailed"] = 200] = "DeviceConnectionFailed";
+    BleErrorCode[BleErrorCode["DeviceDisconnected"] = 201] = "DeviceDisconnected";
+    BleErrorCode[BleErrorCode["DeviceRSSIReadFailed"] = 202] = "DeviceRSSIReadFailed";
+    BleErrorCode[BleErrorCode["DeviceAlreadyConnected"] = 203] = "DeviceAlreadyConnected";
+    BleErrorCode[BleErrorCode["DeviceNotFound"] = 204] = "DeviceNotFound";
+    BleErrorCode[BleErrorCode["DeviceNotConnected"] = 205] = "DeviceNotConnected";
+    BleErrorCode[BleErrorCode["DeviceMTUChangeFailed"] = 206] = "DeviceMTUChangeFailed";
+    BleErrorCode[BleErrorCode["ServicesDiscoveryFailed"] = 300] = "ServicesDiscoveryFailed";
+    BleErrorCode[BleErrorCode["IncludedServicesDiscoveryFailed"] = 301] = "IncludedServicesDiscoveryFailed";
+    BleErrorCode[BleErrorCode["ServiceNotFound"] = 302] = "ServiceNotFound";
+    BleErrorCode[BleErrorCode["ServicesNotDiscovered"] = 303] = "ServicesNotDiscovered";
+    BleErrorCode[BleErrorCode["CharacteristicsDiscoveryFailed"] = 400] = "CharacteristicsDiscoveryFailed";
+    BleErrorCode[BleErrorCode["CharacteristicWriteFailed"] = 401] = "CharacteristicWriteFailed";
+    BleErrorCode[BleErrorCode["CharacteristicReadFailed"] = 402] = "CharacteristicReadFailed";
+    BleErrorCode[BleErrorCode["CharacteristicNotifyChangeFailed"] = 403] = "CharacteristicNotifyChangeFailed";
+    BleErrorCode[BleErrorCode["CharacteristicNotFound"] = 404] = "CharacteristicNotFound";
+    BleErrorCode[BleErrorCode["CharacteristicsNotDiscovered"] = 405] = "CharacteristicsNotDiscovered";
+    BleErrorCode[BleErrorCode["CharacteristicInvalidDataFormat"] = 406] = "CharacteristicInvalidDataFormat";
+    BleErrorCode[BleErrorCode["DescriptorsDiscoveryFailed"] = 500] = "DescriptorsDiscoveryFailed";
+    BleErrorCode[BleErrorCode["DescriptorWriteFailed"] = 501] = "DescriptorWriteFailed";
+    BleErrorCode[BleErrorCode["DescriptorReadFailed"] = 502] = "DescriptorReadFailed";
+    BleErrorCode[BleErrorCode["DescriptorNotFound"] = 503] = "DescriptorNotFound";
+    BleErrorCode[BleErrorCode["DescriptorsNotDiscovered"] = 504] = "DescriptorsNotDiscovered";
+    BleErrorCode[BleErrorCode["DescriptorInvalidDataFormat"] = 505] = "DescriptorInvalidDataFormat";
+    BleErrorCode[BleErrorCode["DescriptorWriteNotAllowed"] = 506] = "DescriptorWriteNotAllowed";
+    BleErrorCode[BleErrorCode["ScanStartFailed"] = 600] = "ScanStartFailed";
+    BleErrorCode[BleErrorCode["LocationServicesDisabled"] = 601] = "LocationServicesDisabled";
+})(BleErrorCode || (BleErrorCode = {}));
+export var BleATTErrorCode;
+(function (BleATTErrorCode) {
+    BleATTErrorCode[BleATTErrorCode["Success"] = 0] = "Success";
+    BleATTErrorCode[BleATTErrorCode["InvalidHandle"] = 1] = "InvalidHandle";
+    BleATTErrorCode[BleATTErrorCode["ReadNotPermitted"] = 2] = "ReadNotPermitted";
+    BleATTErrorCode[BleATTErrorCode["WriteNotPermitted"] = 3] = "WriteNotPermitted";
+    BleATTErrorCode[BleATTErrorCode["InvalidPdu"] = 4] = "InvalidPdu";
+    BleATTErrorCode[BleATTErrorCode["InsufficientAuthentication"] = 5] = "InsufficientAuthentication";
+    BleATTErrorCode[BleATTErrorCode["RequestNotSupported"] = 6] = "RequestNotSupported";
+    BleATTErrorCode[BleATTErrorCode["InvalidOffset"] = 7] = "InvalidOffset";
+    BleATTErrorCode[BleATTErrorCode["InsufficientAuthorization"] = 8] = "InsufficientAuthorization";
+    BleATTErrorCode[BleATTErrorCode["PrepareQueueFull"] = 9] = "PrepareQueueFull";
+    BleATTErrorCode[BleATTErrorCode["AttributeNotFound"] = 10] = "AttributeNotFound";
+    BleATTErrorCode[BleATTErrorCode["AttributeNotLong"] = 11] = "AttributeNotLong";
+    BleATTErrorCode[BleATTErrorCode["InsufficientEncryptionKeySize"] = 12] = "InsufficientEncryptionKeySize";
+    BleATTErrorCode[BleATTErrorCode["InvalidAttributeValueLength"] = 13] = "InvalidAttributeValueLength";
+    BleATTErrorCode[BleATTErrorCode["UnlikelyError"] = 14] = "UnlikelyError";
+    BleATTErrorCode[BleATTErrorCode["InsufficientEncryption"] = 15] = "InsufficientEncryption";
+    BleATTErrorCode[BleATTErrorCode["UnsupportedGroupType"] = 16] = "UnsupportedGroupType";
+    BleATTErrorCode[BleATTErrorCode["InsufficientResources"] = 17] = "InsufficientResources";
+})(BleATTErrorCode || (BleATTErrorCode = {}));
+export var BleIOSErrorCode;
+(function (BleIOSErrorCode) {
+    BleIOSErrorCode[BleIOSErrorCode["Unknown"] = 0] = "Unknown";
+    BleIOSErrorCode[BleIOSErrorCode["InvalidParameters"] = 1] = "InvalidParameters";
+    BleIOSErrorCode[BleIOSErrorCode["InvalidHandle"] = 2] = "InvalidHandle";
+    BleIOSErrorCode[BleIOSErrorCode["NotConnected"] = 3] = "NotConnected";
+    BleIOSErrorCode[BleIOSErrorCode["OutOfSpace"] = 4] = "OutOfSpace";
+    BleIOSErrorCode[BleIOSErrorCode["OperationCancelled"] = 5] = "OperationCancelled";
+    BleIOSErrorCode[BleIOSErrorCode["ConnectionTimeout"] = 6] = "ConnectionTimeout";
+    BleIOSErrorCode[BleIOSErrorCode["PeripheralDisconnected"] = 7] = "PeripheralDisconnected";
+    BleIOSErrorCode[BleIOSErrorCode["UuidNotAllowed"] = 8] = "UuidNotAllowed";
+    BleIOSErrorCode[BleIOSErrorCode["AlreadyAdvertising"] = 9] = "AlreadyAdvertising";
+    BleIOSErrorCode[BleIOSErrorCode["ConnectionFailed"] = 10] = "ConnectionFailed";
+    BleIOSErrorCode[BleIOSErrorCode["ConnectionLimitReached"] = 11] = "ConnectionLimitReached";
+    BleIOSErrorCode[BleIOSErrorCode["UnknownDevice"] = 12] = "UnknownDevice";
+})(BleIOSErrorCode || (BleIOSErrorCode = {}));
+export var BleAndroidErrorCode;
+(function (BleAndroidErrorCode) {
+    BleAndroidErrorCode[BleAndroidErrorCode["NoResources"] = 128] = "NoResources";
+    BleAndroidErrorCode[BleAndroidErrorCode["InternalError"] = 129] = "InternalError";
+    BleAndroidErrorCode[BleAndroidErrorCode["WrongState"] = 130] = "WrongState";
+    BleAndroidErrorCode[BleAndroidErrorCode["DbFull"] = 131] = "DbFull";
+    BleAndroidErrorCode[BleAndroidErrorCode["Busy"] = 132] = "Busy";
+    BleAndroidErrorCode[BleAndroidErrorCode["Error"] = 133] = "Error";
+    BleAndroidErrorCode[BleAndroidErrorCode["CmdStarted"] = 134] = "CmdStarted";
+    BleAndroidErrorCode[BleAndroidErrorCode["IllegalParameter"] = 135] = "IllegalParameter";
+    BleAndroidErrorCode[BleAndroidErrorCode["Pending"] = 136] = "Pending";
+    BleAndroidErrorCode[BleAndroidErrorCode["AuthFail"] = 137] = "AuthFail";
+    BleAndroidErrorCode[BleAndroidErrorCode["More"] = 138] = "More";
+    BleAndroidErrorCode[BleAndroidErrorCode["InvalidCfg"] = 139] = "InvalidCfg";
+    BleAndroidErrorCode[BleAndroidErrorCode["ServiceStarted"] = 140] = "ServiceStarted";
+    BleAndroidErrorCode[BleAndroidErrorCode["EncrypedNoMitm"] = 141] = "EncrypedNoMitm";
+    BleAndroidErrorCode[BleAndroidErrorCode["NotEncrypted"] = 142] = "NotEncrypted";
+    BleAndroidErrorCode[BleAndroidErrorCode["Congested"] = 143] = "Congested";
+})(BleAndroidErrorCode || (BleAndroidErrorCode = {}));

package/lib/utils/base64.d.ts

@@ -0,0 +1,25 @@
+import type { Base64 } from '../specs/types';
+/**
+ * Utility functions for Base64 encoding/decoding
+ * Maintains compatibility with react-native-ble-plx Base64 operations
+ */
+/**
+ * Converts a string to Base64
+ */
+export declare function stringToBase64(str: string): Base64;
+/**
+ * Converts Base64 to string
+ */
+export declare function base64ToString(base64: Base64): string;
+/**
+ * Converts Uint8Array to Base64
+ */
+export declare function uint8ArrayToBase64(uint8Array: Uint8Array): Base64;
+/**
+ * Converts Base64 to Uint8Array
+ */
+export declare function base64ToUint8Array(base64: Base64): Uint8Array;
+/**
+ * Validates if a string is valid Base64
+ */
+export declare function isValidBase64(str: string): boolean;

package/lib/utils/base64.js

@@ -0,0 +1,80 @@
+/**
+ * Utility functions for Base64 encoding/decoding
+ * Maintains compatibility with react-native-ble-plx Base64 operations
+ */
+/**
+ * Converts a string to Base64
+ */
+export function stringToBase64(str) {
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        return Buffer.from(str, 'utf8').toString('base64');
+    }
+    else if (typeof btoa !== 'undefined') {
+        // Browser environment
+        return btoa(str);
+    }
+    else {
+        throw new Error('Base64 encoding not supported in this environment');
+    }
+}
+/**
+ * Converts Base64 to string
+ */
+export function base64ToString(base64) {
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        return Buffer.from(base64, 'base64').toString('utf8');
+    }
+    else if (typeof atob !== 'undefined') {
+        // Browser environment
+        return atob(base64);
+    }
+    else {
+        throw new Error('Base64 decoding not supported in this environment');
+    }
+}
+/**
+ * Converts Uint8Array to Base64
+ */
+export function uint8ArrayToBase64(uint8Array) {
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        return Buffer.from(uint8Array).toString('base64');
+    }
+    else {
+        // Browser environment
+        const binary = Array.from(uint8Array, byte => String.fromCharCode(byte)).join('');
+        return btoa(binary);
+    }
+}
+/**
+ * Converts Base64 to Uint8Array
+ */
+export function base64ToUint8Array(base64) {
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        return new Uint8Array(Buffer.from(base64, 'base64'));
+    }
+    else {
+        // Browser environment
+        const binary = atob(base64);
+        const uint8Array = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            uint8Array[i] = binary.charCodeAt(i);
+        }
+        return uint8Array;
+    }
+}
+/**
+ * Validates if a string is valid Base64
+ */
+export function isValidBase64(str) {
+    try {
+        const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+        return base64Regex.test(str) && (str.length % 4 === 0);
+    }
+    catch {
+        return false;
+    }
+}

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './uuid';
+export * from './base64';

package/lib/utils/index.js

@@ -0,0 +1,2 @@
+export * from './uuid';
+export * from './base64';

package/lib/utils/uuid.d.ts

@@ -0,0 +1,9 @@
+import type { UUID } from '../specs/types';
+/**
+ * Converts UUID to full 128bit, lowercase format which should be used to compare UUID values.
+ * This function maintains 100% compatibility with react-native-ble-plx
+ *
+ * @param uuid 16bit, 32bit or 128bit UUID.
+ * @returns 128bit lowercase UUID.
+ */
+export declare function fullUUID(uuid: UUID): UUID;

package/lib/utils/uuid.js

@@ -0,0 +1,37 @@
+/**
+ * Converts UUID to full 128bit, lowercase format which should be used to compare UUID values.
+ * This function maintains 100% compatibility with react-native-ble-plx
+ *
+ * @param uuid 16bit, 32bit or 128bit UUID.
+ * @returns 128bit lowercase UUID.
+ */
+export function fullUUID(uuid) {
+    if (typeof uuid !== 'string') {
+        throw new Error('UUID must be a string');
+    }
+    // Remove dashes and convert to lowercase
+    const cleanUuid = uuid.replace(/-/g, '').toLowerCase();
+    // 16-bit UUID (4 characters)
+    if (cleanUuid.length === 4) {
+        return `0000${cleanUuid}-0000-1000-8000-00805f9b34fb`;
+    }
+    // 32-bit UUID (8 characters)
+    if (cleanUuid.length === 8) {
+        return `${cleanUuid}-0000-1000-8000-00805f9b34fb`;
+    }
+    // 128-bit UUID (32 characters)
+    if (cleanUuid.length === 32) {
+        return [
+            cleanUuid.substring(0, 8),
+            cleanUuid.substring(8, 12),
+            cleanUuid.substring(12, 16),
+            cleanUuid.substring(16, 20),
+            cleanUuid.substring(20, 32)
+        ].join('-');
+    }
+    // Already formatted UUID with dashes
+    if (cleanUuid.length === 36 && uuid.match(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)) {
+        return uuid.toLowerCase();
+    }
+    throw new Error(`Invalid UUID format: ${uuid}`);
+}

package/nitro.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://nitro.margelo.com/nitro.schema.json",
+  "cxxNamespace": ["co", "zyke", "ble"],
+  "ios": {
+    "iosModuleName": "BleNitro"
+  },
+  "android": {
+    "androidNamespace": ["co", "zyke", "ble"],
+    "androidCxxLibName": "BleNitro"
+  },
+  "autolinking": {},
+  "ignorePaths": [
+    "**/node_modules"
+  ]
+}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "react-native-ble-nitro",
+  "version": "1.0.0-alpha.1",
+  "description": "High-performance React Native BLE library built on Nitro Modules - drop-in replacement for react-native-ble-plx",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "react-native": "./src/index.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js",
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./plugin": {
+      "import": "./plugin/build/index.js",
+      "require": "./plugin/build/index.js",
+      "types": "./plugin/build/index.d.ts",
+      "default": "./plugin/build/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "npm run clean && npm run build:plugin && tsc",
+    "build:plugin": "tsc --project plugin/tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm run test",
+    "nitro-codegen": "nitro-codegen generate",
+    "clean": "rm -rf lib && rm -rf plugin/build",
+    "test": "jest",
+    "lint": "eslint src/ --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "version": "npm run build",
+    "postversion": "git push && git push --tags"
+  },
+  "keywords": [
+    "react-native",
+    "bluetooth",
+    "ble",
+    "bluetooth-low-energy",
+    "nitro-modules",
+    "expo",
+    "ios",
+    "android",
+    "performance"
+  ],
+  "author": "Zyke (https://zyke.co)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zykeco/react-native-ble-nitro.git"
+  },
+  "homepage": "https://github.com/zykeco/react-native-ble-nitro#readme",
+  "bugs": {
+    "url": "https://github.com/zykeco/react-native-ble-nitro/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.76.0",
+    "react-native-nitro-modules": "*"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.0.0",
+    "expo": "^52.0.47",
+    "jest": "^29.0.0",
+    "nitro-codegen": "^0.26.4",
+    "react-native": "^0.76.0",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "ios/",
+    "android/",
+    "plugin/build/",
+    "nitro.json",
+    "react-native.config.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "expo": {
+    "platforms": [
+      "ios",
+      "android"
+    ]
+  },
+  "codegenConfig": {
+    "name": "BleNitroSpec",
+    "type": "modules",
+    "jsSrcsDir": "src"
+  }
+}