@ledgerhq/device-transport-kit-react-native-ble 0.0.0-wip-20250214170223 → 0.0.0-wrong-error-when-in-experimental-provider-20251021161219

package/lib/types/api/transport/RNBleTransport.d.ts

@@ -1,28 +1,33 @@
-import { type ApduReceiverServiceFactory, type ApduSenderServiceFactory, type ConnectError, type DeviceId, type DeviceModelDataSource, type DisconnectHandler, type DmkError, type LoggerPublisherService, type Transport, TransportConnectedDevice, type TransportDiscoveredDevice, type TransportFactory, type TransportIdentifier } from "@ledgerhq/device-management-kit";
-import { type Either } from "purify-ts";
-import { Observable } from "rxjs";
+import { Platform } from "react-native";
+import { type BleManager, State } from "react-native-ble-plx";
+import { type ApduReceiverServiceFactory, type ApduSenderServiceFactory, type ConnectError, DeviceConnectionStateMachine, type DeviceConnectionStateMachineParams, type DeviceId, type DeviceModelDataSource, type DisconnectHandler, type DmkError, type LoggerPublisherService, type Transport, TransportConnectedDevice, type TransportDiscoveredDevice, type TransportIdentifier } from "@ledgerhq/device-management-kit";
+import { Either } from "purify-ts";
+import { type Observable } from "rxjs";
+import { type PermissionsService } from "../permissions/PermissionsService";
+import { RNBleApduSender, type RNBleApduSenderConstructorArgs, type RNBleApduSenderDependencies } from "../transport/RNBleApduSender";
 export declare const rnBleTransportIdentifier = "RN_BLE";
 export declare class RNBleTransport implements Transport {
     private readonly _deviceModelDataSource;
     private readonly _loggerServiceFactory;
     private readonly _apduSenderFactory;
     private readonly _apduReceiverFactory;
+    private readonly _manager;
+    private readonly _platform;
+    private readonly _permissionsService;
+    private readonly _scanThrottleDelayMs;
+    private readonly _deviceConnectionStateMachineFactory;
+    private readonly _deviceApduSenderFactory;
     private _logger;
-    private _isSupported;
-    private _internalDevicesById;
     private _deviceConnectionsById;
-    private readonly _manager;
     private readonly identifier;
-    constructor(_deviceModelDataSource: DeviceModelDataSource, _loggerServiceFactory: (tag: string) => LoggerPublisherService, _apduSenderFactory: ApduSenderServiceFactory, _apduReceiverFactory: ApduReceiverServiceFactory);
+    private _reconnectionSubscription;
+    private readonly _bleStateSubject;
+    constructor(_deviceModelDataSource: DeviceModelDataSource, _loggerServiceFactory: (tag: string) => LoggerPublisherService, _apduSenderFactory: ApduSenderServiceFactory, _apduReceiverFactory: ApduReceiverServiceFactory, _manager: BleManager, _platform: Platform, _permissionsService: PermissionsService, _scanThrottleDelayMs?: number, _deviceConnectionStateMachineFactory?: (args: DeviceConnectionStateMachineParams<RNBleApduSenderDependencies>) => DeviceConnectionStateMachine<RNBleApduSenderDependencies>, _deviceApduSenderFactory?: (args: RNBleApduSenderConstructorArgs, loggerFactory: (tag: string) => LoggerPublisherService) => RNBleApduSender);
+    /** Exposed for testing purposes */
+    observeBleState(): Observable<State>;
     /**
-     * Starts the discovery process to find Bluetooth devices that match specific criteria.
-     *
-     * This method clears the internal device cache and requests necessary permissions
-     * before initiating the discovery of both known and new devices. If the Bluetooth
-     * Low Energy (BLE) feature is not supported, an error is thrown.
-     *
-     * @return {Observable<TransportDiscoveredDevice>} An observable emitting discovered devices
-     * that match the specified Bluetooth services.
+     * Not implemented for now as the return signature is not really usable.
+     * Use listenToAvailableDevices instead.
      */
     startDiscovering(): Observable<TransportDiscoveredDevice>;
     /**
@@ -31,6 +36,29 @@ export declare class RNBleTransport implements Transport {
      * @return {Promise<void>} A promise that resolves once the device scanning has been successfully stopped.
      */
     stopDiscovering(): Promise<void>;
+    private _scannedDevicesSubject;
+    private _startedScanningSubscriber;
+    /**
+     * Returns an observable that emits a value when the prerequisites for scanning are met.
+     * The prerequisites are:
+     * - BLE should be supported. If not, it will throw an error.
+     * - Permissions should be granted. If not, it request them, if it fails, it will throw an error.
+     * - BLE state should be PoweredOn.
+     *   - If BLE state is undetermined (Unknown or Resetting), it will wait for the state to be updated.
+     *   - For other states, it will throw an error.
+     */
+    private _waitForScanningPrerequisites;
+    private _startScanning;
+    private _stopScanning;
+    /**
+     * Listens to known devices and emits updates when new devices are discovered or when properties of existing devices are updated.
+     *
+     * @return {Observable<TransportDiscoveredDevice[]>} An observable stream of discovered devices, containing device information as an array of TransportDiscoveredDevice objects.
+     */
+    listenToAvailableDevices(): Observable<TransportDiscoveredDevice[]>;
+    private _mapServicesUUIDsToBluetoothDeviceInfo;
+    private _mapServicesUUIDsToDeviceModel;
+    private _mapDeviceToTransportDiscoveredDevice;
     /**
      * Establishes a connection to a device and configures the necessary parameters for communication.
      *
@@ -52,13 +80,6 @@ export declare class RNBleTransport implements Transport {
     disconnect(params: {
         connectedDevice: TransportConnectedDevice;
     }): Promise<Either<DmkError, void>>;
-    private _isDiscoveredDeviceLost;
-    /**
-     * Listens to known devices and emits updates when new devices are discovered or when properties of existing devices are updated.
-     *
-     * @return {Observable<TransportDiscoveredDevice[]>} An observable stream of discovered devices, containing device information as an array of TransportDiscoveredDevice objects.
-     */
-    listenToKnownDevices(): Observable<TransportDiscoveredDevice[]>;
     /**
      * Determines if the feature or permission is supported.
      *
@@ -77,55 +98,9 @@ export declare class RNBleTransport implements Transport {
      */
     getIdentifier(): TransportIdentifier;
     /**
-     * Requests the necessary permissions based on the operating system.
-     * For iOS, it automatically sets the permissions as granted.
-     * For Android, it checks and requests location, Bluetooth scan, and Bluetooth connect permissions, depending on the API level.
-     * If permissions are granted, updates the internal support state and logs the result.
-     *
-     * @return {Promise<boolean>} A promise that resolves to true if the required permissions are granted, otherwise false.
-     */
-    requestPermission(): Promise<boolean>;
-    /**
-     * Retrieves a discovered device and its BLE device information, if available, from the provided input.
-     *
-     * @param {Device} rnDevice - The Bluetooth device to analyze for discovery.
-     * @param {string[]} ledgerUuids - A list of UUIDs associated with the target Ledger devices.
-     * @return {Maybe<{ bleDeviceInfos: BleDeviceInfos; discoveredDevice: TransportDiscoveredDevice }>} A Maybe object containing the discovered device and its BLE information, or Nothing if the device or information cannot be determined.
-     */
-    private _getDiscoveredDeviceFrom;
-    /**
-     * Handles the processing of devices that have been determined to be "lost" by iterating
-     * through a collection of internal devices, identifying lost devices, updating their status,
-     * and notifying a subscriber about the change.
-     *
-     * @param {Subscriber<TransportDiscoveredDevice>} subscriber - The observer that will be notified
-     *     when a device is marked as lost, including updated device information with its availability set to false.
-     * @return {void} This method does not return a value.
-     */
-    private _handleLostDiscoveredDevices;
-    /**
-     * Emits a discovered device to the provided subscriber and manages internal state
-     * for the discovered device, including handling its availability status and disconnection events.
-     *
-     * @param {Subscriber<TransportDiscoveredDevice>} subscriber The subscriber to emit the discovered device to.
-     * @param {BleDeviceInfos} bleDeviceInfos The BLE device information associated with the discovered device.
-     * @param {TransportDiscoveredDevice} discoveredDevice The newly discovered device to be emitted.
-     * @return {void} Does*/
-    private _emitDiscoveredDevice;
-    /**
-     * Discovers new devices by scanning for BLE devices and filtering them based on the provided ledger UUIDs.
-     *
-     * @param {string[]} ledgerUuids - An array of UUIDs used to identify relevant ledger devices.
-     * @return {Observable<TransportDiscoveredDevice>} An observable that emits discovered devices matching the provided UUIDs.
-     */
-    private _discoverNewDevices;
-    /**
-     * Discovers and emits known ledger devices based on the provided UUIDs.
-     *
-     * @param {string[]} ledgerUuids - An array of UUIDs representing the target ledger devices to discover.
-     * @return {Observable<TransportDiscoveredDevice>} An Observable that emits discovered devices matching the provided UUIDs.
+     * Checks if the necessary permissions are granted and requests them if not.
      */
-    private _discoverKnownDevices;
+    checkAndRequestPermissions(): Promise<boolean>;
     /**
      * Handles the event when a Bluetooth device gets disconnected. This method attempts
      * to reconnect to the device, retries a certain number of times on failure, and
@@ -133,22 +108,23 @@ export declare class RNBleTransport implements Transport {
      *
      * @param {BleError | null} error - The error object representing the reason for the disconnection, or null if no error occurred.
      * @param {Device | null} device - The Bluetooth device that was disconnected, or null if no device is provided.
-     * @param {DisconnectHandler} onDisconnect - A callback function to be called if the reconnection attempts fail completely.
      * @return {void}
      */
     private _handleDeviceDisconnected;
+    private _listenToDeviceDisconnected;
+    private tryToReconnect;
     /**
      * Handles the reconnection of a device. Configures the device connection and its corresponding
      * internal device upon reconnection, including updating the connection state, registering
      * callbacks for write and monitor operations, and initiating a reconnect operation.
      *
-     * @param {Device} device - The device object that has been reconnected. Contains device details,
+     * @param {Device} device - The ddevice object that has been reconnected. Contains device details,
      *                          such as the device ID.
      * @return {Promise<Either<DeviceConnectionNotFound | InternalDeviceNotFound, void>>} A promise that completes when the device reconnection has been fully
      *                         configured. Resolves with no value or rejects if an error occurs during
      *                         the reconnection process.
      */
     private _handleDeviceReconnected;
+    private _safeCancel;
 }
-export declare const RNBleTransportFactory: TransportFactory;
 //# sourceMappingURL=RNBleTransport.d.ts.map

package/lib/types/api/transport/RNBleTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RNBleTransport.d.ts","sourceRoot":"","sources":["../../../../src/api/transport/RNBleTransport.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAE7B,KAAK,YAAY,EAEjB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAE3B,KAAK,SAAS,EACd,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAEzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,MAAM,EAAsC,MAAM,WAAW,CAAC;AAC5E,OAAO,EAGL,UAAU,EAIX,MAAM,MAAM,CAAC;AAiBd,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD,qBAAa,cAAe,YAAW,SAAS;IAY5C,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAGtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAhBvC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,sBAAsB,CAG5B;IACF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;gBAGzC,sBAAsB,EAAE,qBAAqB,EAC7C,qBAAqB,EAAE,CACtC,GAAG,EAAE,MAAM,KACR,sBAAsB,EACV,kBAAkB,EAAE,wBAAwB,EAC5C,oBAAoB,EAAE,0BAA0B;IAUnE;;;;;;;;;OASG;IACH,gBAAgB,IAAI,UAAU,CAAC,yBAAyB,CAAC;IAgBzD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,QAAQ,CAAC;QACnB,YAAY,EAAE,iBAAiB,CAAC;KACjC,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAgF3D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,eAAe,EAAE,wBAAwB,CAAC;KAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAYnC,OAAO,CAAC,uBAAuB;IAW/B;;;;OAIG;IACH,oBAAoB,IAAI,UAAU,CAAC,yBAAyB,EAAE,CAAC;IAI/D;;;;;;;;;OASG;IACH,WAAW,IAAI,OAAO;IAStB;;;;OAIG;IACH,aAAa,IAAI,mBAAmB;IAIpC;;;;;;;OAOG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAmD3C;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAwChC;;;;;;;;OAQG;IACH,OAAO,CAAC,4BAA4B;IAcpC;;;;;;;4BAOwB;IACxB,OAAO,CAAC,qBAAqB;IAyB7B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;;;;;;;;OASG;IACH,OAAO,CAAC,yBAAyB;IAwEjC;;;;;;;;;;OAUG;YACW,wBAAwB;CA2BvC;AAED,eAAO,MAAM,qBAAqB,EAAE,gBAWjC,CAAC"}
+{"version":3,"file":"RNBleTransport.d.ts","sourceRoot":"","sources":["../../../../src/api/transport/RNBleTransport.ts"],"names":[],"mappings":"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"}

package/lib/types/api/transport/RNBleTransport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RNBleTransport.test.d.ts.map

package/lib/types/api/transport/RNBleTransport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RNBleTransport.test.d.ts","sourceRoot":"","sources":["../../../../src/api/transport/RNBleTransport.test.ts"],"names":[],"mappings":""}

package/lib/types/api/transport/RNBleTransportFactory.d.ts

@@ -0,0 +1,3 @@
+import type { TransportFactory } from "@ledgerhq/device-management-kit";
+export declare const RNBleTransportFactory: TransportFactory;
+//# sourceMappingURL=RNBleTransportFactory.d.ts.map

package/lib/types/api/transport/RNBleTransportFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RNBleTransportFactory.d.ts","sourceRoot":"","sources":["../../../../src/api/transport/RNBleTransportFactory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAQxE,eAAO,MAAM,qBAAqB,EAAE,gBAmBjC,CAAC"}