@tempivo/sensor-beacon 1.1.1 → 1.1.4

package/CHANGELOG.md

@@ -6,6 +6,49 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+<!-- Publish trigger: 1.1.4 not on npm until CI Trusted Publisher (ci.yml) runs. -->
+
+## [1.1.4] - 2026-09-07
+
+### Fixed
+
+- Android BLE get/set for alarm rules uses the same raw ProtoConfig GATT path as iOS (0x0C / 0x0D), with a persistent GATT link and `writeProtoConfigBase64`.
+- Partner `getConfiguration` return value is only partner fields (no `configSource` / `protoBase64`).
+
+### Changed
+
+- `setConfigurationJson` (JS): on iOS and Android, read baseline proto → patch partner alerts → raw GATT write.
+- Vendor SDK remains for connect, scan, trigger, and calibration.
+
+## [1.1.3] - 2026-09-07
+
+### Fixed
+
+- BLE set: if the device already has the same alarm rules, treat it as success (info), not a reject. Fail only when on-device rules actually differ after write.
+- iOS BLE get/set for alarm rules uses raw ProtoConfig GATT (0x0C / 0x0D), not the vendor SDK rule APIs (HC7 SDK get returns empty rules; SDK set often fails with Invalid PIN).
+- iOS: back-to-back config reads and writes no longer time out. The raw config link is now one persistent central/peripheral reused across commands, with one retry on failure.
+- iOS BLE set only writes rules-related fields. Echoing the whole device read back exceeded the single-write BLE limit and would have rewritten server, APN, and token settings.
+- BLE get: device intervals reported as `0` or `null` are omitted instead of failing the whole read.
+
+### Changed
+
+- Partner `getConfiguration` / `setConfigurationJson` signatures unchanged.
+- Vendor SDK is still used for connect, scan, trigger, and calibration.
+
+## [1.1.2] - 2026-09-05
+
+### Fixed
+
+- BLE get: `schedule: { always: true }` no longer reads back as `weekdays: [6]`.
+- BLE set: dual ambient + probe ranges with `transmitOnReturn` keep alerts on get (interleaved OR after each pair).
+- Native compile fail-closed on bad/missing alert fields or full slots (no silent drop).
+- Post-set readback requires alert count ≥ written count.
+- iOS parse aligned with Android/TS (required thresholds, schedule fields, slot budget).
+
+### Changed
+
+- README: range + `transmitOnReturn` uses **3** slots; weekday BLE get caveat.
+
 ## [1.1.1] - 2026-09-03
 
 ### Changed

package/README.md

@@ -59,36 +59,40 @@ const sub = await addDeviceFoundListener((device) => {
 });
 
 await startScan();
+// Stop scan before GATT connect. While connected, the sensor does not advertise.
 
 const qr = parseSensorQrJson(stickerQrText);
 await connect(qr);
-await setConfigurationJson({
-  schedule: { always: true },
-  temperatureAlerts: [
-    {
-      type: 'range',
-      channel: 'probe',
-      lowC: -30,
-      highC: -10,
-      hysteresisC: 0.5,
-    },
-  ],
-});
-// BLE write is on-device only. Cloud pending / last report update after a cellular uplink:
-await triggerTransmission();
-// Tempivo then drops from the cloud queue only fields the device already matches;
-// other queued Cellular fields can still downlink. To cancel the whole queue:
-// DELETE /api/v1/devices/{serial}/config (see docs/cellular-api.md).
-const applied = await getConfiguration();
-const cal = await getCalibration();
-await disconnect();
+try {
+  await setConfigurationJson({
+    schedule: { always: true },
+    temperatureAlerts: [
+      {
+        type: 'range',
+        channel: 'probe',
+        lowC: -30,
+        highC: -10,
+        hysteresisC: 0.5,
+      },
+    ],
+  });
+  // BLE write is on-device only. Cloud pending / last report update after a cellular uplink:
+  await triggerTransmission();
+  // Tempivo then drops from the cloud queue only fields the device already matches;
+  // other queued Cellular fields can still downlink. To cancel the whole queue:
+  // DELETE /api/v1/devices/{serial}/config (see docs/cellular-api.md).
+  const applied = await getConfiguration();
+  const cal = await getCalibration();
+} finally {
+  await disconnect(); // required so advertising / startScan can see the sensor again
+}
 stopScan();
 sub.remove();
 ```
 
 `startScan` and `connect` request Bluetooth permission. Sticker PIN is required on `connect`. Wrong PIN is `invalidPin`.
 
-**Connect tips:** stop scan before GATT connect. Pass the scan row’s `deviceId` and MAC when they differ from the sticker serial (`parseSensorQrForConnect`). 5–6 digit PINs map to an encryption key internally; numeric `resetCode` alone is not enough on all devices.
+**Connect tips:** stop scan before GATT connect. Pass the scan row’s `deviceId` and MAC when they differ from the sticker serial (`parseSensorQrForConnect`). 5–6 digit PINs map to an encryption key internally; numeric `resetCode` alone is not enough on all devices. Call `disconnect()` when finished. **While any device holds a GATT connection, the sensor does not advertise**, so `startScan` will not show beacon / live readings for that sensor until everyone disconnects (including other apps).
 
 If a bundler misses native BLE, import `@tempivo/sensor-beacon/react-native`.
 
@@ -129,6 +133,12 @@ const draft = draftSensorQrConnectJsonFromScanDevice(device);
 // Connect: parse sticker + merge selected row deviceId / MAC
 const qr = parseSensorQrForConnect(stickerJson, selectedDevice);
 await connect(qr);
+try {
+  await setConfigurationJson(profileJson);
+  await getConfiguration();
+} finally {
+  await disconnect();
+}
 
 // Scan list: same reading line as in-app
 formatSensorReadingLine({ typeHex: 'temperature', text: '23.5 °C' });
@@ -263,7 +273,9 @@ When **both** are set on write, uplink must be at most **60×** the measurement
 
 Use `parseSensorConfigurationJson` to validate before write. Use `parseSensorConfigurationFromDevice` / `parseSensorConfigurationFromDeviceJson` when parsing a **readback** from the device (relaxed interval rules). For `GET /devices/config-profiles/{slug}`, use `configurationFromApiProfile(response.profile)` or pass the `{ profile }` envelope directly to `setConfigurationJson`.
 
-**Alert slot budget:** the device has **12** rule slots. A `range` with default `transmitOnReturn: true` uses **two** slots (breach + return). Up to **4** such ranges, or more min/max alerts if you disable `transmitOnReturn` on ranges.
+**Alert slot budget:** the device has **12** rule slots. A `range` with default `transmitOnReturn: true` uses **three** slots (`low` + `high` + OR). Up to **4** such ranges. A lone `min`/`max` uses one; with return on a range disabled, a range uses two.
+
+**Weekday schedules** (`Mon–Fri`, etc.): BLE **get** may not round-trip weekdays on current partner firmware (day-mask decode). Prefer `{ "always": true }` when possible. After set, if get looks wrong (e.g. only Sunday), trust what you wrote.
 
 **Each `temperatureAlerts[]` item**
 
@@ -309,6 +321,8 @@ Sticker QR is JSON. Parse with `parseSensorQrJson`.
 
 Filter manufacturer data on company id **0x026C**. Active scanning is on so scan-response packets arrive.
 
+**Advertising vs GATT:** beacon packets (manufacturer `0x026C`, frames `0x03` / `0x04`) are only sent while the sensor is **not** in a GATT session. If your app, another phone, or another tool is connected, scan results for that sensor disappear or freeze until `disconnect()` (or the link drops). Do not expect live `telemetry.readings` during `connect`.
+
 | Field | Meaning |
 |------|---------|
 | `deviceId` | Platform BLE id. Often randomized. Not the sticker serial. |
@@ -391,6 +405,7 @@ try {
     val applied = session.getConfiguration()
     val cal = session.getCalibration()
 } finally {
+    // Without disconnect, the sensor will not advertise for startScan.
     session.disconnect()
 }
 ```
@@ -410,7 +425,7 @@ Needs a physical device for GATT. Simulator can scan advertisements only. Set **
 let qr = try TempivoSensorQrParser.parse(stickerQrText)
 let session = TempivoSensorSession()
 try session.connect(qr: qr)
-defer { session.disconnect() }
+defer { session.disconnect() } // advertising resumes after disconnect
 try session.setConfigurationJson(profileJson)
 _ = try session.triggerTransmission()
 let applied = try session.getConfiguration()

package/android/build.gradle

@@ -4,14 +4,14 @@ plugins {
 }
 
 group = 'com.tempivo.sensor.beacon'
-version = '0.4.3'
+version = '0.4.4'
 
 android {
   namespace "expo.modules.tempivosensorbeacon"
   defaultConfig {
     minSdk 26
     versionCode 1
-    versionName "0.4.3"
+    versionName "0.4.4"
   }
   compileOptions {
     sourceCompatibility JavaVersion.VERSION_17

package/android/src/main/java/expo/modules/tempivosensorbeacon/SensorBeaconNative.java

@@ -95,6 +95,14 @@ final class SensorBeaconNative {
     }
   }
 
+  void writeProtoConfigBase64(String base64) {
+    try {
+      requireSessionConnected().writeProtoConfigBase64Blocking(base64);
+    } catch (Throwable error) {
+      throw wrap(error);
+    }
+  }
+
   void setConfigurationJson(String json) {
     try {
       requireSessionConnected().setConfigurationJsonBlocking(json);

package/android/src/main/java/expo/modules/tempivosensorbeacon/TempivoSensorBeaconModule.kt

@@ -68,6 +68,14 @@ class TempivoSensorBeaconModule : Module() {
       }
     }
 
+    AsyncFunction("writeProtoConfigBase64") { base64: String ->
+      try {
+        native.writeProtoConfigBase64(base64)
+      } catch (error: Throwable) {
+        throw error.toSensorException()
+      }
+    }
+
     AsyncFunction("setConfigurationJson") { json: String ->
       try {
         native.setConfigurationJson(json)

package/android-aar/library/build.gradle

@@ -20,6 +20,10 @@ android {
     kotlinOptions {
         jvmTarget = "17"
     }
+
+    testOptions {
+        unitTests.returnDefaultValues = true
+    }
 }
 
 dependencies {
@@ -27,4 +31,5 @@ dependencies {
     implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2"
     implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2"
     implementation "pl.efento.mobile:bluetooth:2.3.0"
+    testImplementation "junit:junit:4.13.2"
 }