respectlytics-react-native 1.0.1 → 2.0.0

package/README.md

@@ -4,15 +4,15 @@
 [![Platform](https://img.shields.io/badge/platform-iOS%20%7C%20Android-lightgrey.svg)](https://github.com/respectlytics/respectlytics-react-native)
 [![License](https://img.shields.io/badge/license-Proprietary-blue.svg)](LICENSE)
 
-Official Respectlytics SDK for React Native. Privacy-first analytics with automatic session management, offline event queuing, and zero device identifier collection.
+Official Respectlytics SDK for React Native. Privacy-first, session-based analytics with automatic session management, offline event queuing, and zero device identifier collection.
 
 ## Features
 
 - 🔒 **Privacy-First**: No device identifiers (IDFA, GAID, Android ID)
-- ⚡ **Simple Integration**: 3 lines of code to get started
+- ⚡ **Simple Integration**: 2 lines of code to get started
 - 📡 **Offline Support**: Events queue automatically and sync when online
-- 🔄 **Automatic Sessions**: 30-minute inactivity timeout, handled internally
-- 🎯 **Cross-Session Tracking**: Optional persistent user IDs
+- 🔄 **Automatic Sessions**: RAM-only, 2-hour rotation, new session on app restart
+- ✅ **Designed for GDPR/ePrivacy compliance** - Potentially consent-free
 - 📱 **Cross-Platform**: iOS and Android support
 
 ## Requirements
@@ -51,14 +51,13 @@ import Respectlytics from 'respectlytics-react-native';
 // 1. Configure at app startup
 Respectlytics.configure('your-api-key');
 
-// 2. Enable user tracking (optional)
-Respectlytics.identify();
-
-// 3. Track events
+// 2. Track events
 Respectlytics.track('purchase');
 Respectlytics.track('view_product', 'ProductScreen');
 ```
 
+That's it! Session management is fully automatic.
+
 ## API Reference
 
 ### `configure(apiKey: string)`
@@ -78,47 +77,47 @@ Respectlytics.track('button_clicked');
 Respectlytics.track('checkout_started', 'CartScreen');
 ```
 
-### `identify()`
+### `flush()`
 
-Enable cross-session user tracking. Generates and persists a random user ID.
+Force send all queued events immediately. Rarely needed - the SDK auto-flushes.
 
 ```typescript
-Respectlytics.identify();
+await Respectlytics.flush();
 ```
 
-### `reset()`
+## 🔄 Automatic Session Management
 
-Clear the user ID. Call when user logs out.
+Session IDs are managed entirely by the SDK - no configuration needed.
 
-```typescript
-Respectlytics.reset();
-```
+| Behavior | Description |
+|----------|-------------|
+| **New session on app launch** | Every time your app starts, a fresh session begins |
+| **2-hour rotation** | Sessions automatically rotate after 2 hours of use |
+| **RAM-only storage** | Session IDs are never written to disk |
+| **No cross-session tracking** | Each session is independent and anonymous |
 
-### `flush()`
-
-Force send all queued events immediately. Rarely needed - the SDK auto-flushes.
-
-```typescript
-await Respectlytics.flush();
-```
+This RAM-only approach ensures compliance with ePrivacy Directive Article 5(3) - no device storage means no consent requirement for the session identifier.
 
 ## Privacy by Design
 
+Your privacy is our priority. Our mobile analytics solution is meticulously designed to provide valuable insights without compromising your data. We achieve this by collecting only session-based data, using anonymized identifiers that are stored only in your device's memory and renewed every two hours or upon app restart. IP addresses are processed transiently for approximate geolocation (country and region) only and are never stored. This privacy-by-design approach ensures that no personal data is retained, making our solution designed to comply with GDPR and the ePrivacy Directive, potentially enabling analytics without user consent in many jurisdictions.
+
 | What we DON'T collect | Why |
 |----------------------|-----|
 | IDFA / GAID | Device advertising IDs can track users across apps |
 | Device fingerprints | Can be used to identify users without consent |
-| IP addresses | Used only for geolocation lookup, then discarded |
+| IP addresses | Processed transiently for geolocation, then discarded |
 | Custom properties | Prevents accidental PII collection |
+| Persistent user IDs | Cross-session tracking requires consent |
 
 | What we DO collect | Purpose |
 |-------------------|---------|
 | Event name | Analytics |
 | Screen name | Navigation analytics |
-| Random session ID | Group events in a session |
-| Random user ID (opt-in) | Cross-session analytics |
+| Random session ID (RAM-only) | Group events in a session |
 | Platform, OS version | Debugging |
-| App version | Debugging |
+| App version, locale | Debugging |
+| Country, region | Approximate geolocation |
 
 ## Automatic Behaviors
 
@@ -126,7 +125,7 @@ The SDK handles these automatically - no developer action needed:
 
 | Feature | Behavior |
 |---------|----------|
-| **Session Management** | New session ID generated on first event, rotates after 30 min inactivity |
+| **Session Management** | New session ID on app launch, rotates after 2 hours |
 | **Event Batching** | Events queued and sent in batches (max 10 events or 30 seconds) |
 | **Offline Support** | Events queued when offline, sent when connectivity returns |
 | **Retry Logic** | Failed requests retry with exponential backoff (max 3 attempts) |
@@ -141,13 +140,23 @@ Events are automatically queued when offline and sent when connectivity returns:
 3. Queue is flushed when connectivity is restored
 4. Failed sends are retried with exponential backoff
 
-## Session Management
+## Migration from v1.x
+
+### Breaking Changes
+
+- `identify()` method removed - no longer needed
+- `reset()` method removed - no longer needed
+- AsyncStorage no longer used for user IDs - sessions are RAM-only
+
+### What to do
+
+1. Remove any calls to `Respectlytics.identify()`
+2. Remove any calls to `Respectlytics.reset()`
+3. That's it! Session management is now automatic.
 
-Sessions are managed automatically:
+### Why This Change?
 
-- New session starts on first event
-- Session rotates after 30 minutes of inactivity
-- No developer action required
+Storing identifiers on device (AsyncStorage) requires user consent under ePrivacy Directive Article 5(3). In-memory sessions require no consent, making Respectlytics truly consent-free analytics.
 
 ## License
 
@@ -155,6 +164,6 @@ This SDK is provided under a proprietary license. See [LICENSE](LICENSE) for det
 
 ## Support
 
-- Documentation: [https://respectlytics.com/docs/](https://respectlytics.com/docs/)
+- Documentation: [https://respectlytics.com/sdk/](https://respectlytics.com/sdk/)
 - Issues: [https://github.com/respectlytics/respectlytics-react-native/issues](https://github.com/respectlytics/respectlytics-react-native/issues)
 - Email: respectlytics@loheden.com

package/lib/commonjs/EventQueue.js

@@ -0,0 +1,174 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EventQueue = void 0;
+var _reactNative = require("react-native");
+var _netinfo = _interopRequireDefault(require("@react-native-community/netinfo"));
+var _Storage = require("./Storage");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * EventQueue.ts
+ * Respectlytics React Native SDK
+ * 
+ * Manages event batching, persistence, and automatic flushing.
+ * Events are NEVER lost - they are persisted immediately and retried on failure.
+ * Copyright (c) 2025 Respectlytics. All rights reserved.
+ */
+
+const MAX_QUEUE_SIZE = 10;
+const FLUSH_INTERVAL_MS = 30000; // 30 seconds
+const QUEUE_STORAGE_KEY = 'com.respectlytics.eventQueue';
+class EventQueue {
+  events = [];
+  isOnline = true;
+  flushTimer = null;
+  isFlushing = false;
+  unsubscribeNetInfo = null;
+  appStateSubscription = null;
+  constructor(networkClient) {
+    this.networkClient = networkClient;
+  }
+
+  /**
+   * Initialize the queue - load persisted events and set up listeners
+   */
+  async start() {
+    await this.loadPersistedQueue();
+    this.setupNetworkMonitor();
+    this.setupAppStateMonitor();
+    this.scheduleFlush();
+    console.log('[Respectlytics] ✓ Event queue started');
+  }
+
+  /**
+   * Stop the queue and clean up resources
+   */
+  stop() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.unsubscribeNetInfo) {
+      this.unsubscribeNetInfo();
+      this.unsubscribeNetInfo = null;
+    }
+    if (this.appStateSubscription) {
+      this.appStateSubscription.remove();
+      this.appStateSubscription = null;
+    }
+  }
+
+  /**
+   * Add an event to the queue
+   * CRITICAL: Events are persisted IMMEDIATELY before any async operations
+   */
+  async add(event) {
+    this.events.push(event);
+
+    // IMMEDIATELY persist before any async operations
+    await this.persistQueue();
+
+    // Check if we should flush
+    if (this.events.length >= MAX_QUEUE_SIZE) {
+      this.flush();
+    }
+  }
+
+  /**
+   * Force flush all queued events
+   */
+  async flush() {
+    if (this.isFlushing || this.events.length === 0) {
+      return;
+    }
+    if (!this.isOnline) {
+      console.log('[Respectlytics] Offline, skipping flush');
+      return;
+    }
+    if (!this.networkClient.isConfigured()) {
+      console.log('[Respectlytics] ⚠️ SDK not configured, skipping flush');
+      return;
+    }
+    this.isFlushing = true;
+
+    // Take a snapshot of events to send
+    const batch = [...this.events];
+    this.events = [];
+    await this.persistQueue();
+    try {
+      await this.networkClient.send(batch);
+      console.log(`[Respectlytics] ✓ Sent ${batch.length} event(s)`);
+    } catch (error) {
+      // Re-add failed events to the front of the queue
+      this.events = [...batch, ...this.events];
+      await this.persistQueue();
+      console.log('[Respectlytics] Failed to send events, will retry later');
+    } finally {
+      this.isFlushing = false;
+    }
+  }
+
+  /**
+   * Get current queue size (for testing)
+   */
+  getQueueSize() {
+    return this.events.length;
+  }
+
+  // MARK: - Private Helpers
+
+  scheduleFlush() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+    }
+    this.flushTimer = setInterval(() => {
+      this.flush();
+    }, FLUSH_INTERVAL_MS);
+  }
+  setupNetworkMonitor() {
+    this.unsubscribeNetInfo = _netinfo.default.addEventListener(state => {
+      const wasOffline = !this.isOnline;
+      this.isOnline = state.isConnected ?? false;
+
+      // If we just came online, try to flush
+      if (wasOffline && this.isOnline) {
+        console.log('[Respectlytics] Network restored, flushing queue');
+        this.flush();
+      }
+    });
+  }
+  setupAppStateMonitor() {
+    this.appStateSubscription = _reactNative.AppState.addEventListener('change', nextAppState => {
+      // Flush when app goes to background
+      if (nextAppState === 'background' || nextAppState === 'inactive') {
+        this.flush();
+      }
+    });
+  }
+  async persistQueue() {
+    try {
+      await _Storage.Storage.setItem(QUEUE_STORAGE_KEY, JSON.stringify(this.events));
+    } catch (error) {
+      console.log('[Respectlytics] Failed to persist queue:', error);
+    }
+  }
+  async loadPersistedQueue() {
+    try {
+      const data = await _Storage.Storage.getItem(QUEUE_STORAGE_KEY);
+      if (data) {
+        const parsed = JSON.parse(data);
+        if (Array.isArray(parsed)) {
+          this.events = parsed;
+          console.log(`[Respectlytics] Loaded ${this.events.length} persisted event(s)`);
+        }
+      }
+    } catch (error) {
+      console.log('[Respectlytics] Failed to load persisted queue:', error);
+      this.events = [];
+    }
+  }
+}
+exports.EventQueue = EventQueue;
+//# sourceMappingURL=EventQueue.js.map

package/lib/commonjs/EventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_netinfo","_interopRequireDefault","_Storage","e","__esModule","default","MAX_QUEUE_SIZE","FLUSH_INTERVAL_MS","QUEUE_STORAGE_KEY","EventQueue","events","isOnline","flushTimer","isFlushing","unsubscribeNetInfo","appStateSubscription","constructor","networkClient","start","loadPersistedQueue","setupNetworkMonitor","setupAppStateMonitor","scheduleFlush","console","log","stop","clearInterval","remove","add","event","push","persistQueue","length","flush","isConfigured","batch","send","error","getQueueSize","setInterval","NetInfo","addEventListener","state","wasOffline","isConnected","AppState","nextAppState","Storage","setItem","JSON","stringify","data","getItem","parsed","parse","Array","isArray","exports"],"sourceRoot":"../../src","sources":["EventQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/NetworkClient.js

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.networkClient = exports.NetworkError = exports.NetworkClient = void 0;
+/**
+ * NetworkClient.ts
+ * Respectlytics React Native SDK
+ * 
+ * Handles HTTP communication with the Respectlytics API.
+ * Copyright (c) 2025 Respectlytics. All rights reserved.
+ */
+
+const API_ENDPOINT = 'https://respectlytics.com/api/v1/events/';
+const MAX_RETRIES = 3;
+const TIMEOUT_MS = 30000;
+let NetworkError = exports.NetworkError = /*#__PURE__*/function (NetworkError) {
+  NetworkError["NotConfigured"] = "NOT_CONFIGURED";
+  NetworkError["InvalidResponse"] = "INVALID_RESPONSE";
+  NetworkError["Unauthorized"] = "UNAUTHORIZED";
+  NetworkError["BadRequest"] = "BAD_REQUEST";
+  NetworkError["RateLimited"] = "RATE_LIMITED";
+  NetworkError["ServerError"] = "SERVER_ERROR";
+  NetworkError["NetworkError"] = "NETWORK_ERROR";
+  NetworkError["Timeout"] = "TIMEOUT";
+  return NetworkError;
+}({});
+class NetworkClient {
+  apiKey = null;
+
+  /**
+   * Configure the network client with an API key
+   */
+  configure(apiKey) {
+    this.apiKey = apiKey;
+  }
+
+  /**
+   * Check if the client is configured
+   */
+  isConfigured() {
+    return this.apiKey !== null;
+  }
+
+  /**
+   * Send events to the API
+   */
+  async send(events) {
+    if (!this.apiKey) {
+      throw new Error(NetworkError.NotConfigured);
+    }
+    for (const event of events) {
+      await this.sendEvent(event, 1);
+    }
+  }
+
+  /**
+   * Send a single event with retry logic
+   */
+  async sendEvent(event, attempt) {
+    if (!this.apiKey) {
+      throw new Error(NetworkError.NotConfigured);
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+      const response = await fetch(API_ENDPOINT, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-App-Key': this.apiKey
+        },
+        body: JSON.stringify(this.eventToPayload(event)),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (response.ok) {
+        return; // Success
+      }
+      switch (response.status) {
+        case 401:
+          throw new Error(NetworkError.Unauthorized);
+        case 400:
+          throw new Error(NetworkError.BadRequest);
+        case 429:
+          // Rate limited - retry with backoff
+          if (attempt < MAX_RETRIES) {
+            await this.delay(Math.pow(2, attempt) * 1000);
+            return this.sendEvent(event, attempt + 1);
+          }
+          throw new Error(NetworkError.RateLimited);
+        default:
+          if (response.status >= 500) {
+            // Server error - retry with backoff
+            if (attempt < MAX_RETRIES) {
+              await this.delay(Math.pow(2, attempt) * 1000);
+              return this.sendEvent(event, attempt + 1);
+            }
+            throw new Error(NetworkError.ServerError);
+          }
+          throw new Error(NetworkError.InvalidResponse);
+      }
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error) {
+        // Don't retry auth or bad request errors
+        if (error.message === NetworkError.Unauthorized || error.message === NetworkError.BadRequest) {
+          throw error;
+        }
+
+        // Check for abort (timeout)
+        if (error.name === 'AbortError') {
+          if (attempt < MAX_RETRIES) {
+            await this.delay(Math.pow(2, attempt) * 1000);
+            return this.sendEvent(event, attempt + 1);
+          }
+          throw new Error(NetworkError.Timeout);
+        }
+      }
+
+      // Network error - retry with backoff
+      if (attempt < MAX_RETRIES) {
+        await this.delay(Math.pow(2, attempt) * 1000);
+        return this.sendEvent(event, attempt + 1);
+      }
+      throw new Error(NetworkError.NetworkError);
+    }
+  }
+
+  /**
+   * Convert Event object to API payload format
+   * Note: As of v2.0.0, no user_id field is sent (session-based analytics only)
+   */
+  eventToPayload(event) {
+    return {
+      event_name: event.eventName,
+      timestamp: event.timestamp,
+      session_id: event.sessionId,
+      screen: event.screen || undefined,
+      platform: event.platform,
+      os_version: event.osVersion,
+      app_version: event.appVersion,
+      locale: event.locale,
+      device_type: event.deviceType
+    };
+  }
+
+  /**
+   * Helper to delay for exponential backoff
+   */
+  delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  }
+}
+exports.NetworkClient = NetworkClient;
+const networkClient = exports.networkClient = new NetworkClient();
+//# sourceMappingURL=NetworkClient.js.map

package/lib/commonjs/NetworkClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["API_ENDPOINT","MAX_RETRIES","TIMEOUT_MS","NetworkError","exports","NetworkClient","apiKey","configure","isConfigured","send","events","Error","NotConfigured","event","sendEvent","attempt","controller","AbortController","timeoutId","setTimeout","abort","response","fetch","method","headers","body","JSON","stringify","eventToPayload","signal","clearTimeout","ok","status","Unauthorized","BadRequest","delay","Math","pow","RateLimited","ServerError","InvalidResponse","error","message","name","Timeout","event_name","eventName","timestamp","session_id","sessionId","screen","undefined","platform","os_version","osVersion","app_version","appVersion","locale","device_type","deviceType","ms","Promise","resolve","networkClient"],"sourceRoot":"../../src","sources":["NetworkClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/Respectlytics.js

@@ -0,0 +1,167 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.RespectlyticsSDK = void 0;
+var _reactNative = require("react-native");
+var _SessionManager = require("./SessionManager");
+var _NetworkClient = require("./NetworkClient");
+var _EventQueue = require("./EventQueue");
+/**
+ * Respectlytics.ts
+ * Respectlytics React Native SDK
+ * 
+ * Main entry point for the SDK.
+ * Copyright (c) 2025 Respectlytics. All rights reserved.
+ */
+
+/**
+ * Main entry point for the Respectlytics SDK.
+ * 
+ * v2.0.0 uses session-based analytics only:
+ * - Session IDs are generated automatically in RAM
+ * - Sessions rotate every 2 hours
+ * - New session on every app restart
+ * - No persistent user tracking (GDPR/ePrivacy compliant)
+ * 
+ * Usage:
+ * ```typescript
+ * // 1. Configure at app launch
+ * Respectlytics.configure('your-api-key');
+ * 
+ * // 2. Track events
+ * Respectlytics.track('purchase');
+ * Respectlytics.track('view_product', 'ProductScreen');
+ * ```
+ */
+class RespectlyticsSDK {
+  isConfigured = false;
+  constructor() {
+    this.networkClient = new _NetworkClient.NetworkClient();
+    this.eventQueue = new _EventQueue.EventQueue(this.networkClient);
+    this.sessionManager = new _SessionManager.SessionManager();
+  }
+
+  /**
+   * Initialize the SDK with your API key.
+   * Call once at app startup.
+   * 
+   * @param apiKey Your Respectlytics API key from the dashboard
+   */
+  configure(apiKey) {
+    if (!apiKey || apiKey.trim() === '') {
+      console.log('[Respectlytics] ⚠️ API key cannot be empty');
+      return;
+    }
+    this.networkClient.configure(apiKey);
+    this.eventQueue.start();
+    this.isConfigured = true;
+    console.log('[Respectlytics] ✓ SDK configured');
+  }
+
+  /**
+   * Track an event with an optional screen name.
+   * 
+   * The SDK automatically collects privacy-safe metadata:
+   * - timestamp, session_id, platform, os_version, app_version, locale
+   * 
+   * @param eventName Name of the event (e.g., "purchase", "button_clicked")
+   * @param screen Optional screen name where the event occurred
+   */
+  track(eventName, screen) {
+    if (!this.isConfigured) {
+      console.log('[Respectlytics] ⚠️ SDK not configured. Call configure(apiKey) first.');
+      return;
+    }
+    if (!eventName || eventName.trim() === '') {
+      console.log('[Respectlytics] ⚠️ Event name cannot be empty');
+      return;
+    }
+    if (eventName.length > 100) {
+      console.log('[Respectlytics] ⚠️ Event name too long (max 100 characters)');
+      return;
+    }
+    const event = this.createEvent(eventName, screen);
+    this.eventQueue.add(event);
+  }
+
+  /**
+   * Force send all queued events immediately.
+   * Rarely needed - the SDK auto-flushes every 30 seconds or when the queue reaches 10 events.
+   */
+  async flush() {
+    await this.eventQueue.flush();
+  }
+
+  // MARK: - Private Helpers
+
+  createEvent(eventName, screen) {
+    const metadata = this.collectMetadata();
+    return {
+      eventName,
+      timestamp: new Date().toISOString(),
+      sessionId: this.sessionManager.getSessionId(),
+      screen: screen || null,
+      ...metadata
+    };
+  }
+  collectMetadata() {
+    // Determine platform
+    const platform = _reactNative.Platform.OS === 'ios' ? 'iOS' : 'Android';
+
+    // Get OS version
+    const osVersion = String(_reactNative.Platform.Version);
+
+    // Get app version - try to get from native modules
+    let appVersion = 'unknown';
+    try {
+      // React Native provides app info through different native modules
+      const {
+        PlatformConstants
+      } = _reactNative.NativeModules;
+      if (PlatformConstants?.reactNativeVersion) {
+        // This is React Native version, not app version
+        // App version should come from the host app
+      }
+      // For now, use 'unknown' as we can't reliably get app version without additional dependencies
+      // In a real app, the developer would configure this
+    } catch {
+      appVersion = 'unknown';
+    }
+
+    // Get locale
+    let locale = 'en_US';
+    try {
+      // React Native doesn't expose locale directly, but we can get it from platform
+      if (_reactNative.Platform.OS === 'ios') {
+        locale = _reactNative.NativeModules.SettingsManager?.settings?.AppleLocale || _reactNative.NativeModules.SettingsManager?.settings?.AppleLanguages?.[0] || 'en_US';
+      } else {
+        locale = _reactNative.NativeModules.I18nManager?.localeIdentifier || 'en_US';
+      }
+    } catch {
+      locale = 'en_US';
+    }
+
+    // Determine device type based on screen size
+    const {
+      width,
+      height
+    } = _reactNative.Dimensions.get('window');
+    const minDimension = Math.min(width, height);
+    const deviceType = minDimension >= 600 ? 'tablet' : 'phone';
+    return {
+      platform,
+      osVersion,
+      appVersion,
+      locale,
+      deviceType
+    };
+  }
+}
+
+// Export singleton instance
+exports.RespectlyticsSDK = RespectlyticsSDK;
+const Respectlytics = new RespectlyticsSDK();
+var _default = exports.default = Respectlytics;
+//# sourceMappingURL=Respectlytics.js.map

package/lib/commonjs/Respectlytics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_SessionManager","_NetworkClient","_EventQueue","RespectlyticsSDK","isConfigured","constructor","networkClient","NetworkClient","eventQueue","EventQueue","sessionManager","SessionManager","configure","apiKey","trim","console","log","start","track","eventName","screen","length","event","createEvent","add","flush","metadata","collectMetadata","timestamp","Date","toISOString","sessionId","getSessionId","platform","Platform","OS","osVersion","String","Version","appVersion","PlatformConstants","NativeModules","reactNativeVersion","locale","SettingsManager","settings","AppleLocale","AppleLanguages","I18nManager","localeIdentifier","width","height","Dimensions","get","minDimension","Math","min","deviceType","exports","Respectlytics","_default","default"],"sourceRoot":"../../src","sources":["Respectlytics.ts"],"mappings":";;;;;;AAQA,IAAAA,YAAA,GAAAC,OAAA;AAEA,IAAAC,eAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,WAAA,GAAAH,OAAA;AAZA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMI,gBAAgB,CAAC;EACbC,YAAY,GAAG,KAAK;EAK5BC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,aAAa,GAAG,IAAIC,4BAAa,CAAC,CAAC;IACxC,IAAI,CAACC,UAAU,GAAG,IAAIC,sBAAU,CAAC,IAAI,CAACH,aAAa,CAAC;IACpD,IAAI,CAACI,cAAc,GAAG,IAAIC,8BAAc,CAAC,CAAC;EAC5C;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,SAASA,CAACC,MAAc,EAAQ;IAC9B,IAAI,CAACA,MAAM,IAAIA,MAAM,CAACC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;MACnCC,OAAO,CAACC,GAAG,CAAC,4CAA4C,CAAC;MACzD;IACF;IAEA,IAAI,CAACV,aAAa,CAACM,SAAS,CAACC,MAAM,CAAC;IACpC,IAAI,CAACL,UAAU,CAACS,KAAK,CAAC,CAAC;IACvB,IAAI,CAACb,YAAY,GAAG,IAAI;IAExBW,OAAO,CAACC,GAAG,CAAC,kCAAkC,CAAC;EACjD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,KAAKA,CAACC,SAAiB,EAAEC,MAAe,EAAQ;IAC9C,IAAI,CAAC,IAAI,CAAChB,YAAY,EAAE;MACtBW,OAAO,CAACC,GAAG,CAAC,sEAAsE,CAAC;MACnF;IACF;IAEA,IAAI,CAACG,SAAS,IAAIA,SAAS,CAACL,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;MACzCC,OAAO,CAACC,GAAG,CAAC,+CAA+C,CAAC;MAC5D;IACF;IAEA,IAAIG,SAAS,CAACE,MAAM,GAAG,GAAG,EAAE;MAC1BN,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;MAC1E;IACF;IAEA,MAAMM,KAAK,GAAG,IAAI,CAACC,WAAW,CAACJ,SAAS,EAAEC,MAAM,CAAC;IACjD,IAAI,CAACZ,UAAU,CAACgB,GAAG,CAACF,KAAK,CAAC;EAC5B;;EAEA;AACF;AACA;AACA;EACE,MAAMG,KAAKA,CAAA,EAAkB;IAC3B,MAAM,IAAI,CAACjB,UAAU,CAACiB,KAAK,CAAC,CAAC;EAC/B;;EAEA;;EAEQF,WAAWA,CAACJ,SAAiB,EAAEC,MAAe,EAAS;IAC7D,MAAMM,QAAQ,GAAG,IAAI,CAACC,eAAe,CAAC,CAAC;IAEvC,OAAO;MACLR,SAAS;MACTS,SAAS,EAAE,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;MACnCC,SAAS,EAAE,IAAI,CAACrB,cAAc,CAACsB,YAAY,CAAC,CAAC;MAC7CZ,MAAM,EAAEA,MAAM,IAAI,IAAI;MACtB,GAAGM;IACL,CAAC;EACH;EAEQC,eAAeA,CAAA,EAMrB;IACA;IACA,MAAMM,QAAQ,GAAGC,qBAAQ,CAACC,EAAE,KAAK,KAAK,GAAG,KAAK,GAAG,SAAS;;IAE1D;IACA,MAAMC,SAAS,GAAGC,MAAM,CAACH,qBAAQ,CAACI,OAAO,CAAC;;IAE1C;IACA,IAAIC,UAAU,GAAG,SAAS;IAC1B,IAAI;MACF;MACA,MAAM;QAAEC;MAAkB,CAAC,GAAGC,0BAAa;MAC3C,IAAID,iBAAiB,EAAEE,kBAAkB,EAAE;QACzC;QACA;MAAA;MAEF;MACA;IACF,CAAC,CAAC,MAAM;MACNH,UAAU,GAAG,SAAS;IACxB;;IAEA;IACA,IAAII,MAAM,GAAG,OAAO;IACpB,IAAI;MACF;MACA,IAAIT,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;QACzBQ,MAAM,GAAGF,0BAAa,CAACG,eAAe,EAAEC,QAAQ,EAAEC,WAAW,IACpDL,0BAAa,CAACG,eAAe,EAAEC,QAAQ,EAAEE,cAAc,GAAG,CAAC,CAAC,IAC5D,OAAO;MAClB,CAAC,MAAM;QACLJ,MAAM,GAAGF,0BAAa,CAACO,WAAW,EAAEC,gBAAgB,IAAI,OAAO;MACjE;IACF,CAAC,CAAC,MAAM;MACNN,MAAM,GAAG,OAAO;IAClB;;IAEA;IACA,MAAM;MAAEO,KAAK;MAAEC;IAAO,CAAC,GAAGC,uBAAU,CAACC,GAAG,CAAC,QAAQ,CAAC;IAClD,MAAMC,YAAY,GAAGC,IAAI,CAACC,GAAG,CAACN,KAAK,EAAEC,MAAM,CAAC;IAC5C,MAAMM,UAAU,GAAGH,YAAY,IAAI,GAAG,GAAG,QAAQ,GAAG,OAAO;IAE3D,OAAO;MACLrB,QAAQ;MACRG,SAAS;MACTG,UAAU;MACVI,MAAM;MACNc;IACF,CAAC;EACH;AACF;;AAEA;AAAAC,OAAA,CAAAvD,gBAAA,GAAAA,gBAAA;AACA,MAAMwD,aAAa,GAAG,IAAIxD,gBAAgB,CAAC,CAAC;AAAC,IAAAyD,QAAA,GAAAF,OAAA,CAAAG,OAAA,GAC9BF,aAAa","ignoreList":[]}