@formo/analytics-react-native 0.1.0

package/lib/commonjs/lib/event/EventQueue.js

@@ -0,0 +1,290 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EventQueue = void 0;
+var _reactNative = require("react-native");
+var _constants = require("../../constants");
+var _utils = require("../../utils");
+var _hash = require("../../utils/hash");
+var _timestamp = require("../../utils/timestamp");
+var _logger = require("../logger");
+const DEFAULT_RETRY = 3;
+const MAX_RETRY = 5;
+const MIN_RETRY = 1;
+const DEFAULT_FLUSH_AT = 20;
+const MAX_FLUSH_AT = 20;
+const MIN_FLUSH_AT = 1;
+const DEFAULT_QUEUE_SIZE = 1_024 * 500; // 500kB
+const MAX_QUEUE_SIZE = 1_024 * 500; // 500kB
+const MIN_QUEUE_SIZE = 200; // 200 bytes
+
+const DEFAULT_FLUSH_INTERVAL = 1_000 * 30; // 30 seconds
+const MAX_FLUSH_INTERVAL = 1_000 * 300; // 5 minutes
+const MIN_FLUSH_INTERVAL = 1_000 * 10; // 10 seconds
+
+const noop = () => {};
+
+/**
+ * Event queue for React Native
+ * Handles batching, flushing, and retries with app lifecycle awareness
+ */
+class EventQueue {
+  queue = [];
+  timer = null;
+  payloadHashes = new Set();
+  flushMutex = Promise.resolve();
+  appStateSubscription = null;
+  constructor(writeKey, options) {
+    this.writeKey = writeKey;
+    this.apiHost = options.apiHost;
+    this.retryCount = (0, _utils.clampNumber)(options.retryCount || DEFAULT_RETRY, MAX_RETRY, MIN_RETRY);
+    this.flushAt = (0, _utils.clampNumber)(options.flushAt || DEFAULT_FLUSH_AT, MAX_FLUSH_AT, MIN_FLUSH_AT);
+    this.maxQueueSize = (0, _utils.clampNumber)(options.maxQueueSize || DEFAULT_QUEUE_SIZE, MAX_QUEUE_SIZE, MIN_QUEUE_SIZE);
+    this.flushIntervalMs = (0, _utils.clampNumber)(options.flushInterval || DEFAULT_FLUSH_INTERVAL, MAX_FLUSH_INTERVAL, MIN_FLUSH_INTERVAL);
+    // Set up app state listener for React Native
+    this.setupAppStateListener();
+  }
+
+  /**
+   * Set up listener for app state changes
+   * Flush events when app goes to background
+   */
+  setupAppStateListener() {
+    this.appStateSubscription = _reactNative.AppState.addEventListener("change", this.handleAppStateChange.bind(this));
+  }
+
+  /**
+   * Handle app state changes
+   */
+  handleAppStateChange(nextAppState) {
+    // Flush when app goes to background or becomes inactive
+    if (nextAppState === "background" || nextAppState === "inactive") {
+      _logger.logger.debug("EventQueue: App going to background, flushing events");
+      this.flush().catch(error => {
+        _logger.logger.error("EventQueue: Failed to flush on background", error);
+      });
+    }
+  }
+
+  /**
+   * Generate message ID for deduplication
+   */
+  async generateMessageId(event) {
+    const formattedTimestamp = (0, _timestamp.toDateHourMinute)(new Date(event.original_timestamp));
+    const eventForHashing = {
+      ...event,
+      original_timestamp: formattedTimestamp
+    };
+    const eventString = JSON.stringify(eventForHashing);
+    return (0, _hash.hash)(eventString);
+  }
+
+  /**
+   * Check if event is a duplicate
+   */
+  isDuplicate(eventId) {
+    if (this.payloadHashes.has(eventId)) return true;
+    this.payloadHashes.add(eventId);
+    return false;
+  }
+
+  /**
+   * Add event to queue
+   */
+  async enqueue(event, callback) {
+    callback = callback || noop;
+    const message_id = await this.generateMessageId(event);
+
+    // Check for duplicate
+    if (this.isDuplicate(message_id)) {
+      _logger.logger.warn(`Event already enqueued, try again after ${(0, _utils.millisecondsToSecond)(this.flushIntervalMs)} seconds.`);
+      return;
+    }
+    this.queue.push({
+      message: {
+        ...event,
+        message_id
+      },
+      callback,
+      hash: message_id
+    });
+    _logger.logger.log(`Event enqueued: ${(0, _utils.getActionDescriptor)(event.type, event.properties)}`);
+    const hasReachedFlushAt = this.queue.length >= this.flushAt;
+    const hasReachedQueueSize = this.queue.reduce((acc, item) => acc + JSON.stringify(item).length, 0) >= this.maxQueueSize;
+    if (hasReachedFlushAt || hasReachedQueueSize) {
+      // Clear timer to prevent double flush
+      if (this.timer) {
+        clearTimeout(this.timer);
+        this.timer = null;
+      }
+      // Flush uses internal mutex to serialize operations
+      this.flush().catch(error => {
+        _logger.logger.error("EventQueue: Failed to flush on threshold", error);
+      });
+      return;
+    }
+    if (this.flushIntervalMs && !this.timer) {
+      this.timer = setTimeout(this.flush.bind(this), this.flushIntervalMs);
+    }
+  }
+
+  /**
+   * Flush events to API
+   * Uses a mutex to ensure only one flush operation runs at a time,
+   * preventing race conditions with re-queued items on failure.
+   */
+  async flush(callback) {
+    callback = callback || noop;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+
+    // Use mutex to serialize flush operations and prevent race conditions
+    const previousMutex = this.flushMutex;
+    let resolveMutex;
+    this.flushMutex = new Promise(resolve => {
+      resolveMutex = resolve;
+    });
+    try {
+      // Wait for any previous flush to complete
+      await previousMutex;
+      if (!this.queue.length) {
+        callback();
+        return;
+      }
+      const items = this.queue.splice(0, this.flushAt);
+      const sentAt = new Date().toISOString();
+      const data = items.map(item => ({
+        ...item.message,
+        sent_at: sentAt
+      }));
+      const done = err => {
+        items.forEach(({
+          message,
+          callback: itemCallback
+        }) => itemCallback(err, message, data));
+        callback(err, data);
+      };
+      try {
+        await this.sendWithRetry(data);
+        // Only remove hashes after successful send
+        items.forEach(item => this.payloadHashes.delete(item.hash));
+        done();
+        _logger.logger.info(`Events sent successfully: ${data.length} events`);
+      } catch (err) {
+        // Re-add items to the front of the queue for retry on next flush
+        // Note: We intentionally keep hashes in payloadHashes to prevent duplicate
+        // events from being enqueued while these items are pending retry.
+        this.queue.unshift(...items);
+        done(err);
+        _logger.logger.error("Error sending events, re-queued for retry:", err);
+        throw err;
+      }
+    } finally {
+      resolveMutex();
+    }
+  }
+
+  /**
+   * Send events with retry logic
+   */
+  async sendWithRetry(data, attempt = 0) {
+    try {
+      const response = await fetch(this.apiHost, {
+        method: "POST",
+        headers: (0, _constants.EVENTS_API_REQUEST_HEADER)(this.writeKey),
+        body: JSON.stringify(data)
+      });
+      if (!response.ok) {
+        const shouldRetry = this.shouldRetry(response.status);
+        if (shouldRetry && attempt < this.retryCount) {
+          const delay = Math.pow(2, attempt) * 1000;
+          await new Promise(resolve => setTimeout(() => resolve(), delay));
+          return this.sendWithRetry(data, attempt + 1);
+        }
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+    } catch (error) {
+      if ((0, _utils.isNetworkError)(error) && attempt < this.retryCount) {
+        const delay = Math.pow(2, attempt) * 1000;
+        _logger.logger.warn(`Network error, retrying in ${delay}ms...`);
+        await new Promise(resolve => setTimeout(() => resolve(), delay));
+        return this.sendWithRetry(data, attempt + 1);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Check if error should be retried
+   */
+  shouldRetry(status) {
+    // Retry on server errors (5xx) and rate limiting (429)
+    return status >= 500 && status <= 599 || status === 429;
+  }
+
+  /**
+   * Discard all pending events without sending them.
+   * Used when the user opts out of tracking to prevent queued events
+   * from being sent after consent is revoked.
+   */
+  clear() {
+    this.queue = [];
+    this.payloadHashes.clear();
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    _logger.logger.debug("EventQueue: Cleared all pending events");
+  }
+
+  /**
+   * Clean up resources, flushing any pending events first
+   */
+  async cleanup() {
+    // Flush all remaining queued events before teardown
+    // Loop until queue is empty since flush() only sends flushAt events per call
+    // Safety limit prevents infinite loops if flush silently fails
+    const maxAttempts = Math.ceil(this.queue.length / this.flushAt) + 3;
+    let attempts = 0;
+    const initialQueueLength = this.queue.length;
+    while (this.queue.length > 0 && attempts < maxAttempts) {
+      const queueLengthBefore = this.queue.length;
+      try {
+        await this.flush();
+      } catch (error) {
+        _logger.logger.error("EventQueue: Failed to flush during cleanup", error);
+        // Break on error to avoid infinite loop if flush keeps failing
+        break;
+      }
+
+      // If queue length didn't decrease, flush is silently failing
+      if (this.queue.length >= queueLengthBefore) {
+        _logger.logger.warn("EventQueue: Flush did not reduce queue size, aborting cleanup");
+        break;
+      }
+      attempts++;
+    }
+    if (attempts >= maxAttempts && this.queue.length > 0) {
+      _logger.logger.warn(`EventQueue: Cleanup safety limit reached. Discarding ${this.queue.length} events.`);
+      this.queue = [];
+      this.payloadHashes.clear();
+    }
+    if (initialQueueLength > 0) {
+      _logger.logger.debug(`EventQueue: Cleanup completed, flushed ${initialQueueLength - this.queue.length} events`);
+    }
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    if (this.appStateSubscription) {
+      this.appStateSubscription.remove();
+      this.appStateSubscription = null;
+    }
+  }
+}
+exports.EventQueue = EventQueue;
+//# sourceMappingURL=EventQueue.js.map

package/lib/commonjs/lib/event/EventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_constants","_utils","_hash","_timestamp","_logger","DEFAULT_RETRY","MAX_RETRY","MIN_RETRY","DEFAULT_FLUSH_AT","MAX_FLUSH_AT","MIN_FLUSH_AT","DEFAULT_QUEUE_SIZE","MAX_QUEUE_SIZE","MIN_QUEUE_SIZE","DEFAULT_FLUSH_INTERVAL","MAX_FLUSH_INTERVAL","MIN_FLUSH_INTERVAL","noop","EventQueue","queue","timer","payloadHashes","Set","flushMutex","Promise","resolve","appStateSubscription","constructor","writeKey","options","apiHost","retryCount","clampNumber","flushAt","maxQueueSize","flushIntervalMs","flushInterval","setupAppStateListener","AppState","addEventListener","handleAppStateChange","bind","nextAppState","logger","debug","flush","catch","error","generateMessageId","event","formattedTimestamp","toDateHourMinute","Date","original_timestamp","eventForHashing","eventString","JSON","stringify","hash","isDuplicate","eventId","has","add","enqueue","callback","message_id","warn","millisecondsToSecond","push","message","log","getActionDescriptor","type","properties","hasReachedFlushAt","length","hasReachedQueueSize","reduce","acc","item","clearTimeout","setTimeout","previousMutex","resolveMutex","items","splice","sentAt","toISOString","data","map","sent_at","done","err","forEach","itemCallback","sendWithRetry","delete","info","unshift","attempt","response","fetch","method","headers","EVENTS_API_REQUEST_HEADER","body","ok","shouldRetry","status","delay","Math","pow","Error","isNetworkError","clear","cleanup","maxAttempts","ceil","attempts","initialQueueLength","queueLengthBefore","remove","exports"],"sourceRoot":"../../../../src","sources":["lib/event/EventQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/event/index.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _EventFactory = require("./EventFactory");
+Object.keys(_EventFactory).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _EventFactory[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _EventFactory[key];
+    }
+  });
+});
+var _EventManager = require("./EventManager");
+Object.keys(_EventManager).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _EventManager[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _EventManager[key];
+    }
+  });
+});
+var _EventQueue = require("./EventQueue");
+Object.keys(_EventQueue).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _EventQueue[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _EventQueue[key];
+    }
+  });
+});
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_EventFactory","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_EventManager","_EventQueue","_types"],"sourceRoot":"../../../../src","sources":["lib/event/index.ts"],"mappings":";;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,aAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,aAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,aAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,aAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,aAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,aAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,aAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,WAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,WAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,WAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,WAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,MAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,MAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,MAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,MAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/lib/event/types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=types.js.map

package/lib/commonjs/lib/event/types.js.map

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

package/lib/commonjs/lib/lifecycle/index.js

@@ -0,0 +1,196 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AppLifecycleManager = void 0;
+var _reactNative = require("react-native");
+var _logger = require("../logger");
+var _storage = require("../storage");
+var _storage2 = require("../../constants/storage");
+/**
+ * Application Lifecycle Event Manager
+ *
+ * Tracks application lifecycle events following the Segment/RudderStack spec:
+ * - Application Installed (first launch)
+ * - Application Updated (version/build changed)
+ * - Application Opened (every cold start + foreground return)
+ * - Application Backgrounded (app goes to background)
+ *
+ * Detection is JS-side using AsyncStorage (no native modules required).
+ */
+
+/** Interface for the analytics instance to avoid circular deps */
+
+/** App version info resolved from device or config */
+
+/**
+ * Resolves current app version and build from device info modules or options.
+ * Uses the same fallback chain as EventFactory.getDeviceInfo().
+ */
+async function resolveAppVersionInfo(appOptions) {
+  // Use explicit options first
+  if (appOptions?.version && appOptions?.build) {
+    return {
+      version: appOptions.version,
+      build: appOptions.build
+    };
+  }
+
+  // Try react-native-device-info
+  try {
+    const DeviceInfo = require("react-native-device-info").default;
+    return {
+      version: appOptions?.version || DeviceInfo.getVersion(),
+      build: appOptions?.build || DeviceInfo.getBuildNumber()
+    };
+  } catch {
+    // Not available
+  }
+
+  // Try expo-application
+  try {
+    const ExpoApplication = require("expo-application");
+    return {
+      version: appOptions?.version || ExpoApplication.nativeApplicationVersion || "",
+      build: appOptions?.build || ExpoApplication.nativeBuildVersion || ""
+    };
+  } catch {
+    // Not available
+  }
+  return {
+    version: appOptions?.version || "",
+    build: appOptions?.build || ""
+  };
+}
+class AppLifecycleManager {
+  appStateSubscription = null;
+  lastAppState = _reactNative.AppState.currentState;
+  appVersionInfo = {
+    version: "",
+    build: ""
+  };
+  constructor(analytics) {
+    this.analytics = analytics;
+  }
+
+  /**
+   * Initialize lifecycle tracking.
+   * Detects install/update, fires Application Opened, and sets up AppState listener.
+   */
+  async start(appOptions) {
+    this.appVersionInfo = await resolveAppVersionInfo(appOptions);
+
+    // Detect install vs update
+    await this.detectInstallOrUpdate();
+
+    // Fire Application Opened (cold start)
+    let initialUrl;
+    try {
+      const url = await _reactNative.Linking.getInitialURL();
+      if (url) {
+        initialUrl = url;
+      }
+    } catch {
+      // Linking not available
+    }
+    await this.analytics.track("Application Opened", {
+      version: this.appVersionInfo.version,
+      build: this.appVersionInfo.build,
+      from_background: false,
+      ...(initialUrl && {
+        url: initialUrl
+      })
+    });
+
+    // Subscribe to AppState changes
+    this.appStateSubscription = _reactNative.AppState.addEventListener("change", this.handleAppStateChange.bind(this));
+    _logger.logger.info("AppLifecycleManager: Started");
+  }
+
+  /**
+   * Compare stored version/build with current to detect install or update.
+   * Requires persistent storage (AsyncStorage) — skips if only MemoryStorage is available,
+   * since MemoryStorage is empty on every cold start and would false-positive as "installed".
+   */
+  async detectInstallOrUpdate() {
+    const manager = (0, _storage.getStorageManager)();
+    const hasPersistentStorage = manager?.hasPersistentStorage() ?? false;
+    if (!hasPersistentStorage) {
+      _logger.logger.warn("AppLifecycleManager: AsyncStorage not available, skipping install/update detection. " + "Provide asyncStorage to FormoAnalyticsProvider for accurate lifecycle tracking.");
+      return;
+    }
+    const previousVersion = (0, _storage.storage)().get(_storage2.LOCAL_APP_VERSION_KEY);
+    const previousBuild = (0, _storage.storage)().get(_storage2.LOCAL_APP_BUILD_KEY);
+    const {
+      version,
+      build
+    } = this.appVersionInfo;
+    if (previousVersion === null && previousBuild === null) {
+      // No stored version — first install
+      _logger.logger.info("AppLifecycleManager: Application Installed");
+      await this.analytics.track("Application Installed", {
+        version,
+        build
+      });
+    } else if (previousVersion !== version || previousBuild !== build) {
+      // Version or build changed — update
+      _logger.logger.info("AppLifecycleManager: Application Updated");
+      await this.analytics.track("Application Updated", {
+        version,
+        build,
+        previous_version: previousVersion || "",
+        previous_build: previousBuild || ""
+      });
+    }
+
+    // Persist current version/build for next comparison
+    // Use setAsync to ensure data is written to AsyncStorage before continuing,
+    // preventing duplicate install events if the app is terminated before persistence completes
+    await (0, _storage.storage)().setAsync(_storage2.LOCAL_APP_VERSION_KEY, version);
+    await (0, _storage.storage)().setAsync(_storage2.LOCAL_APP_BUILD_KEY, build);
+  }
+
+  /**
+   * Handle AppState transitions for foreground/background events.
+   */
+  handleAppStateChange(nextAppState) {
+    // Ignore "inactive" (iOS transitional state) and "unknown"
+    if (nextAppState === "inactive" || nextAppState === "unknown") {
+      return;
+    }
+    if (nextAppState === "active" && this.lastAppState === "background") {
+      // Returning from background
+      this.analytics.track("Application Opened", {
+        version: this.appVersionInfo.version,
+        build: this.appVersionInfo.build,
+        from_background: true
+      }).catch(error => {
+        _logger.logger.error("AppLifecycleManager: Error tracking Application Opened", error);
+      });
+    }
+    if (nextAppState === "background" && this.lastAppState === "active") {
+      // Going to background
+      this.analytics.track("Application Backgrounded", {
+        version: this.appVersionInfo.version,
+        build: this.appVersionInfo.build
+      }).catch(error => {
+        _logger.logger.error("AppLifecycleManager: Error tracking Application Backgrounded", error);
+      });
+    }
+    this.lastAppState = nextAppState;
+  }
+
+  /**
+   * Clean up AppState listener.
+   */
+  cleanup() {
+    if (this.appStateSubscription) {
+      this.appStateSubscription.remove();
+      this.appStateSubscription = null;
+    }
+    _logger.logger.info("AppLifecycleManager: Cleaned up");
+  }
+}
+exports.AppLifecycleManager = AppLifecycleManager;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_logger","_storage","_storage2","resolveAppVersionInfo","appOptions","version","build","DeviceInfo","default","getVersion","getBuildNumber","ExpoApplication","nativeApplicationVersion","nativeBuildVersion","AppLifecycleManager","appStateSubscription","lastAppState","AppState","currentState","appVersionInfo","constructor","analytics","start","detectInstallOrUpdate","initialUrl","url","Linking","getInitialURL","track","from_background","addEventListener","handleAppStateChange","bind","logger","info","manager","getStorageManager","hasPersistentStorage","warn","previousVersion","storage","get","LOCAL_APP_VERSION_KEY","previousBuild","LOCAL_APP_BUILD_KEY","previous_version","previous_build","setAsync","nextAppState","catch","error","cleanup","remove","exports"],"sourceRoot":"../../../../src","sources":["lib/lifecycle/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/logger/index.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.logger = exports.Logger = void 0;
+class LoggerClass {
+  config = {
+    enabled: false,
+    enabledLevels: []
+  };
+  init(config) {
+    this.config = config;
+  }
+  shouldLog(level) {
+    if (!this.config.enabled) return false;
+    if (this.config.enabledLevels?.length === 0) return true;
+    return this.config.enabledLevels?.includes(level) ?? false;
+  }
+  debug(...args) {
+    if (this.shouldLog("debug")) {
+      console.debug("[Formo RN]", ...args);
+    }
+  }
+  info(...args) {
+    if (this.shouldLog("info")) {
+      console.info("[Formo RN]", ...args);
+    }
+  }
+  warn(...args) {
+    if (this.shouldLog("warn")) {
+      console.warn("[Formo RN]", ...args);
+    }
+  }
+  error(...args) {
+    if (this.shouldLog("error")) {
+      console.error("[Formo RN]", ...args);
+    }
+  }
+  log(...args) {
+    if (this.shouldLog("log")) {
+      console.log("[Formo RN]", ...args);
+    }
+  }
+}
+const Logger = exports.Logger = new LoggerClass();
+const logger = exports.logger = Logger;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LoggerClass","config","enabled","enabledLevels","init","shouldLog","level","length","includes","debug","args","console","info","warn","error","log","Logger","exports","logger"],"sourceRoot":"../../../../src","sources":["lib/logger/index.ts"],"mappings":";;;;;;AAOA,MAAMA,WAAW,CAAC;EACRC,MAAM,GAAiB;IAC7BC,OAAO,EAAE,KAAK;IACdC,aAAa,EAAE;EACjB,CAAC;EAEDC,IAAIA,CAACH,MAAoB,EAAE;IACzB,IAAI,CAACA,MAAM,GAAGA,MAAM;EACtB;EAEQI,SAASA,CAACC,KAAe,EAAW;IAC1C,IAAI,CAAC,IAAI,CAACL,MAAM,CAACC,OAAO,EAAE,OAAO,KAAK;IACtC,IAAI,IAAI,CAACD,MAAM,CAACE,aAAa,EAAEI,MAAM,KAAK,CAAC,EAAE,OAAO,IAAI;IACxD,OAAO,IAAI,CAACN,MAAM,CAACE,aAAa,EAAEK,QAAQ,CAACF,KAAK,CAAC,IAAI,KAAK;EAC5D;EAEAG,KAAKA,CAAC,GAAGC,IAAe,EAAE;IACxB,IAAI,IAAI,CAACL,SAAS,CAAC,OAAO,CAAC,EAAE;MAC3BM,OAAO,CAACF,KAAK,CAAC,YAAY,EAAE,GAAGC,IAAI,CAAC;IACtC;EACF;EAEAE,IAAIA,CAAC,GAAGF,IAAe,EAAE;IACvB,IAAI,IAAI,CAACL,SAAS,CAAC,MAAM,CAAC,EAAE;MAC1BM,OAAO,CAACC,IAAI,CAAC,YAAY,EAAE,GAAGF,IAAI,CAAC;IACrC;EACF;EAEAG,IAAIA,CAAC,GAAGH,IAAe,EAAE;IACvB,IAAI,IAAI,CAACL,SAAS,CAAC,MAAM,CAAC,EAAE;MAC1BM,OAAO,CAACE,IAAI,CAAC,YAAY,EAAE,GAAGH,IAAI,CAAC;IACrC;EACF;EAEAI,KAAKA,CAAC,GAAGJ,IAAe,EAAE;IACxB,IAAI,IAAI,CAACL,SAAS,CAAC,OAAO,CAAC,EAAE;MAC3BM,OAAO,CAACG,KAAK,CAAC,YAAY,EAAE,GAAGJ,IAAI,CAAC;IACtC;EACF;EAEAK,GAAGA,CAAC,GAAGL,IAAe,EAAE;IACtB,IAAI,IAAI,CAACL,SAAS,CAAC,KAAK,CAAC,EAAE;MACzBM,OAAO,CAACI,GAAG,CAAC,YAAY,EAAE,GAAGL,IAAI,CAAC;IACpC;EACF;AACF;AAEO,MAAMM,MAAM,GAAAC,OAAA,CAAAD,MAAA,GAAG,IAAIhB,WAAW,CAAC,CAAC;AAChC,MAAMkB,MAAM,GAAAD,OAAA,CAAAC,MAAA,GAAGF,MAAM","ignoreList":[]}