@mostly-good-metrics/react-native 0.1.0

package/README.md

@@ -0,0 +1,228 @@
+# MostlyGoodMetrics React Native SDK
+
+A lightweight React Native SDK for tracking analytics events with [MostlyGoodMetrics](https://mostlygoodmetrics.com).
+
+## Requirements
+
+- React Native 0.71+
+- Expo SDK 49+ (if using Expo)
+
+## Installation
+
+### Expo (Recommended)
+
+```bash
+npm install @mostly-good-metrics/react-native
+```
+
+That's it! Expo includes AsyncStorage by default, so events persist across app restarts.
+
+### Bare React Native
+
+```bash
+npm install @mostly-good-metrics/react-native @react-native-async-storage/async-storage
+cd ios && pod install
+```
+
+**Note:** AsyncStorage is optional. Without it, events are stored in memory only (lost on app restart).
+
+## Quick Start
+
+### 1. Initialize the SDK
+
+Initialize once at app startup:
+
+```typescript
+import MostlyGoodMetrics from '@mostly-good-metrics/react-native';
+
+MostlyGoodMetrics.configure('mgm_proj_your_api_key');
+```
+
+### 2. Track Events
+
+```typescript
+// Simple event
+MostlyGoodMetrics.track('button_clicked');
+
+// Event with properties
+MostlyGoodMetrics.track('purchase_completed', {
+  product_id: 'SKU123',
+  price: 29.99,
+  currency: 'USD',
+});
+```
+
+### 3. Identify Users
+
+```typescript
+// Set user identity
+MostlyGoodMetrics.identify('user_123');
+
+// Reset identity (e.g., on logout)
+MostlyGoodMetrics.resetIdentity();
+```
+
+That's it! Events are automatically batched and sent.
+
+## Configuration Options
+
+For more control, pass a configuration object:
+
+```typescript
+import { version } from './package.json'; // Or use expo-constants
+
+MostlyGoodMetrics.configure('mgm_proj_your_api_key', {
+  baseURL: 'https://mostlygoodmetrics.com',
+  environment: 'production',
+  appVersion: version, // Required for install/update tracking
+  maxBatchSize: 100,
+  flushInterval: 30,
+  maxStoredEvents: 10000,
+  enableDebugLogging: __DEV__,
+  trackAppLifecycleEvents: true,
+});
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `baseURL` | `https://mostlygoodmetrics.com` | API endpoint |
+| `environment` | `"production"` | Environment name |
+| `appVersion` | - | App version string (required for install/update tracking) |
+| `maxBatchSize` | `100` | Events per batch (1-1000) |
+| `flushInterval` | `30` | Auto-flush interval in seconds |
+| `maxStoredEvents` | `10000` | Max cached events |
+| `enableDebugLogging` | `false` | Enable console output |
+| `trackAppLifecycleEvents` | `true` | Auto-track lifecycle events |
+
+## Automatic Events
+
+When `trackAppLifecycleEvents` is enabled (default), the SDK automatically tracks:
+
+| Event | When | Properties |
+|-------|------|------------|
+| `$app_installed` | First launch after install | `$version` |
+| `$app_updated` | First launch after version change | `$version`, `$previous_version` |
+| `$app_opened` | App became active (foreground) | - |
+| `$app_backgrounded` | App resigned active (background) | - |
+
+## Automatic Properties
+
+The SDK automatically includes these properties with every event:
+
+| Property | Description |
+|----------|-------------|
+| `$device_type` | Device type (`phone`, `tablet`) |
+| `$storage_type` | Storage type (`persistent` or `memory`) |
+
+Additionally, `osVersion` and `appVersion` (if configured) are included at the event level.
+
+## Event Naming
+
+Event names must:
+- Start with a letter (or `$` for system events)
+- Contain only alphanumeric characters and underscores
+- Be 255 characters or less
+
+```typescript
+// Valid
+MostlyGoodMetrics.track('button_clicked');
+MostlyGoodMetrics.track('PurchaseCompleted');
+MostlyGoodMetrics.track('step_1_completed');
+
+// Invalid (will be ignored)
+MostlyGoodMetrics.track('123_event');      // starts with number
+MostlyGoodMetrics.track('event-name');     // contains hyphen
+MostlyGoodMetrics.track('event name');     // contains space
+```
+
+## Properties
+
+Events support various property types:
+
+```typescript
+MostlyGoodMetrics.track('checkout', {
+  string_prop: 'value',
+  int_prop: 42,
+  double_prop: 3.14,
+  bool_prop: true,
+  null_prop: null,
+  list_prop: ['a', 'b', 'c'],
+  nested: {
+    key: 'value',
+  },
+});
+```
+
+**Limits:**
+- String values: truncated to 1000 characters
+- Nesting depth: max 3 levels
+- Total properties size: max 10KB
+
+## Manual Flush
+
+Events are automatically flushed periodically and when the app backgrounds. You can also trigger a manual flush:
+
+```typescript
+MostlyGoodMetrics.flush();
+```
+
+To check pending events:
+
+```typescript
+const count = await MostlyGoodMetrics.getPendingEventCount();
+console.log(`${count} events pending`);
+```
+
+## Automatic Behavior
+
+The SDK automatically:
+
+- **Persists events** to AsyncStorage, surviving app restarts
+- **Batches events** for efficient network usage
+- **Flushes on interval** (default: every 30 seconds)
+- **Flushes on background** when the app goes to background
+- **Retries on failure** for network errors (events are preserved)
+- **Persists user ID** across app launches
+- **Generates session IDs** per app launch
+
+## Debug Logging
+
+Enable debug logging to see SDK activity:
+
+```typescript
+MostlyGoodMetrics.configure('mgm_proj_your_api_key', {
+  enableDebugLogging: true,
+});
+```
+
+Output example:
+```
+[MostlyGoodMetrics] Configuring with options: {...}
+[MostlyGoodMetrics] Setting up lifecycle tracking
+[MostlyGoodMetrics] App opened (foreground)
+[MostlyGoodMetrics] Flushing events
+```
+
+## Running the Example
+
+```bash
+cd example
+npm install
+```
+
+For iOS:
+
+```bash
+cd ios && pod install && cd ..
+npm run ios
+```
+
+For Android:
+
+```bash
+npm run android
+```
+
+## License
+
+MIT

package/lib/commonjs/index.js

@@ -0,0 +1,267 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+var _javascript = require("@mostly-good-metrics/javascript");
+var _storage = require("./storage");
+// Use global to persist state across hot reloads
+const g = globalThis;
+
+// Initialize or restore state
+if (!g.__MGM_RN_STATE__) {
+  g.__MGM_RN_STATE__ = {
+    appStateSubscription: null,
+    isConfigured: false,
+    currentAppState: _reactNative.AppState.currentState,
+    debugLogging: false,
+    lastLifecycleEvent: null
+  };
+}
+const state = g.__MGM_RN_STATE__;
+const DEDUPE_INTERVAL_MS = 1000; // Ignore duplicate events within 1 second
+
+function log(...args) {
+  if (state.debugLogging) {
+    console.log('[MostlyGoodMetrics]', ...args);
+  }
+}
+
+/**
+ * Track a lifecycle event with deduplication.
+ */
+function trackLifecycleEvent(eventName, properties) {
+  const now = Date.now();
+
+  // Deduplicate events that fire multiple times in quick succession
+  if (state.lastLifecycleEvent && state.lastLifecycleEvent.name === eventName && now - state.lastLifecycleEvent.time < DEDUPE_INTERVAL_MS) {
+    log(`Skipping duplicate ${eventName} (${now - state.lastLifecycleEvent.time}ms ago)`);
+    return;
+  }
+  state.lastLifecycleEvent = {
+    name: eventName,
+    time: now
+  };
+  log(`Tracking lifecycle event: ${eventName}`);
+  _javascript.MostlyGoodMetrics.track(eventName, properties);
+}
+
+/**
+ * Handle app state changes for lifecycle tracking.
+ */
+function handleAppStateChange(nextAppState) {
+  if (!_javascript.MostlyGoodMetrics.shared) return;
+  log(`AppState change: ${state.currentAppState} -> ${nextAppState}`);
+
+  // App came to foreground
+  if (state.currentAppState.match(/inactive|background/) && nextAppState === 'active') {
+    trackLifecycleEvent(_javascript.SystemEvents.APP_OPENED);
+  }
+
+  // App went to background
+  if (state.currentAppState === 'active' && nextAppState.match(/inactive|background/)) {
+    trackLifecycleEvent(_javascript.SystemEvents.APP_BACKGROUNDED);
+    // Flush events when going to background
+    _javascript.MostlyGoodMetrics.flush().catch(e => log('Flush error:', e));
+  }
+  state.currentAppState = nextAppState;
+}
+
+/**
+ * Track app install or update events.
+ */
+async function trackInstallOrUpdate(appVersion) {
+  if (!appVersion) return;
+  const previousVersion = await _storage.persistence.getAppVersion();
+  const isFirst = await _storage.persistence.isFirstLaunch();
+  if (isFirst) {
+    trackLifecycleEvent(_javascript.SystemEvents.APP_INSTALLED, {
+      [_javascript.SystemProperties.VERSION]: appVersion
+    });
+    await _storage.persistence.setAppVersion(appVersion);
+  } else if (previousVersion && previousVersion !== appVersion) {
+    trackLifecycleEvent(_javascript.SystemEvents.APP_UPDATED, {
+      [_javascript.SystemProperties.VERSION]: appVersion,
+      [_javascript.SystemProperties.PREVIOUS_VERSION]: previousVersion
+    });
+    await _storage.persistence.setAppVersion(appVersion);
+  } else if (!previousVersion) {
+    await _storage.persistence.setAppVersion(appVersion);
+  }
+}
+
+/**
+ * MostlyGoodMetrics React Native SDK
+ */
+const MostlyGoodMetrics = {
+  /**
+   * Configure the SDK with an API key and optional settings.
+   */
+  configure(apiKey, config = {}) {
+    // Check both our state and the underlying JS SDK
+    if (state.isConfigured || _javascript.MostlyGoodMetrics.isConfigured) {
+      log('Already configured, skipping');
+      return;
+    }
+    state.debugLogging = config.enableDebugLogging ?? false;
+    log('Configuring with options:', config);
+
+    // Create AsyncStorage-based storage
+    const storage = new _storage.AsyncStorageEventStorage(config.maxStoredEvents);
+
+    // Restore user ID from storage
+    _storage.persistence.getUserId().then(userId => {
+      if (userId) {
+        log('Restored user ID:', userId);
+      }
+    });
+
+    // Configure the JS SDK
+    // Disable its built-in lifecycle tracking since we handle it ourselves
+    _javascript.MostlyGoodMetrics.configure({
+      apiKey,
+      ...config,
+      storage,
+      osVersion: getOSVersion(),
+      trackAppLifecycleEvents: false // We handle this with AppState
+    });
+    state.isConfigured = true;
+
+    // Set up React Native lifecycle tracking
+    if (config.trackAppLifecycleEvents !== false) {
+      log('Setting up lifecycle tracking, currentAppState:', state.currentAppState);
+
+      // Remove any existing listener (in case of hot reload)
+      if (state.appStateSubscription) {
+        state.appStateSubscription.remove();
+        state.appStateSubscription = null;
+      }
+
+      // Track initial app open
+      trackLifecycleEvent(_javascript.SystemEvents.APP_OPENED);
+
+      // Track install/update
+      trackInstallOrUpdate(config.appVersion).catch(e => log('Install/update tracking error:', e));
+
+      // Subscribe to app state changes
+      state.appStateSubscription = _reactNative.AppState.addEventListener('change', handleAppStateChange);
+    }
+  },
+  /**
+   * Track an event with optional properties.
+   */
+  track(name, properties) {
+    if (!state.isConfigured) {
+      console.warn('[MostlyGoodMetrics] SDK not configured. Call configure() first.');
+      return;
+    }
+
+    // Add React Native specific properties
+    const enrichedProperties = {
+      [_javascript.SystemProperties.DEVICE_TYPE]: getDeviceType(),
+      $storage_type: (0, _storage.getStorageType)(),
+      ...properties
+    };
+    _javascript.MostlyGoodMetrics.track(name, enrichedProperties);
+  },
+  /**
+   * Identify a user.
+   */
+  identify(userId) {
+    if (!state.isConfigured) {
+      console.warn('[MostlyGoodMetrics] SDK not configured. Call configure() first.');
+      return;
+    }
+    log('Identifying user:', userId);
+    _javascript.MostlyGoodMetrics.identify(userId);
+    // Also persist to AsyncStorage for restoration
+    _storage.persistence.setUserId(userId).catch(e => log('Failed to persist user ID:', e));
+  },
+  /**
+   * Clear the current user identity.
+   */
+  resetIdentity() {
+    if (!state.isConfigured) return;
+    log('Resetting identity');
+    _javascript.MostlyGoodMetrics.resetIdentity();
+    _storage.persistence.setUserId(null).catch(e => log('Failed to clear user ID:', e));
+  },
+  /**
+   * Manually flush pending events to the server.
+   */
+  flush() {
+    if (!state.isConfigured) return;
+    log('Flushing events');
+    _javascript.MostlyGoodMetrics.flush().catch(e => log('Flush error:', e));
+  },
+  /**
+   * Start a new session with a fresh session ID.
+   */
+  startNewSession() {
+    if (!state.isConfigured) return;
+    log('Starting new session');
+    _javascript.MostlyGoodMetrics.startNewSession();
+  },
+  /**
+   * Clear all pending events without sending them.
+   */
+  clearPendingEvents() {
+    if (!state.isConfigured) return;
+    log('Clearing pending events');
+    _javascript.MostlyGoodMetrics.clearPendingEvents().catch(e => log('Clear error:', e));
+  },
+  /**
+   * Get the number of pending events.
+   */
+  async getPendingEventCount() {
+    if (!state.isConfigured) return 0;
+    return _javascript.MostlyGoodMetrics.getPendingEventCount();
+  },
+  /**
+   * Clean up resources. Call when unmounting the app.
+   */
+  destroy() {
+    if (state.appStateSubscription) {
+      state.appStateSubscription.remove();
+      state.appStateSubscription = null;
+    }
+    _javascript.MostlyGoodMetrics.reset();
+    state.isConfigured = false;
+    state.lastLifecycleEvent = null;
+    log('Destroyed');
+  }
+};
+
+/**
+ * Get device type based on platform.
+ */
+function getDeviceType() {
+  if (_reactNative.Platform.OS === 'ios') {
+    // Could use react-native-device-info for more accuracy
+    return _reactNative.Platform.isPad ? 'tablet' : 'phone';
+  }
+  if (_reactNative.Platform.OS === 'android') {
+    return 'phone'; // Could detect tablet with dimensions
+  }
+  return 'unknown';
+}
+
+/**
+ * Get OS version based on platform.
+ */
+function getOSVersion() {
+  const version = _reactNative.Platform.Version;
+  if (_reactNative.Platform.OS === 'ios') {
+    // iOS returns a string like "15.0"
+    return String(version);
+  }
+  if (_reactNative.Platform.OS === 'android') {
+    // Android returns SDK version number (e.g., 31 for Android 12)
+    return String(version);
+  }
+  return 'unknown';
+}
+var _default = exports.default = MostlyGoodMetrics;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_javascript","_storage","g","globalThis","__MGM_RN_STATE__","appStateSubscription","isConfigured","currentAppState","AppState","currentState","debugLogging","lastLifecycleEvent","state","DEDUPE_INTERVAL_MS","log","args","console","trackLifecycleEvent","eventName","properties","now","Date","name","time","MGMClient","track","handleAppStateChange","nextAppState","shared","match","SystemEvents","APP_OPENED","APP_BACKGROUNDED","flush","catch","e","trackInstallOrUpdate","appVersion","previousVersion","persistence","getAppVersion","isFirst","isFirstLaunch","APP_INSTALLED","SystemProperties","VERSION","setAppVersion","APP_UPDATED","PREVIOUS_VERSION","MostlyGoodMetrics","configure","apiKey","config","enableDebugLogging","storage","AsyncStorageEventStorage","maxStoredEvents","getUserId","then","userId","osVersion","getOSVersion","trackAppLifecycleEvents","remove","addEventListener","warn","enrichedProperties","DEVICE_TYPE","getDeviceType","$storage_type","getStorageType","identify","setUserId","resetIdentity","startNewSession","clearPendingEvents","getPendingEventCount","destroy","reset","Platform","OS","isPad","version","Version","String","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/storage.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AsyncStorageEventStorage = void 0;
+exports.getStorageType = getStorageType;
+exports.persistence = void 0;
+const STORAGE_KEY = 'mostlygoodmetrics_events';
+const USER_ID_KEY = 'mostlygoodmetrics_user_id';
+const APP_VERSION_KEY = 'mostlygoodmetrics_app_version';
+const FIRST_LAUNCH_KEY = 'mostlygoodmetrics_installed';
+
+// Try to import AsyncStorage, fall back to null if not available
+let AsyncStorage = null;
+try {
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  AsyncStorage = require('@react-native-async-storage/async-storage').default;
+} catch {
+  // AsyncStorage not installed - will use in-memory storage
+}
+
+/**
+ * Returns the storage type being used.
+ */
+function getStorageType() {
+  return AsyncStorage ? 'persistent' : 'memory';
+}
+
+/**
+ * In-memory fallback storage when AsyncStorage is not available.
+ */
+const memoryStorage = {};
+
+/**
+ * Storage helpers that work with or without AsyncStorage.
+ */
+async function getItem(key) {
+  if (AsyncStorage) {
+    try {
+      return await AsyncStorage.getItem(key);
+    } catch {
+      return memoryStorage[key] ?? null;
+    }
+  }
+  return memoryStorage[key] ?? null;
+}
+async function setItem(key, value) {
+  memoryStorage[key] = value;
+  if (AsyncStorage) {
+    try {
+      await AsyncStorage.setItem(key, value);
+    } catch {
+      // Fall back to memory storage (already set above)
+    }
+  }
+}
+async function removeItem(key) {
+  delete memoryStorage[key];
+  if (AsyncStorage) {
+    try {
+      await AsyncStorage.removeItem(key);
+    } catch {
+      // Already removed from memory
+    }
+  }
+}
+
+/**
+ * Event storage for React Native.
+ * Uses AsyncStorage if available, otherwise falls back to in-memory storage.
+ */
+class AsyncStorageEventStorage {
+  events = null;
+  constructor(maxEvents = 10000) {
+    this.maxEvents = Math.max(maxEvents, 100);
+  }
+  async loadEvents() {
+    if (this.events !== null) {
+      return this.events;
+    }
+    try {
+      const stored = await getItem(STORAGE_KEY);
+      if (stored) {
+        this.events = JSON.parse(stored);
+      } else {
+        this.events = [];
+      }
+    } catch {
+      this.events = [];
+    }
+    return this.events;
+  }
+  async saveEvents() {
+    await setItem(STORAGE_KEY, JSON.stringify(this.events ?? []));
+  }
+  async store(event) {
+    const events = await this.loadEvents();
+    events.push(event);
+
+    // Trim oldest events if we exceed the limit
+    if (events.length > this.maxEvents) {
+      const excess = events.length - this.maxEvents;
+      events.splice(0, excess);
+    }
+    await this.saveEvents();
+  }
+  async fetchEvents(limit) {
+    const events = await this.loadEvents();
+    return events.slice(0, limit);
+  }
+  async removeEvents(count) {
+    const events = await this.loadEvents();
+    events.splice(0, count);
+    await this.saveEvents();
+  }
+  async eventCount() {
+    const events = await this.loadEvents();
+    return events.length;
+  }
+  async clear() {
+    this.events = [];
+    await removeItem(STORAGE_KEY);
+  }
+}
+
+/**
+ * Persistence helpers for user ID and app version.
+ */
+exports.AsyncStorageEventStorage = AsyncStorageEventStorage;
+const persistence = exports.persistence = {
+  async getUserId() {
+    return getItem(USER_ID_KEY);
+  },
+  async setUserId(userId) {
+    if (userId) {
+      await setItem(USER_ID_KEY, userId);
+    } else {
+      await removeItem(USER_ID_KEY);
+    }
+  },
+  async getAppVersion() {
+    return getItem(APP_VERSION_KEY);
+  },
+  async setAppVersion(version) {
+    if (version) {
+      await setItem(APP_VERSION_KEY, version);
+    } else {
+      await removeItem(APP_VERSION_KEY);
+    }
+  },
+  async isFirstLaunch() {
+    const hasLaunched = await getItem(FIRST_LAUNCH_KEY);
+    if (!hasLaunched) {
+      await setItem(FIRST_LAUNCH_KEY, 'true');
+      return true;
+    }
+    return false;
+  }
+};
+//# sourceMappingURL=storage.js.map

package/lib/commonjs/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_KEY","USER_ID_KEY","APP_VERSION_KEY","FIRST_LAUNCH_KEY","AsyncStorage","require","default","getStorageType","memoryStorage","getItem","key","setItem","value","removeItem","AsyncStorageEventStorage","events","constructor","maxEvents","Math","max","loadEvents","stored","JSON","parse","saveEvents","stringify","store","event","push","length","excess","splice","fetchEvents","limit","slice","removeEvents","count","eventCount","clear","exports","persistence","getUserId","setUserId","userId","getAppVersion","setAppVersion","version","isFirstLaunch","hasLaunched"],"sourceRoot":"../../src","sources":["storage.ts"],"mappings":"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","ignoreList":[]}