@mostly-good-metrics/react-native 0.1.0

package/lib/module/index.js

@@ -0,0 +1,261 @@
+import { AppState, Platform } from 'react-native';
+import { MostlyGoodMetrics as MGMClient, SystemEvents, SystemProperties } from '@mostly-good-metrics/javascript';
+import { AsyncStorageEventStorage, persistence, getStorageType } from './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: 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}`);
+  MGMClient.track(eventName, properties);
+}
+
+/**
+ * Handle app state changes for lifecycle tracking.
+ */
+function handleAppStateChange(nextAppState) {
+  if (!MGMClient.shared) return;
+  log(`AppState change: ${state.currentAppState} -> ${nextAppState}`);
+
+  // App came to foreground
+  if (state.currentAppState.match(/inactive|background/) && nextAppState === 'active') {
+    trackLifecycleEvent(SystemEvents.APP_OPENED);
+  }
+
+  // App went to background
+  if (state.currentAppState === 'active' && nextAppState.match(/inactive|background/)) {
+    trackLifecycleEvent(SystemEvents.APP_BACKGROUNDED);
+    // Flush events when going to background
+    MGMClient.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 persistence.getAppVersion();
+  const isFirst = await persistence.isFirstLaunch();
+  if (isFirst) {
+    trackLifecycleEvent(SystemEvents.APP_INSTALLED, {
+      [SystemProperties.VERSION]: appVersion
+    });
+    await persistence.setAppVersion(appVersion);
+  } else if (previousVersion && previousVersion !== appVersion) {
+    trackLifecycleEvent(SystemEvents.APP_UPDATED, {
+      [SystemProperties.VERSION]: appVersion,
+      [SystemProperties.PREVIOUS_VERSION]: previousVersion
+    });
+    await persistence.setAppVersion(appVersion);
+  } else if (!previousVersion) {
+    await 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 || MGMClient.isConfigured) {
+      log('Already configured, skipping');
+      return;
+    }
+    state.debugLogging = config.enableDebugLogging ?? false;
+    log('Configuring with options:', config);
+
+    // Create AsyncStorage-based storage
+    const storage = new AsyncStorageEventStorage(config.maxStoredEvents);
+
+    // Restore user ID from 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
+    MGMClient.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(SystemEvents.APP_OPENED);
+
+      // Track install/update
+      trackInstallOrUpdate(config.appVersion).catch(e => log('Install/update tracking error:', e));
+
+      // Subscribe to app state changes
+      state.appStateSubscription = 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 = {
+      [SystemProperties.DEVICE_TYPE]: getDeviceType(),
+      $storage_type: getStorageType(),
+      ...properties
+    };
+    MGMClient.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);
+    MGMClient.identify(userId);
+    // Also persist to AsyncStorage for restoration
+    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');
+    MGMClient.resetIdentity();
+    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');
+    MGMClient.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');
+    MGMClient.startNewSession();
+  },
+  /**
+   * Clear all pending events without sending them.
+   */
+  clearPendingEvents() {
+    if (!state.isConfigured) return;
+    log('Clearing pending events');
+    MGMClient.clearPendingEvents().catch(e => log('Clear error:', e));
+  },
+  /**
+   * Get the number of pending events.
+   */
+  async getPendingEventCount() {
+    if (!state.isConfigured) return 0;
+    return MGMClient.getPendingEventCount();
+  },
+  /**
+   * Clean up resources. Call when unmounting the app.
+   */
+  destroy() {
+    if (state.appStateSubscription) {
+      state.appStateSubscription.remove();
+      state.appStateSubscription = null;
+    }
+    MGMClient.reset();
+    state.isConfigured = false;
+    state.lastLifecycleEvent = null;
+    log('Destroyed');
+  }
+};
+
+/**
+ * Get device type based on platform.
+ */
+function getDeviceType() {
+  if (Platform.OS === 'ios') {
+    // Could use react-native-device-info for more accuracy
+    return Platform.isPad ? 'tablet' : 'phone';
+  }
+  if (Platform.OS === 'android') {
+    return 'phone'; // Could detect tablet with dimensions
+  }
+  return 'unknown';
+}
+
+/**
+ * Get OS version based on platform.
+ */
+function getOSVersion() {
+  const version = Platform.Version;
+  if (Platform.OS === 'ios') {
+    // iOS returns a string like "15.0"
+    return String(version);
+  }
+  if (Platform.OS === 'android') {
+    // Android returns SDK version number (e.g., 31 for Android 12)
+    return String(version);
+  }
+  return 'unknown';
+}
+export default MostlyGoodMetrics;
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

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

package/lib/module/storage.js

@@ -0,0 +1,152 @@
+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.
+ */
+export 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.
+ */
+export 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.
+ */
+export const 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/module/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","persistence","getUserId","setUserId","userId","getAppVersion","setAppVersion","version","isFirstLaunch","hasLaunched"],"sourceRoot":"../../src","sources":["storage.ts"],"mappings":"AAEA,MAAMA,WAAW,GAAG,0BAA0B;AAC9C,MAAMC,WAAW,GAAG,2BAA2B;AAC/C,MAAMC,eAAe,GAAG,+BAA+B;AACvD,MAAMC,gBAAgB,GAAG,6BAA6B;;AAEtD;AACA,IAAIC,YAAuF,GAAG,IAAI;AAClG,IAAI;EACF;EACAA,YAAY,GAAGC,OAAO,CAAC,2CAA2C,CAAC,CAACC,OAAO;AAC7E,CAAC,CAAC,MAAM;EACN;AAAA;;AAGF;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAA4B;EACxD,OAAOH,YAAY,GAAG,YAAY,GAAG,QAAQ;AAC/C;;AAEA;AACA;AACA;AACA,MAAMI,aAAqC,GAAG,CAAC,CAAC;;AAEhD;AACA;AACA;AACA,eAAeC,OAAOA,CAACC,GAAW,EAA0B;EAC1D,IAAIN,YAAY,EAAE;IAChB,IAAI;MACF,OAAO,MAAMA,YAAY,CAACK,OAAO,CAACC,GAAG,CAAC;IACxC,CAAC,CAAC,MAAM;MACN,OAAOF,aAAa,CAACE,GAAG,CAAC,IAAI,IAAI;IACnC;EACF;EACA,OAAOF,aAAa,CAACE,GAAG,CAAC,IAAI,IAAI;AACnC;AAEA,eAAeC,OAAOA,CAACD,GAAW,EAAEE,KAAa,EAAiB;EAChEJ,aAAa,CAACE,GAAG,CAAC,GAAGE,KAAK;EAC1B,IAAIR,YAAY,EAAE;IAChB,IAAI;MACF,MAAMA,YAAY,CAACO,OAAO,CAACD,GAAG,EAAEE,KAAK,CAAC;IACxC,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF;AAEA,eAAeC,UAAUA,CAACH,GAAW,EAAiB;EACpD,OAAOF,aAAa,CAACE,GAAG,CAAC;EACzB,IAAIN,YAAY,EAAE;IAChB,IAAI;MACF,MAAMA,YAAY,CAACS,UAAU,CAACH,GAAG,CAAC;IACpC,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMI,wBAAwB,CAA0B;EAErDC,MAAM,GAAsB,IAAI;EAExCC,WAAWA,CAACC,SAAiB,GAAG,KAAK,EAAE;IACrC,IAAI,CAACA,SAAS,GAAGC,IAAI,CAACC,GAAG,CAACF,SAAS,EAAE,GAAG,CAAC;EAC3C;EAEA,MAAcG,UAAUA,CAAA,EAAwB;IAC9C,IAAI,IAAI,CAACL,MAAM,KAAK,IAAI,EAAE;MACxB,OAAO,IAAI,CAACA,MAAM;IACpB;IAEA,IAAI;MACF,MAAMM,MAAM,GAAG,MAAMZ,OAAO,CAACT,WAAW,CAAC;MACzC,IAAIqB,MAAM,EAAE;QACV,IAAI,CAACN,MAAM,GAAGO,IAAI,CAACC,KAAK,CAACF,MAAM,CAAe;MAChD,CAAC,MAAM;QACL,IAAI,CAACN,MAAM,GAAG,EAAE;MAClB;IACF,CAAC,CAAC,MAAM;MACN,IAAI,CAACA,MAAM,GAAG,EAAE;IAClB;IAEA,OAAO,IAAI,CAACA,MAAM;EACpB;EAEA,MAAcS,UAAUA,CAAA,EAAkB;IACxC,MAAMb,OAAO,CAACX,WAAW,EAAEsB,IAAI,CAACG,SAAS,CAAC,IAAI,CAACV,MAAM,IAAI,EAAE,CAAC,CAAC;EAC/D;EAEA,MAAMW,KAAKA,CAACC,KAAe,EAAiB;IAC1C,MAAMZ,MAAM,GAAG,MAAM,IAAI,CAACK,UAAU,CAAC,CAAC;IACtCL,MAAM,CAACa,IAAI,CAACD,KAAK,CAAC;;IAElB;IACA,IAAIZ,MAAM,CAACc,MAAM,GAAG,IAAI,CAACZ,SAAS,EAAE;MAClC,MAAMa,MAAM,GAAGf,MAAM,CAACc,MAAM,GAAG,IAAI,CAACZ,SAAS;MAC7CF,MAAM,CAACgB,MAAM,CAAC,CAAC,EAAED,MAAM,CAAC;IAC1B;IAEA,MAAM,IAAI,CAACN,UAAU,CAAC,CAAC;EACzB;EAEA,MAAMQ,WAAWA,CAACC,KAAa,EAAuB;IACpD,MAAMlB,MAAM,GAAG,MAAM,IAAI,CAACK,UAAU,CAAC,CAAC;IACtC,OAAOL,MAAM,CAACmB,KAAK,CAAC,CAAC,EAAED,KAAK,CAAC;EAC/B;EAEA,MAAME,YAAYA,CAACC,KAAa,EAAiB;IAC/C,MAAMrB,MAAM,GAAG,MAAM,IAAI,CAACK,UAAU,CAAC,CAAC;IACtCL,MAAM,CAACgB,MAAM,CAAC,CAAC,EAAEK,KAAK,CAAC;IACvB,MAAM,IAAI,CAACZ,UAAU,CAAC,CAAC;EACzB;EAEA,MAAMa,UAAUA,CAAA,EAAoB;IAClC,MAAMtB,MAAM,GAAG,MAAM,IAAI,CAACK,UAAU,CAAC,CAAC;IACtC,OAAOL,MAAM,CAACc,MAAM;EACtB;EAEA,MAAMS,KAAKA,CAAA,EAAkB;IAC3B,IAAI,CAACvB,MAAM,GAAG,EAAE;IAChB,MAAMF,UAAU,CAACb,WAAW,CAAC;EAC/B;AACF;;AAEA;AACA;AACA;AACA,OAAO,MAAMuC,WAAW,GAAG;EACzB,MAAMC,SAASA,CAAA,EAA2B;IACxC,OAAO/B,OAAO,CAACR,WAAW,CAAC;EAC7B,CAAC;EAED,MAAMwC,SAASA,CAACC,MAAqB,EAAiB;IACpD,IAAIA,MAAM,EAAE;MACV,MAAM/B,OAAO,CAACV,WAAW,EAAEyC,MAAM,CAAC;IACpC,CAAC,MAAM;MACL,MAAM7B,UAAU,CAACZ,WAAW,CAAC;IAC/B;EACF,CAAC;EAED,MAAM0C,aAAaA,CAAA,EAA2B;IAC5C,OAAOlC,OAAO,CAACP,eAAe,CAAC;EACjC,CAAC;EAED,MAAM0C,aAAaA,CAACC,OAAsB,EAAiB;IACzD,IAAIA,OAAO,EAAE;MACX,MAAMlC,OAAO,CAACT,eAAe,EAAE2C,OAAO,CAAC;IACzC,CAAC,MAAM;MACL,MAAMhC,UAAU,CAACX,eAAe,CAAC;IACnC;EACF,CAAC;EAED,MAAM4C,aAAaA,CAAA,EAAqB;IACtC,MAAMC,WAAW,GAAG,MAAMtC,OAAO,CAACN,gBAAgB,CAAC;IACnD,IAAI,CAAC4C,WAAW,EAAE;MAChB,MAAMpC,OAAO,CAACR,gBAAgB,EAAE,MAAM,CAAC;MACvC,OAAO,IAAI;IACb;IACA,OAAO,KAAK;EACd;AACF,CAAC","ignoreList":[]}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,51 @@
+import { type MGMConfiguration, type EventProperties } from '@mostly-good-metrics/javascript';
+export type { MGMConfiguration, EventProperties };
+export interface ReactNativeConfig extends Omit<MGMConfiguration, 'storage'> {
+    /**
+     * The app version string. Required for install/update tracking.
+     */
+    appVersion?: string;
+}
+/**
+ * MostlyGoodMetrics React Native SDK
+ */
+declare const MostlyGoodMetrics: {
+    /**
+     * Configure the SDK with an API key and optional settings.
+     */
+    configure(apiKey: string, config?: Omit<ReactNativeConfig, "apiKey">): void;
+    /**
+     * Track an event with optional properties.
+     */
+    track(name: string, properties?: EventProperties): void;
+    /**
+     * Identify a user.
+     */
+    identify(userId: string): void;
+    /**
+     * Clear the current user identity.
+     */
+    resetIdentity(): void;
+    /**
+     * Manually flush pending events to the server.
+     */
+    flush(): void;
+    /**
+     * Start a new session with a fresh session ID.
+     */
+    startNewSession(): void;
+    /**
+     * Clear all pending events without sending them.
+     */
+    clearPendingEvents(): void;
+    /**
+     * Get the number of pending events.
+     */
+    getPendingEventCount(): Promise<number>;
+    /**
+     * Clean up resources. Call when unmounting the app.
+     */
+    destroy(): void;
+};
+export default MostlyGoodMetrics;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAGrB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAC1E;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqGD;;GAEG;AACH,QAAA,MAAM,iBAAiB;IACrB;;OAEG;sBACe,MAAM,WAAU,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAAQ,IAAI;IAqD/E;;OAEG;gBACS,MAAM,eAAe,eAAe,GAAG,IAAI;IAgBvD;;OAEG;qBACc,MAAM,GAAG,IAAI;IAY9B;;OAEG;qBACc,IAAI;IAQrB;;OAEG;aACM,IAAI;IAOb;;OAEG;uBACgB,IAAI;IAOvB;;OAEG;0BACmB,IAAI;IAO1B;;OAEG;4BAC2B,OAAO,CAAC,MAAM,CAAC;IAK7C;;OAEG;eACQ,IAAI;CAUhB,CAAC;AAgCF,eAAe,iBAAiB,CAAC"}

package/lib/typescript/src/storage.d.ts

@@ -0,0 +1,32 @@
+import type { IEventStorage, MGMEvent } from '@mostly-good-metrics/javascript';
+/**
+ * Returns the storage type being used.
+ */
+export declare function getStorageType(): 'persistent' | 'memory';
+/**
+ * Event storage for React Native.
+ * Uses AsyncStorage if available, otherwise falls back to in-memory storage.
+ */
+export declare class AsyncStorageEventStorage implements IEventStorage {
+    private maxEvents;
+    private events;
+    constructor(maxEvents?: number);
+    private loadEvents;
+    private saveEvents;
+    store(event: MGMEvent): Promise<void>;
+    fetchEvents(limit: number): Promise<MGMEvent[]>;
+    removeEvents(count: number): Promise<void>;
+    eventCount(): Promise<number>;
+    clear(): Promise<void>;
+}
+/**
+ * Persistence helpers for user ID and app version.
+ */
+export declare const persistence: {
+    getUserId(): Promise<string | null>;
+    setUserId(userId: string | null): Promise<void>;
+    getAppVersion(): Promise<string | null>;
+    setAppVersion(version: string | null): Promise<void>;
+    isFirstLaunch(): Promise<boolean>;
+};
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/src/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAgB/E;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,GAAG,QAAQ,CAExD;AA2CD;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,aAAa;IAC5D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,SAAS,GAAE,MAAc;YAIvB,UAAU;YAmBV,UAAU;IAIlB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAarC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK/C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;iBACH,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;sBAIjB,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;qBAQ9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;2BAIhB,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;qBAQnC,OAAO,CAAC,OAAO,CAAC;CAQxC,CAAC"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@mostly-good-metrics/react-native",
+  "version": "0.1.0",
+  "description": "React Native SDK for MostlyGoodMetrics analytics",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "typescript": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "prepare": "bob build",
+    "clean": "del-cli lib"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "analytics",
+    "metrics",
+    "mostlygoodmetrics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mostly-Good-Metrics/mostly-good-metrics-react-native.git"
+  },
+  "author": "Josh Holtz",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Mostly-Good-Metrics/mostly-good-metrics-react-native/issues"
+  },
+  "homepage": "https://github.com/Mostly-Good-Metrics/mostly-good-metrics-react-native#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@mostly-good-metrics/javascript": "^0.1.0"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.21.0",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "del-cli": "^5.0.0",
+    "jest": "^30.2.0",
+    "react": "^18.2.0",
+    "react-native": "^0.73.0",
+    "react-native-builder-bob": "^0.23.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": true
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}