@tempivo/sensor-beacon 1.1.6 → 1.1.7

package/CHANGELOG.md

@@ -6,6 +6,12 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.1.7] - 2026-09-30
+
+### Added
+
+- `clearMeasurementQueue()`: clear on-device measurement / uplink queue (memory reset). Manual recovery only; not used by `setConfigurationJson`.
+
 ## [1.1.6] - 2026-09-25
 
 ### Changed
@@ -13,7 +19,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Parsed sticker model **TS10** stays `TS10` on `TempivoSensorQr` (connect / native still maps to HC7).
 - Production defaults check is looser: PLMN `1000000` and legacy `0xFFFFFFFF` as automatic, DEL-only APN user/password as unused, DNS `255.255.255.255` as automatic, any regional NB-IoT band mask, any non-empty firmware string.
 - React Native entry re-exports native BLE helpers live from the native module (avoids a stale snapshot when Metro loads).
-- Docs: prefer Cellular API for laboratory calibration date; BLE `getCalibration` is not the source of truth. Cloud field is not released yet and returns `null` for now. Examples no longer call `getCalibration()`.
+- Docs: prefer Cellular API for laboratory calibration date; BLE `getCalibration` is optional. Examples no longer call `getCalibration()`.
+- Docs: cloud `laboratoryCalibrationDate` is live (certificate and/or device extended-config uplink); remove “not released yet” wording.
 
 ## [1.1.5] - 2026-09-08
 

package/README.md

@@ -107,7 +107,8 @@ The Expo config plugin sets **minSdk 26**, Android BLE permissions, and **`NSBlu
 | `connect` / `disconnect` | GATT session with parsed QR (`TempivoSensorQr`). |
 | `getConfiguration` / `setConfigurationJson` | Read / write alert rules, schedule, optional intervals. |
 | `triggerTransmission` | Ask firmware to uplink now; returns `{ ok }`. Cloud pending syncs after that uplink (or schedule/button), not from the BLE write alone. |
-| `getCalibration` | Legacy BLE read of laboratory calibration date. Prefer the Cellular API (see below). |
+| `clearMeasurementQueue` | Clear on-device measurement / uplink queue (memory reset). Manual recovery only; not used by `setConfigurationJson`. |
+| `getCalibration` | Optional BLE read of laboratory calibration date. Prefer the Cellular API (see below). |
 
 **Cloud queue:** BLE updates the sensor only. After uplink, Tempivo drops from Cellular `pendingConfig` only fields the device already matches; other queued fields can still downlink. Cancel the whole queue with `DELETE /api/v1/devices/{serial}/config` (see Tempivo Cellular API docs).
 
@@ -363,9 +364,9 @@ Prefer **cloud to cloud**, not BLE:
 - After the sensor is registered, use **`GET /api/v1/assets/{assetId}`** (`laboratoryCalibrationDate`, and `calibrationCertificate` when a PDF is linked).
 - Download PDF: **`GET /api/v1/assets/{assetId}/calibration-certificate`**.
 
-This cloud field is **not released yet**. Until Tempivo turns it on, the API returns **`null`** for `laboratoryCalibrationDate` (except sample / demo serials documented in the Cellular API). Do not use BLE for production calibration dates.
+`laboratoryCalibrationDate` is live. Sources (first wins): uploaded certificate date, then device extended-config `LABORATORY_CALIBRATION_DATE` after cellular uplink. `null` only when neither exists yet (see Cellular API sample serial `STOREVIEW001` for a fixed demo date).
 
-BLE `getCalibration()` exists for tooling only and is not shown in the examples above.
+BLE `getCalibration()` can still read the on-device date when present; it is not shown in the examples above.
 
 ## Node / TypeScript helpers
 
@@ -409,6 +410,8 @@ session.connect(qr)
 try {
     session.setConfigurationJson(profileJson)
     val trigger = session.triggerTransmission()
+    // Manual recovery only (not part of setConfiguration):
+    // session.clearMeasurementQueue()
     val applied = session.getConfiguration()
 } finally {
     // Without disconnect, the sensor will not advertise for startScan.

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

@@ -122,6 +122,17 @@ final class SensorBeaconNative {
     }
   }
 
+  Map<String, Object> clearMeasurementQueue() {
+    try {
+      requireSessionConnected().clearMeasurementQueueBlocking();
+      Map<String, Object> payload = new HashMap<>();
+      payload.put("ok", true);
+      return payload;
+    } catch (Throwable error) {
+      throw wrap(error);
+    }
+  }
+
   Map<String, Object> getCalibration() {
     try {
       return calibrationMap(requireSessionConnected().getCalibrationBlocking());

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

@@ -92,6 +92,14 @@ class TempivoSensorBeaconModule : Module() {
       }
     }
 
+    AsyncFunction("clearMeasurementQueue") {
+      try {
+        native.clearMeasurementQueue()
+      } catch (error: Throwable) {
+        throw error.toSensorException()
+      }
+    }
+
     AsyncFunction("getCalibration") {
       try {
         native.calibration

package/android-aar/library/src/main/java/com/tempivo/sensor/beacon/SensorBleRuntime.kt

@@ -119,6 +119,15 @@ internal object SensorBleRuntime {
         }
     }
 
+    /**
+     * Clear on-device measurement / uplink queue (memory reset).
+     * Manual recovery only: not used by [writeConfiguration] / partner setConfiguration.
+     */
+    suspend fun clearMeasurementQueue(session: Session) {
+        val base = modernGetConfiguration(session.connection)
+        session.connection.commands.setConfiguration(base.copy(resetMemoryRequest = true)) { }
+    }
+
     suspend fun readCalibration(session: Session): TempivoSensorCalibration {
         val ext = session.connection.commands.getExtendedConfiguration { }
         return TempivoSensorCalibrationDecoder.decode(ext.laboratoryCalibrationTimestamp)

package/android-aar/library/src/main/java/com/tempivo/sensor/beacon/TempivoSensorSession.kt

@@ -170,6 +170,16 @@ class TempivoSensorSession(
         }
     }
 
+    /**
+     * Clear on-device measurement / uplink queue (memory reset). Manual recovery only.
+     */
+    suspend fun clearMeasurementQueue() {
+        runGatt {
+            ensureSdkConnected()
+            SensorBleRuntime.clearMeasurementQueue(requireSession())
+        }
+    }
+
     suspend fun getCalibration(): TempivoSensorCalibration {
         return runGatt {
             ensureSdkConnected()
@@ -192,6 +202,8 @@ class TempivoSensorSession(
 
     fun triggerTransmissionBlocking(): TriggerResult = runBlocking { triggerTransmission() }
 
+    fun clearMeasurementQueueBlocking() = runBlocking { clearMeasurementQueue() }
+
     fun getCalibrationBlocking(): TempivoSensorCalibration = runBlocking { getCalibration() }
 
     private fun requireSession(): SensorBleRuntime.Session =

package/dist/index.d.ts

@@ -12,5 +12,5 @@ export type { ParsedSensorQrLoose, SensorBleConnectCredentials, } from './connec
 export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, } from './calibration.js';
 export { BLE_MAX_MEASUREMENT_INTERVAL_MINUTES, BLE_MAX_TRANSMISSION_INTERVAL_SECONDS, BLE_MIN_MEASUREMENT_INTERVAL_MINUTES, BLE_MIN_TRANSMISSION_INTERVAL_SECONDS, DEFAULT_ALERT_HYSTERESIS_C, compileSensorProfileToBleJson, configurationFromApiProfile, parseSensorConfiguration, parseSensorConfigurationFromDevice, parseSensorConfigurationFromDeviceJson, parseSensorConfigurationJson, pickPartnerConfigurationJson, } from './profile.js';
 export type { TempivoSchedule, TempivoScheduleAlways, TempivoScheduleWeek, TempivoSensorCalibration, TempivoSensorConfiguration, TempivoSensorQr, TempivoSensorSessionType, TempivoTemperatureAlert, TempivoTemperatureChannel, TempivoTemperatureMaxAlert, TempivoTemperatureMinAlert, TempivoTemperatureRangeAlert, TempivoTriggerTransmissionResult, } from './session-types.js';
-export { addDeviceFoundListener, connect, disconnect, getCalibration, getConfiguration, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
+export { addDeviceFoundListener, connect, clearMeasurementQueue, disconnect, getCalibration, getConfiguration, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
 export type { TempivoDeviceFoundSubscription, TempivoNativeCalibration, TempivoNativeMeasurement, TempivoNativePermissionResponse, TempivoNativePermissionStatus, TempivoNativeQr, TempivoNativeTelemetry, TempivoSensorBeaconDevice, } from './native-types.js';

package/dist/index.js

@@ -9,4 +9,4 @@ export { isMissingAdvertisementFirmware, sensorModelFromFirmware, } from './mode
 export { buildSensorQrConnectJson, draftSensorQrConnectJsonFromScanDevice, formatSensorReadingLine, mergeScanTargetIntoSensorQr, normalizeSensorStickerModel, parseSensorQrForConnect, pinFromSensorQrRecord, resolveSensorBleConnectCredentialsFromPin, sensorQrConnectJsonFromLoose, sensorQrSerialMatchesSelected, serialHexFromSensorQrScan, tryParseSensorQrJson, } from './connect-helpers.js';
 export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, } from './calibration.js';
 export { BLE_MAX_MEASUREMENT_INTERVAL_MINUTES, BLE_MAX_TRANSMISSION_INTERVAL_SECONDS, BLE_MIN_MEASUREMENT_INTERVAL_MINUTES, BLE_MIN_TRANSMISSION_INTERVAL_SECONDS, DEFAULT_ALERT_HYSTERESIS_C, compileSensorProfileToBleJson, configurationFromApiProfile, parseSensorConfiguration, parseSensorConfigurationFromDevice, parseSensorConfigurationFromDeviceJson, parseSensorConfigurationJson, pickPartnerConfigurationJson, } from './profile.js';
-export { addDeviceFoundListener, connect, disconnect, getCalibration, getConfiguration, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
+export { addDeviceFoundListener, connect, clearMeasurementQueue, disconnect, getCalibration, getConfiguration, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, startScan, stopScan, triggerTransmission, } from './native-bridge.js';

package/dist/native-bridge.d.ts

@@ -11,5 +11,8 @@ export declare function disconnect(): Promise<void>;
 export declare function getConfiguration(): Promise<TempivoSensorConfiguration>;
 export declare function setConfigurationJson(config: string | TempivoSensorConfiguration): Promise<void>;
 export declare function triggerTransmission(): Promise<TempivoTriggerTransmissionResult>;
+export declare function clearMeasurementQueue(): Promise<{
+    ok: boolean;
+}>;
 export declare function getCalibration(): Promise<TempivoNativeCalibration>;
 export declare function getProtoConfiguration(): Promise<Record<string, unknown>>;

package/dist/native-bridge.js

@@ -46,6 +46,9 @@ export async function setConfigurationJson(config) {
 export async function triggerTransmission() {
     return (await loadNative()).triggerTransmission();
 }
+export async function clearMeasurementQueue() {
+    return (await loadNative()).clearMeasurementQueue();
+}
 export async function getCalibration() {
     return (await loadNative()).getCalibration();
 }

package/dist/native-module.d.ts

@@ -22,6 +22,13 @@ export declare function getConfiguration(): Promise<TempivoSensorConfiguration>;
  */
 export declare function setConfigurationJson(config: string | TempivoSensorConfiguration): Promise<void>;
 export declare function triggerTransmission(): Promise<TempivoTriggerTransmissionResult>;
+/**
+ * Clear on-device measurement / uplink queue (memory reset).
+ * Manual recovery only: not used by setConfigurationJson.
+ */
+export declare function clearMeasurementQueue(): Promise<{
+    ok: boolean;
+}>;
 /** Decoded device ProtoConfig (server, APN, intervals). Requires an open BLE session. */
 export declare function getProtoConfiguration(): Promise<ProtoConfigObject>;
 export declare function getCalibration(): Promise<TempivoNativeCalibration>;

package/dist/native-module.js

@@ -142,6 +142,22 @@ export async function triggerTransmission() {
         throw mapNativeError(error);
     }
 }
+/**
+ * Clear on-device measurement / uplink queue (memory reset).
+ * Manual recovery only: not used by setConfigurationJson.
+ */
+export async function clearMeasurementQueue() {
+    try {
+        const native = getNative();
+        if (typeof native.clearMeasurementQueue !== 'function') {
+            throw new TempivoSensorError('runtimeUnavailable', 'Native clearMeasurementQueue is unavailable in this build.');
+        }
+        return await native.clearMeasurementQueue();
+    }
+    catch (error) {
+        throw mapNativeError(error);
+    }
+}
 /** Decoded device ProtoConfig (server, APN, intervals). Requires an open BLE session. */
 export async function getProtoConfiguration() {
     try {

package/dist/react-native.d.ts

@@ -13,6 +13,6 @@ export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, } fr
 export { BLE_MAX_MEASUREMENT_INTERVAL_MINUTES, BLE_MAX_TRANSMISSION_INTERVAL_SECONDS, BLE_MIN_MEASUREMENT_INTERVAL_MINUTES, BLE_MIN_TRANSMISSION_INTERVAL_SECONDS, DEFAULT_ALERT_HYSTERESIS_C, compileSensorProfileToBleJson, configurationFromApiProfile, parseSensorConfiguration, parseSensorConfigurationFromDevice, parseSensorConfigurationFromDeviceJson, parseSensorConfigurationJson, pickPartnerConfigurationJson, } from './profile.js';
 export type { TempivoSchedule, TempivoScheduleAlways, TempivoScheduleWeek, TempivoSensorCalibration, TempivoSensorConfiguration, TempivoSensorQr, TempivoSensorSessionType, TempivoTemperatureAlert, TempivoTemperatureChannel, TempivoTemperatureMaxAlert, TempivoTemperatureMinAlert, TempivoTemperatureRangeAlert, TempivoTriggerTransmissionResult, } from './session-types.js';
 export type { TempivoDeviceFoundSubscription, TempivoNativeCalibration, TempivoNativeMeasurement, TempivoNativePermissionResponse, TempivoNativePermissionStatus, TempivoNativeQr, TempivoNativeTelemetry, TempivoSensorBeaconDevice, } from './native-types.js';
-export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, setConfigurationJson, triggerTransmission, getCalibration, getProtoConfiguration, } from './native-module.js';
+export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, } from './native-module.js';
 export { checkProductionDefaults } from './production-defaults.js';
 export type { ProductionCheckLine, ProductionCheckResult } from './production-defaults.js';

package/dist/react-native.js

@@ -9,5 +9,5 @@ export { isMissingAdvertisementFirmware, sensorModelFromFirmware } from './model
 export { buildSensorQrConnectJson, draftSensorQrConnectJsonFromScanDevice, formatSensorReadingLine, mergeScanTargetIntoSensorQr, normalizeSensorStickerModel, parseSensorQrForConnect, pinFromSensorQrRecord, resolveSensorBleConnectCredentialsFromPin, sensorQrConnectJsonFromLoose, sensorQrSerialMatchesSelected, serialHexFromSensorQrScan, tryParseSensorQrJson, } from './connect-helpers.js';
 export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, } from './calibration.js';
 export { BLE_MAX_MEASUREMENT_INTERVAL_MINUTES, BLE_MAX_TRANSMISSION_INTERVAL_SECONDS, BLE_MIN_MEASUREMENT_INTERVAL_MINUTES, BLE_MIN_TRANSMISSION_INTERVAL_SECONDS, DEFAULT_ALERT_HYSTERESIS_C, compileSensorProfileToBleJson, configurationFromApiProfile, parseSensorConfiguration, parseSensorConfigurationFromDevice, parseSensorConfigurationFromDeviceJson, parseSensorConfigurationJson, pickPartnerConfigurationJson, } from './profile.js';
-export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, setConfigurationJson, triggerTransmission, getCalibration, getProtoConfiguration, } from './native-module.js';
+export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, } from './native-module.js';
 export { checkProductionDefaults } from './production-defaults.js';

package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64/TempivoSensorBridge.framework/Headers/TempivoSensorBridge.h

@@ -169,6 +169,7 @@ __attribute__((swift_name("TempivoSensorBridge")))
 @interface TSBTempivoSensorBridge : TSBBase
 - (instancetype)init __attribute__((swift_name("init()"))) __attribute__((objc_designated_initializer));
 + (instancetype)new __attribute__((availability(swift, unavailable, message="use object initializers instead")));
+- (NSString *)clearMeasurementQueuePayloadJson __attribute__((swift_name("clearMeasurementQueuePayloadJson()")));
 - (NSString *)connectPayloadJsonDeviceId:(NSString *)deviceId bluetoothMac:(NSString *)bluetoothMac pin:(NSString *)pin legacy:(BOOL)legacy __attribute__((swift_name("connectPayloadJson(deviceId:bluetoothMac:pin:legacy:)")));
 - (void)disconnect __attribute__((swift_name("disconnect()")));
 - (NSString *)getCalibrationPayloadJson __attribute__((swift_name("getCalibrationPayloadJson()")));

package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64/TempivoSensorBridge.framework/TempivoSensorBridge

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64/TempivoSensorBridge.framework/TempivoSensorBridge
-size: 78397208 bytes
-sha256: 47d3b00a0b04f500eaa566d288ee0884e55da39ce593c844dc164b415ef8ccab
+size: 78427712 bytes
+sha256: 3d8331bcccc757e88f3cc11ebd41a81837c0712942178f3bfdd869094b90cd45

package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64-simulator/TempivoSensorBridge.framework/Headers/TempivoSensorBridge.h

@@ -169,6 +169,7 @@ __attribute__((swift_name("TempivoSensorBridge")))
 @interface TSBTempivoSensorBridge : TSBBase
 - (instancetype)init __attribute__((swift_name("init()"))) __attribute__((objc_designated_initializer));
 + (instancetype)new __attribute__((availability(swift, unavailable, message="use object initializers instead")));
+- (NSString *)clearMeasurementQueuePayloadJson __attribute__((swift_name("clearMeasurementQueuePayloadJson()")));
 - (NSString *)connectPayloadJsonDeviceId:(NSString *)deviceId bluetoothMac:(NSString *)bluetoothMac pin:(NSString *)pin legacy:(BOOL)legacy __attribute__((swift_name("connectPayloadJson(deviceId:bluetoothMac:pin:legacy:)")));
 - (void)disconnect __attribute__((swift_name("disconnect()")));
 - (NSString *)getCalibrationPayloadJson __attribute__((swift_name("getCalibrationPayloadJson()")));

package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64-simulator/TempivoSensorBridge.framework/TempivoSensorBridge

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/ios/Frameworks/TempivoSensorBridge.xcframework/ios-arm64-simulator/TempivoSensorBridge.framework/TempivoSensorBridge
-size: 35252152 bytes
-sha256: 6ff38e03c9e174414232b38328a14ccca43929477cb2769ca7c604f14341f188
+size: 35253832 bytes
+sha256: e861ca361a1210560b37ef321f2a2590a8f634f493a424a50cfd2c4c90b4e401

package/ios/Sources/TempivoSensorBeacon/TempivoSensorSession.swift

@@ -146,6 +146,17 @@ public final class TempivoSensorSession: @unchecked Sendable {
         #endif
     }
 
+    /// Clear on-device measurement / uplink queue (memory reset). Manual recovery only.
+    public func clearMeasurementQueue() throws {
+        #if canImport(TempivoSensorBridge)
+        try ensureSdkConnected()
+        let result = parseBridgeJson(bridge.clearMeasurementQueuePayloadJson())
+        try throwIfBridgeError(result)
+        #else
+        throw TempivoSensorError(.runtimeUnavailable, "Sensor GATT requires a physical device with the native runtime.")
+        #endif
+    }
+
     public func getCalibration() throws -> TempivoSensorCalibration {
         #if canImport(TempivoSensorBridge)
         try ensureSdkConnected()

package/ios/TempivoSensorBeaconModule.swift

@@ -120,6 +120,15 @@ public class TempivoSensorBeaconModule: Module {
       }
     }
 
+    AsyncFunction("clearMeasurementQueue") { () -> [String: Any] in
+      do {
+        try self.session.clearMeasurementQueue()
+        return ["ok": true]
+      } catch {
+        throw self.mapError(error)
+      }
+    }
+
     AsyncFunction("getCalibration") { () -> [String: Any] in
       do {
         let cal = try self.session.getCalibration()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempivo/sensor-beacon",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "Tempivo sensor BLE SDK. Native scan and GATT for Expo, React Native, Android, and iOS. Node helpers decode advertisements and parse QR or config (no radio).",
   "homepage": "https://app.tempivo.com/integrations",
   "repository": {