react-native-nitro-compass 1.1.0 → 1.2.0

package/ios/HybridNitroCompass.swift

@@ -43,6 +43,18 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     return q
   }()
   private var lastInterference: Bool?
+  // Most recent calibrated magnetic-field magnitude (µT). Surfaced on
+  // every CompassSample so consumers can render a strength meter; -1
+  // until CMDeviceMotion produces its first calibrated reading.
+  private var lastFieldUt: Double = -1
+  // Counter of consecutive non-uncalibrated motion samples. CoreMotion's
+  // bias estimate takes a second or two of normal motion to converge
+  // after subscribe; emitting interference transitions before then
+  // produces false positives because the early "calibrated" field is
+  // dominated by the device's own internal bias. Wait for N stable
+  // samples before trusting the magnitude reading.
+  private var motionStableSampleCount: Int = 0
+  private static let motionStableSampleThreshold: Int = 5
   private var pauseOnBackground: Bool = true
   private var started: Bool = false
   private var isSubscribed: Bool = false
@@ -59,7 +71,10 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     super.init()
     let setup = {
       let m = CLLocationManager()
-      m.headingFilter = 1
+      // headingFilter is overwritten by subscribe() each start(); the
+      // init value is only relevant if a caller queried headingFilter
+      // before start, which nothing does. Pick the default that matches
+      // activeFilterDegrees so a stray query is consistent.
       m.desiredAccuracy = kCLLocationAccuracyNearestTenMeters
       self.manager = m
     }
@@ -193,6 +208,25 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     return SensorDiagnostics(sensor: .corelocation)
   }
 
+  // iOS lets CLLocationManager handle the gyro+mag fusion + bias
+  // estimation internally, so most of the Android-side debug fields
+  // have no analogue on this side. We surface the two we *can*
+  // observe (current interference state, last field strength) and
+  // report sentinel "n/a" values for the rest, matching the iOS
+  // notes in the DebugInfo doc.
+  func getDebugInfo() throws -> DebugInfo {
+    return DebugInfo(
+      interferenceActive: lastInterference == true,
+      msSinceLastBiasJump: -1,
+      expectedFieldMicroTesla: -1,
+      lastFieldMicroTesla: lastFieldUt,
+      fusedYawDeg: Double.nan,
+      lastYawRateDegPerS: 0,
+      hasGameRotationVector: false,
+      usingUncalibratedMag: false
+    )
+  }
+
   func getCurrentHeading() throws -> CompassSample? {
     return lastSample
   }
@@ -201,8 +235,18 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     declinationDeg = degrees
   }
 
+  // No-op on iOS — `CLLocationManager` already uses GPS-derived location
+  // internally for all field-related reasoning (true-north, declination,
+  // expected field strength). Layering our own lookup on top would be
+  // redundant. Provided for cross-platform JS callers.
+  func setLocation(latitude: Double, longitude: Double) throws {}
+
   func setOnCalibrationNeeded(onChange: @escaping (_ quality: AccuracyQuality) -> Void) throws {
     calibrationCb = onChange
+    // Replay current bucket so a late-registering consumer sees the
+    // truth instead of waiting for the next transition. Mirrors the
+    // setOnInterferenceDetected behavior.
+    if let last = lastQuality { onChange(last) }
   }
 
   func setOnInterferenceDetected(onChange: @escaping (_ interferenceDetected: Bool) -> Void) throws {
@@ -222,6 +266,30 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     }
   }
 
+  func recalibrate() throws {
+    // Stop/start the heading subscription and reset every cached
+    // signal. Apple's CLLocationManager handles soft/hard-iron
+    // calibration internally — the recovery itself still requires the
+    // user to move the device through varying orientations — but
+    // dropping our own cached state ensures the next callback isn't
+    // suppressed by stale `lastQuality` / `lastInterference`
+    // comparisons, and dismisses any pending heading-calibration
+    // overlay so the consumer can prompt fresh.
+    guard started else { return }
+    // dismissHeadingCalibrationDisplay touches UIKit-adjacent state and
+    // must run on main. recalibrate() may be called from the JS thread.
+    DispatchQueue.main.async { [weak self] in
+      self?.manager.dismissHeadingCalibrationDisplay()
+    }
+    let wasSubscribed = isSubscribed
+    if wasSubscribed { unsubscribe() }
+    lastSample = nil
+    lastQuality = nil
+    lastInterference = nil
+    lastFieldUt = -1
+    if wasSubscribed { subscribe() }
+  }
+
   func getPermissionStatus() throws -> PermissionStatus {
     return Self.mapAuthStatus(manager.authorizationStatus)
   }
@@ -296,12 +364,28 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     guard motionManager.isDeviceMotionAvailable,
           !motionManager.isDeviceMotionActive else { return }
     motionManager.deviceMotionUpdateInterval = 0.2 // 5Hz
+    motionStableSampleCount = 0
     motionManager.startDeviceMotionUpdates(to: motionQueue) { [weak self] motion, _ in
       guard let self = self, let m = motion else { return }
       let cal = m.magneticField
-      if cal.accuracy == .uncalibrated { return }
+      if cal.accuracy == .uncalibrated {
+        // Bias estimate not yet usable. Reset stability counter so the
+        // post-convergence count starts fresh.
+        self.motionStableSampleCount = 0
+        return
+      }
       let f = cal.field
       let magnitude = sqrt(f.x * f.x + f.y * f.y + f.z * f.z)
+      self.lastFieldUt = magnitude
+
+      // Wait for N consecutive non-uncalibrated samples before letting
+      // magnitude drive interference transitions. Without this, the
+      // first second post-subscribe routinely fires false positives
+      // because the bias estimate hasn't converged yet.
+      if self.motionStableSampleCount < Self.motionStableSampleThreshold {
+        self.motionStableSampleCount += 1
+        return
+      }
       self.evaluateInterference(magnitude: magnitude)
     }
   }
@@ -310,6 +394,7 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     if motionManager.isDeviceMotionActive {
       motionManager.stopDeviceMotionUpdates()
     }
+    motionStableSampleCount = 0
   }
 
   private func evaluateInterference(magnitude: Double) {
@@ -359,13 +444,18 @@ class HybridNitroCompass: HybridNitroCompassSpec {
     lastSample = nil
     lastQuality = nil
     lastInterference = nil
+    lastFieldUt = -1
   }
 
   private func deliver(heading magnetic: Double, accuracy: Double) {
     var heading = magnetic + declinationDeg
     heading = heading.truncatingRemainder(dividingBy: 360)
     if heading < 0 { heading += 360 }
-    let sample = CompassSample(heading: heading, accuracy: accuracy)
+    let sample = CompassSample(
+      heading: heading,
+      accuracy: accuracy,
+      fieldStrengthMicroTesla: lastFieldUt
+    )
     lastSample = sample
 
     // CLLocationManager.headingAccuracy is conservative — even a
@@ -397,6 +487,19 @@ class HybridNitroCompass: HybridNitroCompassSpec {
   }
 
   private func applyHeadingOrientation() {
+    // Prefer device orientation for face-up / face-down — those don't
+    // appear in interfaceOrientation but matter for headings on tablets
+    // held flat. Fall back to interfaceOrientation for the standard
+    // four cases (which respects app rotation locks).
+    let device = UIDevice.current.orientation
+    if device == .faceUp {
+      manager.headingOrientation = .faceUp
+      return
+    }
+    if device == .faceDown {
+      manager.headingOrientation = .faceDown
+      return
+    }
     let scene = UIApplication.shared.connectedScenes
       .compactMap { $0 as? UIWindowScene }
       .first

package/lib/commonjs/hook.js

@@ -25,14 +25,40 @@ function useCompass(options = {}) {
   const [reading, setReading] = (0, _react.useState)(null);
   const [quality, setQuality] = (0, _react.useState)(null);
   const [interfering, setInterfering] = (0, _react.useState)(false);
-  const [hasCompass] = (0, _react.useState)(() => _native.NitroCompass.hasCompass());
-  const [diagnostics] = (0, _react.useState)(() => _native.NitroCompass.getDiagnostics());
 
-  // Tracked via ref so the heading-subscription effect can re-apply
-  // the user's filter after a stop/start cycle without restarting on
-  // every filterDegrees change.
+  // Wrap in try/catch so a missing/misconfigured native module doesn't
+  // throw during render — return safe defaults and let the host UI
+  // surface "no compass". Without this, the throw bubbles up and
+  // becomes a render error that blanks the screen.
+  const [hasCompass] = (0, _react.useState)(() => {
+    try {
+      return _native.NitroCompass.hasCompass();
+    } catch {
+      return false;
+    }
+  });
+  const [diagnostics] = (0, _react.useState)(() => {
+    try {
+      return _native.NitroCompass.getDiagnostics();
+    } catch {
+      return undefined;
+    }
+  });
+  const [permission, setPermission] = (0, _react.useState)(() => {
+    try {
+      return _native.NitroCompass.getPermissionStatus();
+    } catch {
+      return 'unknown';
+    }
+  });
+
+  // Tracked via refs so the heading-subscription effect can re-apply
+  // the user's filter and smoothing after a stop/start cycle without
+  // restarting on every option change.
   const filterRef = (0, _react.useRef)(filterDegrees);
   filterRef.current = filterDegrees;
+  const smoothingRef = (0, _react.useRef)(smoothingAlpha);
+  smoothingRef.current = smoothingAlpha;
   (0, _react.useEffect)(() => {
     _native.NitroCompass.setFilter(filterDegrees);
   }, [filterDegrees]);
@@ -54,20 +80,81 @@ function useCompass(options = {}) {
     return (0, _multiplex.addInterferenceListener)(setInterfering);
   }, [hasCompass]);
   (0, _react.useEffect)(() => {
-    if (!hasCompass || !enabled) return;
-    const off = (0, _multiplex.addHeadingListener)(setReading);
-    // Multiplex starts the sensor with a default filter; re-apply the
-    // current option after subscribing.
-    _native.NitroCompass.setFilter(filterRef.current);
+    if (!hasCompass || !enabled) {
+      // When the user disables the hook, clear stale UI state.
+      // Without this, `reading` / `interfering` keep their last value
+      // forever, so the consumer's UI can't tell "subscription is off"
+      // from "compass is currently quiet".
+      setReading(null);
+      setInterfering(false);
+      return;
+    }
+    let off;
+    try {
+      off = (0, _multiplex.addHeadingListener)(setReading);
+      // Multiplex starts the sensor with a default filter; re-apply
+      // the current options after subscribing. recalibrate() can also
+      // reset native smoothing state, so we pin our chosen alpha back
+      // here as well.
+      _native.NitroCompass.setFilter(filterRef.current);
+      _native.NitroCompass.setSmoothing(smoothingRef.current);
+    } catch (e) {
+      // start() throws on iOS when location authorization is denied.
+      // Swallow it here so the hook tree doesn't unmount; consumers
+      // should call NitroCompass.requestPermission() explicitly before
+      // setting enabled=true if they want to recover.
+      // eslint-disable-next-line no-console
+      console.warn('[NitroCompass] failed to start heading subscription:', e);
+    }
     return off;
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [hasCompass, enabled]);
+
+  // Stable callbacks so consumers' useEffect deps don't churn on every
+  // render. All four are thin wrappers around NitroCompass; the hook's
+  // own state isn't reactive to recalibrate/setLocation since neither
+  // changes any field returned here.
+  const getCurrentHeading = (0, _react.useCallback)(() => {
+    try {
+      return _native.NitroCompass.getCurrentHeading();
+    } catch {
+      return undefined;
+    }
+  }, []);
+  const recalibrate = (0, _react.useCallback)(() => {
+    try {
+      _native.NitroCompass.recalibrate();
+    } catch {
+      // Native missing — nothing to do.
+    }
+  }, []);
+  const setLocation = (0, _react.useCallback)((latitude, longitude) => {
+    try {
+      _native.NitroCompass.setLocation(latitude, longitude);
+    } catch {
+      // Native missing — silently ignored.
+    }
+  }, []);
+  const requestPermission = (0, _react.useCallback)(async () => {
+    try {
+      const status = await _native.NitroCompass.requestPermission();
+      setPermission(status);
+      return status;
+    } catch {
+      return 'denied';
+    }
+  }, []);
   return {
     reading,
     quality,
     interfering,
     hasCompass,
-    diagnostics
+    diagnostics,
+    permission,
+    getCurrentHeading,
+    recalibrate,
+    setLocation,
+    requestPermission
   };
 }
 //# sourceMappingURL=hook.js.map

package/lib/commonjs/hook.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_native","_multiplex","useCompass","options","filterDegrees","smoothingAlpha","declination","pauseOnBackground","enabled","reading","setReading","useState","quality","setQuality","interfering","setInterfering","hasCompass","NitroCompass","diagnostics","getDiagnostics","filterRef","useRef","current","useEffect","setFilter","setSmoothing","setDeclination","setPauseOnBackground","addCalibrationListener","addInterferenceListener","off","addHeadingListener"],"sourceRoot":"../../src","sources":["hook.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAMA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,UAAA,GAAAF,OAAA;AAyDA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,UAAUA,CACxBC,OAA0B,GAAG,CAAC,CAAC,EACb;EAClB,MAAM;IACJC,aAAa,GAAG,CAAC;IACjBC,cAAc,GAAG,GAAG;IACpBC,WAAW,GAAG,CAAC;IACfC,iBAAiB,GAAG,IAAI;IACxBC,OAAO,GAAG;EACZ,CAAC,GAAGL,OAAO;EAEX,MAAM,CAACM,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAC,eAAQ,EAAuB,IAAI,CAAC;EAClE,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAF,eAAQ,EAAyB,IAAI,CAAC;EACpE,MAAM,CAACG,WAAW,EAAEC,cAAc,CAAC,GAAG,IAAAJ,eAAQ,EAAC,KAAK,CAAC;EAErD,MAAM,CAACK,UAAU,CAAC,GAAG,IAAAL,eAAQ,EAAC,MAAMM,oBAAY,CAACD,UAAU,CAAC,CAAC,CAAC;EAC9D,MAAM,CAACE,WAAW,CAAC,GAAG,IAAAP,eAAQ,EAAC,MAAMM,oBAAY,CAACE,cAAc,CAAC,CAAC,CAAC;;EAEnE;EACA;EACA;EACA,MAAMC,SAAS,GAAG,IAAAC,aAAM,EAACjB,aAAa,CAAC;EACvCgB,SAAS,CAACE,OAAO,GAAGlB,aAAa;EAEjC,IAAAmB,gBAAS,EAAC,MAAM;IACdN,oBAAY,CAACO,SAAS,CAACpB,aAAa,CAAC;EACvC,CAAC,EAAE,CAACA,aAAa,CAAC,CAAC;EAEnB,IAAAmB,gBAAS,EAAC,MAAM;IACdN,oBAAY,CAACQ,YAAY,CAACpB,cAAc,CAAC;EAC3C,CAAC,EAAE,CAACA,cAAc,CAAC,CAAC;EAEpB,IAAAkB,gBAAS,EAAC,MAAM;IACdN,oBAAY,CAACS,cAAc,CAACpB,WAAW,CAAC;EAC1C,CAAC,EAAE,CAACA,WAAW,CAAC,CAAC;EAEjB,IAAAiB,gBAAS,EAAC,MAAM;IACdN,oBAAY,CAACU,oBAAoB,CAACpB,iBAAiB,CAAC;EACtD,CAAC,EAAE,CAACA,iBAAiB,CAAC,CAAC;EAEvB,IAAAgB,gBAAS,EAAC,MAAM;IACd,IAAI,CAACP,UAAU,EAAE;IACjB,OAAO,IAAAY,iCAAsB,EAACf,UAAU,CAAC;EAC3C,CAAC,EAAE,CAACG,UAAU,CAAC,CAAC;EAEhB,IAAAO,gBAAS,EAAC,MAAM;IACd,IAAI,CAACP,UAAU,EAAE;IACjB,OAAO,IAAAa,kCAAuB,EAACd,cAAc,CAAC;EAChD,CAAC,EAAE,CAACC,UAAU,CAAC,CAAC;EAEhB,IAAAO,gBAAS,EAAC,MAAM;IACd,IAAI,CAACP,UAAU,IAAI,CAACR,OAAO,EAAE;IAC7B,MAAMsB,GAAG,GAAG,IAAAC,6BAAkB,EAACrB,UAAU,CAAC;IAC1C;IACA;IACAO,oBAAY,CAACO,SAAS,CAACJ,SAAS,CAACE,OAAO,CAAC;IACzC,OAAOQ,GAAG;IACV;EACF,CAAC,EAAE,CAACd,UAAU,EAAER,OAAO,CAAC,CAAC;EAEzB,OAAO;IAAEC,OAAO;IAAEG,OAAO;IAAEE,WAAW;IAAEE,UAAU;IAAEE;EAAY,CAAC;AACnE","ignoreList":[]}
+{"version":3,"names":["_react","require","_native","_multiplex","useCompass","options","filterDegrees","smoothingAlpha","declination","pauseOnBackground","enabled","reading","setReading","useState","quality","setQuality","interfering","setInterfering","hasCompass","NitroCompass","diagnostics","getDiagnostics","undefined","permission","setPermission","getPermissionStatus","filterRef","useRef","current","smoothingRef","useEffect","setFilter","setSmoothing","setDeclination","setPauseOnBackground","addCalibrationListener","addInterferenceListener","off","addHeadingListener","e","console","warn","getCurrentHeading","useCallback","recalibrate","setLocation","latitude","longitude","requestPermission","status"],"sourceRoot":"../../src","sources":["hook.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_native","require","_multiplex","_hook"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,IAAAA,OAAA,GAAAC,OAAA;AAWA,IAAAC,UAAA,GAAAD,OAAA;AAMA,IAAAE,KAAA,GAAAF,OAAA","ignoreList":[]}
+{"version":3,"names":["_native","require","_multiplex","_hook"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,IAAAA,OAAA,GAAAC,OAAA;AAYA,IAAAC,UAAA,GAAAD,OAAA;AAMA,IAAAE,KAAA,GAAAF,OAAA","ignoreList":[]}

package/lib/commonjs/multiplex.js

@@ -77,6 +77,13 @@ function addHeadingListener(cb) {
   };
 }
 
+// Module-level no-op kept stable so we can swap it back into the native
+// callback slot when the last listener leaves — releasing references
+// to old dispatcher closures, which matters when the JS module is
+// re-evaluated (Metro Fast Refresh, jest module reset).
+const NOOP_CALIBRATION = _ => {};
+const NOOP_INTERFERENCE = _ => {};
+
 /**
  * Subscribe to calibration-bucket transitions. Only fires while a
  * heading subscription is active. Returns the unsubscribe function.
@@ -88,7 +95,17 @@ function addCalibrationListener(cb) {
   }
   calibrationListeners.add(cb);
   return () => {
-    calibrationListeners.delete(cb);
+    if (!calibrationListeners.delete(cb)) return;
+    if (calibrationListeners.size === 0) {
+      // Detach our dispatcher from the native side. Without this, a
+      // module reload (Metro Fast Refresh, jest resetModules) leaves
+      // the old dispatcher pinned in native memory while a new module
+      // load installs a *second* dispatcher pointing at a fresh
+      // listener Set — splitting events between the two and silently
+      // dropping the now-orphaned listeners.
+      _native.NitroCompass.setOnCalibrationNeeded(NOOP_CALIBRATION);
+      calibrationRegistered = false;
+    }
   };
 }
 
@@ -103,7 +120,11 @@ function addInterferenceListener(cb) {
   }
   interferenceListeners.add(cb);
   return () => {
-    interferenceListeners.delete(cb);
+    if (!interferenceListeners.delete(cb)) return;
+    if (interferenceListeners.size === 0) {
+      _native.NitroCompass.setOnInterferenceDetected(NOOP_INTERFERENCE);
+      interferenceRegistered = false;
+    }
   };
 }
 //# sourceMappingURL=multiplex.js.map

package/lib/commonjs/multiplex.js.map

@@ -1 +1 @@
-{"version":3,"names":["_native","require","headingListeners","Set","calibrationListeners","interferenceListeners","calibrationRegistered","interferenceRegistered","DEFAULT_FILTER_DEG","dispatchHeading","sample","cb","Array","from","e","console","error","dispatchCalibration","quality","dispatchInterference","detected","addHeadingListener","wasEmpty","size","add","NitroCompass","start","delete","stop","addCalibrationListener","setOnCalibrationNeeded","addInterferenceListener","setOnInterferenceDetected"],"sourceRoot":"../../src","sources":["multiplex.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_native","require","headingListeners","Set","calibrationListeners","interferenceListeners","calibrationRegistered","interferenceRegistered","DEFAULT_FILTER_DEG","dispatchHeading","sample","cb","Array","from","e","console","error","dispatchCalibration","quality","dispatchInterference","detected","addHeadingListener","wasEmpty","size","add","NitroCompass","start","delete","stop","NOOP_CALIBRATION","_","NOOP_INTERFERENCE","addCalibrationListener","setOnCalibrationNeeded","addInterferenceListener","setOnInterferenceDetected"],"sourceRoot":"../../src","sources":["multiplex.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hook.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import { useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import { NitroCompass } from './native';
 import { addCalibrationListener, addHeadingListener, addInterferenceListener } from './multiplex';
 /**
@@ -21,14 +21,40 @@ export function useCompass(options = {}) {
   const [reading, setReading] = useState(null);
   const [quality, setQuality] = useState(null);
   const [interfering, setInterfering] = useState(false);
-  const [hasCompass] = useState(() => NitroCompass.hasCompass());
-  const [diagnostics] = useState(() => NitroCompass.getDiagnostics());
 
-  // Tracked via ref so the heading-subscription effect can re-apply
-  // the user's filter after a stop/start cycle without restarting on
-  // every filterDegrees change.
+  // Wrap in try/catch so a missing/misconfigured native module doesn't
+  // throw during render — return safe defaults and let the host UI
+  // surface "no compass". Without this, the throw bubbles up and
+  // becomes a render error that blanks the screen.
+  const [hasCompass] = useState(() => {
+    try {
+      return NitroCompass.hasCompass();
+    } catch {
+      return false;
+    }
+  });
+  const [diagnostics] = useState(() => {
+    try {
+      return NitroCompass.getDiagnostics();
+    } catch {
+      return undefined;
+    }
+  });
+  const [permission, setPermission] = useState(() => {
+    try {
+      return NitroCompass.getPermissionStatus();
+    } catch {
+      return 'unknown';
+    }
+  });
+
+  // Tracked via refs so the heading-subscription effect can re-apply
+  // the user's filter and smoothing after a stop/start cycle without
+  // restarting on every option change.
   const filterRef = useRef(filterDegrees);
   filterRef.current = filterDegrees;
+  const smoothingRef = useRef(smoothingAlpha);
+  smoothingRef.current = smoothingAlpha;
   useEffect(() => {
     NitroCompass.setFilter(filterDegrees);
   }, [filterDegrees]);
@@ -50,20 +76,81 @@ export function useCompass(options = {}) {
     return addInterferenceListener(setInterfering);
   }, [hasCompass]);
   useEffect(() => {
-    if (!hasCompass || !enabled) return;
-    const off = addHeadingListener(setReading);
-    // Multiplex starts the sensor with a default filter; re-apply the
-    // current option after subscribing.
-    NitroCompass.setFilter(filterRef.current);
+    if (!hasCompass || !enabled) {
+      // When the user disables the hook, clear stale UI state.
+      // Without this, `reading` / `interfering` keep their last value
+      // forever, so the consumer's UI can't tell "subscription is off"
+      // from "compass is currently quiet".
+      setReading(null);
+      setInterfering(false);
+      return;
+    }
+    let off;
+    try {
+      off = addHeadingListener(setReading);
+      // Multiplex starts the sensor with a default filter; re-apply
+      // the current options after subscribing. recalibrate() can also
+      // reset native smoothing state, so we pin our chosen alpha back
+      // here as well.
+      NitroCompass.setFilter(filterRef.current);
+      NitroCompass.setSmoothing(smoothingRef.current);
+    } catch (e) {
+      // start() throws on iOS when location authorization is denied.
+      // Swallow it here so the hook tree doesn't unmount; consumers
+      // should call NitroCompass.requestPermission() explicitly before
+      // setting enabled=true if they want to recover.
+      // eslint-disable-next-line no-console
+      console.warn('[NitroCompass] failed to start heading subscription:', e);
+    }
     return off;
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [hasCompass, enabled]);
+
+  // Stable callbacks so consumers' useEffect deps don't churn on every
+  // render. All four are thin wrappers around NitroCompass; the hook's
+  // own state isn't reactive to recalibrate/setLocation since neither
+  // changes any field returned here.
+  const getCurrentHeading = useCallback(() => {
+    try {
+      return NitroCompass.getCurrentHeading();
+    } catch {
+      return undefined;
+    }
+  }, []);
+  const recalibrate = useCallback(() => {
+    try {
+      NitroCompass.recalibrate();
+    } catch {
+      // Native missing — nothing to do.
+    }
+  }, []);
+  const setLocation = useCallback((latitude, longitude) => {
+    try {
+      NitroCompass.setLocation(latitude, longitude);
+    } catch {
+      // Native missing — silently ignored.
+    }
+  }, []);
+  const requestPermission = useCallback(async () => {
+    try {
+      const status = await NitroCompass.requestPermission();
+      setPermission(status);
+      return status;
+    } catch {
+      return 'denied';
+    }
+  }, []);
   return {
     reading,
     quality,
     interfering,
     hasCompass,
-    diagnostics
+    diagnostics,
+    permission,
+    getCurrentHeading,
+    recalibrate,
+    setLocation,
+    requestPermission
   };
 }
 //# sourceMappingURL=hook.js.map

package/lib/module/hook.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useRef","useState","NitroCompass","addCalibrationListener","addHeadingListener","addInterferenceListener","useCompass","options","filterDegrees","smoothingAlpha","declination","pauseOnBackground","enabled","reading","setReading","quality","setQuality","interfering","setInterfering","hasCompass","diagnostics","getDiagnostics","filterRef","current","setFilter","setSmoothing","setDeclination","setPauseOnBackground","off"],"sourceRoot":"../../src","sources":["hook.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAMnD,SAASC,YAAY,QAAQ,UAAU;AACvC,SACEC,sBAAsB,EACtBC,kBAAkB,EAClBC,uBAAuB,QAClB,aAAa;AAqDpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBC,OAA0B,GAAG,CAAC,CAAC,EACb;EAClB,MAAM;IACJC,aAAa,GAAG,CAAC;IACjBC,cAAc,GAAG,GAAG;IACpBC,WAAW,GAAG,CAAC;IACfC,iBAAiB,GAAG,IAAI;IACxBC,OAAO,GAAG;EACZ,CAAC,GAAGL,OAAO;EAEX,MAAM,CAACM,OAAO,EAAEC,UAAU,CAAC,GAAGb,QAAQ,CAAuB,IAAI,CAAC;EAClE,MAAM,CAACc,OAAO,EAAEC,UAAU,CAAC,GAAGf,QAAQ,CAAyB,IAAI,CAAC;EACpE,MAAM,CAACgB,WAAW,EAAEC,cAAc,CAAC,GAAGjB,QAAQ,CAAC,KAAK,CAAC;EAErD,MAAM,CAACkB,UAAU,CAAC,GAAGlB,QAAQ,CAAC,MAAMC,YAAY,CAACiB,UAAU,CAAC,CAAC,CAAC;EAC9D,MAAM,CAACC,WAAW,CAAC,GAAGnB,QAAQ,CAAC,MAAMC,YAAY,CAACmB,cAAc,CAAC,CAAC,CAAC;;EAEnE;EACA;EACA;EACA,MAAMC,SAAS,GAAGtB,MAAM,CAACQ,aAAa,CAAC;EACvCc,SAAS,CAACC,OAAO,GAAGf,aAAa;EAEjCT,SAAS,CAAC,MAAM;IACdG,YAAY,CAACsB,SAAS,CAAChB,aAAa,CAAC;EACvC,CAAC,EAAE,CAACA,aAAa,CAAC,CAAC;EAEnBT,SAAS,CAAC,MAAM;IACdG,YAAY,CAACuB,YAAY,CAAChB,cAAc,CAAC;EAC3C,CAAC,EAAE,CAACA,cAAc,CAAC,CAAC;EAEpBV,SAAS,CAAC,MAAM;IACdG,YAAY,CAACwB,cAAc,CAAChB,WAAW,CAAC;EAC1C,CAAC,EAAE,CAACA,WAAW,CAAC,CAAC;EAEjBX,SAAS,CAAC,MAAM;IACdG,YAAY,CAACyB,oBAAoB,CAAChB,iBAAiB,CAAC;EACtD,CAAC,EAAE,CAACA,iBAAiB,CAAC,CAAC;EAEvBZ,SAAS,CAAC,MAAM;IACd,IAAI,CAACoB,UAAU,EAAE;IACjB,OAAOhB,sBAAsB,CAACa,UAAU,CAAC;EAC3C,CAAC,EAAE,CAACG,UAAU,CAAC,CAAC;EAEhBpB,SAAS,CAAC,MAAM;IACd,IAAI,CAACoB,UAAU,EAAE;IACjB,OAAOd,uBAAuB,CAACa,cAAc,CAAC;EAChD,CAAC,EAAE,CAACC,UAAU,CAAC,CAAC;EAEhBpB,SAAS,CAAC,MAAM;IACd,IAAI,CAACoB,UAAU,IAAI,CAACP,OAAO,EAAE;IAC7B,MAAMgB,GAAG,GAAGxB,kBAAkB,CAACU,UAAU,CAAC;IAC1C;IACA;IACAZ,YAAY,CAACsB,SAAS,CAACF,SAAS,CAACC,OAAO,CAAC;IACzC,OAAOK,GAAG;IACV;EACF,CAAC,EAAE,CAACT,UAAU,EAAEP,OAAO,CAAC,CAAC;EAEzB,OAAO;IAAEC,OAAO;IAAEE,OAAO;IAAEE,WAAW;IAAEE,UAAU;IAAEC;EAAY,CAAC;AACnE","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useRef","useState","NitroCompass","addCalibrationListener","addHeadingListener","addInterferenceListener","useCompass","options","filterDegrees","smoothingAlpha","declination","pauseOnBackground","enabled","reading","setReading","quality","setQuality","interfering","setInterfering","hasCompass","diagnostics","getDiagnostics","undefined","permission","setPermission","getPermissionStatus","filterRef","current","smoothingRef","setFilter","setSmoothing","setDeclination","setPauseOnBackground","off","e","console","warn","getCurrentHeading","recalibrate","setLocation","latitude","longitude","requestPermission","status"],"sourceRoot":"../../src","sources":["hook.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroCompass","addCalibrationListener","addHeadingListener","addInterferenceListener","useCompass"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AASA,SAASA,YAAY,QAAQ,UAAU;AAWvC,SACEC,sBAAsB,EACtBC,kBAAkB,EAClBC,uBAAuB,QAClB,aAAa;AAEpB,SAASC,UAAU,QAAQ,QAAQ","ignoreList":[]}
+{"version":3,"names":["NitroCompass","addCalibrationListener","addHeadingListener","addInterferenceListener","useCompass"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAUA,SAASA,YAAY,QAAQ,UAAU;AAYvC,SACEC,sBAAsB,EACtBC,kBAAkB,EAClBC,uBAAuB,QAClB,aAAa;AAEpB,SAASC,UAAU,QAAQ,QAAQ","ignoreList":[]}

package/lib/module/multiplex.js

@@ -71,6 +71,13 @@ export function addHeadingListener(cb) {
   };
 }
 
+// Module-level no-op kept stable so we can swap it back into the native
+// callback slot when the last listener leaves — releasing references
+// to old dispatcher closures, which matters when the JS module is
+// re-evaluated (Metro Fast Refresh, jest module reset).
+const NOOP_CALIBRATION = _ => {};
+const NOOP_INTERFERENCE = _ => {};
+
 /**
  * Subscribe to calibration-bucket transitions. Only fires while a
  * heading subscription is active. Returns the unsubscribe function.
@@ -82,7 +89,17 @@ export function addCalibrationListener(cb) {
   }
   calibrationListeners.add(cb);
   return () => {
-    calibrationListeners.delete(cb);
+    if (!calibrationListeners.delete(cb)) return;
+    if (calibrationListeners.size === 0) {
+      // Detach our dispatcher from the native side. Without this, a
+      // module reload (Metro Fast Refresh, jest resetModules) leaves
+      // the old dispatcher pinned in native memory while a new module
+      // load installs a *second* dispatcher pointing at a fresh
+      // listener Set — splitting events between the two and silently
+      // dropping the now-orphaned listeners.
+      NitroCompass.setOnCalibrationNeeded(NOOP_CALIBRATION);
+      calibrationRegistered = false;
+    }
   };
 }
 
@@ -97,7 +114,11 @@ export function addInterferenceListener(cb) {
   }
   interferenceListeners.add(cb);
   return () => {
-    interferenceListeners.delete(cb);
+    if (!interferenceListeners.delete(cb)) return;
+    if (interferenceListeners.size === 0) {
+      NitroCompass.setOnInterferenceDetected(NOOP_INTERFERENCE);
+      interferenceRegistered = false;
+    }
   };
 }
 //# sourceMappingURL=multiplex.js.map

package/lib/module/multiplex.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroCompass","headingListeners","Set","calibrationListeners","interferenceListeners","calibrationRegistered","interferenceRegistered","DEFAULT_FILTER_DEG","dispatchHeading","sample","cb","Array","from","e","console","error","dispatchCalibration","quality","dispatchInterference","detected","addHeadingListener","wasEmpty","size","add","start","delete","stop","addCalibrationListener","setOnCalibrationNeeded","addInterferenceListener","setOnInterferenceDetected"],"sourceRoot":"../../src","sources":["multiplex.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,YAAY,QAAQ,UAAU;AAMvC,MAAMC,gBAAgB,GAAG,IAAIC,GAAG,CAAkB,CAAC;AACnD,MAAMC,oBAAoB,GAAG,IAAID,GAAG,CAAsB,CAAC;AAC3D,MAAME,qBAAqB,GAAG,IAAIF,GAAG,CAAuB,CAAC;AAE7D,IAAIG,qBAAqB,GAAG,KAAK;AACjC,IAAIC,sBAAsB,GAAG,KAAK;AAElC,MAAMC,kBAAkB,GAAG,CAAC;AAE5B,SAASC,eAAeA,CAACC,MAAqB,EAAE;EAC9C,KAAK,MAAMC,EAAE,IAAIC,KAAK,CAACC,IAAI,CAACX,gBAAgB,CAAC,EAAE;IAC7C,IAAI;MACFS,EAAE,CAACD,MAAM,CAAC;IACZ,CAAC,CAAC,OAAOI,CAAC,EAAE;MACVC,OAAO,CAACC,KAAK,CAAC,wCAAwC,EAAEF,CAAC,CAAC;IAC5D;EACF;AACF;AAEA,SAASG,mBAAmBA,CAACC,OAAwB,EAAE;EACrD,KAAK,MAAMP,EAAE,IAAIC,KAAK,CAACC,IAAI,CAACT,oBAAoB,CAAC,EAAE;IACjD,IAAI;MACFO,EAAE,CAACO,OAAO,CAAC;IACb,CAAC,CAAC,OAAOJ,CAAC,EAAE;MACVC,OAAO,CAACC,KAAK,CAAC,4CAA4C,EAAEF,CAAC,CAAC;IAChE;EACF;AACF;AAEA,SAASK,oBAAoBA,CAACC,QAAiB,EAAE;EAC/C,KAAK,MAAMT,EAAE,IAAIC,KAAK,CAACC,IAAI,CAACR,qBAAqB,CAAC,EAAE;IAClD,IAAI;MACFM,EAAE,CAACS,QAAQ,CAAC;IACd,CAAC,CAAC,OAAON,CAAC,EAAE;MACVC,OAAO,CAACC,KAAK,CAAC,6CAA6C,EAAEF,CAAC,CAAC;IACjE;EACF;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,kBAAkBA,CAACV,EAAmB,EAAc;EAClE,MAAMW,QAAQ,GAAGpB,gBAAgB,CAACqB,IAAI,KAAK,CAAC;EAC5CrB,gBAAgB,CAACsB,GAAG,CAACb,EAAE,CAAC;EACxB,IAAIW,QAAQ,EAAE;IACZrB,YAAY,CAACwB,KAAK,CAACjB,kBAAkB,EAAEC,eAAe,CAAC;EACzD;EACA,OAAO,MAAM;IACX,IAAI,CAACP,gBAAgB,CAACwB,MAAM,CAACf,EAAE,CAAC,EAAE;IAClC,IAAIT,gBAAgB,CAACqB,IAAI,KAAK,CAAC,EAAE;MAC/BtB,YAAY,CAAC0B,IAAI,CAAC,CAAC;IACrB;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CACpCjB,EAAuB,EACX;EACZ,IAAI,CAACL,qBAAqB,EAAE;IAC1BL,YAAY,CAAC4B,sBAAsB,CAACZ,mBAAmB,CAAC;IACxDX,qBAAqB,GAAG,IAAI;EAC9B;EACAF,oBAAoB,CAACoB,GAAG,CAACb,EAAE,CAAC;EAC5B,OAAO,MAAM;IACXP,oBAAoB,CAACsB,MAAM,CAACf,EAAE,CAAC;EACjC,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASmB,uBAAuBA,CACrCnB,EAAwB,EACZ;EACZ,IAAI,CAACJ,sBAAsB,EAAE;IAC3BN,YAAY,CAAC8B,yBAAyB,CAACZ,oBAAoB,CAAC;IAC5DZ,sBAAsB,GAAG,IAAI;EAC/B;EACAF,qBAAqB,CAACmB,GAAG,CAACb,EAAE,CAAC;EAC7B,OAAO,MAAM;IACXN,qBAAqB,CAACqB,MAAM,CAACf,EAAE,CAAC;EAClC,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["NitroCompass","headingListeners","Set","calibrationListeners","interferenceListeners","calibrationRegistered","interferenceRegistered","DEFAULT_FILTER_DEG","dispatchHeading","sample","cb","Array","from","e","console","error","dispatchCalibration","quality","dispatchInterference","detected","addHeadingListener","wasEmpty","size","add","start","delete","stop","NOOP_CALIBRATION","_","NOOP_INTERFERENCE","addCalibrationListener","setOnCalibrationNeeded","addInterferenceListener","setOnInterferenceDetected"],"sourceRoot":"../../src","sources":["multiplex.ts"],"mappings":"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","ignoreList":[]}