@tempivo/sensor-beacon 0.4.7 → 1.1.1

package/CHANGELOG.md

@@ -6,6 +6,19 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.1.1] - 2026-09-03
+
+### Changed
+
+- Partner write min for `measurementIntervalMinutes` is **1** (was 60). Transmission min remains **3600** s.
+
+## [1.1.0] - 2026-09-02
+
+### Changed
+
+- First **1.x** release line (API compatible with 0.4.7 for partners already on that series).
+- README / package description: Node is decode and config helpers only (no BLE radio). Native scan and GATT remain Expo, React Native, Android, and iOS.
+
 ## [0.4.7] - 2026-09-01
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @tempivo/sensor-beacon
 
-BLE for Tempivo sensors. One package for Expo, React Native, Android, iOS, and Node.
+BLE for Tempivo sensors. Native scan + GATT on **Expo / React Native / Android / iOS**. **Node** gets decode and config helpers only (no radio).
 
 ## Expo and React Native
 
@@ -74,7 +74,11 @@ await setConfigurationJson({
     },
   ],
 });
+// 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();
@@ -100,9 +104,11 @@ The Expo config plugin sets **minSdk 26**, Android BLE permissions, and **`NSBlu
 | `addDeviceFoundListener` | Callback per discovered device (includes `telemetry` when decoded). |
 | `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 }`. |
+| `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. |
 
+**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).
+
 ### QR + connect helpers
 
 Shared with the Tempivo app (same sticker JSON, PIN → encryption key, serial match checks):
@@ -250,10 +256,10 @@ Ignored over BLE: `slug`, `name`. Do not pass `alarmRules`.
 
 | Field | Write (`setConfigurationJson`) | Read (`getConfiguration`) |
 |------|--------------------------------|---------------------------|
-| `measurementIntervalMinutes` | 60–600. Omitted: leave device value. | Returns current device value (may be below 60 if set outside the SDK). |
+| `measurementIntervalMinutes` | 1–600. Omitted: leave device value. | Returns current device value. |
 | `transmissionIntervalSeconds` | 3600–604800 (1 h–7 d). Omitted: leave device value. | Returns current device value. |
 
-When **both** are set on write, uplink must be at most **60×** the measurement interval. Example: 60 min sampling → max `3600` s uplink; 120 min → max `7200` s.
+When **both** are set on write, uplink must be at most **60×** the measurement interval. Example: 1 min sampling → max `3600` s uplink; 60 min → max `3600` s; 120 min → max `7200` s.
 
 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`.
 
@@ -372,7 +378,7 @@ AAR after `npm run build:android` (from `packages/tempivo-sensor-beacon`):
 
 Sources: `android-aar/library`. Request `BLUETOOTH_SCAN`, `BLUETOOTH_CONNECT`, and on some OEMs **`ACCESS_FINE_LOCATION`** even on API 31+ (location on older APIs).
 
-**Scan:** temperature and other live values are in scan-response frame **`0x04`** (`telemetry.readings`). Frame **`0x03`** alone fills firmware / battery / cellular but leaves `readings` empty until an active scan delivers `0x04` (usually within a second or two). Keep scanning; do not stop on the first event.
+**Scan:** temperature and other live values are in scan-response frame **`0x04`** (`telemetry.readings`). Frame **`0x03`** alone fills firmware / battery / cellular but leaves `readings` empty until an active scan delivers `0x04` (usually within a second or two). Keep scanning; do not stop on the first event. Regression coverage: `src/scan-telemetry.regression.test.ts`.
 
 ```kotlin
 val qr = TempivoSensorQrParser.parse(stickerQrText)

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

@@ -32,7 +32,7 @@ data class TempivoSensorConfiguration(
 
 object TempivoSensorProfile {
     private val timeRe = Regex("^([01]\\d|2[0-3]):([0-5]\\d)$")
-    private const val MIN_MEASUREMENT_MINUTES = 60.0
+    private const val MIN_MEASUREMENT_MINUTES = 1.0
     private const val MAX_MEASUREMENT_MINUTES = 600.0
     private const val MIN_TRANSMISSION_SECONDS = 3600
     private const val MAX_TRANSMISSION_SECONDS = 604_800
@@ -120,7 +120,7 @@ object TempivoSensorProfile {
                 throw invalid("measurementIntervalMinutes must be a positive number.")
             }
             if (n < MIN_MEASUREMENT_MINUTES) {
-                throw invalid("measurementIntervalMinutes must be at least $MIN_MEASUREMENT_MINUTES (1 hour).")
+                throw invalid("measurementIntervalMinutes must be at least $MIN_MEASUREMENT_MINUTES.")
             }
             if (n > MAX_MEASUREMENT_MINUTES) {
                 throw invalid("measurementIntervalMinutes must be at most $MAX_MEASUREMENT_MINUTES.")

package/dist/profile.d.ts

@@ -2,7 +2,7 @@ import type { TempivoSensorConfiguration } from './session-types.js';
 /** Same default as Cellular API config profiles. */
 export declare const DEFAULT_ALERT_HYSTERESIS_C = 1;
 /** Same limits as Cellular API simple profiles. */
-export declare const BLE_MIN_MEASUREMENT_INTERVAL_MINUTES = 60;
+export declare const BLE_MIN_MEASUREMENT_INTERVAL_MINUTES = 1;
 export declare const BLE_MAX_MEASUREMENT_INTERVAL_MINUTES = 600;
 export declare const BLE_MIN_TRANSMISSION_INTERVAL_SECONDS = 3600;
 export declare const BLE_MAX_TRANSMISSION_INTERVAL_SECONDS = 604800;

package/dist/profile.js

@@ -191,7 +191,7 @@ function rejectWireAlarmRules(rec) {
     }
 }
 /** Same limits as Cellular API simple profiles. */
-export const BLE_MIN_MEASUREMENT_INTERVAL_MINUTES = 60;
+export const BLE_MIN_MEASUREMENT_INTERVAL_MINUTES = 1;
 export const BLE_MAX_MEASUREMENT_INTERVAL_MINUTES = 600;
 export const BLE_MIN_TRANSMISSION_INTERVAL_SECONDS = 3600;
 export const BLE_MAX_TRANSMISSION_INTERVAL_SECONDS = 604_800;
@@ -205,7 +205,7 @@ function parseOptionalIntervals(body, options = {}) {
         }
         if (validatePartnerLimits) {
             if (n < BLE_MIN_MEASUREMENT_INTERVAL_MINUTES) {
-                throw new TempivoSensorError('invalidConfig', `measurementIntervalMinutes must be at least ${BLE_MIN_MEASUREMENT_INTERVAL_MINUTES} (1 hour).`);
+                throw new TempivoSensorError('invalidConfig', `measurementIntervalMinutes must be at least ${BLE_MIN_MEASUREMENT_INTERVAL_MINUTES}.`);
             }
             if (n > BLE_MAX_MEASUREMENT_INTERVAL_MINUTES) {
                 throw new TempivoSensorError('invalidConfig', `measurementIntervalMinutes must be at most ${BLE_MAX_MEASUREMENT_INTERVAL_MINUTES}.`);

package/ios/Sources/TempivoSensorBeacon/TempivoSensorProfile.swift

@@ -90,7 +90,7 @@ public enum TempivoSensorProfile {
         return String(data: data, encoding: .utf8) ?? "{}"
     }
 
-    private static let minMeasurementMinutes: Double = 60
+    private static let minMeasurementMinutes: Double = 1
     private static let maxMeasurementMinutes: Double = 600
     private static let minTransmissionSeconds = 3600
     private static let maxTransmissionSeconds = 604_800
@@ -107,7 +107,7 @@ public enum TempivoSensorProfile {
             }
             if validatePartnerLimits {
                 if n < minMeasurementMinutes {
-                    throw TempivoSensorError(.invalidConfig, "measurementIntervalMinutes must be at least \(Int(minMeasurementMinutes)) (1 hour).")
+                    throw TempivoSensorError(.invalidConfig, "measurementIntervalMinutes must be at least \(Int(minMeasurementMinutes)).")
                 }
                 if n > maxMeasurementMinutes {
                     throw TempivoSensorError(.invalidConfig, "measurementIntervalMinutes must be at most \(Int(maxMeasurementMinutes)).")

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tempivo/sensor-beacon",
-  "version": "0.4.7",
-  "description": "Tempivo sensor BLE SDK for Expo, React Native, Android, iOS, and Node.",
+  "version": "1.1.1",
+  "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": {
     "type": "git",