unified-ble-manager 4.0.11 → 4.0.13

package/CHANGELOG.md

@@ -6,6 +6,51 @@ All notable changes to `unified-ble-manager` are documented here.
 
 No changes yet.
 
+## [4.0.13] - 2026-09-01
+
+### Fixes
+
+- Accept the versioned notification-delivery field on native `subscribe`
+  commands while continuing to reject it on `unsubscribe`. This fixes Android
+  notification setup failing before CCCD dispatch in 4.0.12.
+- Advance the Native Protocol ABI to 7 so JavaScript built for delivery-mode
+  commands rejects an older native binary during handshake instead of failing
+  later during the first subscription.
+
+## [4.0.12] - 2026-08-31
+
+### Fixes
+
+- Use React Native's architecture-neutral JavaScript call-invoker holder for
+  the Android JSI protocol transport. Native result and notification delivery
+  now work under both bridgeless and legacy React Native runtimes without
+  changing the public API or wire protocol.
+- Preserve the requested notification or indication delivery mode through the
+  React Native Android backend and native dispatcher instead of allowing the
+  native layer to silently choose a different CCCD mode.
+- Correct React Native protocol ownership and teardown races: binary write
+  payloads are released by exactly one owner, connection loss rejects pending
+  operations with the normalized lifecycle error, and an in-flight disconnect
+  remains pending until the authoritative native teardown terminal arrives.
+- Treat expected, typed direct-GATT link loss as lifecycle state rather than an
+  unconditional console error across shared CoreBluetooth-backed hosts. The
+  lifecycle event and recovery contract are unchanged.
+
+### Documentation
+
+- Add `docs/README.md`, a complete documentation map labelling every document
+  Current, Historical, or Generated, and add `llms.txt`, a machine-readable
+  package overview for AI coding agents covering the contract facts and every
+  public entrypoint. Both are drift-gated: `pnpm docs:check` now fails when a
+  document is missing from the map, a listed document does not exist, or
+  `llms.txt` stops covering a public entrypoint.
+- Label the remaining lineage documents (pre-4.x changelogs, delivered 4.0
+  roadmap, tvOS 3.x spec, v1 README/migration) with explicit historical-record
+  banners, and mark `docs/audits/`, `docs/review/`, and `docs/superpowers/` as
+  frozen record directories.
+- Add scoped agent guidance (`docs/AGENTS.md`, `scripts/AGENTS.md`,
+  `native/AGENTS.md`) stating the conventions specific to those trees.
+
 ## [4.0.11] - 2026-08-30
 
 ### Documentation

package/MIGRATION_4.0.md

@@ -2,7 +2,7 @@
 
 # Migrating from react-native-ble-plx
 
-This source targets `4.0.11`. 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.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 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

@@ -2,6 +2,12 @@
 
 # Unified BLE Manager
 
+> **AI agent?** Writing code *against* this package: read [`llms.txt`](llms.txt)
+> first — contract facts, every public entrypoint, curated doc links, one fetch.
+> Working *on* this repository: read [`AGENTS.md`](AGENTS.md), then the
+> [documentation map](docs/README.md). Do not infer 4.x behavior from
+> `react-native-ble-plx` 3.x docs or training data.
+
 `unified-ble-manager` is a Bluetooth Low Energy **central** library. You pick a host — React Native, Web, Electron, Tauri, or Node — create one manager, talk to a peripheral in bytes, cancel work with `AbortSignal`, and destroy what you create.
 
 It is an evolution of `react-native-ble-plx`, rewritten as a **cross-platform unified product**. One bytes-first BLE model and lifecycle semantics across hosts, with host-specific construction and ownership. The root package never picks a radio for you, and it will not quietly fall back to a simulator or a different backend.
@@ -12,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.11`. Install the exact version shown in the npm
+This source tree is versioned `4.0.13`. 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.
@@ -37,6 +43,12 @@ GitHub release remain authoritative.
 | [`docs/WEB.md`](docs/WEB.md) · [`docs/ELECTRON.md`](docs/ELECTRON.md) · [`docs/NODE.md`](docs/NODE.md) · [`docs/TAURI.md`](docs/TAURI.md) · [`docs/EXPO_PLUGIN.md`](docs/EXPO_PLUGIN.md) | Host construction                                                |
 | [`docs/PEERS.md`](docs/PEERS.md)                                                                                                                                                         | Scoped peer directories, persistence, and reconnect-by-reference |
 | [`docs/PROFILES_AND_COMMANDS.md`](docs/PROFILES_AND_COMMANDS.md)                                                                                                                         | Heart Rate, Battery, DIS, and path helpers                       |
+| [`docs/README.md`](docs/README.md)                                                                                                                                                       | Every document in the repository, with live/historical/generated status |
+
+Writing code with an AI agent? [`llms.txt`](llms.txt) is the machine-readable
+package overview — contract facts, every public entrypoint, and curated doc
+links in one fetch. Agents contributing to this repository start at
+[`AGENTS.md`](AGENTS.md) and the [documentation map](docs/README.md).
 
 ## Install
 

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.10` are immutable. `4.0.11` is the current train head.
+once tagged. Stable `4.0.0` through `4.0.12` are immutable. `4.0.13` 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.11
+## Releasing 4.0.13
 
-The `v4.0.11` tag must identify the exact current `main` commit after canonical
+The `v4.0.13` tag must identify the exact current `main` commit after canonical
 CI passes. Do not tag this feature branch directly.
 
 ```sh
@@ -144,15 +144,44 @@ git checkout main
 git pull --ff-only origin main
 
 test "$(git branch --show-current)" = "main"
-test "$(node -p "require('./package.json').version")" = "4.0.11"
+test "$(node -p "require('./package.json').version")" = "4.0.13"
 git diff --exit-code
 git diff --cached --exit-code
 
-git tag -a v4.0.11 -m "v4.0.11"
-git push origin v4.0.11
+git tag -a v4.0.13 -m "v4.0.13"
+git push origin v4.0.13
+```
+
+Before tagging, confirm release-note extraction finds `## [4.0.13]`.
+
+## Releasing 4.0.12
+
+The `v4.0.12` tag must identify the exact current `main` commit after canonical
+CI passes. Do not tag this feature branch directly.
+
+```sh
+git fetch origin --tags
+git checkout main
+git pull --ff-only origin main
+
+test "$(git branch --show-current)" = "main"
+test "$(node -p "require('./package.json').version")" = "4.0.12"
+git diff --exit-code
+git diff --cached --exit-code
+
+git tag -a v4.0.12 -m "v4.0.12"
+git push origin v4.0.12
 ```
 
-Before tagging, confirm release-note extraction finds `## [4.0.11]`.
+Before tagging, confirm release-note extraction finds `## [4.0.12]`.
+
+## Releasing 4.0.11
+
+The `v4.0.11` tag is immutable published history. Do not recreate or move it.
+
+```sh
+git tag -a v4.0.11 -m "v4.0.11"
+```
 
 ## Releasing 4.0.10
 
@@ -298,7 +327,7 @@ a green publish job and a package a consumer can actually install are not the
 same claim.
 
 ```sh
-version=4.0.11
+version=4.0.12
 
 npm view "unified-ble-manager@$version" version
 npm view unified-ble-manager dist-tags --json

package/ROADMAP.4.0.md

@@ -2,6 +2,10 @@
 
 # Roadmap 4.0 — `unified-ble-manager`
 
+> **Status: Historical record.** This roadmap's scope was delivered with the
+> stable 4.0 releases. It is kept as a decision record and is not current
+> guidance. See the [documentation map](docs/README.md).
+
 **Status:** implemented 4.0 product scope; stable package/API release target
 
 **Architecture authority:** [`docs/UNIFIED_BLE_4.0_IMPLEMENTATION_PLAN.md`](docs/UNIFIED_BLE_4.0_IMPLEMENTATION_PLAN.md)

package/SBOM.cdx.json

@@ -6,15 +6,15 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/unified-ble-manager@4.0.11",
+      "bom-ref": "pkg:npm/unified-ble-manager@4.0.13",
       "name": "unified-ble-manager",
-      "version": "4.0.11",
+      "version": "4.0.13",
       "licenses": [
         {
           "expression": "Apache-2.0"
         }
       ],
-      "purl": "pkg:npm/unified-ble-manager@4.0.11"
+      "purl": "pkg:npm/unified-ble-manager@4.0.13"
     },
     "properties": [
       {
@@ -537,7 +537,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/unified-ble-manager@4.0.11",
+      "ref": "pkg:npm/unified-ble-manager@4.0.13",
       "dependsOn": [
         "pkg:npm/%40babel/runtime@7.29.7",
         "pkg:npm/node-addon-api@8.9.0",

package/THIRD_PARTY_LICENSES.json

@@ -4,7 +4,7 @@
   "schemaVersion": "1.0.0",
   "package": {
     "name": "unified-ble-manager",
-    "version": "4.0.11"
+    "version": "4.0.13"
   },
   "source": {
     "method": "pnpm-lock production graph with installed-manifest license audit",

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

@@ -571,7 +571,8 @@ class UnifiedBleProtocolAndroidDispatcher(
       endpoint.serviceOccurrence,
       endpoint.characteristicUuid,
       endpoint.characteristicOccurrence,
-      enable
+      enable,
+      subscriptionType = command.optionalString(21)
     ) { result ->
       result.fold(
         onSuccess = {
@@ -598,7 +599,11 @@ class UnifiedBleProtocolAndroidDispatcher(
           }
           val subscriptionId = command.requiredString(7)
           if (enable) {
-            activeSubscriptions[subscriptionId] = SubscriptionRoute(subscriptionId, endpoint)
+            activeSubscriptions[subscriptionId] = SubscriptionRoute(
+              subscriptionId,
+              endpoint,
+              command.optionalString(21)
+            )
           } else {
             activeSubscriptions.remove(subscriptionId)
           }
@@ -682,7 +687,8 @@ class UnifiedBleProtocolAndroidDispatcher(
             route.endpoint.serviceOccurrence,
             route.endpoint.characteristicUuid,
             route.endpoint.characteristicOccurrence,
-            true
+            true,
+            subscriptionType = route.mode
           ) { result ->
             result.exceptionOrNull()?.let { error ->
               radio.reportCleanupFailure(
@@ -1100,7 +1106,8 @@ class UnifiedBleProtocolAndroidDispatcher(
 
   private data class SubscriptionRoute(
     val subscriptionId: String,
-    val endpoint: CharacteristicEndpoint
+    val endpoint: CharacteristicEndpoint,
+    val mode: String?
   ) {
     fun matches(
       deviceId: String,

package/android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolControlModule.java

@@ -22,10 +22,10 @@ import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReadableMap;
-import com.facebook.react.bridge.RuntimeExecutor;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.bridge.ActivityEventListener;
 import com.facebook.react.module.annotations.ReactModule;
+import com.facebook.react.turbomodule.core.CallInvokerHolderImpl;
 import com.sfourdrinier.unifiedblemanager.NativeUnifiedBleProtocolControlSpec;
 
 import java.io.ByteArrayOutputStream;
@@ -487,11 +487,12 @@ public final class UnifiedBleProtocolControlModule extends NativeUnifiedBleProto
   public synchronized void installExecutionRuntime(Promise promise) {
     try {
       requireOpen();
-      final RuntimeExecutor runtimeExecutor = reactContext.getCatalystInstance().getRuntimeExecutor();
-      if (runtimeExecutor == null) {
-        throw new IllegalStateException("React Native RuntimeExecutor is unavailable");
+      final CallInvokerHolderImpl jsCallInvokerHolder =
+          (CallInvokerHolderImpl) reactContext.getJSCallInvokerHolder();
+      if (jsCallInvokerHolder == null) {
+        throw new IllegalStateException("React Native JS CallInvoker is unavailable");
       }
-      UnifiedBleProtocolJsiBinding.install(runtimeExecutor, nativeHandle, reactContext);
+      UnifiedBleProtocolJsiBinding.install(jsCallInvokerHolder, nativeHandle, reactContext);
       promise.resolve(null);
     } catch (RuntimeException error) {
       Log.e(TAG, "installExecutionRuntime failed", error);

package/android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolJsiBinding.java

@@ -2,8 +2,8 @@
 
 package com.sfourdrinier.unifiedblemanager.protocol;
 
-import com.facebook.react.bridge.RuntimeExecutor;
 import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.turbomodule.core.CallInvokerHolderImpl;
 
 import java.util.concurrent.ConcurrentHashMap;
 
@@ -15,14 +15,14 @@ final class UnifiedBleProtocolJsiBinding {
   private UnifiedBleProtocolJsiBinding() {}
 
   static void install(
-      RuntimeExecutor runtimeExecutor,
+      CallInvokerHolderImpl jsCallInvokerHolder,
       long nativeHandle,
       ReactApplicationContext context) {
     final UnifiedBleProtocolAndroidDispatcher dispatcher =
         DISPATCHERS.reserve(
             nativeHandle, () -> new UnifiedBleProtocolAndroidDispatcher(context, nativeHandle));
     try {
-      installNative(runtimeExecutor, nativeHandle);
+      installNative(jsCallInvokerHolder, nativeHandle);
     } catch (RuntimeException error) {
       try {
         close(nativeHandle);
@@ -197,7 +197,7 @@ final class UnifiedBleProtocolJsiBinding {
     }
   }
 
-  private static native void installNative(RuntimeExecutor runtimeExecutor, long nativeHandle);
+  private static native void installNative(CallInvokerHolderImpl jsCallInvokerHolder, long nativeHandle);
   private static native void uninstallNative(long nativeHandle);
   private static native String requestCancellationNative(long nativeHandle, long dispatchEpoch, String nonce);
   private static native boolean emitRecordNative(long nativeHandle, byte[] encodedRecord);

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

@@ -3,7 +3,7 @@
 package com.sfourdrinier.unifiedblemanager.protocol.generated
 
 const val NATIVE_PROTOCOL_VERSION: Int = 2
-const val NATIVE_PROTOCOL_ABI_VERSION: Int = 6
+const val NATIVE_PROTOCOL_ABI_VERSION: Int = 7
 const val NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION: Int = 2
 const val MAXIMUM_CONTROL_RECORD_BYTES: Int = 262144
 const val MAXIMUM_BINARY_PAYLOAD_BYTES: Int = 524288
@@ -119,6 +119,11 @@ enum class WriteModes(val wireValue: Int) {
   WITHOUT_RESPONSE(2)
 }
 
+enum class NotificationDeliveryModes(val wireValue: Int) {
+  NOTIFICATION(1),
+  INDICATION(2)
+}
+
 enum class ConnectionPriorities(val wireValue: Int) {
   LOW_POWER(1),
   BALANCED(2),
@@ -271,6 +276,7 @@ val NATIVE_PROTOCOL_FIELDS: List<FieldDescriptor> = listOf(
     FieldDescriptor(RecordKind.COMMAND, 18, "phyRx", "enum:connectionPhys", false),
     FieldDescriptor(RecordKind.COMMAND, 19, "pairTransport", "enum:pairTransports", false),
     FieldDescriptor(RecordKind.COMMAND, 20, "connectionIntent", "enum:connectionIntents", false),
+    FieldDescriptor(RecordKind.COMMAND, 21, "notificationDeliveryMode", "enum:notificationDeliveryModes", false),
     FieldDescriptor(RecordKind.TERMINAL, 1, "correlation", "record:operationCorrelation", true),
     FieldDescriptor(RecordKind.TERMINAL, 2, "outcome", "enum:terminalOutcomes", true),
     FieldDescriptor(RecordKind.TERMINAL, 3, "cause", "string", false),

package/android/src/main/jni/UnifiedBleProtocolJsiBinding.cpp

@@ -6,7 +6,7 @@
 #include <android/log.h>
 #include <fbjni/fbjni.h>
 #include <jsi/jsi.h>
-#include <react/jni/JRuntimeExecutor.h>
+#include <ReactCommon/CallInvokerHolder.h>
 
 #include <algorithm>
 #include <cstddef>
@@ -1302,22 +1302,27 @@ class UnifiedBleProtocolJsiBinding final : public jni::JavaClass<UnifiedBleProto
 
   static void installNative(
       jni::alias_ref<jclass>,
-      jni::alias_ref<facebook::react::JRuntimeExecutor::javaobject> runtimeExecutor,
+      jni::alias_ref<facebook::react::CallInvokerHolder::javaobject> jsCallInvokerHolder,
       jlong nativeHandle) {
     const auto runtimeLease = unifiedBleProtocolRuntimeLease(nativeHandle);
     if (runtimeLease.expired()) {
       throw std::invalid_argument("Native Protocol v2 runtime is unavailable");
     }
-    auto executor = runtimeExecutor->cthis()->get();
+    auto callInvoker = jsCallInvokerHolder->cthis()->getCallInvoker();
+    if (!callInvoker) {
+      throw std::invalid_argument("React Native JS CallInvoker is unavailable");
+    }
     auto state = std::make_shared<JsiEventSinkState>(
         runtimeLease,
-        [executor](std::function<void(jsi::Runtime&)> task) { executor(std::move(task)); },
+        [callInvoker](std::function<void(jsi::Runtime&)> task) {
+          callInvoker->invokeAsync(std::move(task));
+        },
         nativeHandle);
     {
       std::scoped_lock lock(eventSinkStatesMutex);
       eventSinkStates[nativeHandle] = state;
     }
-    executor([runtimeLease, nativeHandle, state](jsi::Runtime& runtime) {
+    callInvoker->invokeAsync([runtimeLease, nativeHandle, state](jsi::Runtime& runtime) {
       runtime.global().setProperty(
           runtime,
           kRuntimeName,

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

@@ -741,6 +741,21 @@ class UnifiedBleProtocolAndroidDispatcherLifecycleTest {
     )
   }
 
+  @Test
+  fun dispatcherForwardsResolvedSubscriptionModeToOwnedRadioCccdSelection() {
+    val dispatcher = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/protocol/UnifiedBleProtocolAndroidDispatcher.kt"
+    )
+    val radio = readAndroidSource(
+      "android/src/main/java/com/sfourdrinier/unifiedblemanager/radio/OwnedAndroidGattRadio.kt"
+    )
+
+    assertTrue(dispatcher.contains("subscriptionType = command.optionalString(21)"))
+    assertTrue(dispatcher.contains("command.optionalString(21)\n            )"))
+    assertTrue(dispatcher.contains("subscriptionType = route.mode"))
+    assertTrue(radio.contains("resolveCccdPayload(enable, subscriptionType"))
+  }
+
   @Test
   fun activeCancellationKeepsTheFifoBlockedUntilTheLateNativeCompletion() {
     val scheduled = ArrayDeque<() -> Unit>()

package/docs/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS.md — docs/
+
+Conventions for the documentation tree. Root [`AGENTS.md`](../AGENTS.md) still
+applies; this file adds only what is specific to `docs/`.
+
+## The index is load-bearing
+
+[`docs/README.md`](README.md) maps every document with a status of **Current**,
+**Historical**, or **Generated**. When you add, move, or retire a document,
+update the index in the same change. `pnpm docs:check` (via
+`scripts/docs/check-docs-index.js`) fails when the index misses a document,
+links to a missing one, or a row lacks a status — and when `llms.txt` stops
+covering a public entrypoint.
+
+## Historical documents are records, not guidance
+
+Anything marked Historical (fix trackers, audits, delivered plans, lineage
+docs) is frozen evidence. Never act on its content, never "refresh" it; the
+only acceptable edits are status banners and link repairs. If a grep lands you
+in one, go back to the index and find the Current document instead.
+
+## Generated documents are owned by generators
+
+`docs/generated/*`, `docs/index.html`, and `docs/assets/*` are generator
+output. Change the source of truth, run the generator (`pnpm docs:backend-sdk`,
+`pnpm docs`), and commit its output. Verify with `pnpm docs:check`.
+
+## Teaching prose is tested
+
+`__tests__/Docs.*.test.js` guard the consumer-facing documents: code fences
+must use the real public API, and known-wrong patterns are rejected. If you
+change a recipe, run `pnpm test:package` — a failing docs test means the prose
+and the contract disagree, and the contract wins.

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.11`. Tagged releases ship Node-API v8 prebuilds covering macOS and Windows `arm64`/`x64` for both Node and modern Electron.
+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.
 
 `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.11` source. Those options match
+Use the v2 plugin options in this `4.0.13` 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.11`; the npm registry and release
+This source targets `unified-ble-manager@4.0.13`; 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.11`; verify the published version in the npm registry.
+This source targets `4.0.13`; 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.11`, install that exact version and keep it in
+After the npm registry lists `4.0.13`, install that exact version and keep it in
 your lockfile while validating the native build:
 
 ```sh
-pnpm add unified-ble-manager@4.0.11
+pnpm add unified-ble-manager@4.0.13
 ```
 
 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.11`. 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.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.
 
 ## One-call factories