@formo/analytics-react-native 0.1.0

package/lib/module/lib/event/EventQueue.js

@@ -0,0 +1,283 @@
+import { AppState } from "react-native";
+import { EVENTS_API_REQUEST_HEADER } from "../../constants";
+import { clampNumber, getActionDescriptor, millisecondsToSecond, isNetworkError } from "../../utils";
+import { hash } from "../../utils/hash";
+import { toDateHourMinute } from "../../utils/timestamp";
+import { logger } from "../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
+ */
+export 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 = clampNumber(options.retryCount || DEFAULT_RETRY, MAX_RETRY, MIN_RETRY);
+    this.flushAt = clampNumber(options.flushAt || DEFAULT_FLUSH_AT, MAX_FLUSH_AT, MIN_FLUSH_AT);
+    this.maxQueueSize = clampNumber(options.maxQueueSize || DEFAULT_QUEUE_SIZE, MAX_QUEUE_SIZE, MIN_QUEUE_SIZE);
+    this.flushIntervalMs = 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 = 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.debug("EventQueue: App going to background, flushing events");
+      this.flush().catch(error => {
+        logger.error("EventQueue: Failed to flush on background", error);
+      });
+    }
+  }
+
+  /**
+   * Generate message ID for deduplication
+   */
+  async generateMessageId(event) {
+    const formattedTimestamp = toDateHourMinute(new Date(event.original_timestamp));
+    const eventForHashing = {
+      ...event,
+      original_timestamp: formattedTimestamp
+    };
+    const eventString = JSON.stringify(eventForHashing);
+    return 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.warn(`Event already enqueued, try again after ${millisecondsToSecond(this.flushIntervalMs)} seconds.`);
+      return;
+    }
+    this.queue.push({
+      message: {
+        ...event,
+        message_id
+      },
+      callback,
+      hash: message_id
+    });
+    logger.log(`Event enqueued: ${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.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.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.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: 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 (isNetworkError(error) && attempt < this.retryCount) {
+        const delay = Math.pow(2, attempt) * 1000;
+        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.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.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.warn("EventQueue: Flush did not reduce queue size, aborting cleanup");
+        break;
+      }
+      attempts++;
+    }
+    if (attempts >= maxAttempts && this.queue.length > 0) {
+      logger.warn(`EventQueue: Cleanup safety limit reached. Discarding ${this.queue.length} events.`);
+      this.queue = [];
+      this.payloadHashes.clear();
+    }
+    if (initialQueueLength > 0) {
+      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;
+    }
+  }
+}
+//# sourceMappingURL=EventQueue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["AppState","EVENTS_API_REQUEST_HEADER","clampNumber","getActionDescriptor","millisecondsToSecond","isNetworkError","hash","toDateHourMinute","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","flushAt","maxQueueSize","flushIntervalMs","flushInterval","setupAppStateListener","addEventListener","handleAppStateChange","bind","nextAppState","debug","flush","catch","error","generateMessageId","event","formattedTimestamp","Date","original_timestamp","eventForHashing","eventString","JSON","stringify","isDuplicate","eventId","has","add","enqueue","callback","message_id","warn","push","message","log","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","body","ok","shouldRetry","status","delay","Math","pow","Error","clear","cleanup","maxAttempts","ceil","attempts","initialQueueLength","queueLengthBefore","remove"],"sourceRoot":"../../../../src","sources":["lib/event/EventQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/lib/event/index.js

@@ -0,0 +1,5 @@
+export * from "./EventFactory";
+export * from "./EventManager";
+export * from "./EventQueue";
+export * from "./types";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["lib/event/index.ts"],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,gBAAgB;AAC9B,cAAc,cAAc;AAC5B,cAAc,SAAS","ignoreList":[]}

package/lib/module/lib/event/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/lib/module/lib/lifecycle/index.js

@@ -0,0 +1,190 @@
+/**
+ * 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).
+ */
+
+import { AppState, Linking } from "react-native";
+import { logger } from "../logger";
+import { storage, getStorageManager } from "../storage";
+import { LOCAL_APP_VERSION_KEY, LOCAL_APP_BUILD_KEY } from "../../constants/storage";
+
+/** 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 || ""
+  };
+}
+export class AppLifecycleManager {
+  appStateSubscription = null;
+  lastAppState = 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 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 = AppState.addEventListener("change", this.handleAppStateChange.bind(this));
+    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 = getStorageManager();
+    const hasPersistentStorage = manager?.hasPersistentStorage() ?? false;
+    if (!hasPersistentStorage) {
+      logger.warn("AppLifecycleManager: AsyncStorage not available, skipping install/update detection. " + "Provide asyncStorage to FormoAnalyticsProvider for accurate lifecycle tracking.");
+      return;
+    }
+    const previousVersion = storage().get(LOCAL_APP_VERSION_KEY);
+    const previousBuild = storage().get(LOCAL_APP_BUILD_KEY);
+    const {
+      version,
+      build
+    } = this.appVersionInfo;
+    if (previousVersion === null && previousBuild === null) {
+      // No stored version — first install
+      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.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 storage().setAsync(LOCAL_APP_VERSION_KEY, version);
+    await storage().setAsync(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.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.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.info("AppLifecycleManager: Cleaned up");
+  }
+}
+//# sourceMappingURL=index.js.map

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

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

package/lib/module/lib/logger/index.js

@@ -0,0 +1,42 @@
+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);
+    }
+  }
+}
+export const Logger = new LoggerClass();
+export const logger = Logger;
+//# sourceMappingURL=index.js.map

package/lib/module/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","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;AAEA,OAAO,MAAMM,MAAM,GAAG,IAAIhB,WAAW,CAAC,CAAC;AACvC,OAAO,MAAMiB,MAAM,GAAGD,MAAM","ignoreList":[]}

package/lib/module/lib/session/index.js

@@ -0,0 +1,92 @@
+import { SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY } from "../../constants";
+import { storage } from "../storage";
+import { logger } from "../logger";
+export { SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY };
+
+/**
+ * Session manager for tracking wallet detection and identification
+ * Persists to session storage to avoid duplicate detection/identification events
+ * within the same session
+ */
+export class FormoAnalyticsSession {
+  detectedWallets = new Set();
+  identifiedWallets = new Set();
+  constructor() {
+    this.loadFromStorage();
+  }
+
+  /**
+   * Load session state from storage
+   */
+  loadFromStorage() {
+    try {
+      const detected = storage().get(SESSION_WALLET_DETECTED_KEY);
+      if (detected) {
+        const parsed = JSON.parse(detected);
+        this.detectedWallets = new Set(parsed);
+      }
+      const identified = storage().get(SESSION_WALLET_IDENTIFIED_KEY);
+      if (identified) {
+        const parsed = JSON.parse(identified);
+        this.identifiedWallets = new Set(parsed);
+      }
+    } catch (error) {
+      logger.debug("Session: Failed to load from storage", error);
+    }
+  }
+
+  /**
+   * Save session state to storage
+   */
+  saveToStorage() {
+    try {
+      storage().set(SESSION_WALLET_DETECTED_KEY, JSON.stringify(Array.from(this.detectedWallets)));
+      storage().set(SESSION_WALLET_IDENTIFIED_KEY, JSON.stringify(Array.from(this.identifiedWallets)));
+    } catch (error) {
+      logger.debug("Session: Failed to save to storage", error);
+    }
+  }
+
+  /**
+   * Check if a wallet has been detected in this session
+   */
+  isWalletDetected(rdns) {
+    return this.detectedWallets.has(rdns);
+  }
+
+  /**
+   * Mark a wallet as detected
+   */
+  markWalletDetected(rdns) {
+    this.detectedWallets.add(rdns);
+    this.saveToStorage();
+  }
+
+  /**
+   * Check if a wallet + address combination has been identified
+   */
+  isWalletIdentified(address, rdns) {
+    const key = `${address.toLowerCase()}:${rdns}`;
+    return this.identifiedWallets.has(key);
+  }
+
+  /**
+   * Mark a wallet + address combination as identified
+   */
+  markWalletIdentified(address, rdns) {
+    const key = `${address.toLowerCase()}:${rdns}`;
+    this.identifiedWallets.add(key);
+    this.saveToStorage();
+  }
+
+  /**
+   * Clear all session data
+   */
+  clear() {
+    this.detectedWallets.clear();
+    this.identifiedWallets.clear();
+    storage().remove(SESSION_WALLET_DETECTED_KEY);
+    storage().remove(SESSION_WALLET_IDENTIFIED_KEY);
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/module/lib/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SESSION_WALLET_DETECTED_KEY","SESSION_WALLET_IDENTIFIED_KEY","storage","logger","FormoAnalyticsSession","detectedWallets","Set","identifiedWallets","constructor","loadFromStorage","detected","get","parsed","JSON","parse","identified","error","debug","saveToStorage","set","stringify","Array","from","isWalletDetected","rdns","has","markWalletDetected","add","isWalletIdentified","address","key","toLowerCase","markWalletIdentified","clear","remove"],"sourceRoot":"../../../../src","sources":["lib/session/index.ts"],"mappings":"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","ignoreList":[]}