@tempivo/sensor-beacon 1.1.5 → 1.1.7

package/CHANGELOG.md

@@ -6,6 +6,22 @@ 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
+
+- 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 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
 
 ### Fixed

package/README.md

@@ -50,7 +50,6 @@ import {
   setConfigurationJson,
   getConfiguration,
   triggerTransmission,
-  getCalibration,
   disconnect,
 } from '@tempivo/sensor-beacon';
 
@@ -82,7 +81,6 @@ try {
   // 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
 }
@@ -109,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` | Laboratory calibration date from extended config. |
+| `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).
 
@@ -305,14 +304,14 @@ Use `parseSensorConfigurationJson` to validate before write. Use `parseSensorCon
 Sticker QR is JSON. Parse with `parseSensorQrJson`.
 
 ```json
-{ "sn": "282C024F0012", "pin": "111111" }
+{ "sn": "282C024F0012", "pin": "111111", "model": "TS10" }
 ```
 
 | Field | Type | Meaning |
 |------|------|---------|
 | `serial` | string | Device serial, 12 hex chars, no colons. From QR `sn`. |
 | `pin` | string | Sticker PIN. Required on `connect`. Also accepted as QR `resetCode`. |
-| `model` | string | Optional. Defaults to **HC7**. **HC5** is rejected. |
+| `model` | string | Optional. Defaults to **HC7**. **TS10** is Tempivo’s HC7 alias (normalized to HC7). **HC5** is rejected. |
 | `sessionType` | `modern` | Always modern GATT (HC7 / firmware 7+). |
 | `bluetoothMac` | string | BLE MAC with colons, derived from `serial` or scan row. |
 | `deviceId` | string | Optional. Platform BLE id from scan. Pass when connecting to a selected scan row. |
@@ -358,7 +357,16 @@ Filter manufacturer data on company id **0x026C**. Active scanning is on so scan
 
 `triggerTransmission()` returns `{ ok }`. `ok: false` means the firmware rejected the command; it is not thrown as an error.
 
-`getCalibration()` returns `{ laboratoryCalibrationDate, laboratoryCalibrationTimestamp }`. Date is `YYYY-MM-DD`, or null if unset.
+### Laboratory calibration date
+
+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`**.
+
+`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()` can still read the on-device date when present; it is not shown in the examples above.
 
 ## Node / TypeScript helpers
 
@@ -402,8 +410,9 @@ session.connect(qr)
 try {
     session.setConfigurationJson(profileJson)
     val trigger = session.triggerTransmission()
+    // Manual recovery only (not part of setConfiguration):
+    // session.clearMeasurementQueue()
     val applied = session.getConfiguration()
-    val cal = session.getCalibration()
 } finally {
     // Without disconnect, the sensor will not advertise for startScan.
     session.disconnect()
@@ -429,7 +438,6 @@ defer { session.disconnect() } // advertising resumes after disconnect
 try session.setConfigurationJson(profileJson)
 _ = try session.triggerTransmission()
 let applied = try session.getConfiguration()
-let cal = try session.getCalibration()
 ```
 
 ```swift

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/TempivoSensorQr.kt

@@ -40,6 +40,12 @@ object TempivoSensorQrParser {
         return bluetoothMacFromSerial(trimmed)
     }
 
+    fun normalizeModel(model: String): String {
+        val m = model.trim().uppercase(Locale.US).replace("-", "")
+        if (m.isEmpty() || m == "HC7" || m == "TS10") return DEFAULT_MODEL
+        return model.trim()
+    }
+
     fun assertSupportedModel(model: String) {
         val m = model.trim().uppercase(Locale.US).replace("-", "")
         if (m == "HC5") {
@@ -70,7 +76,7 @@ object TempivoSensorQrParser {
         if (pin.isEmpty()) {
             throw TempivoSensorException(TempivoSensorException.Code.INVALID_QR, "QR is missing PIN.")
         }
-        val model = rec.optString("model").trim().ifEmpty { DEFAULT_MODEL }
+        val model = normalizeModel(rec.optString("model"))
         assertSupportedModel(model)
         val hex = if (serial.length == 12) serial else serial.takeLast(12)
         val macOverride =

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/connect-helpers.d.ts

@@ -26,7 +26,7 @@ export declare function serialHexFromSensorQrScan(data: string | {
  * False when both are 12-hex and differ (wrong sticker for selected device).
  */
 export declare function sensorQrSerialMatchesSelected(qrSerialHex: string | null | undefined, selectedSerial: string | null | undefined): boolean;
-/** Normalize sticker `model` to HC5/HC7, or null if missing/unknown. */
+/** Normalize sticker `model` to HC5/HC7, or null if missing/unknown. TS10 is Tempivo’s HC7 alias. */
 export declare function normalizeSensorStickerModel(model: string | undefined | null): SensorStickerModel | null;
 /**
  * Map label PIN to native connect credentials (resetCode + encryptionKey for 5–6 digit codes).

package/dist/connect-helpers.js

@@ -64,14 +64,14 @@ export function sensorQrSerialMatchesSelected(qrSerialHex, selectedSerial) {
         return true;
     return qr === sel;
 }
-/** Normalize sticker `model` to HC5/HC7, or null if missing/unknown. */
+/** Normalize sticker `model` to HC5/HC7, or null if missing/unknown. TS10 is Tempivo’s HC7 alias. */
 export function normalizeSensorStickerModel(model) {
     if (model == null || model.trim() === '')
         return null;
     const m = model.trim().toUpperCase().replace(/-/g, '');
     if (m === 'HC5')
         return 'HC5';
-    if (m === 'HC7')
+    if (m === 'HC7' || m === 'TS10')
         return 'HC7';
     return null;
 }

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, 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, 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,4 +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,12 @@ 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();
 }
+export async function getProtoConfiguration() {
+    return (await loadNative()).getProtoConfiguration();
+}

package/dist/native-helpers.js

@@ -1,5 +1,6 @@
 import { TempivoSensorError } from './errors.js';
 import { pickPartnerConfigurationJson } from './profile.js';
+import { normalizeQrModelField } from './qr.js';
 const SENSOR_CODES = [
     'invalidPin',
     'invalidQr',
@@ -10,13 +11,31 @@ const SENSOR_CODES = [
     'connectFailed',
     'unknown',
 ];
+function rewriteStickerModel(json) {
+    try {
+        const parsed = JSON.parse(json);
+        if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return json;
+        const rec = parsed;
+        if (typeof rec.model !== 'string')
+            return json;
+        const next = normalizeQrModelField(rec.model);
+        if (next === rec.model)
+            return json;
+        rec.model = next;
+        return JSON.stringify(rec);
+    }
+    catch {
+        return json;
+    }
+}
 export function qrToConnectJson(qr) {
     if (typeof qr === 'string')
-        return qr;
+        return rewriteStickerModel(qr);
     const body = {
         sn: qr.serial,
         pin: qr.pin,
-        model: qr.model ?? 'HC7',
+        model: normalizeQrModelField(qr.model ?? 'HC7'),
     };
     if (qr.deviceId)
         body.deviceId = qr.deviceId;

package/dist/native-module.d.ts

@@ -1,4 +1,5 @@
 import type { TempivoDeviceFoundSubscription, TempivoNativeCalibration, TempivoNativePermissionResponse, TempivoNativeQr, TempivoSensorBeaconDevice } from './native-types.js';
+import { type ProtoConfigObject } from './proto/decode-proto-config.js';
 import type { TempivoSensorConfiguration, TempivoSensorQr, TempivoTriggerTransmissionResult } from './session-types.js';
 export declare function isNativeSensorBeaconAvailable(): boolean;
 export declare function requestPermissions(): Promise<TempivoNativePermissionResponse>;
@@ -21,4 +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

@@ -1,6 +1,7 @@
 import { requireOptionalNativeModule } from 'expo-modules-core';
 import { TempivoSensorError } from './errors.js';
 import { configToJson, mapNativeError, qrToConnectJson } from './native-helpers.js';
+import { decodeProtoConfigBase64 } from './proto/decode-proto-config.js';
 import { partnerConfigFromProtoBase64 } from './proto/partner-from-proto.js';
 import { partnerConfigToProtoBase64 } from './proto/partner-to-proto.js';
 import { parseSensorConfigurationFromDevice } from './profile.js';
@@ -141,6 +142,38 @@ 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 {
+        const json = await getNative().getConfigurationJson();
+        const parsed = JSON.parse(json);
+        const protoB64 = typeof parsed.protoBase64 === 'string' ? parsed.protoBase64 : null;
+        if (!protoB64) {
+            throw new TempivoSensorError('unknown', 'Device config did not include a proto frame.');
+        }
+        lastProtoBase64 = protoB64;
+        return decodeProtoConfigBase64(protoB64);
+    }
+    catch (error) {
+        throw mapNativeError(error);
+    }
+}
 export async function getCalibration() {
     try {
         return await getNative().getCalibration();

package/dist/production-defaults.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Factory software defaults from the NB-IoT default-settings sheet (sw 7.02.xx).
+ * Compared against a decoded ProtoConfig. Hardware packaging is not on the radio.
+ */
+export type ProductionCheckLine = {
+    ok: boolean;
+    name: string;
+    expected: string;
+    actual: string;
+};
+export type ProductionCheckResult = {
+    pass: boolean;
+    lines: ProductionCheckLine[];
+};
+export declare function checkProductionDefaults(proto: Record<string, unknown>, extra?: {
+    firmware?: string | null;
+    hasLiveReading?: boolean | null;
+}): ProductionCheckResult;

package/dist/production-defaults.js

@@ -0,0 +1,139 @@
+/**
+ * Factory software defaults from the NB-IoT default-settings sheet (sw 7.02.xx).
+ * Compared against a decoded ProtoConfig. Hardware packaging is not on the radio.
+ */
+const U32_MAX = 0xffffffff;
+/** Current automatic PLMN. 0xFFFFFFFF is the legacy automatic value. */
+const PLMN_AUTOMATIC = 1_000_000;
+/** Single DEL byte: username/password not used. */
+const DEL = '\u007f';
+function u32(value) {
+    if (typeof value === 'bigint') {
+        const n = Number(value);
+        return Number.isFinite(n) ? n >>> 0 : null;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    return value < 0 ? value >>> 0 : value;
+}
+function line(name, expected, actual, ok) {
+    return { ok, name, expected, actual };
+}
+function showCredential(value) {
+    if (typeof value === 'string' && isDelOnly(value))
+        return 'not used';
+    return show(value);
+}
+function show(value) {
+    if (value == null)
+        return 'missing';
+    if (typeof value === 'string')
+        return value === '' ? 'empty' : value;
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value))
+        return value.length === 0 ? 'empty' : JSON.stringify(value);
+    return JSON.stringify(value);
+}
+function eqU32(actual, expected) {
+    const n = u32(actual);
+    return n != null && n === (expected >>> 0);
+}
+function eqStr(actual, expected) {
+    return typeof actual === 'string' && actual.trim().toLowerCase() === expected.toLowerCase();
+}
+function isBlankOrNa(value) {
+    if (value == null)
+        return true;
+    if (typeof value !== 'string')
+        return false;
+    const s = value.trim();
+    return s === '' || s.toUpperCase() === 'N/A' || /^0+$/.test(s) || isDelOnly(s);
+}
+function isDelOnly(value) {
+    return value.length > 0 && [...value].every((ch) => ch === DEL);
+}
+function plmnAutomatic(value) {
+    const n = u32(value);
+    return n === U32_MAX || n === PLMN_AUTOMATIC;
+}
+function dnsAutomatic(value) {
+    if (value == null)
+        return true;
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return true;
+        if (value.every((n) => u32(n) === 0))
+            return true;
+        return value.length === 4 && value.every((n) => u32(n) === 255);
+    }
+    return u32(value) === 0 || u32(value) === 0xffffffff;
+}
+function rulesOff(rules) {
+    if (rules == null)
+        return true;
+    if (!Array.isArray(rules))
+        return false;
+    return rules.every((rule) => {
+        if (rule == null || typeof rule !== 'object')
+            return false;
+        const condition = rule.condition;
+        if (condition == null || condition === 0 || condition === 1)
+            return true;
+        const name = String(condition).toUpperCase();
+        return name === 'CONDITION_DISABLED' || name === 'CONDITION_UNSPECIFIED' || name === 'DISABLED';
+    });
+}
+function firmwareOk(firmware) {
+    return firmware.trim().length > 0;
+}
+export function checkProductionDefaults(proto, extra) {
+    const lines = [];
+    const pushNum = (name, key, expected, label = String(expected)) => {
+        const actual = proto[key];
+        lines.push(line(name, label, show(u32(actual) ?? actual), eqU32(actual, expected)));
+    };
+    const pushStr = (name, key, expected) => {
+        const actual = proto[key];
+        lines.push(line(name, expected, show(actual), eqStr(actual, expected)));
+    };
+    pushNum('Measurement period base', 'measurementPeriodBase', 300);
+    pushNum('Measurement period factor', 'measurementPeriodFactor', 1);
+    pushNum('BLE turn off', 'bleTurnoffTime', U32_MAX, 'never');
+    pushNum('BLE on network issues', 'networkTroubleshooting', 1, 'DISABLE');
+    pushStr('APN', 'apn', 'iot.1nce.net');
+    lines.push(line('APN user', 'N/A', showCredential(proto.apnUsername), isBlankOrNa(proto.apnUsername)));
+    lines.push(line('APN password', 'N/A', showCredential(proto.apnPassword), isBlankOrNa(proto.apnPassword)));
+    lines.push(line('PLMN', 'Automatic', show(u32(proto.plmnSelection) ?? proto.plmnSelection), plmnAutomatic(proto.plmnSelection)));
+    {
+        const mask = u32(proto.modemBandsMask);
+        lines.push(line('NB-IoT bands', 'regional', mask == null ? 'missing' : `0x${mask.toString(16)}`, mask != null));
+    }
+    pushNum('Supervision period', 'supervisionPeriod', 86400);
+    pushNum('Transmission interval', 'transmissionInterval', 10800);
+    pushNum('Transfer limit', 'transferLimit', 65535, 'Disabled');
+    pushNum('Transfer limit period', 'transferLimitTimer', 65535, 'Disabled');
+    pushNum('ACK interval', 'ackInterval', U32_MAX, 'ALWAYS');
+    pushNum('Cloud token mode', 'cloudTokenConfig', 2, 'IMEI');
+    lines.push(line('Cloud token value', 'zeros', show(proto.cloudToken), isBlankOrNa(proto.cloudToken)));
+    pushStr('Server', 'dataServerIp', 'assets.tempivo.com');
+    pushNum('Server port', 'dataServerPort', 5683);
+    pushStr('Measurements endpoint', 'dataEndpoint', '/m');
+    pushStr('Configuration endpoint', 'configurationEndpoint', '/c');
+    pushStr('Device info endpoint', 'deviceInfoEndpoint', '/i');
+    pushStr('Time endpoint', 'timeEndpoint', '/t');
+    pushStr('Extended configuration endpoint', 'extendedConfigurationEndpoint', '/e');
+    lines.push(line('DNS server', 'Automatic', show(proto.dnsServerIp), dnsAutomatic(proto.dnsServerIp)));
+    pushNum('DNS TTL', 'dnsTtlConfig', 864002, 'refresh if communication fails');
+    pushStr('Update server', 'updateServerIp', 'nbiot.efento.io');
+    pushNum('Update UDP port', 'updateServerPortUdp', 50000);
+    pushNum('Update CoAP port', 'updateServerPortCoap', 5680);
+    lines.push(line('Alarm rules', 'OFF', Array.isArray(proto.rules) ? `${proto.rules.length} rules` : 'none', rulesOff(proto.rules)));
+    if (extra?.firmware != null && extra.firmware.trim() !== '') {
+        lines.push(line('Firmware', 'any', extra.firmware.trim(), firmwareOk(extra.firmware)));
+    }
+    if (extra?.hasLiveReading != null) {
+        lines.push(line('Live measurement', 'temperature or humidity', extra.hasLiveReading ? 'seen' : 'none', extra.hasLiveReading));
+    }
+    return { pass: lines.every((row) => row.ok), lines };
+}

package/dist/qr.d.ts

@@ -5,6 +5,8 @@ export declare function bluetoothMacFromSerial(serial: string): string;
 /** BLE default when QR omits `model`. */
 export declare const DEFAULT_SENSOR_MODEL = "HC7";
 export declare function assertSupportedSensorModel(model: string): void;
+/** Sticker `model` → HC7 (incl. Tempivo alias TS10). Unknown strings pass through trimmed. */
+export declare function normalizeQrModelField(model: string | undefined | null): string;
 export declare function sessionTypeFromModel(_model: string | undefined | null): TempivoSensorSessionType;
 /**
  * 3-byte big-endian numeric PIN for GATT command payloads that check a reset code

package/dist/qr.js

@@ -18,9 +18,20 @@ export const DEFAULT_SENSOR_MODEL = 'HC7';
 export function assertSupportedSensorModel(model) {
     const m = model.trim().toUpperCase().replace(/-/g, '');
     if (m === 'HC5') {
-        throw new TempivoSensorError('invalidQr', 'HC5 is not supported by the partner SDK. Use HC7 sensors.');
+        throw new TempivoSensorError('invalidQr', 'HC5 is not supported by the partner SDK. Use HC7 / TS10 sensors.');
     }
 }
+/** Sticker `model` → HC7 (incl. Tempivo alias TS10). Unknown strings pass through trimmed. */
+export function normalizeQrModelField(model) {
+    if (model == null || model.trim() === '')
+        return DEFAULT_SENSOR_MODEL;
+    const m = model.trim().toUpperCase().replace(/-/g, '');
+    if (m === 'TS10' || m === 'HC7')
+        return 'HC7';
+    if (m === 'HC5')
+        return 'HC5';
+    return model.trim();
+}
 export function sessionTypeFromModel(_model) {
     return 'modern';
 }
@@ -80,8 +91,10 @@ export function parseSensorQrJson(text) {
         throw new TempivoSensorError('invalidQr', 'QR is missing PIN.');
     }
     const rawModel = typeof rec.model === 'string' ? rec.model.trim() : '';
-    const model = rawModel || DEFAULT_SENSOR_MODEL;
-    assertSupportedSensorModel(model);
+    const normalized = normalizeQrModelField(rawModel || DEFAULT_SENSOR_MODEL);
+    assertSupportedSensorModel(normalized);
+    const sticker = rawModel.toUpperCase().replace(/-/g, '');
+    const model = sticker === 'TS10' ? 'TS10' : normalized;
     return {
         serial,
         pin,

package/dist/react-native.d.ts

@@ -13,16 +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';
-import * as native from './native-module.js';
-export declare const isNativeSensorBeaconAvailable: typeof native.isNativeSensorBeaconAvailable;
-export declare const requestPermissions: typeof native.requestPermissions;
-export declare const startScan: typeof native.startScan;
-export declare const stopScan: typeof native.stopScan;
-export declare const isScanning: typeof native.isScanning;
-export declare const addDeviceFoundListener: typeof native.addDeviceFoundListener;
-export declare const connect: typeof native.connect;
-export declare const disconnect: typeof native.disconnect;
-export declare const getConfiguration: typeof native.getConfiguration;
-export declare const setConfigurationJson: typeof native.setConfigurationJson;
-export declare const triggerTransmission: typeof native.triggerTransmission;
-export declare const getCalibration: typeof native.getCalibration;
+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,16 +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';
-import * as native from './native-module.js';
-export const isNativeSensorBeaconAvailable = native.isNativeSensorBeaconAvailable;
-export const requestPermissions = native.requestPermissions;
-export const startScan = native.startScan;
-export const stopScan = native.stopScan;
-export const isScanning = native.isScanning;
-export const addDeviceFoundListener = native.addDeviceFoundListener;
-export const connect = native.connect;
-export const disconnect = native.disconnect;
-export const getConfiguration = native.getConfiguration;
-export const setConfigurationJson = native.setConfigurationJson;
-export const triggerTransmission = native.triggerTransmission;
-export const getCalibration = native.getCalibration;
+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: 552a1de0b927f4ad3920434257b884153472c680fa71b3fc3533c7ddf23cc903
+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: 6cc29cf4dc284801eebfc4e1e7eb1afeb789e916e1181a732ed7e577714fd112
+size: 35253832 bytes
+sha256: e861ca361a1210560b37ef321f2a2590a8f634f493a424a50cfd2c4c90b4e401

package/ios/Sources/TempivoSensorBeacon/TempivoSensorQr.swift

@@ -54,6 +54,12 @@ public enum TempivoSensorQrParser {
 
     public static let defaultModel = "HC7"
 
+    public static func normalizeModel(_ model: String) -> String {
+        let m = model.trimmingCharacters(in: .whitespacesAndNewlines).uppercased().replacingOccurrences(of: "-", with: "")
+        if m.isEmpty || m == "HC7" || m == "TS10" { return defaultModel }
+        return model.trimmingCharacters(in: .whitespacesAndNewlines)
+    }
+
     public static func assertSupportedModel(_ model: String) throws {
         let m = model.trimmingCharacters(in: .whitespacesAndNewlines).uppercased().replacingOccurrences(of: "-", with: "")
         if m == "HC5" {
@@ -84,8 +90,8 @@ public enum TempivoSensorQrParser {
         guard !pin.isEmpty else {
             throw TempivoSensorError(.invalidQr, "QR is missing PIN.")
         }
-        let rawModel = (obj["model"] as? String)?.trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
-        let model = rawModel.isEmpty ? defaultModel : rawModel
+        let rawModel = (obj["model"] as? String) ?? ""
+        let model = normalizeModel(rawModel)
         try assertSupportedModel(model)
         let hex = serial.count == 12 ? serial : String(serial.suffix(12))
         let macOverride =

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.5",
+  "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": {
@@ -56,7 +56,7 @@
     "build:ios-bridge": "bash scripts/build-ios-bridge.sh && node scripts/copy-ios-bridge.mjs",
     "copy:ios-bridge": "node scripts/copy-ios-bridge.mjs",
     "build:all": "npm run build:ts && npm run build:android",
-    "prepare": "npm run build:ts",
+    "prepare": "node scripts/prepare-build.mjs",
     "test": "npm run test:all",
     "test:unit": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.config.mjs --testPathIgnorePatterns=ble.integration",
     "test:ble": "TEMPIVO_BLE_INTEGRATION=1 node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.config.mjs --testPathPattern=ble.integration",