yaver-feedback-react-native 0.5.0 → 0.5.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yaver-feedback-react-native",
-  "version": "0.5.0",
-  "description": "Visual feedback SDK for Yaver — shake-to-report, screen recording, voice annotations for vibe coding",
+  "version": "0.5.3",
+  "description": "Visual feedback SDK for Yaver — bug reports, screen recording, voice annotations, and local-first developer workflows",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "files": [
@@ -50,7 +50,8 @@
     "feedback",
     "bug-report",
     "screen-recording",
-    "vibe-coding",
-    "react-native"
+    "react-native",
+    "developer-runtime",
+    "local-first"
   ]
 }

package/src/ShakeDetector.ts

@@ -1,57 +1,117 @@
 import { DeviceEventEmitter, Platform } from 'react-native';
 
-const SHAKE_THRESHOLD = 1.5; // g-force threshold
 const SHAKE_TIMEOUT_MS = 1000; // minimum time between shakes
-const SHAKE_REQUIRED_EVENTS = 3; // number of threshold-exceeding events to trigger
+const ACCEL_THRESHOLD_G = 1.8; // peak g-force that qualifies as a shake event
+const ACCEL_MIN_HITS = 3; // peaks within the window before we fire
+const ACCEL_WINDOW_MS = 800; // rolling window
+const ACCEL_SAMPLE_INTERVAL_MS = 80; // ≈12Hz — cheap but catches shakes
 
 /**
  * Detects device shake gestures.
  *
- * On iOS, listens to the native 'shakeEvent' emitted by RCTDeviceEventEmitter.
- * On Android, uses accelerometer data with threshold-based detection as a fallback.
+ * Two detection paths run in parallel so shake works in both Debug and
+ * Release / TestFlight builds:
+ *
+ *   1. React Native's built-in `shakeEvent` (iOS) / `ShakeEvent` (Android)
+ *      on `DeviceEventEmitter`. RN emits `shakeEvent` only in Debug mode
+ *      on iOS, which is why TestFlight builds never saw a shake prior to
+ *      SDK 0.5.1.
+ *   2. Accelerometer-based fallback via `expo-sensors` (optional peer
+ *      dep). When the host app has `expo-sensors` installed we subscribe
+ *      to the accelerometer and fire on a burst of above-threshold peaks.
+ *      This path works identically in Debug, Release, and TestFlight.
+ *
+ * Both paths share a 1-second debounce so a single shake never fires the
+ * callback twice.
  */
 export class ShakeDetector {
-  private subscription: any = null;
+  private devMenuSub: { remove(): void } | null = null;
+  private accelSub: { remove(): void } | null = null;
   private lastShakeTime = 0;
+  private peakTimestamps: number[] = [];
 
-  /**
-   * Start listening for shake gestures.
-   * @param onShake - Callback invoked when a shake is detected.
-   */
   start(onShake: () => void): void {
     this.stop();
+    this.subscribeDevMenu(onShake);
+    this.subscribeAccelerometer(onShake);
+  }
 
-    // React Native emits a 'shakeEvent' on iOS when the device is shaken
-    // (available via DeviceEventEmitter in debug builds)
-    if (Platform.OS === 'ios') {
-      this.subscription = DeviceEventEmitter.addListener('shakeEvent', () => {
-        const now = Date.now();
-        if (now - this.lastShakeTime > SHAKE_TIMEOUT_MS) {
-          this.lastShakeTime = now;
-          onShake();
-        }
-      });
-      return;
+  stop(): void {
+    if (this.devMenuSub) {
+      this.devMenuSub.remove();
+      this.devMenuSub = null;
     }
+    if (this.accelSub) {
+      this.accelSub.remove();
+      this.accelSub = null;
+    }
+    this.peakTimestamps = [];
+  }
 
-    // Android: listen for accelerometer-based shake detection
-    // Uses the same DeviceEventEmitter pattern — if a native module or
-    // react-native-shake is installed, it will emit 'ShakeEvent'.
-    // Otherwise this is a no-op (manual trigger or floating button can be used).
-    this.subscription = DeviceEventEmitter.addListener('ShakeEvent', () => {
-      const now = Date.now();
-      if (now - this.lastShakeTime > SHAKE_TIMEOUT_MS) {
-        this.lastShakeTime = now;
-        onShake();
-      }
+  private fire(onShake: () => void): void {
+    const now = Date.now();
+    if (now - this.lastShakeTime <= SHAKE_TIMEOUT_MS) return;
+    this.lastShakeTime = now;
+    this.peakTimestamps = [];
+    onShake();
+  }
+
+  /**
+   * Dev-menu / platform-native event listener. On iOS this is the
+   * `shakeEvent` RN posts from RCTDevMenu (Debug only). On Android it is
+   * the `ShakeEvent` name a handful of third-party shake libraries emit.
+   */
+  private subscribeDevMenu(onShake: () => void): void {
+    const eventName = Platform.OS === 'ios' ? 'shakeEvent' : 'ShakeEvent';
+    this.devMenuSub = DeviceEventEmitter.addListener(eventName, () => {
+      this.fire(onShake);
     });
   }
 
-  /** Stop listening for shake gestures. */
-  stop(): void {
-    if (this.subscription) {
-      this.subscription.remove();
-      this.subscription = null;
+  /**
+   * Accelerometer-based detection. Uses `expo-sensors` when available —
+   * the host app's own dependency, not the SDK's, so apps that don't
+   * want the extra native surface get the Dev-menu path only.
+   */
+  private subscribeAccelerometer(onShake: () => void): void {
+    let Accelerometer: {
+      setUpdateInterval: (ms: number) => void;
+      addListener: (cb: (d: { x: number; y: number; z: number }) => void) => {
+        remove(): void;
+      };
+    } | null = null;
+    try {
+      // Optional peer dep — if it isn't installed, we simply skip this path.
+      Accelerometer = require('expo-sensors').Accelerometer;
+    } catch {
+      return;
+    }
+    if (!Accelerometer) return;
+
+    try {
+      Accelerometer.setUpdateInterval(ACCEL_SAMPLE_INTERVAL_MS);
+    } catch {
+      // Some platforms reject zero-value intervals; fall through with defaults
     }
+
+    this.accelSub = Accelerometer.addListener(({ x, y, z }) => {
+      // Magnitude of acceleration vector (in g). Subtract 1 so a stationary
+      // device reports ~0 rather than the 1g of gravity.
+      const mag = Math.sqrt(x * x + y * y + z * z);
+      if (mag - 1 < ACCEL_THRESHOLD_G - 1) return;
+
+      const now = Date.now();
+      this.peakTimestamps.push(now);
+      // Drop peaks that fell out of the rolling window.
+      while (
+        this.peakTimestamps.length > 0 &&
+        now - this.peakTimestamps[0] > ACCEL_WINDOW_MS
+      ) {
+        this.peakTimestamps.shift();
+      }
+      if (this.peakTimestamps.length >= ACCEL_MIN_HITS) {
+        this.fire(onShake);
+      }
+    });
   }
 }