@onekeyfe/hd-transport-react-native 1.2.0-alpha.99 → 1.2.0

package/dist/index.js

@@ -194,6 +194,38 @@ const subscribeBleOn = (bleManager, ms = 1000) => new Promise((resolve, reject)
     }, ms);
 });
 
+const ATT_INSUFFICIENT_AUTHENTICATION = 5;
+const ATT_INSUFFICIENT_ENCRYPTION = 15;
+const IOS_PEER_REMOVED_PAIRING_INFORMATION = 14;
+const nativeErrorText = (error) => [error.reason, error.message]
+    .filter((value) => typeof value === 'string')
+    .join(' ');
+const isNativeBleStaleBondError = (error) => {
+    if (!error || typeof error !== 'object') {
+        return typeof error === 'string' ? hdShared.isBleStaleBondErrorText(error) : false;
+    }
+    const nativeError = error;
+    if (nativeError.attErrorCode === ATT_INSUFFICIENT_AUTHENTICATION ||
+        nativeError.attErrorCode === ATT_INSUFFICIENT_ENCRYPTION ||
+        nativeError.iosErrorCode === IOS_PEER_REMOVED_PAIRING_INFORMATION) {
+        return true;
+    }
+    return hdShared.isBleStaleBondErrorText(nativeErrorText(nativeError));
+};
+const toBleStaleBondHardwareError = (error) => {
+    if (hdShared.isBleStaleBondHardwareError(error)) {
+        return error;
+    }
+    const nativeError = (error !== null && error !== void 0 ? error : {});
+    const text = nativeErrorText(nativeError);
+    const normalizedText = text.toLowerCase();
+    const peerRemoved = nativeError.iosErrorCode === IOS_PEER_REMOVED_PAIRING_INFORMATION ||
+        normalizedText.includes('peer removed pairing information');
+    return hdShared.ERRORS.TypedError(peerRemoved
+        ? hdShared.HardwareErrorCode.BlePeerRemovedPairingInformation
+        : hdShared.HardwareErrorCode.BleDeviceBondError, text || undefined);
+};
+
 const isHeaderChunk = (chunk) => {
     if (chunk.length < 9)
         return false;
@@ -274,9 +306,10 @@ const getFirmwareUploadWriteRetryType = (error) => {
     return text.includes('GATT_CONGESTED') || hasGattCongestedStatus(text) ? 'congested' : null;
 };
 const resolveFirmwareUploadRetryDelay = (attempt, baseDelayMs = 200, maxDelayMs = 1200) => Math.min(baseDelayMs * Math.pow(2, attempt), maxDelayMs);
-const PROTOCOL_PROBE_TIMEOUT_MS = 1000;
+const PROTOCOL_PROBE_TIMEOUT_MS = 3000;
 const PROTOCOL_V2_PROBE_TIMEOUT_MS = 10000;
 const BLE_WRITE_PACKET_TIMEOUT_MS = 10000;
+const BLE_NATIVE_TEARDOWN_TIMEOUT_MS = 3000;
 const WEDGED_WRITE_MESSAGE = 'BLE write timeout after';
 const isWedgedWriteError = (error) => (error === null || error === void 0 ? void 0 : error.errorCode) === hdShared.HardwareErrorCode.BleWriteCharacteristicError &&
     typeof (error === null || error === void 0 ? void 0 : error.message) === 'string' &&
@@ -310,9 +343,6 @@ function resetProtocolV2BleTuning() {
 function getProtocolV2BleTuning() {
     return Object.assign({}, protocolV2BleTuning);
 }
-function inferProtocolHintFromDeviceName(name) {
-    return /\bpro\s*2\b/i.test(name !== null && name !== void 0 ? name : '') ? 'V2' : undefined;
-}
 function getDeviceDisplayName(device) {
     return (device === null || device === void 0 ? void 0 : device.name) || (device === null || device === void 0 ? void 0 : device.localName) || null;
 }
@@ -335,9 +365,14 @@ const BLE_GATT_SETUP_TIMEOUT_MS = 10000;
 const PROTOCOL_REPROBE_FALLBACK_ATTEMPTS = 3;
 const BLE_CONNECT_TIMEOUT_MANAGER_RESET_THRESHOLD = 2;
 const CONNECT_TIMEOUT_MESSAGE = 'BLE connect timeout after';
+const BLE_SETUP_WEDGED_MESSAGE = 'BLE setup wedged repeatedly';
 const isConnectTimeoutError = (error) => (error === null || error === void 0 ? void 0 : error.errorCode) === hdShared.HardwareErrorCode.BleConnectedError &&
     typeof (error === null || error === void 0 ? void 0 : error.message) === 'string' &&
     error.message.startsWith(CONNECT_TIMEOUT_MESSAGE);
+const isWedgedBleSetupError = (error) => (error === null || error === void 0 ? void 0 : error.errorCode) === hdShared.HardwareErrorCode.PollingTimeout &&
+    typeof (error === null || error === void 0 ? void 0 : error.message) === 'string' &&
+    error.message.startsWith(BLE_SETUP_WEDGED_MESSAGE);
+const shouldRethrowBleSetupError = (error) => isConnectTimeoutError(error) || isWedgedBleSetupError(error);
 const isNativeOperationTimeoutError = (error) => (error === null || error === void 0 ? void 0 : error.errorCode) === reactNativeBlePlx.BleErrorCode.OperationTimedOut;
 const tryToGetConfiguration = (device) => {
     if (!device || !device.serviceUUIDs)
@@ -369,12 +404,11 @@ const requestNegotiatedMtu = (device, stage, attempt) => __awaiter(void 0, void
     }
 });
 const resolveNegotiatedMtu = (device) => requestNegotiatedMtu(device, 'connected', 0);
-function remapError(error) {
+function remapError(error, mapProtocolV2StaleBond) {
     var _a;
     if (error instanceof reactNativeBlePlx.BleError) {
-        if (error.iosErrorCode === reactNativeBlePlx.BleATTErrorCode.UnlikelyError ||
-            error.reason === 'Peer removed pairing information') {
-            throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BlePeerRemovedPairingInformation);
+        if (mapProtocolV2StaleBond && isNativeBleStaleBondError(error)) {
+            throw toBleStaleBondHardwareError(error);
         }
         if ((error === null || error === void 0 ? void 0 : error.attErrorCode) === 22) {
             throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleDeviceBondError);
@@ -403,7 +437,10 @@ class ReactNativeBleTransport {
         this.connectionSetupTimeoutCounts = new Map();
         this.deviceProtocolHints = new Map();
         this.sessionProtocols = new Map();
+        this.confirmedProtocolV2 = new Set();
         this.protocolReprobeFailures = new Map();
+        this.staleBondErrors = new Map();
+        this.acquiringProtocolV2 = new Set();
         this.protocolV2Assemblers = new Map();
         this.protocolV2FrameQueues = new Map();
         this.protocolV2FramePromises = new Map();
@@ -434,6 +471,7 @@ class ReactNativeBleTransport {
         this.androidHighPriorityDevices = new Set();
         this.androidPriorityResetTimers = new Map();
         this.nextMonitorToken = 1;
+        this.lifecycleOperations = new Map();
         this.scanTimeout = (_a = options.scanTimeout) !== null && _a !== void 0 ? _a : DEVICE_SCAN_TIMEOUT_MS;
     }
     init(logger, emitter) {
@@ -658,7 +696,7 @@ class ReactNativeBleTransport {
                     allowDuplicates: true,
                     scanMode: reactNativeBlePlx.ScanMode.LowLatency,
                 }, (error, device) => {
-                    var _a;
+                    var _a, _b;
                     if (error) {
                         Log === null || Log === void 0 ? void 0 : Log.debug('ble scan error: ', error);
                         if ([reactNativeBlePlx.BleErrorCode.BluetoothPoweredOff, reactNativeBlePlx.BleErrorCode.BluetoothInUnknownState].includes(error.errorCode)) {
@@ -680,15 +718,12 @@ class ReactNativeBleTransport {
                     }
                     const displayName = getDeviceDisplayName(device);
                     const isUnnamedIOSPeripheral = reactNative.Platform.OS === 'ios' && !(displayName === null || displayName === void 0 ? void 0 : displayName.trim());
-                    const isFindMyPeripheral = hdShared.isPro2FindMyAdvertisementName(device === null || device === void 0 ? void 0 : device.name) ||
-                        hdShared.isPro2FindMyAdvertisementName(device === null || device === void 0 ? void 0 : device.localName);
                     const isOneKey = !isUnnamedIOSPeripheral &&
-                        !isFindMyPeripheral &&
                         hdShared.isOnekeyBluetoothDevice({
                             id: device === null || device === void 0 ? void 0 : device.id,
                             name: device === null || device === void 0 ? void 0 : device.name,
                             localName: device === null || device === void 0 ? void 0 : device.localName,
-                            serviceUuids: device === null || device === void 0 ? void 0 : device.serviceUUIDs,
+                            serviceUuids: (_b = device === null || device === void 0 ? void 0 : device.serviceUUIDs) !== null && _b !== void 0 ? _b : getBluetoothServiceUuids(),
                         });
                     if (isOneKey) {
                         addDevice(device);
@@ -707,15 +742,12 @@ class ReactNativeBleTransport {
                         const localName = 'localName' in device && typeof device.localName === 'string'
                             ? device.localName
                             : null;
-                        const isFindMyPeripheral = hdShared.isPro2FindMyAdvertisementName(device.name) ||
-                            hdShared.isPro2FindMyAdvertisementName(localName);
-                        if (!isFindMyPeripheral &&
-                            hdShared.isOnekeyBluetoothDevice({
-                                id: device.id,
-                                name: device.name,
-                                localName,
-                                serviceUuids: device.serviceUUIDs,
-                            })) {
+                        if (hdShared.isOnekeyBluetoothDevice({
+                            id: device.id,
+                            name: device.name,
+                            localName,
+                            serviceUuids: device.serviceUUIDs,
+                        })) {
                             Log === null || Log === void 0 ? void 0 : Log.debug('search connected peripheral: ', device.id);
                             addDevice(device);
                         }
@@ -725,16 +757,11 @@ class ReactNativeBleTransport {
                     var _a;
                     if (deviceList.every(d => d.id !== device.id)) {
                         const displayName = (_a = getDeviceDisplayName(device)) !== null && _a !== void 0 ? _a : 'Unknown BLE Device';
-                        const protocolHint = inferProtocolHintFromDeviceName(displayName);
-                        if (protocolHint) {
-                            this.deviceProtocolHints.set(device.id, protocolHint);
-                        }
                         deviceList.push(Object.assign(Object.assign({}, device), { name: displayName, commType: 'ble' }));
                         Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] OneKey BLE device discovered', {
                             deviceId: device.id,
                             name: displayName,
                             serviceUUIDs: device.serviceUUIDs,
-                            protocolHint,
                         });
                     }
                 };
@@ -797,24 +824,57 @@ class ReactNativeBleTransport {
         });
     }
     acquire(input) {
-        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            const { uuid, forceCleanRunPromise, expectedProtocol } = input;
+            const { uuid } = input;
             if (!uuid) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleRequiredUUID);
             }
+            return this.runLifecycleOperation(uuid, () => this.acquireUnlocked(input));
+        });
+    }
+    acquireUnlocked(input) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const { uuid, forceCleanRunPromise, expectedProtocol, skipProtocolProbe } = input;
+            const shouldMapProtocolV2StaleBond = expectedProtocol
+                ? expectedProtocol === 'V2'
+                : this.confirmedProtocolV2.has(uuid);
             const cachedTransport = transportCache[uuid];
+            if (skipProtocolProbe && !cachedTransport && this.blePlxManager) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] refresh uncached BLE connection for firmware install:', uuid);
+                const manager = this.blePlxManager;
+                yield this.runNativeTeardown(uuid, manager, () => __awaiter(this, void 0, void 0, function* () {
+                    yield this.runBestEffortNativeOperation('firmware install reconnect: cancel uncached device connection', () => manager.cancelDeviceConnection(uuid));
+                }));
+            }
             if (cachedTransport) {
-                const cachedProtocol = this.deviceProtocol.get(uuid);
-                const isCachedDeviceConnected = yield cachedTransport.device.isConnected().catch(() => false);
-                if (isCachedDeviceConnected &&
-                    cachedProtocol &&
-                    (!expectedProtocol || cachedProtocol === expectedProtocol)) {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] reuse cached BLE transport:', uuid, cachedProtocol);
-                    return { uuid, protocolType: cachedProtocol };
+                if (skipProtocolProbe) {
+                    Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] refresh cached BLE connection for firmware install:', uuid);
+                    const manager = this.blePlxManager;
+                    yield this.releaseUnlocked(uuid, true);
+                    yield this.runNativeTeardown(uuid, manager, () => __awaiter(this, void 0, void 0, function* () {
+                        const operations = [];
+                        if (manager) {
+                            operations.push(this.runBestEffortNativeOperation('firmware install reconnect: cancel device connection', () => manager.cancelDeviceConnection(uuid)));
+                        }
+                        operations.push(this.runBestEffortNativeOperation('firmware install reconnect: device cancel connection', () => cachedTransport.device.cancelConnection()));
+                        yield Promise.all(operations);
+                    }));
+                }
+                else {
+                    const cachedProtocol = this.deviceProtocol.get(uuid);
+                    const isCachedDeviceConnected = yield cachedTransport.device
+                        .isConnected()
+                        .catch(() => false);
+                    if (isCachedDeviceConnected &&
+                        cachedProtocol &&
+                        (!expectedProtocol || cachedProtocol === expectedProtocol)) {
+                        Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] reuse cached BLE transport:', uuid, cachedProtocol);
+                        return { uuid, protocolType: cachedProtocol };
+                    }
+                    Log === null || Log === void 0 ? void 0 : Log.debug('transport not reusable, will release: ', uuid);
+                    yield this.releaseUnlocked(uuid, true);
                 }
-                Log === null || Log === void 0 ? void 0 : Log.debug('transport not reusable, will release: ', uuid);
-                yield this.release(uuid, true);
             }
             let device = null;
             if (forceCleanRunPromise && this.runPromise) {
@@ -858,7 +918,7 @@ class ReactNativeBleTransport {
                 }
                 catch (e) {
                     Log === null || Log === void 0 ? void 0 : Log.debug('try to connect to device has error: ', e);
-                    if (isConnectTimeoutError(e)) {
+                    if (shouldRethrowBleSetupError(e)) {
                         throw e;
                     }
                     if (e.errorCode === reactNativeBlePlx.BleErrorCode.DeviceMTUChangeFailed ||
@@ -871,7 +931,7 @@ class ReactNativeBleTransport {
                         throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleAlreadyConnected);
                     }
                     else {
-                        remapError(e);
+                        remapError(e, shouldMapProtocolV2StaleBond);
                     }
                 }
             }
@@ -886,7 +946,7 @@ class ReactNativeBleTransport {
                 }
                 catch (e) {
                     Log === null || Log === void 0 ? void 0 : Log.debug('not connected, try to connect to device has error: ', e);
-                    if (isConnectTimeoutError(e)) {
+                    if (shouldRethrowBleSetupError(e)) {
                         throw e;
                     }
                     if (e.errorCode === reactNativeBlePlx.BleErrorCode.DeviceMTUChangeFailed ||
@@ -905,7 +965,7 @@ class ReactNativeBleTransport {
                         }
                     }
                     else {
-                        remapError(e);
+                        remapError(e, shouldMapProtocolV2StaleBond);
                     }
                 }
             }
@@ -914,16 +974,43 @@ class ReactNativeBleTransport {
             const { writeCharacteristic, notifyCharacteristic } = yield this.resolveCharacteristicsWithTimeout(uuid, acquiredDevice);
             const protocolHint = expectedProtocol
                 ? undefined
-                : (_b = (_a = input.protocolHint) !== null && _a !== void 0 ? _a : this.deviceProtocolHints.get(uuid)) !== null && _b !== void 0 ? _b : inferProtocolHintFromDeviceName(getDeviceDisplayName(acquiredDevice));
-            yield this.release(uuid, true);
+                : (_a = input.protocolHint) !== null && _a !== void 0 ? _a : this.deviceProtocolHints.get(uuid);
+            yield this.releaseUnlocked(uuid, true);
             if (protocolHint) {
                 this.deviceProtocolHints.set(uuid, protocolHint);
             }
-            yield this.installTransportForAcquire(uuid, acquiredDevice, {
-                writeCharacteristic,
-                notifyCharacteristic,
-            });
+            if (shouldMapProtocolV2StaleBond) {
+                this.acquiringProtocolV2.add(uuid);
+            }
             try {
+                yield this.installTransportForAcquire(uuid, acquiredDevice, {
+                    writeCharacteristic,
+                    notifyCharacteristic,
+                });
+                if (skipProtocolProbe) {
+                    if (!expectedProtocol) {
+                        throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'skipProtocolProbe requires an expected BLE protocol');
+                    }
+                    const hasConfirmedProtocol = this.sessionProtocols.get(uuid) === expectedProtocol ||
+                        (expectedProtocol === 'V2' && this.confirmedProtocolV2.has(uuid));
+                    if (!hasConfirmedProtocol) {
+                        throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'skipProtocolProbe requires a previously confirmed protocol for this BLE endpoint');
+                    }
+                    this.deviceProtocol.set(uuid, expectedProtocol);
+                    this.sessionProtocols.set(uuid, expectedProtocol);
+                    this.protocolReprobeFailures.delete(uuid);
+                    Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] protocol selected without probe', {
+                        deviceId: uuid,
+                        protocol: expectedProtocol,
+                        source: 'firmware-install-reconnect',
+                    });
+                    const currentTransport = transportCache[uuid];
+                    if (!currentTransport) {
+                        throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotFound);
+                    }
+                    this.attachDisconnectSubscription(currentTransport, currentTransport.device, uuid);
+                    return { uuid, protocolType: expectedProtocol };
+                }
                 const protocolType = yield this.detectProtocol(uuid, expectedProtocol, protocolHint, () => __awaiter(this, void 0, void 0, function* () {
                     yield this.installTransportForAcquire(uuid, acquiredDevice);
                 }));
@@ -935,16 +1022,24 @@ class ReactNativeBleTransport {
                 return { uuid, protocolType };
             }
             catch (error) {
-                yield this.release(uuid, true);
+                if (hdShared.isBleStaleBondHardwareError(error)) {
+                    yield this.disconnectUnlocked(uuid);
+                }
+                else {
+                    yield this.releaseUnlocked(uuid, true);
+                }
                 throw error;
             }
+            finally {
+                this.acquiringProtocolV2.delete(uuid);
+            }
         });
     }
     _monitorCharacteristic(characteristic, uuid, monitorToken, notifyTransactionId) {
         let bufferLength = 0;
         let buffer$1 = [];
         const subscription = characteristic.monitor((error, c) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
             const isCurrentMonitor = this.monitorTokens.get(uuid) === monitorToken;
             if (error) {
                 Log === null || Log === void 0 ? void 0 : Log.debug(`error monitor ${characteristic.uuid}, deviceId: ${characteristic.deviceID}: ${error}`);
@@ -956,19 +1051,21 @@ class ReactNativeBleTransport {
                     Log === null || Log === void 0 ? void 0 : Log.debug('monitor error ignored for stale transport: ', uuid, notifyTransactionId);
                     return;
                 }
+                if ((this.getActiveProtocol(uuid) === 'V2' || this.acquiringProtocolV2.has(uuid)) &&
+                    isNativeBleStaleBondError(error)) {
+                    this.rememberStaleBondError(uuid, toBleStaleBondHardwareError(error));
+                    return;
+                }
                 if (this.getActiveProtocol(uuid) === 'V2') {
                     let errorCode = hdShared.HardwareErrorCode.BleCharacteristicNotifyError;
                     if ((_a = error.reason) === null || _a === void 0 ? void 0 : _a.includes('The connection has timed out unexpectedly')) {
                         errorCode = hdShared.HardwareErrorCode.BleTimeoutError;
                     }
-                    else if ((_b = error.reason) === null || _b === void 0 ? void 0 : _b.includes('Encryption is insufficient')) {
-                        errorCode = hdShared.HardwareErrorCode.BleDeviceBondError;
-                    }
-                    else if (((_c = error.reason) === null || _c === void 0 ? void 0 : _c.includes('Cannot write client characteristic config descriptor')) ||
-                        ((_d = error.reason) === null || _d === void 0 ? void 0 : _d.includes('Cannot find client characteristic config descriptor')) ||
-                        ((_e = error.reason) === null || _e === void 0 ? void 0 : _e.includes('The handle is invalid')) ||
-                        ((_f = error.reason) === null || _f === void 0 ? void 0 : _f.includes('Writing is not permitted')) ||
-                        ((_g = error.reason) === null || _g === void 0 ? void 0 : _g.includes('notify change failed for device'))) {
+                    else if (((_b = error.reason) === null || _b === void 0 ? void 0 : _b.includes('Cannot write client characteristic config descriptor')) ||
+                        ((_c = error.reason) === null || _c === void 0 ? void 0 : _c.includes('Cannot find client characteristic config descriptor')) ||
+                        ((_d = error.reason) === null || _d === void 0 ? void 0 : _d.includes('The handle is invalid')) ||
+                        ((_e = error.reason) === null || _e === void 0 ? void 0 : _e.includes('Writing is not permitted')) ||
+                        ((_f = error.reason) === null || _f === void 0 ? void 0 : _f.includes('notify change failed for device'))) {
                         errorCode = hdShared.HardwareErrorCode.BleCharacteristicNotifyChangeFailure;
                     }
                     this.rejectProtocolV2Frames(uuid, hdShared.ERRORS.TypedError(errorCode));
@@ -976,17 +1073,14 @@ class ReactNativeBleTransport {
                 }
                 if (this.runPromise && this.runPromiseDeviceId === uuid) {
                     let ERROR = hdShared.HardwareErrorCode.BleCharacteristicNotifyError;
-                    if ((_h = error.reason) === null || _h === void 0 ? void 0 : _h.includes('The connection has timed out unexpectedly')) {
+                    if ((_g = error.reason) === null || _g === void 0 ? void 0 : _g.includes('The connection has timed out unexpectedly')) {
                         ERROR = hdShared.HardwareErrorCode.BleTimeoutError;
                     }
-                    if ((_j = error.reason) === null || _j === void 0 ? void 0 : _j.includes('Encryption is insufficient')) {
-                        ERROR = hdShared.HardwareErrorCode.BleDeviceBondError;
-                    }
-                    if (((_k = error.reason) === null || _k === void 0 ? void 0 : _k.includes('Cannot write client characteristic config descriptor')) ||
-                        ((_l = error.reason) === null || _l === void 0 ? void 0 : _l.includes('Cannot find client characteristic config descriptor')) ||
-                        ((_m = error.reason) === null || _m === void 0 ? void 0 : _m.includes('The handle is invalid')) ||
-                        ((_o = error.reason) === null || _o === void 0 ? void 0 : _o.includes('Writing is not permitted')) ||
-                        ((_p = error.reason) === null || _p === void 0 ? void 0 : _p.includes('notify change failed for device'))) {
+                    if (((_h = error.reason) === null || _h === void 0 ? void 0 : _h.includes('Cannot write client characteristic config descriptor')) ||
+                        ((_j = error.reason) === null || _j === void 0 ? void 0 : _j.includes('Cannot find client characteristic config descriptor')) ||
+                        ((_k = error.reason) === null || _k === void 0 ? void 0 : _k.includes('The handle is invalid')) ||
+                        ((_l = error.reason) === null || _l === void 0 ? void 0 : _l.includes('Writing is not permitted')) ||
+                        ((_m = error.reason) === null || _m === void 0 ? void 0 : _m.includes('notify change failed for device'))) {
                         const notifyError = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleCharacteristicNotifyChangeFailure);
                         this.runPromise.reject(notifyError);
                         Log === null || Log === void 0 ? void 0 : Log.debug(`${hdShared.HardwareErrorCode.BleCharacteristicNotifyChangeFailure} ${error.message}    ${error.reason}`);
@@ -1028,7 +1122,7 @@ class ReactNativeBleTransport {
                     bufferLength = 0;
                     buffer$1 = [];
                     if (this.runPromiseDeviceId === uuid) {
-                        (_q = this.runPromise) === null || _q === void 0 ? void 0 : _q.resolve(value.toString('hex'));
+                        (_o = this.runPromise) === null || _o === void 0 ? void 0 : _o.resolve(value.toString('hex'));
                     }
                 }
             }
@@ -1039,22 +1133,28 @@ class ReactNativeBleTransport {
                     this.rejectProtocolV2Frames(uuid, notifyError);
                 }
                 else if (this.runPromiseDeviceId === uuid) {
-                    (_r = this.runPromise) === null || _r === void 0 ? void 0 : _r.reject(notifyError);
+                    (_p = this.runPromise) === null || _p === void 0 ? void 0 : _p.reject(notifyError);
                 }
             }
         }, notifyTransactionId);
         return subscription;
     }
     release(uuid, onclose = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.runLifecycleOperation(uuid, () => this.releaseUnlocked(uuid, onclose));
+        });
+    }
+    releaseUnlocked(uuid, onclose = false) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.protocolV2Links.invalidateLink(uuid, 'React Native BLE transport released');
             return this.releaseNative(uuid, onclose);
         });
     }
     releaseNative(uuid, onclose = false) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
             const transport = transportCache[uuid];
+            const manager = this.blePlxManager;
             if (this.runPromise && this.runPromiseDeviceId === uuid) {
                 const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleForceCleanRunPromise);
                 this.runPromise.reject(error);
@@ -1070,7 +1170,6 @@ class ReactNativeBleTransport {
                 this.resetProtocolV2Frames(uuid);
                 return Promise.resolve(true);
             }
-            yield this.restoreAndroidConnectionPriority(uuid, transport);
             if (transport) {
                 if (this.monitorTokens.get(uuid) === transport.monitorToken) {
                     this.monitorTokens.delete(uuid);
@@ -1081,33 +1180,39 @@ class ReactNativeBleTransport {
                 Log === null || Log === void 0 ? void 0 : Log.debug('release: removing notify subscription, characteristic: ', (_c = transport.notifyCharacteristic) === null || _c === void 0 ? void 0 : _c.uuid);
                 (_d = transport.notifySubscription) === null || _d === void 0 ? void 0 : _d.remove();
                 transport.notifySubscription = undefined;
-                if (transport.notifyTransactionId) {
-                    try {
-                        yield ((_e = this.blePlxManager) === null || _e === void 0 ? void 0 : _e.cancelTransaction(transport.notifyTransactionId));
-                    }
-                    catch (e) {
-                        Log === null || Log === void 0 ? void 0 : Log.debug('release: cancel notify transaction error (ignored): ', (e === null || e === void 0 ? void 0 : e.message) || e);
-                    }
+                if (transportCache[uuid] === transport) {
+                    delete transportCache[uuid];
                 }
-                delete transportCache[uuid];
             }
             this.protocolV2HighVolumeLogSignatures.delete(uuid);
             this.deviceProtocol.delete(uuid);
             this.probingProtocols.delete(uuid);
-            (_f = this.protocolV2Assemblers.get(uuid)) === null || _f === void 0 ? void 0 : _f.reset();
+            this.staleBondErrors.delete(uuid);
+            this.acquiringProtocolV2.delete(uuid);
+            (_e = this.protocolV2Assemblers.get(uuid)) === null || _e === void 0 ? void 0 : _e.reset();
             this.protocolV2Assemblers.delete(uuid);
             this.resetProtocolV2Frames(uuid);
-            try {
-                yield ((_g = this.blePlxManager) === null || _g === void 0 ? void 0 : _g.cancelTransaction(uuid));
-            }
-            catch (e) {
-                Log === null || Log === void 0 ? void 0 : Log.debug('release: cancel transaction error (ignored): ', (e === null || e === void 0 ? void 0 : e.message) || e);
-            }
+            yield this.runNativeTeardown(uuid, manager, () => __awaiter(this, void 0, void 0, function* () {
+                const operations = [
+                    this.runBestEffortNativeOperation('release: restore connection priority', () => this.restoreAndroidConnectionPriority(uuid, transport)),
+                ];
+                if ((transport === null || transport === void 0 ? void 0 : transport.notifyTransactionId) && manager) {
+                    operations.push(this.runBestEffortNativeOperation('release: cancel notify transaction', () => manager.cancelTransaction(transport.notifyTransactionId)));
+                }
+                if (manager) {
+                    operations.push(this.runBestEffortNativeOperation('release: cancel transaction', () => manager.cancelTransaction(uuid)));
+                }
+                yield Promise.all(operations);
+            }));
             return Promise.resolve(true);
         });
     }
     post(session, name, data) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this.getProtocolType(session) === 'V2') {
+                yield this.protocolV2Links.sendFlowControl(session, () => this.createProtocolV2Adapter(session), name, data);
+                return;
+            }
             yield this.call(session, name, data);
         });
     }
@@ -1123,7 +1228,6 @@ class ReactNativeBleTransport {
             if (!protocol) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Device protocol has not been detected for ${uuid}`);
             }
-            Log === null || Log === void 0 ? void 0 : Log.debug('transport call', transport.createTransportCallLog(name, protocol, data));
             if (protocol === 'V2') {
                 return this.callProtocolV2(uuid, name, data, options);
             }
@@ -1334,10 +1438,16 @@ class ReactNativeBleTransport {
         this.stopped = true;
     }
     disconnect(session) {
-        var _a, _b, _c, _d, _e;
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.runLifecycleOperation(session, () => this.disconnectUnlocked(session));
+        });
+    }
+    disconnectUnlocked(session) {
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             yield this.protocolV2Links.invalidateLink(session, 'React Native BLE transport disconnected');
             const transport = transportCache[session];
+            const manager = this.blePlxManager;
             const monitorToken = (_a = transport === null || transport === void 0 ? void 0 : transport.monitorToken) !== null && _a !== void 0 ? _a : this.monitorTokens.get(session);
             if (transport === null || transport === void 0 ? void 0 : transport.disconnectSubscription) {
                 try {
@@ -1359,40 +1469,19 @@ class ReactNativeBleTransport {
                     Log === null || Log === void 0 ? void 0 : Log.error('disconnect: remove notify subscription error: ', e);
                 }
             }
-            if (session) {
-                try {
-                    yield ((_c = this.blePlxManager) === null || _c === void 0 ? void 0 : _c.cancelTransaction(session));
-                }
-                catch (e) {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('resetSession: cancel transaction error (ignored): ', (e === null || e === void 0 ? void 0 : e.message) || e);
-                }
-            }
-            if (transport === null || transport === void 0 ? void 0 : transport.device) {
-                try {
-                    yield transport.device.cancelConnection();
-                }
-                catch (e) {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('resetSession: device.cancelConnection error (ignored): ', (e === null || e === void 0 ? void 0 : e.message) || e);
-                }
-            }
-            try {
-                yield ((_d = this.blePlxManager) === null || _d === void 0 ? void 0 : _d.cancelDeviceConnection(session));
-            }
-            catch (e) {
-                Log === null || Log === void 0 ? void 0 : Log.debug('resetSession: manager.cancelDeviceConnection error (ignored): ', (e === null || e === void 0 ? void 0 : e.message) || e);
-            }
-            if (transportCache[session]) {
+            if (!transport || transportCache[session] === transport) {
                 delete transportCache[session];
             }
             this.deviceProtocol.delete(session);
             this.probingProtocols.delete(session);
+            this.staleBondErrors.delete(session);
             this.deviceProtocolHints.delete(session);
             this.sessionProtocols.delete(session);
             this.protocolReprobeFailures.delete(session);
             this.protocolV2Assemblers.delete(session);
             this.resetProtocolV2Frames(session);
             try {
-                this.emitDeviceDisconnect(session, (_e = transport === null || transport === void 0 ? void 0 : transport.device) === null || _e === void 0 ? void 0 : _e.name, monitorToken);
+                this.emitDeviceDisconnect(session, (_c = transport === null || transport === void 0 ? void 0 : transport.device) === null || _c === void 0 ? void 0 : _c.name, monitorToken);
             }
             catch (e) {
                 Log === null || Log === void 0 ? void 0 : Log.error('resetSession: emit disconnect event error: ', e);
@@ -1400,9 +1489,81 @@ class ReactNativeBleTransport {
             if (monitorToken !== undefined && this.monitorTokens.get(session) === monitorToken) {
                 this.monitorTokens.delete(session);
             }
+            yield this.runNativeTeardown(session, manager, () => __awaiter(this, void 0, void 0, function* () {
+                const operations = [];
+                if (manager) {
+                    operations.push(this.runBestEffortNativeOperation('disconnect: cancel transaction', () => manager.cancelTransaction(session)));
+                    operations.push(this.runBestEffortNativeOperation('disconnect: cancel device connection', () => manager.cancelDeviceConnection(session)));
+                }
+                if (transport === null || transport === void 0 ? void 0 : transport.device) {
+                    operations.push(this.runBestEffortNativeOperation('disconnect: device cancel connection', () => transport.device.cancelConnection()));
+                }
+                yield Promise.all(operations);
+            }));
             yield new Promise(resolve => setTimeout(() => resolve(), 100));
         });
     }
+    runNativeTeardown(uuid, manager, teardown) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let timer;
+            let timedOut = false;
+            const pending = Promise.resolve()
+                .then(teardown)
+                .catch(error => {
+                Log === null || Log === void 0 ? void 0 : Log.debug('BLE native teardown error (ignored): ', (error === null || error === void 0 ? void 0 : error.message) || error);
+            });
+            try {
+                yield Promise.race([
+                    pending,
+                    new Promise(resolve => {
+                        timer = setTimeout(() => {
+                            timedOut = true;
+                            resolve();
+                        }, BLE_NATIVE_TEARDOWN_TIMEOUT_MS);
+                    }),
+                ]);
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+            }
+            if (timedOut) {
+                Log === null || Log === void 0 ? void 0 : Log.error('[ReactNativeBleTransport] BLE native teardown timed out:', uuid);
+                if (this.blePlxManager === manager) {
+                    this.resetPlxManager();
+                }
+            }
+        });
+    }
+    runBestEffortNativeOperation(label, operation) {
+        return Promise.resolve()
+            .then(operation)
+            .catch(error => {
+            Log === null || Log === void 0 ? void 0 : Log.debug(`${label} error (ignored): `, (error === null || error === void 0 ? void 0 : error.message) || error);
+        });
+    }
+    runLifecycleOperation(uuid, operation) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const previousOperation = (_a = this.lifecycleOperations.get(uuid)) !== null && _a !== void 0 ? _a : Promise.resolve();
+            let completeOperation;
+            const operationGate = new Promise(resolve => {
+                completeOperation = resolve;
+            });
+            const operationTail = previousOperation.catch(() => undefined).then(() => operationGate);
+            this.lifecycleOperations.set(uuid, operationTail);
+            yield previousOperation.catch(() => undefined);
+            try {
+                return yield operation();
+            }
+            finally {
+                completeOperation();
+                if (this.lifecycleOperations.get(uuid) === operationTail) {
+                    this.lifecycleOperations.delete(uuid);
+                }
+            }
+        });
+    }
     cancel() {
         Log === null || Log === void 0 ? void 0 : Log.debug('transport-react-native transport cancel');
         if (this.runPromise) ;
@@ -1429,7 +1590,10 @@ class ReactNativeBleTransport {
             }
             catch (error) {
                 if (timedOut || isNativeOperationTimeoutError(error)) {
-                    this.abandonStalledConnection(uuid, timedOut ? 'connect-backstop' : 'connect-native');
+                    const resetManager = this.abandonStalledConnection(uuid, timedOut ? 'connect-backstop' : 'connect-native');
+                    if (resetManager) {
+                        throw this.createWedgedBleSetupError();
+                    }
                 }
                 throw error;
             }
@@ -1460,7 +1624,10 @@ class ReactNativeBleTransport {
             }
             catch (error) {
                 if (timedOut || isNativeOperationTimeoutError(error)) {
-                    this.abandonStalledConnection(uuid, timedOut ? 'gatt-backstop' : 'gatt-native');
+                    const resetManager = this.abandonStalledConnection(uuid, timedOut ? 'gatt-backstop' : 'gatt-native');
+                    if (resetManager) {
+                        throw this.createWedgedBleSetupError();
+                    }
                 }
                 throw error;
             }
@@ -1486,13 +1653,20 @@ class ReactNativeBleTransport {
         }
         this.deviceProtocol.delete(uuid);
         this.probingProtocols.delete(uuid);
+        this.staleBondErrors.delete(uuid);
+        this.acquiringProtocolV2.delete(uuid);
         this.protocolV2Assemblers.delete(uuid);
         this.resetProtocolV2Frames(uuid);
         if (timeouts >= BLE_CONNECT_TIMEOUT_MANAGER_RESET_THRESHOLD) {
             Log === null || Log === void 0 ? void 0 : Log.error('[ReactNativeBleTransport] BLE setup wedged repeatedly, resetting BLE manager');
             this.resetPlxManager();
             this.connectionSetupTimeoutCounts.delete(uuid);
+            return true;
         }
+        return false;
+    }
+    createWedgedBleSetupError() {
+        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.PollingTimeout, BLE_SETUP_WEDGED_MESSAGE);
     }
     getCachedTransport(uuid) {
         const transport = transportCache[uuid];
@@ -1550,6 +1724,8 @@ class ReactNativeBleTransport {
         }
         this.deviceProtocol.delete(uuid);
         this.probingProtocols.delete(uuid);
+        this.staleBondErrors.delete(uuid);
+        this.acquiringProtocolV2.delete(uuid);
         this.protocolV2Assemblers.delete(uuid);
         this.resetProtocolV2Frames(uuid);
         if (timeouts >= BLE_WRITE_TIMEOUT_MANAGER_RESET_THRESHOLD) {
@@ -1561,11 +1737,39 @@ class ReactNativeBleTransport {
     resetPlxManager() {
         const manager = this.blePlxManager;
         this.blePlxManager = undefined;
-        Object.keys(transportCache).forEach(key => {
-            delete transportCache[key];
+        const reason = 'React Native BLE manager reset';
+        Object.entries(transportCache).forEach(([uuid, cachedTransport]) => {
+            var _a, _b, _c, _d;
+            try {
+                (_a = cachedTransport.disconnectSubscription) === null || _a === void 0 ? void 0 : _a.remove();
+            }
+            catch (error) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('BLE manager reset disconnect subscription removal failed:', error);
+            }
+            cachedTransport.disconnectSubscription = undefined;
+            try {
+                (_b = cachedTransport.notifySubscription) === null || _b === void 0 ? void 0 : _b.remove();
+            }
+            catch (error) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('BLE manager reset notify subscription removal failed:', error);
+            }
+            cachedTransport.notifySubscription = undefined;
+            this.rejectProtocolV2Frames(uuid, new Error(reason));
+            try {
+                this.emitDeviceDisconnect(uuid, (_c = cachedTransport.device) === null || _c === void 0 ? void 0 : _c.name, (_d = cachedTransport.monitorToken) !== null && _d !== void 0 ? _d : this.monitorTokens.get(uuid));
+            }
+            catch (error) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('BLE manager reset disconnect event failed:', error);
+            }
+            delete transportCache[uuid];
+        });
+        this.protocolV2Links.invalidateAllLinks(reason).catch(error => {
+            Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] BLE manager link invalidation failed:', error);
         });
         this.deviceProtocol.clear();
         this.probingProtocols.clear();
+        this.staleBondErrors.clear();
+        this.acquiringProtocolV2.clear();
         this.sessionProtocols.clear();
         this.protocolReprobeFailures.clear();
         this.writeTimeoutCounts.clear();
@@ -1600,32 +1804,23 @@ class ReactNativeBleTransport {
     detectProtocol(uuid, expectedProtocol, protocolHint, rebuildTransport) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            if (reactNative.Platform.OS === 'ios' && expectedProtocol) {
-                this.deviceProtocol.set(uuid, expectedProtocol);
+            if (expectedProtocol === 'V1') {
+                this.deviceProtocol.set(uuid, 'V1');
                 Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] protocol selected', {
                     deviceId: uuid,
-                    protocol: expectedProtocol,
+                    protocol: 'V1',
                     source: 'expected',
                 });
-                return expectedProtocol;
+                return 'V1';
             }
-            if (expectedProtocol === 'V1') {
-                if (yield this.probeProtocolV1(uuid)) {
-                    this.deviceProtocol.set(uuid, 'V1');
-                    this.sessionProtocols.set(uuid, 'V1');
-                    Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] protocol detected', {
-                        deviceId: uuid,
-                        protocol: 'V1',
-                        source: 'expected',
-                    });
-                    return 'V1';
-                }
-                throw this.createProtocolMismatchError(expectedProtocol);
+            if (expectedProtocol === 'V2' || this.acquiringProtocolV2.has(uuid)) {
+                this.throwIfStaleBondError(uuid);
             }
             if (expectedProtocol === 'V2') {
                 if (yield this.probeProtocolV2(uuid)) {
                     this.deviceProtocol.set(uuid, 'V2');
                     this.sessionProtocols.set(uuid, 'V2');
+                    this.confirmedProtocolV2.add(uuid);
                     Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] protocol detected', {
                         deviceId: uuid,
                         protocol: 'V2',
@@ -1657,6 +1852,9 @@ class ReactNativeBleTransport {
                 if (detected) {
                     this.deviceProtocol.set(uuid, protocol);
                     this.sessionProtocols.set(uuid, protocol);
+                    if (protocol === 'V2') {
+                        this.confirmedProtocolV2.add(uuid);
+                    }
                     this.protocolReprobeFailures.delete(uuid);
                     Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] protocol detected', {
                         deviceId: uuid,
@@ -1748,6 +1946,7 @@ class ReactNativeBleTransport {
             }
             this.probingProtocols.set(uuid, 'V2');
             (_a = this.protocolV2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
+            this.throwIfStaleBondError(uuid);
             const detected = yield transport.probeProtocolV2({
                 call: (name, data, options) => this.callProtocolV2(uuid, name, data, options),
                 timeoutMs: PROTOCOL_V2_PROBE_TIMEOUT_MS,
@@ -1758,6 +1957,7 @@ class ReactNativeBleTransport {
                     (_a = this.protocolV2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
                     this.resetProtocolV2Frames(uuid);
                 },
+                shouldRethrow: hdShared.isBleStaleBondHardwareError,
             });
             if (!detected) {
                 this.clearProbeProtocol(uuid, 'V2');
@@ -1818,6 +2018,19 @@ class ReactNativeBleTransport {
             framePromise.reject(error);
         }
     }
+    rememberStaleBondError(uuid, error) {
+        this.staleBondErrors.set(uuid, error);
+        this.rejectProtocolV2Frames(uuid, error);
+        if (this.runPromise && this.runPromiseDeviceId === uuid) {
+            this.runPromise.reject(error);
+        }
+    }
+    throwIfStaleBondError(uuid) {
+        const error = this.staleBondErrors.get(uuid);
+        if (error) {
+            throw error;
+        }
+    }
     readProtocolV2Frame(uuid) {
         return __awaiter(this, void 0, void 0, function* () {
             const queuedFrame = this.getProtocolV2FrameQueue(uuid).shift();
@@ -1866,6 +2079,11 @@ class ReactNativeBleTransport {
                     return;
                 }
                 catch (error) {
+                    if (isNativeBleStaleBondError(error) || hdShared.isBleStaleBondHardwareError(error)) {
+                        const bondError = toBleStaleBondHardwareError(error);
+                        this.rememberStaleBondError(uuid, bondError);
+                        throw bondError;
+                    }
                     if (getFirmwareUploadWriteRetryType(error) !== 'congested' ||
                         attempt >= FIRMWARE_UPLOAD_WRITE_MAX_RETRIES) {
                         throw error;
@@ -2064,6 +2282,8 @@ class ReactNativeBleTransport {
             }),
             reset: (reason) => {
                 var _a;
+                if (this.monitorTokens.get(uuid) !== generation)
+                    return;
                 (_a = this.protocolV2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
                 this.rejectProtocolV2Frames(uuid, new Error(reason));
             },
@@ -2080,6 +2300,8 @@ class ReactNativeBleTransport {
 exports.BLE_CONNECT_TIMEOUT_MANAGER_RESET_THRESHOLD = BLE_CONNECT_TIMEOUT_MANAGER_RESET_THRESHOLD;
 exports.BLE_CONNECT_TIMEOUT_MS = BLE_CONNECT_TIMEOUT_MS;
 exports.BLE_GATT_SETUP_TIMEOUT_MS = BLE_GATT_SETUP_TIMEOUT_MS;
+exports.BLE_NATIVE_TEARDOWN_TIMEOUT_MS = BLE_NATIVE_TEARDOWN_TIMEOUT_MS;
+exports.BLE_SETUP_WEDGED_MESSAGE = BLE_SETUP_WEDGED_MESSAGE;
 exports.BLE_WRITE_PACKET_TIMEOUT_MS = BLE_WRITE_PACKET_TIMEOUT_MS;
 exports.BLE_WRITE_TIMEOUT_MANAGER_RESET_THRESHOLD = BLE_WRITE_TIMEOUT_MANAGER_RESET_THRESHOLD;
 exports.PROTOCOL_REPROBE_FALLBACK_ATTEMPTS = PROTOCOL_REPROBE_FALLBACK_ATTEMPTS;