unified-ble-manager 4.0.13 → 4.0.15

package/CHANGELOG.md

@@ -6,6 +6,35 @@ All notable changes to `unified-ble-manager` are documented here.
 
 No changes yet.
 
+## [4.0.15] - 2026-09-02
+
+### Fixes
+
+- Silence exactly one expected late React Native Android terminal when a peer
+  is lost while an operation such as GATT discovery is still settling. The
+  boundary records only operations it explicitly rejected for that peer,
+  bounds and lifecycle-scopes those records, and continues to report unknown
+  or duplicate terminals as protocol diagnostics.
+
+## [4.0.14] - 2026-09-02
+
+### Fixes
+
+- Release Android GATT ownership immediately when Bluetooth powers off or
+  resets instead of waiting for a `STATE_DISCONNECTED` callback that Android
+  may never deliver. Failed native closes remain retained and retry when the
+  adapter returns, protocol routes are invalidated before adapter-state
+  publication, and an ordinary disconnect timeout now also publishes the
+  missing terminal state before cleanup. A cleanup unsubscribe after adapter
+  loss is idempotent when native ownership is already gone.
+- Terminalize adapter-loss connections exactly once with the typed `adapter`
+  reason when a native CoreBluetooth-style or WinRT disconnect completes
+  without a platform loss callback. Delayed native callbacks are ignored, and
+  WinRT connection paths retain the attachment that created them.
+- Treat an operation that is still settling after adapter loss as expected
+  quarantine rather than a cleanup error. Cleanup still waits and retries, but
+  only an actual native release failure produces an error diagnostic.
+
 ## [4.0.13] - 2026-09-01
 
 ### Fixes

package/MIGRATION_4.0.md

@@ -2,7 +2,7 @@
 
 # Migrating from react-native-ble-plx
 
-This source targets `4.0.13`. The `4.0.0` release is a new package and a new contract. It is **not a source-compatible rename**. There is no `new BleManager()` facade, no Base64 characteristic values, and no public transaction IDs.
+This source targets `4.0.15`. The `4.0.0` release is a new package and a new contract. It is **not a source-compatible rename**. There is no `new BleManager()` facade, no Base64 characteristic values, and no public transaction IDs.
 
 This page is for a React Native app that already uses `react-native-ble-plx`. Web, Electron, Node, and Tauri are new hosts — use those pages after you understand the RN rewrite.
 

package/README.md

@@ -18,7 +18,7 @@ root import does not pick a radio. Package SemVer and backend support labels are
 independent: each radio backend keeps its evidence-derived label. See
 [`docs/PLATFORMS.md`](docs/PLATFORMS.md).
 
-This source tree is versioned `4.0.13`. Install the exact version shown in the npm
+This source tree is versioned `4.0.15`. Install the exact version shown in the npm
 registry. During release preparation, the version in `package.json` can be ahead
 of npm until the matching tag-driven workflow publishes it; the registry and
 GitHub release remain authoritative.

package/RELEASE.md

@@ -81,7 +81,7 @@ Active `4.0.0-rc.*` release-train candidates publish to npm `latest` so a bare `
 
 On release day, set `release_candidate` to the exact candidate required by the
 release plan. RC2, RC3, RC4, `4.0.0-rc.4.1`, and RC5 are already immutable
-once tagged. Stable `4.0.0` through `4.0.12` are immutable. `4.0.13` is the current train head.
+once tagged. Stable `4.0.0` through `4.0.14` are immutable. `4.0.15` is the current train head.
 
 ```sh
 release_candidate=4.0.0-rc.N
@@ -133,9 +133,9 @@ The `v4.0.3` tag is immutable published history. Do not recreate or move it.
 git tag -a v4.0.3 -m "v4.0.3"
 ```
 
-## Releasing 4.0.13
+## Releasing 4.0.15
 
-The `v4.0.13` tag must identify the exact current `main` commit after canonical
+The `v4.0.15` tag must identify the exact current `main` commit after canonical
 CI passes. Do not tag this feature branch directly.
 
 ```sh
@@ -144,15 +144,28 @@ git checkout main
 git pull --ff-only origin main
 
 test "$(git branch --show-current)" = "main"
-test "$(node -p "require('./package.json').version")" = "4.0.13"
+test "$(node -p "require('./package.json').version")" = "4.0.15"
 git diff --exit-code
 git diff --cached --exit-code
 
-git tag -a v4.0.13 -m "v4.0.13"
-git push origin v4.0.13
+git tag -a v4.0.15 -m "v4.0.15"
+git push origin v4.0.15
 ```
 
-Before tagging, confirm release-note extraction finds `## [4.0.13]`.
+Before tagging, confirm release-note extraction finds `## [4.0.15]`.
+
+## Releasing 4.0.14
+
+The `v4.0.14` tag is immutable history, but its publish workflow was cancelled
+before the npm version check and publish steps. Do not recreate or move it.
+
+## Releasing 4.0.13
+
+The `v4.0.13` tag is immutable published history. Do not recreate or move it.
+
+```sh
+git tag -a v4.0.13 -m "v4.0.13"
+```
 
 ## Releasing 4.0.12
 
@@ -327,7 +340,7 @@ a green publish job and a package a consumer can actually install are not the
 same claim.
 
 ```sh
-version=4.0.12
+version=4.0.15
 
 npm view "unified-ble-manager@$version" version
 npm view unified-ble-manager dist-tags --json

package/SBOM.cdx.json

@@ -6,20 +6,20 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/unified-ble-manager@4.0.13",
+      "bom-ref": "pkg:npm/unified-ble-manager@4.0.15",
       "name": "unified-ble-manager",
-      "version": "4.0.13",
+      "version": "4.0.15",
       "licenses": [
         {
           "expression": "Apache-2.0"
         }
       ],
-      "purl": "pkg:npm/unified-ble-manager@4.0.13"
+      "purl": "pkg:npm/unified-ble-manager@4.0.15"
     },
     "properties": [
       {
         "name": "unified-ble-manager:pnpm-lock-sha256",
-        "value": "58c2b09c18f10de1e250a357e5ce9445fe6bcace614e3778bc60166b9db31fa1"
+        "value": "fea8b9fea3dca31d966c33e5942c5fb0f179c492a8462f90482d0c5dc1bd86d2"
       },
       {
         "name": "unified-ble-manager:dependency-scope",
@@ -537,7 +537,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/unified-ble-manager@4.0.13",
+      "ref": "pkg:npm/unified-ble-manager@4.0.15",
       "dependsOn": [
         "pkg:npm/%40babel/runtime@7.29.7",
         "pkg:npm/node-addon-api@8.9.0",

package/THIRD_PARTY_LICENSES.json

@@ -4,12 +4,12 @@
   "schemaVersion": "1.0.0",
   "package": {
     "name": "unified-ble-manager",
-    "version": "4.0.13"
+    "version": "4.0.15"
   },
   "source": {
     "method": "pnpm-lock production graph with installed-manifest license audit",
     "lockfile": "pnpm-lock.yaml",
-    "lockfileSha256": "58c2b09c18f10de1e250a357e5ce9445fe6bcace614e3778bc60166b9db31fa1"
+    "lockfileSha256": "fea8b9fea3dca31d966c33e5942c5fb0f179c492a8462f90482d0c5dc1bd86d2"
   },
   "reviewedOverrides": [
     {

package/android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolAndroidDispatcher.kt

@@ -38,7 +38,8 @@ class UnifiedBleProtocolAndroidDispatcher(
   private var attachmentRecord: ProtocolWireRecord? = null
 
   init {
-    radio.onAdapterState = {
+    radio.onAdapterState = { adapterState ->
+      clearGattProtocolOwnershipForAdapterLoss(adapterState)
       emitCurrentAdapterState()
     }
     radio.onCleanupFailure = { failure ->
@@ -140,6 +141,33 @@ class UnifiedBleProtocolAndroidDispatcher(
     }
   }
 
+  private fun clearGattProtocolOwnershipForAdapterLoss(adapterState: String) {
+    val state = radio.currentProtocolAdapterState()
+    if (state.availability == "available" && state.authorization == "granted" && state.power == "on") return
+    val failure = when (adapterState) {
+      "PoweredOff" -> AdapterLossConnectFailure(
+        "adapterPoweredOff",
+        "Android Bluetooth was powered off while the connection was pending"
+      )
+      "Resetting" -> AdapterLossConnectFailure(
+        "adapterResetting",
+        "Android Bluetooth reset while the connection was pending"
+      )
+      else -> AdapterLossConnectFailure(
+        "adapterUnavailable",
+        "Android Bluetooth became unavailable while the connection was pending"
+      )
+    }
+    pendingConnects.entries.toList().forEach { entry ->
+      if (pendingConnects.remove(entry.key, entry.value)) {
+        emitFailure(entry.value, failure.code, failure.message)
+      }
+    }
+    establishedConnections.clear()
+    activeDatabases.clear()
+    activeSubscriptions.clear()
+  }
+
   fun emitCurrentAdapterState() {
     val state = radio.currentProtocolAdapterState()
     val fields = mutableMapOf<Int, ProtocolWireValue>(
@@ -564,6 +592,11 @@ class UnifiedBleProtocolAndroidDispatcher(
   }
 
   private fun subscribe(command: ProtocolWireRecord, enable: Boolean) {
+    val subscriptionId = command.requiredString(7)
+    if (!enable && !activeSubscriptions.containsKey(subscriptionId)) {
+      emitSuccess(command, "unsubscribed")
+      return
+    }
     val endpoint = characteristicEndpoint(command.requiredRecord(4))
     val radioOperationId = radio.setNotifyExact(
       endpoint.deviceId,
@@ -597,7 +630,6 @@ class UnifiedBleProtocolAndroidDispatcher(
             }
             return@fold
           }
-          val subscriptionId = command.requiredString(7)
           if (enable) {
             activeSubscriptions[subscriptionId] = SubscriptionRoute(
               subscriptionId,
@@ -1132,6 +1164,11 @@ class UnifiedBleProtocolAndroidDispatcher(
     }
   }
 
+  private data class AdapterLossConnectFailure(
+    val code: String,
+    val message: String
+  )
+
   private fun requirePhyAvailable() {
     check(Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
       "Android PHY requires API 26"
@@ -1158,6 +1195,7 @@ internal fun connectionLostEvent(
       8 to ProtocolWireValue.SignedIntegerValue(status.toLong())
     )
   )
+
   return ProtocolWireRecord(
     RecordKind.EVENT,
     mapOf(

package/android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt

@@ -150,6 +150,11 @@ internal fun bondedPeerAdapterReadiness(
   }
 }
 
+internal fun requiresImmediateGattTeardownOnAdapterState(state: Int?): Boolean =
+  state == BluetoothAdapter.STATE_OFF ||
+    state == BluetoothAdapter.STATE_TURNING_OFF ||
+    state == BluetoothAdapter.STATE_TURNING_ON
+
 /** Normalize the platform snapshot before it crosses the Android protocol boundary. */
 internal fun normalizeBondedPeerSnapshots(
   peers: Iterable<BondedPeerSnapshot>
@@ -416,6 +421,7 @@ class OwnedAndroidGattRadio(private val context: Context) {
         override fun onReceive(ctx: Context?, intent: Intent?) {
           if (intent?.action != BluetoothAdapter.ACTION_STATE_CHANGED) return
           val state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)
+          handleAdapterStateTransition(state)
           onAdapterState?.invoke(mapAdapterState(state))
         }
       }
@@ -430,6 +436,23 @@ class OwnedAndroidGattRadio(private val context: Context) {
     adapterStateReceiver = receiver
   }
 
+  private fun handleAdapterStateTransition(state: Int) {
+    if (state == BluetoothAdapter.STATE_ON) {
+      pendingGattTeardowns.keys.toList().forEach { key -> retryGattTeardown(key) }
+      return
+    }
+    if (!requiresImmediateGattTeardownOnAdapterState(state)) return
+
+    pendingReconnect.clear()
+    (gatts.keys + pendingGattTeardowns.keys).toSet().forEach { key ->
+      failPendingForDevice(key, "adapter unavailable")
+      val owner = pendingGattTeardowns[key]
+      val gatt = gatts[key] ?: owner?.gatt ?: return@forEach
+      val teardownFailure = completeGattTeardown(key, gatt)
+      pendingDisconnectCallbacks.remove(key)?.invoke(teardownFailure)
+    }
+  }
+
   internal fun unregisterAdapterStateReceiver(): OwnedRadioTeardownFailure? {
     val receiver = adapterStateReceiver ?: return null
     try {
@@ -838,6 +861,18 @@ class OwnedAndroidGattRadio(private val context: Context) {
       onComplete(failure)
       return failure
     }
+    if (pendingGattTeardowns[key] != null) {
+      val teardownFailure = retryGattTeardown(key)
+      val failure = cleanupFailure ?: teardownFailure
+      onComplete(failure)
+      return failure
+    }
+    if (requiresImmediateGattTeardownOnAdapterState(adapter?.state)) {
+      val teardownFailure = completeGattTeardown(key, g)
+      val failure = cleanupFailure ?: teardownFailure
+      onComplete(failure)
+      return failure
+    }
     // R3-F003: only disconnect(); close() waits for STATE_DISCONNECTED (or safety timeout).
     pendingDisconnectCallbacks[key] = onComplete
     scheduleSafeClose(key, g)
@@ -923,6 +958,7 @@ class OwnedAndroidGattRadio(private val context: Context) {
       Runnable {
         if (gatts[key] === gatt) {
           OwnedAndroidLog.e("GATT close safety timeout for $key (DISCONNECTED never arrived)")
+          dispatchConnectionState(key, false, BluetoothGatt.GATT_FAILURE)
           failPendingForDevice(key, "disconnected timeout")
           val teardownFailure = completeGattTeardown(key, gatt)
           pendingDisconnectCallbacks.remove(key)?.invoke(teardownFailure)

package/android/src/test/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolAndroidDispatcherLifecycleTest.kt

@@ -11,6 +11,7 @@ import com.sfourdrinier.unifiedblemanager.radio.OwnedAndroidSubscriptionOwnershi
 import com.sfourdrinier.unifiedblemanager.radio.BondedPeerSnapshot
 import com.sfourdrinier.unifiedblemanager.radio.normalizeBondedPeerSnapshots
 import com.sfourdrinier.unifiedblemanager.radio.bondedPeerAdapterReadiness
+import com.sfourdrinier.unifiedblemanager.radio.requiresImmediateGattTeardownOnAdapterState
 import org.junit.Assert.assertEquals
 import org.junit.Assert.assertArrayEquals
 import org.junit.Assert.assertFalse
@@ -26,6 +27,7 @@ import java.util.concurrent.CountDownLatch
 import java.util.concurrent.atomic.AtomicInteger
 import kotlin.concurrent.thread
 import android.bluetooth.BluetoothDevice
+import android.bluetooth.BluetoothAdapter
 import android.bluetooth.le.ScanSettings
 
 class UnifiedBleProtocolAndroidDispatcherLifecycleTest {
@@ -477,7 +479,7 @@ class UnifiedBleProtocolAndroidDispatcherLifecycleTest {
     val consumerAndroidDirectory = File(consumerRoot, "android")
     val packagedSource = File(consumerRoot, "node_modules/unified-ble-manager/$relativePath")
     consumerAndroidDirectory.mkdirs()
-    packagedSource.parentFile.mkdirs()
+    requireNotNull(packagedSource.parentFile).mkdirs()
     packagedSource.writeText("installed-package-source")
 
     try {
@@ -788,6 +790,142 @@ class UnifiedBleProtocolAndroidDispatcherLifecycleTest {
     assertEquals(1, secondStarted)
   }
 
+  @Test
+  fun gattSafetyClosePublishesConnectionLossBeforeDroppingNativeOwnership() {
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+    val timeout = radio.substring(
+      radio.indexOf("private fun scheduleSafeClose"),
+      radio.indexOf("private fun cancelSafeClose")
+    )
+
+    val connectionLossIndex = timeout.indexOf("dispatchConnectionState(key, false, BluetoothGatt.GATT_FAILURE)")
+    val failPendingIndex = timeout.indexOf("failPendingForDevice(key, \"disconnected timeout\")")
+    val teardownIndex = timeout.indexOf("val teardownFailure = completeGattTeardown(key, gatt)")
+    assertTrue(connectionLossIndex >= 0)
+    assertTrue(connectionLossIndex < failPendingIndex)
+    assertTrue(connectionLossIndex < teardownIndex)
+  }
+
+  @Test
+  fun adapterLossClosesGattOwnersBeforeForwardingTheState() {
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+    val receiver = radio.substring(
+      radio.indexOf("fun registerAdapterStateReceiver()"),
+      radio.indexOf("internal fun unregisterAdapterStateReceiver")
+    )
+
+    val teardownIndex = receiver.indexOf("handleAdapterStateTransition(state)")
+    val forwardIndex = receiver.indexOf("onAdapterState?.invoke(mapAdapterState(state))")
+    assertTrue(teardownIndex >= 0)
+    assertTrue(teardownIndex < forwardIndex)
+  }
+
+  @Test
+  fun onlyUnavailableAdapterTransitionsRequireImmediateGattTeardown() {
+    assertFalse(requiresImmediateGattTeardownOnAdapterState(BluetoothAdapter.STATE_ON))
+    assertTrue(requiresImmediateGattTeardownOnAdapterState(BluetoothAdapter.STATE_OFF))
+    assertTrue(requiresImmediateGattTeardownOnAdapterState(BluetoothAdapter.STATE_TURNING_OFF))
+    assertTrue(requiresImmediateGattTeardownOnAdapterState(BluetoothAdapter.STATE_TURNING_ON))
+  }
+
+  @Test
+  fun adapterLossTeardownDoesNotWaitForGattDisconnectedCallback() {
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+    val transition = radio.substring(
+      radio.indexOf("private fun handleAdapterStateTransition("),
+      radio.indexOf("internal fun unregisterAdapterStateReceiver")
+    )
+
+    assertTrue(transition.contains("pendingReconnect.clear()"))
+    assertTrue(transition.contains("failPendingForDevice(key, \"adapter unavailable\")"))
+    assertTrue(transition.contains("completeGattTeardown(key, gatt)"))
+    assertTrue(transition.contains("pendingDisconnectCallbacks.remove(key)?.invoke(teardownFailure)"))
+    assertFalse(transition.contains("scheduleSafeClose"))
+    assertFalse(transition.contains("dispatchConnectionState"))
+  }
+
+  @Test
+  fun adapterRecoveryRetriesRetainedGattTeardownOwnership() {
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+    val transition = radio.substring(
+      radio.indexOf("private fun handleAdapterStateTransition("),
+      radio.indexOf("internal fun unregisterAdapterStateReceiver")
+    )
+
+    assertTrue(transition.contains("BluetoothAdapter.STATE_ON"))
+    assertTrue(transition.contains("pendingGattTeardowns.keys.toList()"))
+    assertTrue(transition.contains("retryGattTeardown(key)"))
+  }
+
+  @Test
+  fun disconnectRetriesRetainedOrUnavailableGattWithoutSchedulingSafetyClose() {
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+    val disconnect = radio.substring(
+      radio.indexOf("internal fun disconnect("),
+      radio.indexOf("private fun openGatt")
+    )
+
+    val retainedIndex = disconnect.indexOf("pendingGattTeardowns[key]")
+    val unavailableIndex = disconnect.indexOf("requiresImmediateGattTeardownOnAdapterState(adapter?.state)")
+    val safetyCloseIndex = disconnect.indexOf("scheduleSafeClose(key, g)")
+    assertTrue(retainedIndex >= 0)
+    assertTrue(unavailableIndex > retainedIndex)
+    assertTrue(safetyCloseIndex > unavailableIndex)
+  }
+
+  @Test
+  fun adapterLossClearsProtocolGattRoutesBeforePublishingAdapterState() {
+    val dispatcher = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolAndroidDispatcher.kt"
+    )
+    val callback = dispatcher.substring(
+      dispatcher.indexOf("radio.onAdapterState = {"),
+      dispatcher.indexOf("radio.onCleanupFailure")
+    )
+    val clearIndex = callback.indexOf("clearGattProtocolOwnershipForAdapterLoss(adapterState)")
+    val emitIndex = callback.indexOf("emitCurrentAdapterState()")
+    assertTrue(clearIndex >= 0)
+    assertTrue(clearIndex < emitIndex)
+
+    val cleanup = dispatcher.substring(
+      dispatcher.indexOf("private fun clearGattProtocolOwnershipForAdapterLoss(adapterState: String)"),
+      dispatcher.indexOf("fun emitCurrentAdapterState()")
+    )
+    assertTrue(cleanup.contains("establishedConnections.clear()"))
+    assertTrue(cleanup.contains("activeDatabases.clear()"))
+    assertTrue(cleanup.contains("activeSubscriptions.clear()"))
+    assertTrue(cleanup.contains("pendingConnects.entries.toList()"))
+    assertTrue(cleanup.contains("pendingConnects.remove(entry.key, entry.value)"))
+    assertTrue(cleanup.contains("emitFailure(entry.value, failure.code, failure.message)"))
+  }
+
+  @Test
+  fun unsubscribeIsIdempotentAfterAdapterLossClearsNativeOwnership() {
+    val dispatcher = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolAndroidDispatcher.kt"
+    )
+    val subscribe = dispatcher.substring(
+      dispatcher.indexOf("private fun subscribe(command: ProtocolWireRecord, enable: Boolean)"),
+      dispatcher.indexOf("private fun destroy(command: ProtocolWireRecord)")
+    )
+    val absentRouteIndex = subscribe.indexOf("!enable && !activeSubscriptions.containsKey(subscriptionId)")
+    val successIndex = subscribe.indexOf("emitSuccess(command, \"unsubscribed\")")
+    val nativeIndex = subscribe.indexOf("radio.setNotifyExact(")
+    assertTrue(absentRouteIndex >= 0)
+    assertTrue(successIndex > absentRouteIndex)
+    assertTrue(nativeIndex > successIndex)
+  }
+
   @Test
   fun destroyBeforePumpCallsEveryQueuedCancellationAndNeverStartsThem() {
     val scheduled = ArrayDeque<() -> Unit>()

package/docs/ELECTRON.md

@@ -4,7 +4,7 @@
 
 Main owns the radio. The renderer uses a versioned IPC client and never loads a native addon.
 
-This source targets `4.0.13`. Tagged releases ship Node-API v8 prebuilds covering macOS and Windows `arm64`/`x64` for both Node and modern Electron.
+This source targets `4.0.15`. Tagged releases ship Node-API v8 prebuilds covering macOS and Windows `arm64`/`x64` for both Node and modern Electron.
 
 `unified-ble-manager/electron/main` and
 `unified-ble-manager/electron/renderer` are the only Electron entrypoints.

package/docs/EXPO_PLUGIN.md

@@ -7,7 +7,7 @@ start a radio, request runtime permissions during prebuild, or prove physical
 radio/restoration reliability. Expo Go is not a supported BLE execution
 environment because it cannot contain this native module.
 
-Use the v2 plugin options in this `4.0.13` source. Those options match
+Use the v2 plugin options in this `4.0.15` source. Those options match
 the schema introduced at `4.0.0-rc.4`. Expo Go cannot load this native module.
 
 ## Installation and development build

package/docs/GAPS.4.0.md

@@ -14,7 +14,7 @@ This file tracks platform code, CI, package, lab, and live-radio evidence. It do
 
 The clean-baseline contract, unified core, public manager, deterministic backend, TCK, native protocol, first-party backend implementations, host-isolated package exports, SDK/CLI, and legacy-absence gates exist in the 4.0 source. Passing deterministic, compile, ABI, or package tests are implementation proof; they do not become physical-radio support evidence unless a retained record proves the corresponding live scenario.
 
-This source targets `unified-ble-manager@4.0.13`; the npm registry and release
+This source targets `unified-ble-manager@4.0.15`; the npm registry and release
 provenance, not a source version string, determine whether it is published.
 Earlier stable releases remain immutable published history. Backend support labels remain
 evidence-derived. This package does not rewrite the evidence inventory: a backend remains at the support level

package/docs/GETTING_STARTED.md

@@ -4,7 +4,7 @@
 
 This page gets you to a first scan, connect, read, notify, and teardown on React Native. Other hosts are linked at the bottom. The root import does not turn Bluetooth on.
 
-This source targets `4.0.13`; verify the published version in the npm registry.
+This source targets `4.0.15`; verify the published version in the npm registry.
 
 ## Pick a host
 
@@ -38,11 +38,11 @@ request runtime permissions on Android 12+, add
 #### Expo / CNG v2
 
 The Expo v2 schema and `unified-ble-manager/expo` factory are in this source.
-After the npm registry lists `4.0.13`, install that exact version and keep it in
+After the npm registry lists `4.0.15`, install that exact version and keep it in
 your lockfile while validating the native build:
 
 ```sh
-pnpm add unified-ble-manager@4.0.13
+pnpm add unified-ble-manager@4.0.15
 ```
 
 The package does not run in Expo Go.

package/docs/NODE.md

@@ -10,7 +10,7 @@ The root import does not open an adapter. Pick one backend:
 | `unified-ble-manager/node/winrt`         | Windows                                      |
 | `unified-ble-manager/node/bluez`         | Linux (needs `dbus-next@^0.10.2` in the app) |
 
-This source targets `4.0.13`. Tagged releases ship Node-API v8 prebuilds for macOS and Windows on `arm64` and `x64`. A normal install should not compile native code. BlueZ talks D-Bus and has no addon.
+This source targets `4.0.15`. Tagged releases ship Node-API v8 prebuilds for macOS and Windows on `arm64` and `x64`. A normal install should not compile native code. BlueZ talks D-Bus and has no addon.
 
 ## One-call factories
 

package/docs/WEB.md

@@ -6,7 +6,7 @@ Use `unified-ble-manager/web` to run the public UBM manager directly in a browse
 
 The complete runnable TypeScript/Vite application is in [`example-web/`](../example-web/).
 
-This guide targets `4.0.13`. Web Bluetooth support still depends on the browser, operating system, adapter, and peripheral. UBM reports those runtime boundaries; it does not fabricate a fallback backend.
+This guide targets `4.0.15`. Web Bluetooth support still depends on the browser, operating system, adapter, and peripheral. UBM reports those runtime boundaries; it does not fabricate a fallback backend.
 
 ## Requirements
 

package/docs/generated/PLATFORM_SUPPORT.md

@@ -6,7 +6,7 @@ This page is generated by `scripts/docs/generate-platform-support.js` from valid
 
 ## Current package
 
-`unified-ble-manager@4.0.13`
+`unified-ble-manager@4.0.15`
 
 No evidence record is bound to this exact package version and artifact. Consequently, this generated page makes no Preview, Live Preview, Supported, or Reliability-qualified platform claim for the current package.
 

package/lib/commonjs/backends/corebluetooth/corebluetooth-adapter-loss-cleanup.js

@@ -39,12 +39,15 @@ async function releaseCoreBluetoothAdapterLossResources(state) {
     failures.push(...cleanup.failures);
   }
   for (const record of [...state.connections.values()]) {
+    const previous = record.state === 'disconnecting' ? 'disconnecting' : 'connected';
     record.state = 'disconnecting';
     try {
       const cleanup = await state.disconnectNative(record, 'direct-gatt.adapter-loss.disconnect', true);
       failures.push(...cleanup.failures);
       if (cleanup.state === 'release-failed') {
         record.state = 'connected';
+      } else {
+        state.terminalizeAdapterLossConnection(record, previous);
       }
     } catch (error) {
       record.state = 'connected';

package/lib/commonjs/backends/corebluetooth/corebluetooth-adapter-loss-cleanup.js.map

@@ -1 +1 @@
-{"version":3,"names":["_corebluetoothHandles","require","releaseCoreBluetoothAdapterLossResources","state","failures","group","scanGroup","consumer","consumers","values","releaseScanConsumerAdmission","stream","closeWithReason","cleanup","stopNativeScan","push","clear","clearScanGroup","error","cleanupFailureDetail","physical","subscriptions","subscription","removed","gattOperations","stopPhysicalSubscription","record","connections","disconnectNative","length","releasedCleanup","Object","freeze"],"sourceRoot":"../../../../src","sources":["backends/corebluetooth/corebluetooth-adapter-loss-cleanup.ts"],"mappings":";;;;;;AAGA,IAAAA,qBAAA,GAAAC,OAAA;AAHA;;AAsBA;AACO,eAAeC,wCAAwCA,CAC5DC,KAA2C,EACnB;EACxB,MAAMC,QAA0B,GAAG,EAAE;EACrC,MAAMC,KAAK,GAAGF,KAAK,CAACG,SAAS;EAC7B,IAAID,KAAK,KAAK,IAAI,EAAE;IAClBA,KAAK,CAACF,KAAK,GAAG,UAAU;IACxB,KAAK,MAAMI,QAAQ,IAAIF,KAAK,CAACG,SAAS,CAACC,MAAM,CAAC,CAAC,EAAE;MAC/CN,KAAK,CAACO,4BAA4B,CAACH,QAAQ,CAAC;MAC5CA,QAAQ,CAACI,MAAM,CAACC,eAAe,CAAC,eAAe,CAAC;IAClD;IACA,IAAI;MACF,MAAMC,OAAO,GAAG,MAAMV,KAAK,CAACW,cAAc,CAACT,KAAK,EAAE,oCAAoC,CAAC;MACvF,IAAIQ,OAAO,CAACV,KAAK,KAAK,gBAAgB,EAAE;QACtCC,QAAQ,CAACW,IAAI,CAAC,GAAGF,OAAO,CAACT,QAAQ,CAAC;MACpC,CAAC,MAAM;QACLC,KAAK,CAACG,SAAS,CAACQ,KAAK,CAAC,CAAC;QACvBb,KAAK,CAACc,cAAc,CAACZ,KAAK,CAAC;MAC7B;IACF,CAAC,CAAC,OAAOa,KAAK,EAAE;MACdd,QAAQ,CAACW,IAAI,CAAC,IAAAI,0CAAoB,EAAC,MAAM,EAAE,oCAAoC,EAAED,KAAK,CAAC,CAAC;IAC1F;EACF;EACA,KAAK,MAAME,QAAQ,IAAI,CAAC,GAAGjB,KAAK,CAACkB,aAAa,CAACZ,MAAM,CAAC,CAAC,CAAC,EAAE;IACxD,KAAK,MAAMa,YAAY,IAAIF,QAAQ,CAACZ,SAAS,EAAE;MAC7Cc,YAAY,CAACX,MAAM,CAACC,eAAe,CAAC,eAAe,CAAC;MACpDU,YAAY,CAACC,OAAO,GAAG,IAAI;IAC7B;IACAH,QAAQ,CAACZ,SAAS,CAACQ,KAAK,CAAC,CAAC;IAC1B,MAAMH,OAAO,GAAG,MAAMV,KAAK,CAACqB,cAAc,CAACC,wBAAwB,CAACL,QAAQ,CAAC;IAC7EhB,QAAQ,CAACW,IAAI,CAAC,GAAGF,OAAO,CAACT,QAAQ,CAAC;EACpC;EACA,KAAK,MAAMsB,MAAM,IAAI,CAAC,GAAGvB,KAAK,CAACwB,WAAW,CAAClB,MAAM,CAAC,CAAC,CAAC,EAAE;IACpDiB,MAAM,CAACvB,KAAK,GAAG,eAAe;IAC9B,IAAI;MACF,MAAMU,OAAO,GAAG,MAAMV,KAAK,CAACyB,gBAAgB,CAACF,MAAM,EAAE,qCAAqC,EAAE,IAAI,CAAC;MACjGtB,QAAQ,CAACW,IAAI,CAAC,GAAGF,OAAO,CAACT,QAAQ,CAAC;MAClC,IAAIS,OAAO,CAACV,KAAK,KAAK,gBAAgB,EAAE;QACtCuB,MAAM,CAACvB,KAAK,GAAG,WAAW;MAC5B;IACF,CAAC,CAAC,OAAOe,KAAK,EAAE;MACdQ,MAAM,CAACvB,KAAK,GAAG,WAAW;MAC1BC,QAAQ,CAACW,IAAI,CAAC,IAAAI,0CAAoB,EAAC,YAAY,EAAE,qCAAqC,EAAED,KAAK,CAAC,CAAC;IACjG;EACF;EACA,OAAOd,QAAQ,CAACyB,MAAM,KAAK,CAAC,GACxBC,qCAAe,GACfC,MAAM,CAACC,MAAM,CAAC;IAAE7B,KAAK,EAAE,gBAAgB;IAAEC,QAAQ,EAAE2B,MAAM,CAACC,MAAM,CAAC5B,QAAQ;EAAE,CAAC,CAAC;AACnF","ignoreList":[]}
+{"version":3,"names":["_corebluetoothHandles","require","releaseCoreBluetoothAdapterLossResources","state","failures","group","scanGroup","consumer","consumers","values","releaseScanConsumerAdmission","stream","closeWithReason","cleanup","stopNativeScan","push","clear","clearScanGroup","error","cleanupFailureDetail","physical","subscriptions","subscription","removed","gattOperations","stopPhysicalSubscription","record","connections","previous","disconnectNative","terminalizeAdapterLossConnection","length","releasedCleanup","Object","freeze"],"sourceRoot":"../../../../src","sources":["backends/corebluetooth/corebluetooth-adapter-loss-cleanup.ts"],"mappings":"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","ignoreList":[]}