@mobileai/react-native 0.9.0 → 0.9.1

package/lib/module/services/telemetry/TelemetryService.js

@@ -0,0 +1,260 @@
+"use strict";
+
+/**
+ * TelemetryService — Batches and sends analytics events to MobileAI Cloud.
+ *
+ * Features:
+ * - Event batching (flush every N seconds or N events)
+ * - Offline queue with retry on reconnect
+ * - Lightweight — no native dependencies
+ * - Opt-in only (requires analyticsKey or analyticsProxyUrl)
+ */
+
+import { AppState, Platform } from 'react-native';
+import { logger } from "../../utils/logger.js";
+import { scrubPII } from "./PiiScrubber.js";
+import { FlagService } from "../flags/FlagService.js";
+
+// Optional: AsyncStorage for offline event persistence
+// SDK works without it — just loses crash recovery for queued events
+let AsyncStorageModule = null;
+try {
+  AsyncStorageModule = require('@react-native-async-storage/async-storage').default;
+} catch {
+  // Not installed — offline queue persistence disabled
+}
+
+// ─── Constants ─────────────────────────────────────────────────
+
+const CLOUD_API_URL = 'https://api.maiagent.dev/v1/events';
+const STORAGE_KEY = '@mobileai/telemetry_queue';
+const DEFAULT_FLUSH_INTERVAL_MS = 30_000;
+const DEFAULT_MAX_BATCH_SIZE = 50;
+const SDK_VERSION = '0.10.0';
+const LOG_TAG = 'Telemetry';
+
+// ─── Utility ───────────────────────────────────────────────────
+
+function generateSessionId() {
+  return `${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+import { getDeviceId } from "./device.js";
+
+// ─── Service ───────────────────────────────────────────────────
+
+export class TelemetryService {
+  queue = [];
+  currentScreen = 'Unknown';
+  flushTimer = null;
+  isFlushing = false;
+  appStateSubscription = null;
+
+  /** Public getter for the current screen, used by auto-capture utilities */
+  get screen() {
+    return this.currentScreen;
+  }
+
+  /**
+   * True while the AI agent is executing a tool (tap, type, navigate, etc.).
+   * The touch interceptor checks this flag to avoid double-counting AI actions
+   * as human interactions. Agent steps are already tracked as agent_step events.
+   */
+  isAgentActing = false;
+  /** Set by AgentRuntime before/after each tool execution. */
+  setAgentActing(active) {
+    this.isAgentActing = active;
+  }
+  constructor(config) {
+    this.config = config;
+    this.sessionId = generateSessionId();
+
+    // Extract base URL for flags API (e.g. drop /v1/events)
+    let baseUrl = 'https://api.maiagent.dev';
+    try {
+      if (config.analyticsProxyUrl) {
+        baseUrl = new URL(config.analyticsProxyUrl).origin;
+      }
+    } catch {}
+    this.flags = new FlagService(baseUrl);
+  }
+
+  // ─── Lifecycle ──────────────────────────────────────────────
+
+  /** Start the telemetry service (call on mount) */
+  async start() {
+    if (!this.isEnabled()) {
+      logger.debug(LOG_TAG, 'Disabled — no analyticsKey or proxyUrl');
+      return;
+    }
+
+    // Restore queued events from previous session
+    await this.restoreQueue();
+
+    // Fetch feature flags asynchronously (do not block startup)
+    if (this.config.analyticsKey) {
+      this.flags.fetch(this.config.analyticsKey).catch(e => logger.warn(LOG_TAG, `Could not sync flags: ${e.message}`));
+    }
+
+    // Start periodic flush
+    const interval = this.config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+    this.flushTimer = setInterval(() => this.flush(), interval);
+
+    // Flush on app background
+    this.appStateSubscription = AppState.addEventListener('change', state => {
+      if (state === 'background' || state === 'inactive') {
+        this.flush();
+      }
+    });
+
+    // Track session start
+    this.track('session_start', {
+      device: Platform.OS,
+      os: String(Platform.Version),
+      sdk_version: SDK_VERSION
+    });
+    logger.info(LOG_TAG, `Started (session: ${this.sessionId})`);
+  }
+
+  /** Stop the telemetry service (call on unmount) */
+  async stop() {
+    if (!this.isEnabled()) return;
+
+    // Track session end
+    this.track('session_end', {
+      events_count: this.queue.length
+    });
+
+    // Final flush
+    await this.flush();
+
+    // Cleanup
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.appStateSubscription) {
+      this.appStateSubscription.remove();
+      this.appStateSubscription = null;
+    }
+    logger.info(LOG_TAG, 'Stopped');
+  }
+
+  // ─── Public API ─────────────────────────────────────────────
+
+  /** Track an event (auto or custom) */
+  track(type, data = {}) {
+    if (!this.isEnabled()) return;
+
+    // Sanitize any string values in the data payload to remove PII
+    const sanitizedData = Object.fromEntries(Object.entries(data).map(([k, v]) => [k, typeof v === 'string' ? scrubPII(v) : v]));
+
+    // Auto-append active feature flags
+    sanitizedData.$flags = this.flags.getAllFlags();
+    const event = {
+      type,
+      data: sanitizedData,
+      timestamp: new Date().toISOString(),
+      screen: this.currentScreen,
+      sessionId: this.sessionId
+    };
+    this.queue.push(event);
+    if (this.config.debug) {
+      logger.debug(LOG_TAG, `→ ${type}`, data);
+    }
+
+    // Auto-flush if batch is full
+    const maxSize = this.config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+    if (this.queue.length >= maxSize) {
+      this.flush();
+    }
+  }
+
+  /** Update current screen (called by AIAgent on navigation) */
+  setScreen(screenName) {
+    if (this.currentScreen !== screenName) {
+      const prevScreen = this.currentScreen;
+      this.currentScreen = screenName;
+      this.track('screen_view', {
+        screen: screenName,
+        prev_screen: prevScreen
+      });
+    }
+  }
+
+  // ─── Flush ──────────────────────────────────────────────────
+
+  /** Send queued events to the cloud API */
+  async flush() {
+    if (!this.isEnabled() || this.queue.length === 0 || this.isFlushing) return;
+    this.isFlushing = true;
+    const eventsToSend = [...this.queue];
+    this.queue = [];
+    try {
+      const url = this.config.analyticsProxyUrl ?? CLOUD_API_URL;
+      const headers = {
+        'Content-Type': 'application/json',
+        ...(this.config.analyticsProxyHeaders ?? {})
+      };
+      const batch = {
+        analyticsKey: this.config.analyticsKey ?? '',
+        appId: Platform.OS,
+        // Consumer can override via config later
+        deviceId: getDeviceId(),
+        sdkVersion: SDK_VERSION,
+        events: eventsToSend
+      };
+      const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(batch)
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      logger.info(LOG_TAG, `Flushed ${eventsToSend.length} events`);
+    } catch (error) {
+      // Re-queue failed events for retry
+      this.queue = [...eventsToSend, ...this.queue];
+      await this.persistQueue();
+      logger.warn(LOG_TAG, `Flush failed (${eventsToSend.length} events re-queued): ${error.message}`);
+    } finally {
+      this.isFlushing = false;
+    }
+  }
+
+  // ─── Persistence (offline support) ──────────────────────────
+
+  /** Save queued events to AsyncStorage for crash/restart recovery */
+  async persistQueue() {
+    if (!AsyncStorageModule) return;
+    try {
+      await AsyncStorageModule.setItem(STORAGE_KEY, JSON.stringify(this.queue));
+    } catch {
+      // AsyncStorage may not be available in all environments
+    }
+  }
+
+  /** Restore queued events from previous session */
+  async restoreQueue() {
+    if (!AsyncStorageModule) return;
+    try {
+      const stored = await AsyncStorageModule.getItem(STORAGE_KEY);
+      if (stored) {
+        const events = JSON.parse(stored);
+        this.queue = [...events, ...this.queue];
+        await AsyncStorageModule.removeItem(STORAGE_KEY);
+        logger.info(LOG_TAG, `Restored ${events.length} events from previous session`);
+      }
+    } catch {
+      // Silently fail — telemetry is non-critical
+    }
+  }
+
+  // ─── Helpers ────────────────────────────────────────────────
+
+  /** Check if telemetry is configured */
+  isEnabled() {
+    return !!(this.config.analyticsKey || this.config.analyticsProxyUrl);
+  }
+}
+//# sourceMappingURL=TelemetryService.js.map

package/lib/module/services/telemetry/TelemetryService.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AppState","Platform","logger","scrubPII","FlagService","AsyncStorageModule","require","default","CLOUD_API_URL","STORAGE_KEY","DEFAULT_FLUSH_INTERVAL_MS","DEFAULT_MAX_BATCH_SIZE","SDK_VERSION","LOG_TAG","generateSessionId","Date","now","Math","random","toString","slice","getDeviceId","TelemetryService","queue","currentScreen","flushTimer","isFlushing","appStateSubscription","screen","isAgentActing","setAgentActing","active","constructor","config","sessionId","baseUrl","analyticsProxyUrl","URL","origin","flags","start","isEnabled","debug","restoreQueue","analyticsKey","fetch","catch","e","warn","message","interval","flushIntervalMs","setInterval","flush","addEventListener","state","track","device","OS","os","String","Version","sdk_version","info","stop","events_count","length","clearInterval","remove","type","data","sanitizedData","Object","fromEntries","entries","map","k","v","$flags","getAllFlags","event","timestamp","toISOString","push","maxSize","maxBatchSize","setScreen","screenName","prevScreen","prev_screen","eventsToSend","url","headers","analyticsProxyHeaders","batch","appId","deviceId","sdkVersion","events","response","method","body","JSON","stringify","ok","Error","status","error","persistQueue","setItem","stored","getItem","parse","removeItem"],"sourceRoot":"../../../../src","sources":["services/telemetry/TelemetryService.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/services/telemetry/TouchAutoCapture.js

@@ -0,0 +1,159 @@
+"use strict";
+
+/**
+ * TouchAutoCapture — Extracts a human-readable label from a React Native
+ * touch event target by walking up the native view hierarchy.
+ *
+ * Used by AIAgent to auto-track every tap in the app without
+ * any developer code changes (zero-config analytics).
+ *
+ * Strategy:
+ * 1. Read the touched element's accessibilityLabel (best signal).
+ * 2. If none, use React Native's internal _children to find nested text.
+ * 3. Fallback to the component's testID.
+ * 4. Last resort: "Unknown Element".
+ */
+
+// React Native imports not needed — we use Fiber internals directly
+
+const recentTaps = [];
+const RAGE_WINDOW_MS = 2000;
+const RAGE_THRESHOLD = 3;
+
+/**
+ * Checks if the user is repeatedly tapping the same element in frustration.
+ * If rage click detected, emits 'rage_click' event to telemetry.
+ */
+export function checkRageClick(label, telemetry) {
+  const now = Date.now();
+  recentTaps.push({
+    label,
+    ts: now
+  });
+
+  // Keep buffer unbounded size of 5
+  if (recentTaps.length > 5) recentTaps.shift();
+  const recent = recentTaps.filter(t => t.label === label && now - t.ts < RAGE_WINDOW_MS);
+  if (recent.length >= RAGE_THRESHOLD) {
+    telemetry.track('rage_click', {
+      label,
+      count: recent.length,
+      screen: telemetry.screen
+    });
+    recentTaps.length = 0; // reset buffer after emitting to avoid spam
+  }
+}
+
+/**
+ * Extract a label from a GestureResponderEvent's native target.
+ *
+ * @param nativeEvent - The nativeEvent from onStartShouldSetResponderCapture
+ * @param rootRef - The root View ref (to resolve relative positions)
+ * @returns A descriptive label string for the tapped element
+ */
+export function extractTouchLabel(nativeEvent) {
+  // Try accessible properties first (most reliable)
+  const target = nativeEvent?.target;
+  if (!target) return 'Unknown Element';
+
+  // React Native internal: _internalFiberInstanceHandleDEV or _nativeTag
+  // We can walk the Fiber tree from the target to find text
+  try {
+    // Strategy 1: Walk up the Fiber tree from the touched element
+    let fiber = getFiberFromNativeTag(target);
+    if (fiber) {
+      // Walk up looking for text content or accessibility labels
+      let current = fiber;
+      let depth = 0;
+      const MAX_DEPTH = 10;
+      while (current && depth < MAX_DEPTH) {
+        // Check for accessibilityLabel
+        if (current.memoizedProps?.accessibilityLabel) {
+          return current.memoizedProps.accessibilityLabel;
+        }
+
+        // Check for testID
+        if (current.memoizedProps?.testID) {
+          return current.memoizedProps.testID;
+        }
+
+        // Check for title (Button component)
+        if (current.memoizedProps?.title) {
+          return current.memoizedProps.title;
+        }
+
+        // Check for placeholder (TextInput)
+        if (current.memoizedProps?.placeholder) {
+          return `Input: ${current.memoizedProps.placeholder}`;
+        }
+
+        // Check if this is a Text node with children string
+        if (typeof current.memoizedProps?.children === 'string' && current.memoizedProps.children.trim()) {
+          return current.memoizedProps.children.trim();
+        }
+
+        // Check for nested text in children array
+        if (Array.isArray(current.memoizedProps?.children)) {
+          const textChild = findTextInChildren(current.memoizedProps.children);
+          if (textChild) return textChild;
+        }
+        current = current.return;
+        depth++;
+      }
+    }
+  } catch {
+    // Fiber access failed — fall back gracefully
+  }
+  return 'Unknown Element';
+}
+
+/**
+ * Find the first string text in a React children tree (recursive, max 3 levels).
+ */
+function findTextInChildren(children, depth = 0) {
+  if (depth > 3) return null;
+  for (const child of children) {
+    if (typeof child === 'string' && child.trim()) {
+      return child.trim();
+    }
+    if (typeof child === 'number') {
+      return String(child);
+    }
+    // React element with props.children
+    if (child?.props?.children) {
+      if (typeof child.props.children === 'string' && child.props.children.trim()) {
+        return child.props.children.trim();
+      }
+      if (Array.isArray(child.props.children)) {
+        const found = findTextInChildren(child.props.children, depth + 1);
+        if (found) return found;
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Attempt to get the Fiber node from a native tag (React Native internal).
+ * This uses the same technique as React DevTools and testing libraries.
+ */
+function getFiberFromNativeTag(nativeTag) {
+  try {
+    // React Native stores a reference from native tag → Fiber
+    // via the __internalInstanceHandle on the native node
+    const instance = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    if (instance?.renderers) {
+      for (const [, renderer] of instance.renderers) {
+        if (renderer?.findFiberByHostInstance) {
+          // Try to find via the devtools hook
+          const fiber = renderer.findFiberByHostInstance(nativeTag);
+          if (fiber) return fiber;
+        }
+      }
+    }
+  } catch {
+    // DevTools hook not available — expected in production
+  }
+  return null;
+}
+//# sourceMappingURL=TouchAutoCapture.js.map

package/lib/module/services/telemetry/TouchAutoCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["recentTaps","RAGE_WINDOW_MS","RAGE_THRESHOLD","checkRageClick","label","telemetry","now","Date","push","ts","length","shift","recent","filter","t","track","count","screen","extractTouchLabel","nativeEvent","target","fiber","getFiberFromNativeTag","current","depth","MAX_DEPTH","memoizedProps","accessibilityLabel","testID","title","placeholder","children","trim","Array","isArray","textChild","findTextInChildren","return","child","String","props","found","nativeTag","instance","globalThis","__REACT_DEVTOOLS_GLOBAL_HOOK__","renderers","renderer","findFiberByHostInstance"],"sourceRoot":"../../../../src","sources":["services/telemetry/TouchAutoCapture.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/services/telemetry/device.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { Platform } from 'react-native';
+
+/**
+ * Deterministic device ID based on platform info.
+ * This ensures analytics and flags remain consistent across sessions
+ * without collecting PII hardware identifiers.
+ */
+export function getDeviceId() {
+  const raw = `${Platform.OS}_${Platform.Version}`;
+  let hash = 0;
+  for (let i = 0; i < raw.length; i++) {
+    hash = (hash << 5) - hash + raw.charCodeAt(i);
+    hash |= 0;
+  }
+  return `dev_${Math.abs(hash).toString(36)}`;
+}
+//# sourceMappingURL=device.js.map

package/lib/module/services/telemetry/device.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","getDeviceId","raw","OS","Version","hash","i","length","charCodeAt","Math","abs","toString"],"sourceRoot":"../../../../src","sources":["services/telemetry/device.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;;AAEvC;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAW;EACpC,MAAMC,GAAG,GAAG,GAAGF,QAAQ,CAACG,EAAE,IAAIH,QAAQ,CAACI,OAAO,EAAE;EAChD,IAAIC,IAAI,GAAG,CAAC;EACZ,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGJ,GAAG,CAACK,MAAM,EAAED,CAAC,EAAE,EAAE;IACnCD,IAAI,GAAG,CAACA,IAAI,IAAI,CAAC,IAAIA,IAAI,GAAGH,GAAG,CAACM,UAAU,CAACF,CAAC,CAAC;IAC7CD,IAAI,IAAI,CAAC;EACX;EACA,OAAO,OAAOI,IAAI,CAACC,GAAG,CAACL,IAAI,CAAC,CAACM,QAAQ,CAAC,EAAE,CAAC,EAAE;AAC7C","ignoreList":[]}

package/lib/module/services/telemetry/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+/**
+ * Telemetry module barrel export.
+ */
+
+export { TelemetryService } from "./TelemetryService.js";
+export { MobileAI, bindTelemetryService } from "./MobileAI.js";
+//# sourceMappingURL=index.js.map

package/lib/module/services/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TelemetryService","MobileAI","bindTelemetryService"],"sourceRoot":"../../../../src","sources":["services/telemetry/index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SAASA,gBAAgB,QAAQ,uBAAoB;AACrD,SAASC,QAAQ,EAAEC,oBAAoB,QAAQ,eAAY","ignoreList":[]}

package/lib/module/services/telemetry/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/services/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["services/telemetry/types.ts"],"mappings":"","ignoreList":[]}