@tempivo/sensor-beacon 1.1.9 → 1.1.10

package/CHANGELOG.md

@@ -6,11 +6,20 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.1.10] - 2026-10-14
+
+### Added
+
+- `getOperator()`: read preferred PLMN from device config → `'AUTO'`, country ISO (`'SE'`, …), or `null` if custom PLMN is outside the SDK map.
+- `getCellularNetworkStatus().operator`: same code as `getOperator()` (config read in parallel with modem status). Use this to skip `setOperator` when already correct.
+
 ## [1.1.9] - 2026-10-14
 
 ### Changed
 
 - npm package metadata: drop private GitHub `repository` so npmjs.com no longer links Changelog / bugs to an inaccessible repo. Changelog remains in the published package (`CHANGELOG.md`).
+- `setOperator` / `resolveSetOperator`: unknown country ISO → `AUTO` (no silent Sweden `24001` fallback). Invalid shape (not two letters) still throws.
+- `getCellularNetworkStatus` return: one flat object (`label`, `statusLabel`, `operatorName`, `operatorPlmn`, IP/RSSI/…). No nested `status`, no raw `json` string, no `summary` / `tone` / `legacySession`. Docs: scan `telemetry.cellularStatus` (`cell_ok`, …) for coarse modem state without GATT.
 
 ## [1.1.8] - 2026-10-14
 

package/README.md

@@ -113,19 +113,27 @@ The Expo config plugin sets **minSdk 26**, Android BLE permissions, and **`NSBlu
 | `getConfigurationErrors` | Read decoded `configurationErrors` from ProtoConfig (BLE get). Empty list when none. |
 | `triggerTransmission` | Ask firmware to uplink now; returns `{ ok }`. Cloud pending syncs after that uplink (or schedule/button), not from the BLE write alone. |
 | `clearMeasurementQueue` / `deleteMeasurements` | Clear on-device measurement / uplink queue (memory reset). Manual recovery only; not used by `setConfigurationJson`. |
-| `getCellularNetworkStatus` / `getCellularNetworkStatusJson` / `setOperator` | GATT network status with short labels (`label` includes operator when known, plus `statusLabel` / `operatorName` / `summary` / `tone`; `locale`: `en` \| `sv`), raw JSON, PLMN `AUTO` or country ISO (`SE`, …). |
-| `cellularNetworkStatusViewFromJson` (+ related) | Pure label helpers from stored GATT JSON (no radio). |
+| `getCellularNetworkStatus` | GATT read (after `connect`). UI fields + parsed modem fields (`locale`: `en` \| `sv`). Includes `operator` (`'AUTO'` / ISO) from device preferred PLMN. |
+| `getOperator` | Preferred PLMN only (`'AUTO'` / ISO / `null`). Same source as `setOperator`. |
+| `setOperator` | Set preferred PLMN: `'AUTO'` or country ISO (`'SE'`, `'NO'`, …). Unknown ISO → `AUTO`. |
 | `getCalibration` | BLE read of lab calibration. Returns `laboratoryCalibrationDate` (`YYYY-MM-DD`) and unix `laboratoryCalibrationTimestamp` (start of that day). Device has no wall-clock time. Prefer Cellular API in production. |
 
-```ts
-const { label, statusLabel, operatorName, summary, tone } = await getCellularNetworkStatus({
-  locale: 'en',
-});
-// label: "Telia Sweden, Server OK" (operator from GATT rplmn when known)
-// statusLabel: "No server" | "No internet" | "Server OK" | …
-// operatorName: "Telia Sweden" | null
+**Cellular without connect:** scan telemetry already has a coarse modem hint: `telemetry.cellularStatus` = `ble_only` \| `cell_ok` \| `no_server` \| `net_issue` (frame `0x03` bits 6–7). Use that for “looks OK / no server” while scanning. Use `getCellularNetworkStatus` only when you need IP, RSSI, SIM, operator name, etc.
 
-await setOperator('AUTO'); // or 'SE', 'NO', …
+```ts
+// From scan (no GATT):
+device.telemetry?.cellularStatus; // e.g. "cell_ok"
+
+// After connect:
+const s = await getCellularNetworkStatus({ locale: 'en' });
+// s.operator      → "AUTO" | "SE" | … (preferred; same as setOperator)
+// s.operatorName  → "Telia Sweden" (registered network label)
+// s.operatorPlmn  → modem rplmn (telemetry only; do not compare this to setOperator)
+
+// Set operator based on country, or AUTO if cross-country usage.
+// Recommended to set operator country if only one country is used for the session.
+if (s.operator !== 'SE') await setOperator('SE');
+// or: const op = await getOperator();
 ```
 
 **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).

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

@@ -152,6 +152,24 @@ final class SensorBeaconNative {
     }
   }
 
+  Map<String, Object> getOperator() {
+    try {
+      kotlin.Pair<Boolean, Integer> pair = requireSessionConnected().getOperatorBlocking();
+      Map<String, Object> payload = new HashMap<>();
+      boolean automatic = Boolean.TRUE.equals(pair.getFirst());
+      payload.put("automatic", automatic);
+      Integer plmn = pair.getSecond();
+      if (!automatic && plmn != null) {
+        payload.put("plmn", plmn);
+      } else {
+        payload.put("plmn", null);
+      }
+      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

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

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

@@ -183,6 +183,18 @@ internal object SensorBleRuntime {
         session.connection.commands.setConfiguration(next) { }
     }
 
+    /**
+     * Read preferred PLMN from live SensorConfiguration (same source [setOperator] writes).
+     * @return automatic=true for AUTO; otherwise preferred operator code in [plmn].
+     */
+    suspend fun getOperator(session: Session): Pair<Boolean, Int?> {
+        val cfg = modernGetConfiguration(session.connection)
+        return when (val p = cfg.plmn) {
+            null, is Plmn.Automatic -> true to null
+            is Plmn.Custom -> false to p.operatorCode
+        }
+    }
+
     /** Truncate rule slots SDK 2.3 rejects on setConfiguration (>12 rules / >6 calendars). */
     private fun prepareForSetConfiguration(cfg: SensorConfiguration): SensorConfiguration {
         var out = cfg

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

@@ -195,6 +195,14 @@ class TempivoSensorSession(
         }
     }
 
+    /** Preferred PLMN from device config. first=automatic, second=custom code or null. */
+    suspend fun getOperator(): Pair<Boolean, Int?> {
+        return runGatt {
+            ensureSdkConnected()
+            SensorBleRuntime.getOperator(requireSession())
+        }
+    }
+
     suspend fun getCalibration(): TempivoSensorCalibration {
         return runGatt {
             ensureSdkConnected()
@@ -223,6 +231,8 @@ class TempivoSensorSession(
 
     fun setOperatorBlocking(automatic: Boolean, plmn: Int?) = runBlocking { setOperator(automatic, plmn) }
 
+    fun getOperatorBlocking(): Pair<Boolean, Int?> = runBlocking { getOperator() }
+
     fun getCalibrationBlocking(): TempivoSensorCalibration = runBlocking { getCalibration() }
 
     private fun requireSession(): SensorBleRuntime.Session =

package/dist/cellular-network-status.d.ts

@@ -14,34 +14,40 @@ export type TempivoCellularNetworkStatus = {
     simCardStatus: string | null;
     /** Registered / serving PLMN from GATT (`rplmn`). */
     registeredPlmn: number | null;
-    legacySession: boolean;
 };
 export type TempivoCellularStatusLocale = 'en' | 'sv';
+/** Optional UI severity helper (not returned by {@link getCellularNetworkStatus}). */
 export type TempivoCellularStatusTone = 'ok' | 'warn' | 'bad' | 'muted';
+/** Partner-facing GATT cellular status (one object, no nested raw string). */
 export type TempivoCellularNetworkStatusView = {
-    /** Raw JSON from native GATT. */
-    json: string;
-    status: TempivoCellularNetworkStatus | null;
-    /** Registered PLMN from GATT (`rplmn`), when present. */
-    operatorPlmn: number | null;
-    /** Operator name (e.g. Tele2 Sweden), or `PLMN {code}` when unknown. */
-    operatorName: string | null;
-    /**
-     * Short chip label. Status only, or `Operator, status` when PLMN is known
-     * (e.g. Tele2 Sweden, No server).
-     */
+    /** Chip / row: `Operator, status` when PLMN known, else status only. */
     label: string;
-    /** Status without operator (No internet, No server, Server OK). */
+    /** Human status (No SIM, No internet, No server, Server OK, …). */
     statusLabel: string;
-    /** One-line summary for toasts / logs (includes operator when known). */
-    summary: string;
-    tone: TempivoCellularStatusTone;
+    /**
+     * Preferred operator for {@link setOperator}: `'AUTO'`, country ISO (`'SE'`, …), or `null`
+     * when the device has a custom PLMN outside the SDK country map. Filled by
+     * {@link getCellularNetworkStatus} / {@link getOperator} (config read), not from modem `rplmn`.
+     */
+    operator: string | null;
+    /** Operator name from registered PLMN (e.g. Telia Sweden), or null. */
+    operatorName: string | null;
+    /** Registered PLMN from GATT (`rplmn`), or null. */
+    operatorPlmn: number | null;
+    ipAddress: string | null;
+    registrationStatus: string | null;
+    serverCommunicationStatus: string | null;
+    communicationStatus: string | null;
+    signalStrengthDbm: number | null;
+    ecl: 0 | 1 | 2 | null;
+    rsrpDbm: number | null;
+    simCardStatus: string | null;
 };
 export declare function isValidCellularIpAddress(ip: string | null | undefined): boolean;
 export declare function normalizeCellularSignalStrengthDbm(raw: number | null | undefined): number | null;
-export declare function parseCellularNetworkStatusObject(obj: Record<string, unknown>, legacySession?: boolean): TempivoCellularNetworkStatus;
+export declare function parseCellularNetworkStatusObject(obj: Record<string, unknown>): TempivoCellularNetworkStatus;
 /** Parse Gson/SDK JSON from {@link getCellularNetworkStatusJson}. */
-export declare function parseCellularNetworkStatusJson(json: string, legacySession?: boolean): TempivoCellularNetworkStatus | null;
+export declare function parseCellularNetworkStatusJson(json: string): TempivoCellularNetworkStatus | null;
 export declare function isCellularRegistrationOk(status: TempivoCellularNetworkStatus): boolean;
 export declare function isSimCardOk(status: TempivoCellularNetworkStatus): boolean;
 export declare function isCellularServerCommunicationOk(status: TempivoCellularNetworkStatus): boolean;
@@ -64,6 +70,5 @@ export declare function resolveCellularStatusTone(status: TempivoCellularNetwork
 /** Build a partner-ready view from raw GATT JSON (no radio). */
 export declare function cellularNetworkStatusViewFromJson(json: string, opts?: {
     locale?: TempivoCellularStatusLocale;
-    afterServerTrigger?: boolean;
-    legacySession?: boolean;
+    operator?: string | null;
 }): TempivoCellularNetworkStatusView;

package/dist/cellular-network-status.js

@@ -123,7 +123,7 @@ function readPlmnField(obj, key) {
         return Number.parseInt(v.trim(), 10);
     return null;
 }
-export function parseCellularNetworkStatusObject(obj, legacySession = false) {
+export function parseCellularNetworkStatusObject(obj) {
     const signalRaw = readNumberField(obj, 'signalStrength') ?? readNumberField(obj, 'rssi');
     const rsrpRaw = readNumberField(obj, 'rsrp') ?? readNumberField(obj, 'referenceSignalReceivedPower');
     return {
@@ -136,17 +136,16 @@ export function parseCellularNetworkStatusObject(obj, legacySession = false) {
         rsrpDbm: rsrpRaw == null || !Number.isFinite(rsrpRaw) || rsrpRaw === 0 ? null : Math.round(rsrpRaw),
         simCardStatus: readStringField(obj, 'simCardStatus'),
         registeredPlmn: readPlmnField(obj, 'rplmn'),
-        legacySession,
     };
 }
 /** Parse Gson/SDK JSON from {@link getCellularNetworkStatusJson}. */
-export function parseCellularNetworkStatusJson(json, legacySession = false) {
+export function parseCellularNetworkStatusJson(json) {
     const trimmed = json.trim();
     if (!trimmed)
         return null;
     try {
         const obj = JSON.parse(trimmed);
-        return parseCellularNetworkStatusObject(obj, legacySession);
+        return parseCellularNetworkStatusObject(obj);
     }
     catch {
         return null;
@@ -161,11 +160,11 @@ export function isSimCardOk(status) {
     return OK_SIM_CARD_STATUSES.has(status.simCardStatus.trim().toUpperCase());
 }
 export function isCellularServerCommunicationOk(status) {
-    if (status.legacySession) {
-        return status.communicationStatus != null && OK_COMM_STATUSES.has(status.communicationStatus);
-    }
-    return (status.serverCommunicationStatus != null &&
-        OK_COMM_STATUSES.has(status.serverCommunicationStatus));
+    const modern = status.serverCommunicationStatus;
+    if (modern != null && OK_COMM_STATUSES.has(modern))
+        return true;
+    const legacy = status.communicationStatus;
+    return legacy != null && OK_COMM_STATUSES.has(legacy);
 }
 export function isCellularConnectionFullyOk(status) {
     return (isValidCellularIpAddress(status.ipAddress) &&
@@ -174,7 +173,7 @@ export function isCellularConnectionFullyOk(status) {
         isCellularServerCommunicationOk(status));
 }
 function rawServerStatus(status) {
-    const raw = status.legacySession ? status.communicationStatus : status.serverCommunicationStatus;
+    const raw = status.serverCommunicationStatus ?? status.communicationStatus;
     return raw?.trim() ? raw.trim() : null;
 }
 function normalizeCommKey(raw) {
@@ -258,35 +257,45 @@ export function resolveCellularStatusTone(status) {
         return 'bad';
     return 'warn';
 }
+function emptyView(label, operator = null) {
+    return {
+        label,
+        statusLabel: label,
+        operator,
+        operatorName: null,
+        operatorPlmn: null,
+        ipAddress: null,
+        registrationStatus: null,
+        serverCommunicationStatus: null,
+        communicationStatus: null,
+        signalStrengthDbm: null,
+        ecl: null,
+        rsrpDbm: null,
+        simCardStatus: null,
+    };
+}
 /** Build a partner-ready view from raw GATT JSON (no radio). */
 export function cellularNetworkStatusViewFromJson(json, opts) {
     const locale = opts?.locale ?? 'en';
+    const operator = opts?.operator ?? null;
     const L = labelsFor(locale);
-    const status = parseCellularNetworkStatusJson(json, opts?.legacySession === true);
-    if (!status) {
-        return {
-            json,
-            status: null,
-            operatorPlmn: null,
-            operatorName: null,
-            label: L.unavailable,
-            statusLabel: L.unavailable,
-            summary: L.unavailable,
-            tone: 'muted',
-        };
-    }
+    const status = parseCellularNetworkStatusJson(json);
+    if (!status)
+        return emptyView(L.unavailable, operator);
     const statusLabel = formatCellularNetworkStatusLabel(status, locale);
     return {
-        json,
-        status,
-        operatorPlmn: status.registeredPlmn,
-        operatorName: getOperatorNameFromPlmn(status.registeredPlmn),
         label: formatCellularNetworkStatusLabelWithOperator(status, locale),
         statusLabel,
-        summary: formatCellularNetworkStatusSummary(status, {
-            locale,
-            afterServerTrigger: opts?.afterServerTrigger,
-        }),
-        tone: resolveCellularStatusTone(status),
+        operator,
+        operatorName: getOperatorNameFromPlmn(status.registeredPlmn),
+        operatorPlmn: status.registeredPlmn,
+        ipAddress: status.ipAddress,
+        registrationStatus: status.registrationStatus,
+        serverCommunicationStatus: status.serverCommunicationStatus,
+        communicationStatus: status.communicationStatus,
+        signalStrengthDbm: status.signalStrengthDbm,
+        ecl: status.ecl,
+        rsrpDbm: status.rsrpDbm,
+        simCardStatus: status.simCardStatus,
     };
 }

package/dist/index.d.ts

@@ -16,10 +16,10 @@ export type { ProbeCapabilitySource } from './channel-capability.js';
 export { configurationErrorsFromProtoConfig, decodeConfigurationError, decodeConfigurationErrorCodes, formatConfigurationErrorTimestamp, } from './config-errors.js';
 export type { TempivoConfigErrorParameter, TempivoConfigErrorSide, TempivoConfigErrorValue, TempivoConfigurationError, TempivoConfigurationErrors, } from './config-errors.js';
 export type { TempivoSchedule, TempivoScheduleAlways, TempivoScheduleWeek, TempivoSensorCalibration, TempivoSensorConfiguration, TempivoSensorQr, TempivoSensorSessionType, TempivoTemperatureAlert, TempivoTemperatureChannel, TempivoTemperatureMaxAlert, TempivoTemperatureMinAlert, TempivoTemperatureRangeAlert, TempivoTriggerTransmissionResult, } from './session-types.js';
-export { addDeviceFoundListener, connect, clearMeasurementQueue, deleteMeasurements, disconnect, getCalibration, getCellularNetworkStatus, getCellularNetworkStatusJson, getConfiguration, getConfigurationErrors, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, setOperator, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
+export { addDeviceFoundListener, connect, clearMeasurementQueue, deleteMeasurements, disconnect, getCalibration, getCellularNetworkStatus, getCellularNetworkStatusJson, getConfiguration, getConfigurationErrors, getOperator, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, setOperator, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
 export { cellularNetworkStatusViewFromJson, formatCellularNetworkStatusLabel, formatCellularNetworkStatusLabelWithOperator, formatCellularNetworkStatusSummary, formatCellularServerDetailLabel, isCellularConnectionFullyOk, isCellularRegistrationOk, isCellularServerCommunicationOk, isSimCardOk, isValidCellularIpAddress, normalizeCellularSignalStrengthDbm, parseCellularNetworkStatusJson, parseCellularNetworkStatusObject, resolveCellularStatusTone, } from './cellular-network-status.js';
 export type { TempivoCellularNetworkStatus, TempivoCellularNetworkStatusView, TempivoCellularStatusLocale, TempivoCellularStatusTone, } from './cellular-network-status.js';
-export { PREFERRED_PLMN_BY_COUNTRY_ISO2, PREFERRED_PLMN_FALLBACK, normalizeCountryIso2, resolveSetOperator, } from './plmn-by-country.js';
+export { PREFERRED_PLMN_BY_COUNTRY_ISO2, normalizeCountryIso2, resolveOperatorFromPreferredPlmn, resolveSetOperator, } from './plmn-by-country.js';
 export type { SetOperatorArg } from './plmn-by-country.js';
 export { getOperatorNameFromPlmn, PLMN_OPERATOR_LABELS } from './plmn-labels.js';
 export type { TempivoPlmnOperatorOption } from './plmn-labels.js';

package/dist/index.js

@@ -11,8 +11,8 @@ export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, form
 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 { PROBE_CHANNEL_INDEX_0, alertsRequireProbe, assertProbeAlertsAllowed, channelTypesFromProtoConfig, deviceSupportsProbeFromBeaconReadings, deviceSupportsProbeFromChannelTypes, isTemperatureReadingType, resolveProbeSupported, } from './channel-capability.js';
 export { configurationErrorsFromProtoConfig, decodeConfigurationError, decodeConfigurationErrorCodes, formatConfigurationErrorTimestamp, } from './config-errors.js';
-export { addDeviceFoundListener, connect, clearMeasurementQueue, deleteMeasurements, disconnect, getCalibration, getCellularNetworkStatus, getCellularNetworkStatusJson, getConfiguration, getConfigurationErrors, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, setOperator, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
+export { addDeviceFoundListener, connect, clearMeasurementQueue, deleteMeasurements, disconnect, getCalibration, getCellularNetworkStatus, getCellularNetworkStatusJson, getConfiguration, getConfigurationErrors, getOperator, getProtoConfiguration, isNativeSensorBeaconAvailable, isScanning, requestPermissions, setConfigurationJson, setOperator, startScan, stopScan, triggerTransmission, } from './native-bridge.js';
 export { cellularNetworkStatusViewFromJson, formatCellularNetworkStatusLabel, formatCellularNetworkStatusLabelWithOperator, formatCellularNetworkStatusSummary, formatCellularServerDetailLabel, isCellularConnectionFullyOk, isCellularRegistrationOk, isCellularServerCommunicationOk, isSimCardOk, isValidCellularIpAddress, normalizeCellularSignalStrengthDbm, parseCellularNetworkStatusJson, parseCellularNetworkStatusObject, resolveCellularStatusTone, } from './cellular-network-status.js';
-export { PREFERRED_PLMN_BY_COUNTRY_ISO2, PREFERRED_PLMN_FALLBACK, normalizeCountryIso2, resolveSetOperator, } from './plmn-by-country.js';
+export { PREFERRED_PLMN_BY_COUNTRY_ISO2, normalizeCountryIso2, resolveOperatorFromPreferredPlmn, resolveSetOperator, } from './plmn-by-country.js';
 export { getOperatorNameFromPlmn, PLMN_OPERATOR_LABELS } from './plmn-labels.js';
 export { checkProductionDefaults } from './production-defaults.js';

package/dist/native-bridge.d.ts

@@ -20,9 +20,9 @@ export declare function deleteMeasurements(): Promise<{
     ok: boolean;
 }>;
 export declare function getCellularNetworkStatusJson(): Promise<string>;
+export declare function getOperator(): Promise<string | null>;
 export declare function getCellularNetworkStatus(opts?: {
     locale?: TempivoCellularStatusLocale;
-    afterServerTrigger?: boolean;
 }): Promise<TempivoCellularNetworkStatusView>;
 export declare function setOperator(countryOrAuto: string): Promise<void>;
 export declare function getCalibration(): Promise<TempivoNativeCalibration>;

package/dist/native-bridge.js

@@ -57,9 +57,16 @@ export async function deleteMeasurements() {
 export async function getCellularNetworkStatusJson() {
     return (await loadNative()).getCellularNetworkStatusJson();
 }
+export async function getOperator() {
+    return (await loadNative()).getOperator();
+}
 export async function getCellularNetworkStatus(opts) {
-    const json = await getCellularNetworkStatusJson();
-    return cellularNetworkStatusViewFromJson(json, opts);
+    const native = await loadNative();
+    const [json, operator] = await Promise.all([
+        native.getCellularNetworkStatusJson(),
+        native.getOperator().catch(() => null),
+    ]);
+    return cellularNetworkStatusViewFromJson(json, { ...opts, operator });
 }
 export async function setOperator(countryOrAuto) {
     return (await loadNative()).setOperator(countryOrAuto);

package/dist/native-module.d.ts

@@ -39,9 +39,16 @@ export declare function deleteMeasurements(): Promise<{
 export declare function getCellularNetworkStatusJson(): Promise<string>;
 /**
  * Set PLMN AUTO or preferred operator for a country ISO (`SE`, `NO`, …).
+ * Unsupported / unknown ISO → AUTO (no silent Sweden PLMN).
  * Native merges PLMN into getConfiguration (sanitized). Avoids raw ProtoConfig write.
  */
 export declare function setOperator(countryOrAuto: string): Promise<void>;
+/**
+ * Read preferred PLMN mode from device config (same field {@link setOperator} writes).
+ * Returns `'AUTO'`, a country ISO from the SDK map (`'SE'`, …), or `null` when the device
+ * has a custom PLMN outside that map.
+ */
+export declare function getOperator(): Promise<string | null>;
 /** Decoded device ProtoConfig (server, APN, intervals). Requires an open BLE session. */
 export declare function getProtoConfiguration(): Promise<ProtoConfigObject>;
 /**

package/dist/native-module.js

@@ -3,6 +3,7 @@ import { normalizeLaboratoryCalibration, } from './calibration.js';
 import { configurationErrorsFromProtoConfig, } from './config-errors.js';
 import { TempivoSensorError } from './errors.js';
 import { configToJson, mapNativeError, qrToConnectJson } from './native-helpers.js';
+import { resolveOperatorFromPreferredPlmn } from './plmn-by-country.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';
@@ -194,7 +195,10 @@ export async function getCellularNetworkStatusJson() {
         throw mapNativeError(error);
     }
 }
-/** Preferred PLMN map (keep in sync with `plmn-by-country.ts`). Inlined for Metro file: links. */
+/**
+ * Preferred PLMN map (keep in sync with `plmn-by-country.ts`). Inlined for Metro file: links.
+ * Unknown ISO → AUTO (same as {@link resolveSetOperator}).
+ */
 const PREFERRED_PLMN_BY_COUNTRY_ISO2 = {
     SE: 24001,
     NO: 24201,
@@ -209,18 +213,26 @@ const PREFERRED_PLMN_BY_COUNTRY_ISO2 = {
 };
 /**
  * Set PLMN AUTO or preferred operator for a country ISO (`SE`, `NO`, …).
+ * Unsupported / unknown ISO → AUTO (no silent Sweden PLMN).
  * Native merges PLMN into getConfiguration (sanitized). Avoids raw ProtoConfig write.
  */
 export async function setOperator(countryOrAuto) {
     const raw = String(countryOrAuto ?? '').trim();
-    const automatic = !raw || raw.toUpperCase() === 'AUTO';
+    let automatic = !raw || raw.toUpperCase() === 'AUTO';
     let plmn = null;
     if (!automatic) {
         const iso = raw.toUpperCase();
         if (!/^[A-Z]{2}$/.test(iso)) {
-            throw new TempivoSensorError('unknown', `Invalid country ISO: ${raw}`);
+            throw new TempivoSensorError('invalidConfig', `Invalid country ISO: ${raw}`);
+        }
+        const mapped = PREFERRED_PLMN_BY_COUNTRY_ISO2[iso];
+        if (mapped == null) {
+            automatic = true;
+            plmn = null;
+        }
+        else {
+            plmn = mapped;
         }
-        plmn = PREFERRED_PLMN_BY_COUNTRY_ISO2[iso] ?? 24001;
     }
     try {
         const native = getNative();
@@ -233,6 +245,26 @@ export async function setOperator(countryOrAuto) {
         throw mapNativeError(error);
     }
 }
+/**
+ * Read preferred PLMN mode from device config (same field {@link setOperator} writes).
+ * Returns `'AUTO'`, a country ISO from the SDK map (`'SE'`, …), or `null` when the device
+ * has a custom PLMN outside that map.
+ */
+export async function getOperator() {
+    try {
+        const native = getNative();
+        if (typeof native.getOperator !== 'function') {
+            throw new TempivoSensorError('runtimeUnavailable', 'Native getOperator is unavailable in this build.');
+        }
+        const raw = await withTimeout(native.getOperator(), 45_000, 'getOperator');
+        const automatic = raw?.automatic !== false;
+        const plmn = raw?.plmn == null || raw.plmn === undefined ? null : Number(raw.plmn);
+        return resolveOperatorFromPreferredPlmn(automatic || plmn == null || !Number.isFinite(plmn), Number.isFinite(plmn) ? plmn : null);
+    }
+    catch (error) {
+        throw mapNativeError(error);
+    }
+}
 function withTimeout(promise, ms, label) {
     return new Promise((resolve, reject) => {
         const id = setTimeout(() => {

package/dist/plmn-by-country.d.ts

@@ -3,12 +3,21 @@
  * Keep in sync with app `src/lib/default-plmn-by-country.ts`.
  */
 export declare const PREFERRED_PLMN_BY_COUNTRY_ISO2: Record<string, number>;
-export declare const PREFERRED_PLMN_FALLBACK = 24001;
 export declare function normalizeCountryIso2(code: string | null | undefined): string | null;
 /** `AUTO` or ISO2 → PLMN mode for BLE. */
 export type SetOperatorArg = 'AUTO' | string;
+/**
+ * Resolve `setOperator` arg.
+ * Unknown / unsupported country ISO → `AUTO` (never invent a default PLMN).
+ * Invalid shape (not empty, not AUTO, not two letters) → throws.
+ */
 export declare function resolveSetOperator(arg: SetOperatorArg): {
     mode: 'AUTO' | 'VALUE';
     plmn?: number;
     countryIso?: string;
 };
+/**
+ * Map device preferred PLMN (from config) to a {@link setOperator} arg.
+ * Automatic / missing → `AUTO`. Known preferred PLMN → ISO2. Other custom PLMN → `null`.
+ */
+export declare function resolveOperatorFromPreferredPlmn(automatic: boolean, plmn: number | null | undefined): string | null;

package/dist/plmn-by-country.js

@@ -14,7 +14,6 @@ export const PREFERRED_PLMN_BY_COUNTRY_ISO2 = {
     IT: 22201,
     ES: 21401,
 };
-export const PREFERRED_PLMN_FALLBACK = 24001;
 export function normalizeCountryIso2(code) {
     if (code == null || typeof code !== 'string')
         return null;
@@ -23,6 +22,11 @@ export function normalizeCountryIso2(code) {
         return null;
     return t;
 }
+/**
+ * Resolve `setOperator` arg.
+ * Unknown / unsupported country ISO → `AUTO` (never invent a default PLMN).
+ * Invalid shape (not empty, not AUTO, not two letters) → throws.
+ */
 export function resolveSetOperator(arg) {
     const raw = String(arg ?? '').trim();
     if (!raw || raw.toUpperCase() === 'AUTO')
@@ -30,6 +34,29 @@ export function resolveSetOperator(arg) {
     const iso = normalizeCountryIso2(raw);
     if (!iso)
         throw new Error(`Invalid country ISO: ${raw}`);
-    const plmn = PREFERRED_PLMN_BY_COUNTRY_ISO2[iso] ?? PREFERRED_PLMN_FALLBACK;
+    const plmn = PREFERRED_PLMN_BY_COUNTRY_ISO2[iso];
+    if (plmn == null)
+        return { mode: 'AUTO' };
     return { mode: 'VALUE', plmn, countryIso: iso };
 }
+/** Reverse of {@link PREFERRED_PLMN_BY_COUNTRY_ISO2} (first ISO wins when several share a PLMN). */
+const COUNTRY_ISO2_BY_PREFERRED_PLMN = (() => {
+    const out = {};
+    for (const [iso, plmn] of Object.entries(PREFERRED_PLMN_BY_COUNTRY_ISO2)) {
+        if (out[plmn] == null)
+            out[plmn] = iso;
+    }
+    return out;
+})();
+/**
+ * Map device preferred PLMN (from config) to a {@link setOperator} arg.
+ * Automatic / missing → `AUTO`. Known preferred PLMN → ISO2. Other custom PLMN → `null`.
+ */
+export function resolveOperatorFromPreferredPlmn(automatic, plmn) {
+    if (automatic || plmn == null)
+        return 'AUTO';
+    const n = Number(plmn);
+    if (!Number.isFinite(n))
+        return null;
+    return COUNTRY_ISO2_BY_PREFERRED_PLMN[n] ?? null;
+}

package/dist/react-native.d.ts

@@ -13,22 +13,22 @@ export { calibrationFromExtendedJson, decodeLaboratoryCalibrationTimestamp, form
 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 { getCellularNetworkStatusJson as getCellularNetworkStatusJsonNative, deleteMeasurements as deleteMeasurementsNative, setOperator as setOperatorNative, isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration } from './native-module.js';
+import { getCellularNetworkStatusJson as getCellularNetworkStatusJsonNative, getOperator as getOperatorNative, deleteMeasurements as deleteMeasurementsNative, setOperator as setOperatorNative, isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration } from './native-module.js';
 import { type TempivoCellularNetworkStatusView, type TempivoCellularStatusLocale } from './cellular-network-status.js';
 export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, };
 /** Raw GATT JSON (no label formatting). */
 export declare const getCellularNetworkStatusJson: typeof getCellularNetworkStatusJsonNative;
 export declare const deleteMeasurements: typeof deleteMeasurementsNative;
 export declare const setOperator: typeof setOperatorNative;
+export declare const getOperator: typeof getOperatorNative;
 /**
- * GATT cellular status with short partner labels.
+ * GATT cellular status with short partner labels + preferred `operator` (`AUTO` / ISO).
  * Composed here (static imports) so Metro file: links do not dynamic-import label helpers.
  */
 export declare function getCellularNetworkStatus(opts?: {
     locale?: TempivoCellularStatusLocale;
-    afterServerTrigger?: boolean;
 }): Promise<TempivoCellularNetworkStatusView>;
-export { PREFERRED_PLMN_BY_COUNTRY_ISO2, resolveSetOperator, } from './plmn-by-country.js';
+export { PREFERRED_PLMN_BY_COUNTRY_ISO2, resolveOperatorFromPreferredPlmn, resolveSetOperator, } from './plmn-by-country.js';
 export { cellularNetworkStatusViewFromJson, formatCellularNetworkStatusLabel, formatCellularNetworkStatusLabelWithOperator, formatCellularNetworkStatusSummary, formatCellularServerDetailLabel, isCellularConnectionFullyOk, isCellularRegistrationOk, isCellularServerCommunicationOk, isSimCardOk, isValidCellularIpAddress, normalizeCellularSignalStrengthDbm, parseCellularNetworkStatusJson, parseCellularNetworkStatusObject, resolveCellularStatusTone, } from './cellular-network-status.js';
 export type { TempivoCellularNetworkStatus, TempivoCellularNetworkStatusView, TempivoCellularStatusLocale, TempivoCellularStatusTone, } from './cellular-network-status.js';
 export { getOperatorNameFromPlmn, PLMN_OPERATOR_LABELS } from './plmn-labels.js';

package/dist/react-native.js

@@ -9,22 +9,26 @@ 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, formatLaboratoryCalibration, normalizeLaboratoryCalibration, } 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 { getCellularNetworkStatusJson as getCellularNetworkStatusJsonNative, deleteMeasurements as deleteMeasurementsNative, setOperator as setOperatorNative, isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, } from './native-module.js';
+import { getCellularNetworkStatusJson as getCellularNetworkStatusJsonNative, getOperator as getOperatorNative, deleteMeasurements as deleteMeasurementsNative, setOperator as setOperatorNative, isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, } from './native-module.js';
 import { cellularNetworkStatusViewFromJson, } from './cellular-network-status.js';
 export { isNativeSensorBeaconAvailable, requestPermissions, startScan, stopScan, isScanning, addDeviceFoundListener, connect, disconnect, getConfiguration, getConfigurationErrors, setConfigurationJson, triggerTransmission, clearMeasurementQueue, getCalibration, getProtoConfiguration, };
 /** Raw GATT JSON (no label formatting). */
 export const getCellularNetworkStatusJson = getCellularNetworkStatusJsonNative;
 export const deleteMeasurements = deleteMeasurementsNative;
 export const setOperator = setOperatorNative;
+export const getOperator = getOperatorNative;
 /**
- * GATT cellular status with short partner labels.
+ * GATT cellular status with short partner labels + preferred `operator` (`AUTO` / ISO).
  * Composed here (static imports) so Metro file: links do not dynamic-import label helpers.
  */
 export async function getCellularNetworkStatus(opts) {
-    const json = await getCellularNetworkStatusJsonNative();
-    return cellularNetworkStatusViewFromJson(json, opts);
+    const [json, operator] = await Promise.all([
+        getCellularNetworkStatusJsonNative(),
+        getOperatorNative().catch(() => null),
+    ]);
+    return cellularNetworkStatusViewFromJson(json, { ...opts, operator });
 }
-export { PREFERRED_PLMN_BY_COUNTRY_ISO2, resolveSetOperator, } from './plmn-by-country.js';
+export { PREFERRED_PLMN_BY_COUNTRY_ISO2, resolveOperatorFromPreferredPlmn, resolveSetOperator, } from './plmn-by-country.js';
 export { cellularNetworkStatusViewFromJson, formatCellularNetworkStatusLabel, formatCellularNetworkStatusLabelWithOperator, formatCellularNetworkStatusSummary, formatCellularServerDetailLabel, isCellularConnectionFullyOk, isCellularRegistrationOk, isCellularServerCommunicationOk, isSimCardOk, isValidCellularIpAddress, normalizeCellularSignalStrengthDbm, parseCellularNetworkStatusJson, parseCellularNetworkStatusObject, resolveCellularStatusTone, } from './cellular-network-status.js';
 export { getOperatorNameFromPlmn, PLMN_OPERATOR_LABELS } from './plmn-labels.js';
 export { configurationErrorsFromProtoConfig, decodeConfigurationError, decodeConfigurationErrorCodes, formatConfigurationErrorTimestamp, } from './config-errors.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempivo/sensor-beacon",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "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",
   "author": "Tempivo",