unified-ble-manager 4.0.12 → 4.0.13

package/CHANGELOG.md

@@ -6,6 +6,17 @@ 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

package/MIGRATION_4.0.md

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

@@ -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.12`. 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.

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.11` are immutable. `4.0.12` 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,6 +133,27 @@ 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
+
+The `v4.0.13` 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.13"
+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
+```
+
+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

package/SBOM.cdx.json

@@ -6,15 +6,15 @@
   "metadata": {
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/unified-ble-manager@4.0.12",
+      "bom-ref": "pkg:npm/unified-ble-manager@4.0.13",
       "name": "unified-ble-manager",
-      "version": "4.0.12",
+      "version": "4.0.13",
       "licenses": [
         {
           "expression": "Apache-2.0"
         }
       ],
-      "purl": "pkg:npm/unified-ble-manager@4.0.12"
+      "purl": "pkg:npm/unified-ble-manager@4.0.13"
     },
     "properties": [
       {
@@ -537,7 +537,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:npm/unified-ble-manager@4.0.12",
+      "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.12"
+    "version": "4.0.13"
   },
   "source": {
     "method": "pnpm-lock production graph with installed-manifest license audit",

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

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.12`. 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.12` 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.12`; 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.12`; 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.12`, 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.12
+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.12`. 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
 

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.12`. 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.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.
 
 ## 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.12`
+`unified-ble-manager@4.0.13`
 
 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/ios/Generated/NativeProtocolV2Schema.swift

@@ -3,7 +3,7 @@
 import Foundation
 
 public let nativeProtocolVersion: UInt32 = 2
-public let nativeProtocolABIVersion: UInt32 = 6
+public let nativeProtocolABIVersion: UInt32 = 7
 public let nativeProtocolControlSurfaceVersion: UInt32 = 2
 public let maximumControlRecordBytes: Int = 262144
 public let maximumBinaryPayloadBytes: Int = 524288

package/lib/commonjs/implementation-version.js

@@ -7,5 +7,5 @@ exports.UNIFIED_BLE_IMPLEMENTATION_VERSION = void 0;
 // src/implementation-version.ts
 
 /** The one production version stamped into every first-party backend identity. */
-const UNIFIED_BLE_IMPLEMENTATION_VERSION = exports.UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.12';
+const UNIFIED_BLE_IMPLEMENTATION_VERSION = exports.UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.13';
 //# sourceMappingURL=implementation-version.js.map

package/lib/commonjs/native-protocol/generated/native-protocol-v2-schema.js

@@ -7,7 +7,7 @@ exports.writeModes = exports.terminalOutcomes = exports.securityBondStates = exp
 // src/native-protocol/generated/native-protocol-v2-schema.ts
 
 const NATIVE_PROTOCOL_VERSION = exports.NATIVE_PROTOCOL_VERSION = 2;
-const NATIVE_PROTOCOL_ABI_VERSION = exports.NATIVE_PROTOCOL_ABI_VERSION = 6;
+const NATIVE_PROTOCOL_ABI_VERSION = exports.NATIVE_PROTOCOL_ABI_VERSION = 7;
 const NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = exports.NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = 2;
 const MAXIMUM_CONTROL_RECORD_BYTES = exports.MAXIMUM_CONTROL_RECORD_BYTES = 262144;
 const MAXIMUM_BINARY_PAYLOAD_BYTES = exports.MAXIMUM_BINARY_PAYLOAD_BYTES = 524288;

package/lib/module/implementation-version.js

@@ -3,5 +3,5 @@
 // src/implementation-version.ts
 
 /** The one production version stamped into every first-party backend identity. */
-export const UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.12';
+export const UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.13';
 //# sourceMappingURL=implementation-version.js.map

package/lib/module/native-protocol/generated/native-protocol-v2-schema.js

@@ -3,7 +3,7 @@
 // src/native-protocol/generated/native-protocol-v2-schema.ts
 
 export const NATIVE_PROTOCOL_VERSION = 2;
-export const NATIVE_PROTOCOL_ABI_VERSION = 6;
+export const NATIVE_PROTOCOL_ABI_VERSION = 7;
 export const NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = 2;
 export const MAXIMUM_CONTROL_RECORD_BYTES = 262144;
 export const MAXIMUM_BINARY_PAYLOAD_BYTES = 524288;

package/lib/typescript/commonjs/src/backends/bluez/bluez-backend-provider.d.ts

@@ -4,7 +4,7 @@ import { type BackendCompatibilityOffer } from '../../backend-contract/primitive
 import { type BluezBusKind, type BluezDbusBoundaryFactory } from './bluez-dbus-contract';
 export declare const BLUEZ_BACKEND_ID = "unified-ble:bluez-dbus";
 export declare const BLUEZ_PLATFORM_ID = "unified-ble:linux-bluez";
-export declare const BLUEZ_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const BLUEZ_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const bluezCompatibility: BackendCompatibilityOffer;
 export interface BluezBackendProviderOptions {
     readonly busKind: BluezBusKind;

package/lib/typescript/commonjs/src/backends/corebluetooth/corebluetooth-identity.d.ts

@@ -1,7 +1,7 @@
 import { type FeatureRegistry } from '../../backend-contract/capabilities';
 export declare const COREBLUETOOTH_BACKEND_ID = "unified-ble:corebluetooth";
 export declare const COREBLUETOOTH_PLATFORM_ID = "unified-ble:macos-corebluetooth";
-export declare const COREBLUETOOTH_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const COREBLUETOOTH_IMPLEMENTATION_VERSION = "4.0.13";
 /** Identity metadata for a direct-GATT boundary that shares this backend core. */
 export interface DirectGattBackendIdentityOptions {
     readonly registeredBackendId: string;

package/lib/typescript/commonjs/src/backends/reactnative/react-native-android-provider.d.ts

@@ -9,7 +9,7 @@ import { ReactNativeAndroidProtocolBoundary } from '../../native-protocol/rn-and
 import { ReactNativeRestorationCoordinator, type ReactNativeRestorationActivation, type ReactNativeRestorationBackendProvider } from './react-native-restoration';
 export declare const REACT_NATIVE_ANDROID_BACKEND_ID = "unified-ble:react-native-android";
 export declare const REACT_NATIVE_ANDROID_PLATFORM_ID = "unified-ble:android-gatt";
-export declare const REACT_NATIVE_ANDROID_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const REACT_NATIVE_ANDROID_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const REACT_NATIVE_ANDROID_DEFAULT_ADAPTER_NATIVE_ID = "android-default-adapter";
 export declare const reactNativeAndroidCompatibility: NativeCompatibilityOffer;
 export interface ReactNativeAndroidBackendProviderOptions {

package/lib/typescript/commonjs/src/backends/reactnative/react-native-apple-provider.d.ts

@@ -3,7 +3,7 @@ import type { Spec as NativeProtocolControl } from '../../NativeUnifiedBleProtoc
 import { type ReactNativeRestorationBackendProvider } from './react-native-restoration';
 export declare const REACT_NATIVE_APPLE_BACKEND_ID = "unified-ble:react-native-apple";
 export declare const REACT_NATIVE_APPLE_PLATFORM_ID = "unified-ble:apple-corebluetooth";
-export declare const REACT_NATIVE_APPLE_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const REACT_NATIVE_APPLE_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const REACT_NATIVE_APPLE_DEFAULT_ADAPTER_NATIVE_ID = "apple-corebluetooth-default-adapter";
 export declare const reactNativeAppleCompatibility: NativeCompatibilityOffer;
 export interface ReactNativeAppleBackendProviderOptions {

package/lib/typescript/commonjs/src/backends/winrt/winrt-provider.d.ts

@@ -3,7 +3,7 @@ import { type BackendCompatibilityOffer } from '../../backend-contract/primitive
 import { type WinRtAdapterRecord, type WinRtBoundary } from './winrt-boundary';
 export declare const WINRT_BACKEND_ID = "unified-ble:winrt";
 export declare const WINRT_PLATFORM_ID = "unified-ble:windows-winrt";
-export declare const WINRT_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const WINRT_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const winRtCompatibility: BackendCompatibilityOffer;
 export interface WinRtBackendProviderOptions {
     readonly boundaryFactory: () => WinRtBoundary;

package/lib/typescript/commonjs/src/implementation-version.d.ts

@@ -1,3 +1,3 @@
 /** The one production version stamped into every first-party backend identity. */
-export declare const UNIFIED_BLE_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const UNIFIED_BLE_IMPLEMENTATION_VERSION = "4.0.13";
 //# sourceMappingURL=implementation-version.d.ts.map

package/lib/typescript/commonjs/src/native-protocol/generated/native-protocol-v2-schema.d.ts

@@ -1,5 +1,5 @@
 export declare const NATIVE_PROTOCOL_VERSION = 2;
-export declare const NATIVE_PROTOCOL_ABI_VERSION = 6;
+export declare const NATIVE_PROTOCOL_ABI_VERSION = 7;
 export declare const NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = 2;
 export declare const MAXIMUM_CONTROL_RECORD_BYTES = 262144;
 export declare const MAXIMUM_BINARY_PAYLOAD_BYTES = 524288;

package/lib/typescript/module/src/backends/bluez/bluez-backend-provider.d.ts

@@ -4,7 +4,7 @@ import { type BackendCompatibilityOffer } from '../../backend-contract/primitive
 import { type BluezBusKind, type BluezDbusBoundaryFactory } from './bluez-dbus-contract.js';
 export declare const BLUEZ_BACKEND_ID = "unified-ble:bluez-dbus";
 export declare const BLUEZ_PLATFORM_ID = "unified-ble:linux-bluez";
-export declare const BLUEZ_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const BLUEZ_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const bluezCompatibility: BackendCompatibilityOffer;
 export interface BluezBackendProviderOptions {
     readonly busKind: BluezBusKind;

package/lib/typescript/module/src/backends/corebluetooth/corebluetooth-identity.d.ts

@@ -1,7 +1,7 @@
 import { type FeatureRegistry } from '../../backend-contract/capabilities.js';
 export declare const COREBLUETOOTH_BACKEND_ID = "unified-ble:corebluetooth";
 export declare const COREBLUETOOTH_PLATFORM_ID = "unified-ble:macos-corebluetooth";
-export declare const COREBLUETOOTH_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const COREBLUETOOTH_IMPLEMENTATION_VERSION = "4.0.13";
 /** Identity metadata for a direct-GATT boundary that shares this backend core. */
 export interface DirectGattBackendIdentityOptions {
     readonly registeredBackendId: string;

package/lib/typescript/module/src/backends/reactnative/react-native-android-provider.d.ts

@@ -9,7 +9,7 @@ import { ReactNativeAndroidProtocolBoundary } from '../../native-protocol/rn-and
 import { ReactNativeRestorationCoordinator, type ReactNativeRestorationActivation, type ReactNativeRestorationBackendProvider } from './react-native-restoration.js';
 export declare const REACT_NATIVE_ANDROID_BACKEND_ID = "unified-ble:react-native-android";
 export declare const REACT_NATIVE_ANDROID_PLATFORM_ID = "unified-ble:android-gatt";
-export declare const REACT_NATIVE_ANDROID_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const REACT_NATIVE_ANDROID_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const REACT_NATIVE_ANDROID_DEFAULT_ADAPTER_NATIVE_ID = "android-default-adapter";
 export declare const reactNativeAndroidCompatibility: NativeCompatibilityOffer;
 export interface ReactNativeAndroidBackendProviderOptions {

package/lib/typescript/module/src/backends/reactnative/react-native-apple-provider.d.ts

@@ -3,7 +3,7 @@ import type { Spec as NativeProtocolControl } from '../../NativeUnifiedBleProtoc
 import { type ReactNativeRestorationBackendProvider } from './react-native-restoration.js';
 export declare const REACT_NATIVE_APPLE_BACKEND_ID = "unified-ble:react-native-apple";
 export declare const REACT_NATIVE_APPLE_PLATFORM_ID = "unified-ble:apple-corebluetooth";
-export declare const REACT_NATIVE_APPLE_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const REACT_NATIVE_APPLE_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const REACT_NATIVE_APPLE_DEFAULT_ADAPTER_NATIVE_ID = "apple-corebluetooth-default-adapter";
 export declare const reactNativeAppleCompatibility: NativeCompatibilityOffer;
 export interface ReactNativeAppleBackendProviderOptions {

package/lib/typescript/module/src/backends/winrt/winrt-provider.d.ts

@@ -3,7 +3,7 @@ import { type BackendCompatibilityOffer } from '../../backend-contract/primitive
 import { type WinRtAdapterRecord, type WinRtBoundary } from './winrt-boundary.js';
 export declare const WINRT_BACKEND_ID = "unified-ble:winrt";
 export declare const WINRT_PLATFORM_ID = "unified-ble:windows-winrt";
-export declare const WINRT_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const WINRT_IMPLEMENTATION_VERSION = "4.0.13";
 export declare const winRtCompatibility: BackendCompatibilityOffer;
 export interface WinRtBackendProviderOptions {
     readonly boundaryFactory: () => WinRtBoundary;

package/lib/typescript/module/src/implementation-version.d.ts

@@ -1,3 +1,3 @@
 /** The one production version stamped into every first-party backend identity. */
-export declare const UNIFIED_BLE_IMPLEMENTATION_VERSION = "4.0.12";
+export declare const UNIFIED_BLE_IMPLEMENTATION_VERSION = "4.0.13";
 //# sourceMappingURL=implementation-version.d.ts.map

package/lib/typescript/module/src/native-protocol/generated/native-protocol-v2-schema.d.ts

@@ -1,5 +1,5 @@
 export declare const NATIVE_PROTOCOL_VERSION = 2;
-export declare const NATIVE_PROTOCOL_ABI_VERSION = 6;
+export declare const NATIVE_PROTOCOL_ABI_VERSION = 7;
 export declare const NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = 2;
 export declare const MAXIMUM_CONTROL_RECORD_BYTES = 262144;
 export declare const MAXIMUM_BINARY_PAYLOAD_BYTES = 524288;

package/native/PREBUILDS.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "package": "unified-ble-manager@4.0.12",
+  "package": "unified-ble-manager@4.0.13",
   "nodeApiVersion": 8,
   "entries": [
     {
@@ -10,7 +10,7 @@
       "nodeApiVersion": 8,
       "path": "native/electron/corebluetooth/prebuilds/darwin-arm64/unified_ble_corebluetooth.node",
       "bytes": 332368,
-      "sha256": "926ab6a757bd0b1a4b6df18cd80f81b5b5748e2563ce4d525460d8ed44bb56af"
+      "sha256": "1775dfd0af6d6cd48a1e4e1dfa7cece4013f426cfa75e14ebd4008679eed2abe"
     },
     {
       "backend": "corebluetooth",
@@ -19,7 +19,7 @@
       "nodeApiVersion": 8,
       "path": "native/electron/corebluetooth/prebuilds/darwin-x64/unified_ble_corebluetooth.node",
       "bytes": 314872,
-      "sha256": "360b7c5e4c5c6c9223a6d681e88e9aadc423f4e0a62e9ab41f39858e8da807e8"
+      "sha256": "e4e916c3c1fd9db7b21dcf4143dcf76fa5e0b31b8f3e1bedb7ea346a94700346"
     },
     {
       "backend": "winrt",
@@ -28,7 +28,7 @@
       "nodeApiVersion": 8,
       "path": "native/electron/winrt/prebuilds/win32-arm64/unified_ble_winrt.node",
       "bytes": 644608,
-      "sha256": "59d02e9378c040a005a87021bd0bbe45625a3cd0c7b7f19e8c48145d4c99c5c9"
+      "sha256": "3c98d96ac49ef7ba5ff18cef51420d0ecc8e3cd8ffffcce6caf094b8ad92f159"
     },
     {
       "backend": "winrt",
@@ -37,7 +37,7 @@
       "nodeApiVersion": 8,
       "path": "native/electron/winrt/prebuilds/win32-x64/unified_ble_winrt.node",
       "bytes": 614400,
-      "sha256": "e3d07a11e50dcef6f238ff46e2fce276ad325c5f30327e878dac06a684abc752"
+      "sha256": "a84c66454c800170cb22489a04f8b5cb097f1dc7f93943355fffbc21d1465b1c"
     }
   ]
 }

package/native/protocol/generated/NativeProtocolV2Schema.hpp

@@ -10,7 +10,7 @@
 namespace unified_ble::native_protocol::v2 {
 
 inline constexpr std::uint32_t kProtocolVersion = 2U;
-inline constexpr std::uint32_t kAbiVersion = 6U;
+inline constexpr std::uint32_t kAbiVersion = 7U;
 inline constexpr std::uint32_t kControlSurfaceVersion = 2U;
 inline constexpr std::size_t kMaximumControlRecordBytes = 262144U;
 inline constexpr std::size_t kMaximumBinaryPayloadBytes = 524288U;

package/native/protocol/schema/native-protocol-v2-abi.json

@@ -1,6 +1,6 @@
 {
   "schema": "unified-ble-native-protocol-abi",
-  "version": 6,
+  "version": 7,
   "recordKinds": {
     "attachment": 1,
     "connectionPath": 2,

package/native/protocol/schema/native-protocol-v2.json

@@ -1,7 +1,7 @@
 {
   "schema": "unified-ble-native-protocol",
   "version": 2,
-  "abiVersion": 6,
+  "abiVersion": 7,
   "controlSurfaceVersion": 2,
   "abiManifest": "native-protocol-v2-abi.json",
   "maximumControlRecordBytes": 262144,

package/native/protocol/src/NativeProtocolV2Codec.cpp

@@ -454,7 +454,9 @@ void validateCommandSemantics(const ProtocolRecord& record) {
     requireFieldSet(record, {1U, 2U, 3U, 5U}, {});
   } else if (*kind == "writeDescriptor") {
     requireFieldSet(record, {1U, 2U, 3U, 5U, 6U}, {});
-  } else if (*kind == "subscribe" || *kind == "unsubscribe") {
+  } else if (*kind == "subscribe") {
+    requireFieldSet(record, {1U, 2U, 3U, 4U, 7U}, {21U});
+  } else if (*kind == "unsubscribe") {
     requireFieldSet(record, {1U, 2U, 3U, 4U, 7U}, {});
   } else if (*kind == "cancel") {
     requireFieldSet(record, {1U, 2U, 3U, 8U}, {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unified-ble-manager",
-  "version": "4.0.12",
+  "version": "4.0.13",
   "description": "Unified Bluetooth Low Energy manager for React Native, Electron, Tauri, Web, and desktop",
   "packageManager": "pnpm@10.14.0",
   "main": "lib/commonjs/index.js",

package/src/implementation-version.ts

@@ -1,4 +1,4 @@
 // src/implementation-version.ts
 
 /** The one production version stamped into every first-party backend identity. */
-export const UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.12'
+export const UNIFIED_BLE_IMPLEMENTATION_VERSION = '4.0.13'

package/src/native-protocol/generated/native-protocol-v2-schema.ts

@@ -1,7 +1,7 @@
 // src/native-protocol/generated/native-protocol-v2-schema.ts
 
 export const NATIVE_PROTOCOL_VERSION = 2
-export const NATIVE_PROTOCOL_ABI_VERSION = 6
+export const NATIVE_PROTOCOL_ABI_VERSION = 7
 export const NATIVE_PROTOCOL_CONTROL_SURFACE_VERSION = 2
 export const MAXIMUM_CONTROL_RECORD_BYTES = 262144
 export const MAXIMUM_BINARY_PAYLOAD_BYTES = 524288