respectlytics-react-native 2.0.1 → 2.2.0

package/lib/module/NetworkClient.js

@@ -1,12 +1,12 @@
 /**
  * NetworkClient.ts
  * Respectlytics React Native SDK
- * 
+ *
  * Handles HTTP communication with the Respectlytics API.
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
-const API_ENDPOINT = 'https://respectlytics.com/api/v1/events/';
+const DEFAULT_API_ENDPOINT = 'https://respectlytics.com/api/v1/events/';
 const MAX_RETRIES = 3;
 const TIMEOUT_MS = 30000;
 export let NetworkError = /*#__PURE__*/function (NetworkError) {
@@ -22,12 +22,16 @@ export let NetworkError = /*#__PURE__*/function (NetworkError) {
 }({});
 export class NetworkClient {
   apiKey = null;
+  apiEndpoint = DEFAULT_API_ENDPOINT;
 
   /**
-   * Configure the network client with an API key
+   * Configure the network client with an API key and optional custom endpoint
    */
-  configure(apiKey) {
+  configure(apiKey, apiEndpoint) {
     this.apiKey = apiKey;
+    if (apiEndpoint) {
+      this.apiEndpoint = apiEndpoint;
+    }
   }
 
   /**
@@ -59,7 +63,7 @@ export class NetworkClient {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
     try {
-      const response = await fetch(API_ENDPOINT, {
+      const response = await fetch(this.apiEndpoint, {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
@@ -123,20 +127,15 @@ export class NetworkClient {
   }
 
   /**
-   * Convert Event object to API payload format
-   * Note: As of v2.0.0, no user_id field is sent (session-based analytics only)
+   * Convert Event object to API payload format.
+   * The SDK sends 4 fields; the API stores 5 (adding country derived from IP).
    */
   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
+      platform: event.platform
     };
   }
 

package/lib/module/NetworkClient.js.map

@@ -1 +1 @@
-{"version":3,"names":["API_ENDPOINT","MAX_RETRIES","TIMEOUT_MS","NetworkError","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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,YAAY,GAAG,0CAA0C;AAC/D,MAAMC,WAAW,GAAG,CAAC;AACrB,MAAMC,UAAU,GAAG,KAAK;AAExB,WAAYC,YAAY,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA;AAWxB,OAAO,MAAMC,aAAa,CAAC;EACjBC,MAAM,GAAkB,IAAI;;EAEpC;AACF;AACA;EACEC,SAASA,CAACD,MAAc,EAAQ;IAC9B,IAAI,CAACA,MAAM,GAAGA,MAAM;EACtB;;EAEA;AACF;AACA;EACEE,YAAYA,CAAA,EAAY;IACtB,OAAO,IAAI,CAACF,MAAM,KAAK,IAAI;EAC7B;;EAEA;AACF;AACA;EACE,MAAMG,IAAIA,CAACC,MAAe,EAAiB;IACzC,IAAI,CAAC,IAAI,CAACJ,MAAM,EAAE;MAChB,MAAM,IAAIK,KAAK,CAACP,YAAY,CAACQ,aAAa,CAAC;IAC7C;IAEA,KAAK,MAAMC,KAAK,IAAIH,MAAM,EAAE;MAC1B,MAAM,IAAI,CAACI,SAAS,CAACD,KAAK,EAAE,CAAC,CAAC;IAChC;EACF;;EAEA;AACF;AACA;EACE,MAAcC,SAASA,CAACD,KAAY,EAAEE,OAAe,EAAiB;IACpE,IAAI,CAAC,IAAI,CAACT,MAAM,EAAE;MAChB,MAAM,IAAIK,KAAK,CAACP,YAAY,CAACQ,aAAa,CAAC;IAC7C;IAEA,MAAMI,UAAU,GAAG,IAAIC,eAAe,CAAC,CAAC;IACxC,MAAMC,SAAS,GAAGC,UAAU,CAAC,MAAMH,UAAU,CAACI,KAAK,CAAC,CAAC,EAAEjB,UAAU,CAAC;IAElE,IAAI;MACF,MAAMkB,QAAQ,GAAG,MAAMC,KAAK,CAACrB,YAAY,EAAE;QACzCsB,MAAM,EAAE,MAAM;QACdC,OAAO,EAAE;UACP,cAAc,EAAE,kBAAkB;UAClC,WAAW,EAAE,IAAI,CAAClB;QACpB,CAAC;QACDmB,IAAI,EAAEC,IAAI,CAACC,SAAS,CAAC,IAAI,CAACC,cAAc,CAACf,KAAK,CAAC,CAAC;QAChDgB,MAAM,EAAEb,UAAU,CAACa;MACrB,CAAC,CAAC;MAEFC,YAAY,CAACZ,SAAS,CAAC;MAEvB,IAAIG,QAAQ,CAACU,EAAE,EAAE;QACf,OAAO,CAAC;MACV;MAEA,QAAQV,QAAQ,CAACW,MAAM;QACrB,KAAK,GAAG;UACN,MAAM,IAAIrB,KAAK,CAACP,YAAY,CAAC6B,YAAY,CAAC;QAC5C,KAAK,GAAG;UACN,MAAM,IAAItB,KAAK,CAACP,YAAY,CAAC8B,UAAU,CAAC;QAC1C,KAAK,GAAG;UACN;UACA,IAAInB,OAAO,GAAGb,WAAW,EAAE;YACzB,MAAM,IAAI,CAACiC,KAAK,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEtB,OAAO,CAAC,GAAG,IAAI,CAAC;YAC7C,OAAO,IAAI,CAACD,SAAS,CAACD,KAAK,EAAEE,OAAO,GAAG,CAAC,CAAC;UAC3C;UACA,MAAM,IAAIJ,KAAK,CAACP,YAAY,CAACkC,WAAW,CAAC;QAC3C;UACE,IAAIjB,QAAQ,CAACW,MAAM,IAAI,GAAG,EAAE;YAC1B;YACA,IAAIjB,OAAO,GAAGb,WAAW,EAAE;cACzB,MAAM,IAAI,CAACiC,KAAK,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEtB,OAAO,CAAC,GAAG,IAAI,CAAC;cAC7C,OAAO,IAAI,CAACD,SAAS,CAACD,KAAK,EAAEE,OAAO,GAAG,CAAC,CAAC;YAC3C;YACA,MAAM,IAAIJ,KAAK,CAACP,YAAY,CAACmC,WAAW,CAAC;UAC3C;UACA,MAAM,IAAI5B,KAAK,CAACP,YAAY,CAACoC,eAAe,CAAC;MACjD;IACF,CAAC,CAAC,OAAOC,KAAK,EAAE;MACdX,YAAY,CAACZ,SAAS,CAAC;MAEvB,IAAIuB,KAAK,YAAY9B,KAAK,EAAE;QAC1B;QACA,IACE8B,KAAK,CAACC,OAAO,KAAKtC,YAAY,CAAC6B,YAAY,IAC3CQ,KAAK,CAACC,OAAO,KAAKtC,YAAY,CAAC8B,UAAU,EACzC;UACA,MAAMO,KAAK;QACb;;QAEA;QACA,IAAIA,KAAK,CAACE,IAAI,KAAK,YAAY,EAAE;UAC/B,IAAI5B,OAAO,GAAGb,WAAW,EAAE;YACzB,MAAM,IAAI,CAACiC,KAAK,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEtB,OAAO,CAAC,GAAG,IAAI,CAAC;YAC7C,OAAO,IAAI,CAACD,SAAS,CAACD,KAAK,EAAEE,OAAO,GAAG,CAAC,CAAC;UAC3C;UACA,MAAM,IAAIJ,KAAK,CAACP,YAAY,CAACwC,OAAO,CAAC;QACvC;MACF;;MAEA;MACA,IAAI7B,OAAO,GAAGb,WAAW,EAAE;QACzB,MAAM,IAAI,CAACiC,KAAK,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEtB,OAAO,CAAC,GAAG,IAAI,CAAC;QAC7C,OAAO,IAAI,CAACD,SAAS,CAACD,KAAK,EAAEE,OAAO,GAAG,CAAC,CAAC;MAC3C;MAEA,MAAM,IAAIJ,KAAK,CAACP,YAAY,CAACA,YAAY,CAAC;IAC5C;EACF;;EAEA;AACF;AACA;AACA;EACUwB,cAAcA,CAACf,KAAY,EAA2B;IAC5D,OAAO;MACLgC,UAAU,EAAEhC,KAAK,CAACiC,SAAS;MAC3BC,SAAS,EAAElC,KAAK,CAACkC,SAAS;MAC1BC,UAAU,EAAEnC,KAAK,CAACoC,SAAS;MAC3BC,MAAM,EAAErC,KAAK,CAACqC,MAAM,IAAIC,SAAS;MACjCC,QAAQ,EAAEvC,KAAK,CAACuC,QAAQ;MACxBC,UAAU,EAAExC,KAAK,CAACyC,SAAS;MAC3BC,WAAW,EAAE1C,KAAK,CAAC2C,UAAU;MAC7BC,MAAM,EAAE5C,KAAK,CAAC4C,MAAM;MACpBC,WAAW,EAAE7C,KAAK,CAAC8C;IACrB,CAAC;EACH;;EAEA;AACF;AACA;EACUxB,KAAKA,CAACyB,EAAU,EAAiB;IACvC,OAAO,IAAIC,OAAO,CAACC,OAAO,IAAI3C,UAAU,CAAC2C,OAAO,EAAEF,EAAE,CAAC,CAAC;EACxD;AACF;AAEA,OAAO,MAAMG,aAAa,GAAG,IAAI1D,aAAa,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["DEFAULT_API_ENDPOINT","MAX_RETRIES","TIMEOUT_MS","NetworkError","NetworkClient","apiKey","apiEndpoint","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","platform","ms","Promise","resolve","networkClient"],"sourceRoot":"../../src","sources":["NetworkClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/Respectlytics.js

@@ -1,33 +1,35 @@
 /**
  * Respectlytics.ts
  * Respectlytics React Native SDK
- * 
+ *
  * Main entry point for the SDK.
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
-import { Platform, Dimensions, NativeModules } from 'react-native';
+import { Platform } from 'react-native';
 import { SessionManager } from './SessionManager';
 import { NetworkClient } from './NetworkClient';
 import { EventQueue } from './EventQueue';
 
 /**
  * Main entry point for the Respectlytics SDK.
- * 
- * v2.0.0 uses session-based analytics only:
+ *
+ * v2.1.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)
- * 
+ * - Only 4 fields sent by SDK; 5 stored (country derived server-side)
+ *
  * Usage:
  * ```typescript
  * // 1. Configure at app launch
  * Respectlytics.configure('your-api-key');
- * 
+ *
+ * // For self-hosted instances:
+ * Respectlytics.configure('your-api-key', { apiEndpoint: 'https://your-server.com/api/v1/events/' });
+ *
  * // 2. Track events
  * Respectlytics.track('purchase');
- * Respectlytics.track('view_product', 'ProductScreen');
  * ```
  */
 class RespectlyticsSDK {
@@ -36,35 +38,36 @@ class RespectlyticsSDK {
     this.networkClient = new NetworkClient();
     this.eventQueue = new EventQueue(this.networkClient);
     this.sessionManager = new SessionManager();
+    this.platform = Platform.OS === 'ios' ? 'iOS' : 'Android';
   }
 
   /**
    * Initialize the SDK with your API key.
    * Call once at app startup.
-   * 
+   *
    * @param apiKey Your Respectlytics API key from the dashboard
+   * @param options Optional configuration (e.g., apiEndpoint for self-hosted instances)
    */
-  configure(apiKey) {
+  configure(apiKey, options) {
     if (!apiKey || apiKey.trim() === '') {
       console.log('[Respectlytics] ⚠️ API key cannot be empty');
       return;
     }
-    this.networkClient.configure(apiKey);
+    this.networkClient.configure(apiKey, options?.apiEndpoint);
     this.eventQueue.start();
     this.isConfigured = true;
-    console.log('[Respectlytics] ✓ SDK configured');
+    console.log('[Respectlytics] ✓ SDK configured (v2.2.0)');
   }
 
   /**
-   * Track an event with an optional screen name.
-   * 
-   * The SDK automatically collects privacy-safe metadata:
-   * - timestamp, session_id, platform, os_version, app_version, locale
-   * 
+   * Track an event.
+   *
+   * Custom properties are NOT supported - this is by design for privacy.
+   * The API stores 5 fields (these 4 plus country derived server-side).
+   *
    * @param eventName Name of the event (e.g., "purchase", "button_clicked")
-   * @param screen Optional screen name where the event occurred
    */
-  track(eventName, screen) {
+  track(eventName) {
     if (!this.isConfigured) {
       console.log('[Respectlytics] ⚠️ SDK not configured. Call configure(apiKey) first.');
       return;
@@ -77,7 +80,12 @@ class RespectlyticsSDK {
       console.log('[Respectlytics] ⚠️ Event name too long (max 100 characters)');
       return;
     }
-    const event = this.createEvent(eventName, screen);
+    const event = {
+      eventName,
+      timestamp: new Date().toISOString(),
+      sessionId: this.sessionManager.getSessionId(),
+      platform: this.platform
+    };
     this.eventQueue.add(event);
   }
 
@@ -88,71 +96,6 @@ class RespectlyticsSDK {
   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 = Platform.OS === 'ios' ? 'iOS' : 'Android';
-
-    // Get OS version
-    const osVersion = String(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
-      } = 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 (Platform.OS === 'ios') {
-        locale = NativeModules.SettingsManager?.settings?.AppleLocale || NativeModules.SettingsManager?.settings?.AppleLanguages?.[0] || 'en_US';
-      } else {
-        locale = NativeModules.I18nManager?.localeIdentifier || 'en_US';
-      }
-    } catch {
-      locale = 'en_US';
-    }
-
-    // Determine device type based on screen size
-    const {
-      width,
-      height
-    } = Dimensions.get('window');
-    const minDimension = Math.min(width, height);
-    const deviceType = minDimension >= 600 ? 'tablet' : 'phone';
-    return {
-      platform,
-      osVersion,
-      appVersion,
-      locale,
-      deviceType
-    };
-  }
 }
 
 // Export singleton instance

package/lib/module/Respectlytics.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","Dimensions","NativeModules","SessionManager","NetworkClient","EventQueue","RespectlyticsSDK","isConfigured","constructor","networkClient","eventQueue","sessionManager","configure","apiKey","trim","console","log","start","track","eventName","screen","length","event","createEvent","add","flush","metadata","collectMetadata","timestamp","Date","toISOString","sessionId","getSessionId","platform","OS","osVersion","String","Version","appVersion","PlatformConstants","reactNativeVersion","locale","SettingsManager","settings","AppleLocale","AppleLanguages","I18nManager","localeIdentifier","width","height","get","minDimension","Math","min","deviceType","Respectlytics"],"sourceRoot":"../../src","sources":["Respectlytics.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Platform","SessionManager","NetworkClient","EventQueue","RespectlyticsSDK","isConfigured","constructor","networkClient","eventQueue","sessionManager","platform","OS","configure","apiKey","options","trim","console","log","apiEndpoint","start","track","eventName","length","event","timestamp","Date","toISOString","sessionId","getSessionId","add","flush","Respectlytics"],"sourceRoot":"../../src","sources":["Respectlytics.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,QAAQ,QAAQ,cAAc;AAEvC,SAASC,cAAc,QAAQ,kBAAkB;AACjD,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,UAAU,QAAQ,cAAc;;AAEzC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,CAAC;EACbC,YAAY,GAAG,KAAK;EAM5BC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,aAAa,GAAG,IAAIL,aAAa,CAAC,CAAC;IACxC,IAAI,CAACM,UAAU,GAAG,IAAIL,UAAU,CAAC,IAAI,CAACI,aAAa,CAAC;IACpD,IAAI,CAACE,cAAc,GAAG,IAAIR,cAAc,CAAC,CAAC;IAC1C,IAAI,CAACS,QAAQ,GAAGV,QAAQ,CAACW,EAAE,KAAK,KAAK,GAAG,KAAK,GAAG,SAAS;EAC3D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,SAASA,CAACC,MAAc,EAAEC,OAAkC,EAAQ;IAClE,IAAI,CAACD,MAAM,IAAIA,MAAM,CAACE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;MACnCC,OAAO,CAACC,GAAG,CAAC,4CAA4C,CAAC;MACzD;IACF;IAEA,IAAI,CAACV,aAAa,CAACK,SAAS,CAACC,MAAM,EAAEC,OAAO,EAAEI,WAAW,CAAC;IAC1D,IAAI,CAACV,UAAU,CAACW,KAAK,CAAC,CAAC;IACvB,IAAI,CAACd,YAAY,GAAG,IAAI;IAExBW,OAAO,CAACC,GAAG,CAAC,2CAA2C,CAAC;EAC1D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEG,KAAKA,CAACC,SAAiB,EAAQ;IAC7B,IAAI,CAAC,IAAI,CAAChB,YAAY,EAAE;MACtBW,OAAO,CAACC,GAAG,CAAC,sEAAsE,CAAC;MACnF;IACF;IAEA,IAAI,CAACI,SAAS,IAAIA,SAAS,CAACN,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;MACzCC,OAAO,CAACC,GAAG,CAAC,+CAA+C,CAAC;MAC5D;IACF;IAEA,IAAII,SAAS,CAACC,MAAM,GAAG,GAAG,EAAE;MAC1BN,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;MAC1E;IACF;IAEA,MAAMM,KAAY,GAAG;MACnBF,SAAS;MACTG,SAAS,EAAE,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;MACnCC,SAAS,EAAE,IAAI,CAAClB,cAAc,CAACmB,YAAY,CAAC,CAAC;MAC7ClB,QAAQ,EAAE,IAAI,CAACA;IACjB,CAAC;IAED,IAAI,CAACF,UAAU,CAACqB,GAAG,CAACN,KAAK,CAAC;EAC5B;;EAEA;AACF;AACA;AACA;EACE,MAAMO,KAAKA,CAAA,EAAkB;IAC3B,MAAM,IAAI,CAACtB,UAAU,CAACsB,KAAK,CAAC,CAAC;EAC/B;AACF;;AAEA;AACA,MAAMC,aAAa,GAAG,IAAI3B,gBAAgB,CAAC,CAAC;AAC5C,eAAe2B,aAAa;AAC5B,SAAS3B,gBAAgB","ignoreList":[]}

package/lib/module/SessionManager.js

@@ -3,10 +3,10 @@
  * Respectlytics React Native SDK
  *
  * Manages session ID generation and rotation.
- * Sessions are stored in RAM only (never persisted) for GDPR/ePrivacy compliance.
+ * Sessions are stored in RAM only (never persisted to disk).
  * Sessions automatically rotate every 2 hours.
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
 /**
@@ -29,8 +29,8 @@ function generateUUID() {
  * - Rotated automatically every 2 hours
  * - Regenerated on every app restart (new instance = new session)
  * 
- * This RAM-only approach ensures GDPR/ePrivacy compliance:
- * - No device storage = No consent required under ePrivacy Directive Article 5(3)
+ * This RAM-only approach means session data never touches device storage:
+ * - Sessions exist only in memory and are lost on app restart
  * - Each app launch creates a fresh, unlinked session
  */
 export class SessionManager {

package/lib/module/Storage.js

@@ -4,7 +4,7 @@
  *
  * Wrapper around AsyncStorage for persisting SDK data.
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
 import AsyncStorage from '@react-native-async-storage/async-storage';

package/lib/module/index.js

@@ -5,13 +5,12 @@
  * 
  * v2.0.0 Features:
  * - Session-based analytics (no persistent user tracking)
- * - RAM-only session storage (GDPR/ePrivacy compliant)
+ * - RAM-only session storage (never persisted to disk)
  * - Automatic 2-hour session rotation
  * - New session on every app restart
- * 
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ *
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
-
 import Respectlytics from './Respectlytics';
 
 // Default export - the main SDK instance

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Respectlytics","RespectlyticsSDK","Event"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,aAAa,MAAM,iBAAiB;;AAE3C;AACA,eAAeA,aAAa;;AAE5B;AACA,SAASC,gBAAgB,QAAQ,iBAAiB;AAClD,SAASC,KAAK,QAAQ,SAAS","ignoreList":[]}
+{"version":3,"names":["Respectlytics","RespectlyticsSDK","Event"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAOA,aAAa,MAAM,iBAAiB;;AAE3C;AACA,eAAeA,aAAa;;AAE5B;AACA,SAASC,gBAAgB,QAAQ,iBAAiB;AAClD,SAASC,KAAK,QAAQ,SAAS","ignoreList":[]}

package/lib/module/types.js

@@ -2,26 +2,27 @@
  * types.ts
  * Respectlytics React Native SDK
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- * This SDK is provided under a proprietary license.
- * See LICENSE file for details.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
 /**
  * Represents an analytics event - flat structure matching API payload
  *
- * This interface only contains fields accepted by the Respectlytics API.
- * The API uses a strict allowlist for privacy protection.
- * Custom properties are NOT supported - this is by design for privacy.
- * 
- * Note: As of v2.0.0, there is no userId field. Session-based analytics only.
+ * The SDK sends these 4 fields. The API stores 5 total
+ * (adding country, derived server-side from IP which is immediately discarded):
+ * - event_name (required)
+ * - timestamp
+ * - session_id
+ * - platform
+ *
+ * Country is derived server-side from IP (which is immediately discarded).
  */
 
 /**
  * Storage keys used by the SDK
- * 
- * Note: As of v2.0.0, we only persist the event queue.
- * Session IDs are RAM-only for GDPR/ePrivacy compliance.
+ *
+ * Note: Only the event queue is persisted.
+ * Session IDs are RAM-only for privacy.
  */
 export const STORAGE_KEYS = {
   EVENT_QUEUE: 'com.respectlytics.eventQueue'

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["STORAGE_KEYS","EVENT_QUEUE"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,YAAY,GAAG;EAC1BC,WAAW,EAAE;AACf,CAAU","ignoreList":[]}
+{"version":3,"names":["STORAGE_KEYS","EVENT_QUEUE"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,YAAY,GAAG;EAC1BC,WAAW,EAAE;AACf,CAAU","ignoreList":[]}

package/lib/typescript/EventQueue.d.ts

@@ -4,7 +4,7 @@
  *
  * 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.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 import { Event } from './types';
 import { NetworkClient } from './NetworkClient';

package/lib/typescript/NetworkClient.d.ts

@@ -3,7 +3,7 @@
  * Respectlytics React Native SDK
  *
  * Handles HTTP communication with the Respectlytics API.
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 import { Event } from './types';
 export declare enum NetworkError {
@@ -18,10 +18,11 @@ export declare enum NetworkError {
 }
 export declare class NetworkClient {
     private apiKey;
+    private apiEndpoint;
     /**
-     * Configure the network client with an API key
+     * Configure the network client with an API key and optional custom endpoint
      */
-    configure(apiKey: string): void;
+    configure(apiKey: string, apiEndpoint?: string): void;
     /**
      * Check if the client is configured
      */
@@ -35,8 +36,8 @@ export declare class NetworkClient {
      */
     private sendEvent;
     /**
-     * Convert Event object to API payload format
-     * Note: As of v2.0.0, no user_id field is sent (session-based analytics only)
+     * Convert Event object to API payload format.
+     * The SDK sends 4 fields; the API stores 5 (adding country derived from IP).
      */
     private eventToPayload;
     /**

package/lib/typescript/NetworkClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../src/NetworkClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,oBAAY,YAAY;IACtB,aAAa,mBAAmB;IAChC,eAAe,qBAAqB;IACpC,YAAY,iBAAiB;IAC7B,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;IAC9B,OAAO,YAAY;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1C;;OAEG;YACW,SAAS;IAgFvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}
+{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../src/NetworkClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,oBAAY,YAAY;IACtB,aAAa,mBAAmB;IAChC,eAAe,qBAAqB;IACpC,YAAY,iBAAiB;IAC7B,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;IAC9B,OAAO,YAAY;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAgC;IAEnD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAOrD;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1C;;OAEG;YACW,SAAS;IAgFvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/lib/typescript/Respectlytics.d.ts

@@ -3,25 +3,27 @@
  * Respectlytics React Native SDK
  *
  * Main entry point for the SDK.
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 /**
  * Main entry point for the Respectlytics SDK.
  *
- * v2.0.0 uses session-based analytics only:
+ * v2.1.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)
+ * - Only 4 fields sent by SDK; 5 stored (country derived server-side)
  *
  * Usage:
  * ```typescript
  * // 1. Configure at app launch
  * Respectlytics.configure('your-api-key');
  *
+ * // For self-hosted instances:
+ * Respectlytics.configure('your-api-key', { apiEndpoint: 'https://your-server.com/api/v1/events/' });
+ *
  * // 2. Track events
  * Respectlytics.track('purchase');
- * Respectlytics.track('view_product', 'ProductScreen');
  * ```
  */
 declare class RespectlyticsSDK {
@@ -29,31 +31,32 @@ declare class RespectlyticsSDK {
     private networkClient;
     private eventQueue;
     private sessionManager;
+    private platform;
     constructor();
     /**
      * Initialize the SDK with your API key.
      * Call once at app startup.
      *
      * @param apiKey Your Respectlytics API key from the dashboard
+     * @param options Optional configuration (e.g., apiEndpoint for self-hosted instances)
      */
-    configure(apiKey: string): void;
+    configure(apiKey: string, options?: {
+        apiEndpoint?: string;
+    }): void;
     /**
-     * Track an event with an optional screen name.
+     * Track an event.
      *
-     * The SDK automatically collects privacy-safe metadata:
-     * - timestamp, session_id, platform, os_version, app_version, locale
+     * Custom properties are NOT supported - this is by design for privacy.
+     * The API stores 5 fields (these 4 plus country derived server-side).
      *
      * @param eventName Name of the event (e.g., "purchase", "button_clicked")
-     * @param screen Optional screen name where the event occurred
      */
-    track(eventName: string, screen?: string): void;
+    track(eventName: string): void;
     /**
      * Force send all queued events immediately.
      * Rarely needed - the SDK auto-flushes every 30 seconds or when the queue reaches 10 events.
      */
     flush(): Promise<void>;
-    private createEvent;
-    private collectMetadata;
 }
 declare const Respectlytics: RespectlyticsSDK;
 export default Respectlytics;

package/lib/typescript/Respectlytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Respectlytics.d.ts","sourceRoot":"","sources":["../../src/Respectlytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;;;;;;;;;;;GAkBG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAiB;;IAQvC;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa/B;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoB/C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,eAAe;CAwDxB;AAGD,QAAA,MAAM,aAAa,kBAAyB,CAAC;AAC7C,eAAe,aAAa,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"Respectlytics.d.ts","sourceRoot":"","sources":["../../src/Respectlytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAS;;IASzB;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAanE;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA0B9B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAGD,QAAA,MAAM,aAAa,kBAAyB,CAAC;AAC7C,eAAe,aAAa,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/lib/typescript/SessionManager.d.ts

@@ -3,10 +3,10 @@
  * Respectlytics React Native SDK
  *
  * Manages session ID generation and rotation.
- * Sessions are stored in RAM only (never persisted) for GDPR/ePrivacy compliance.
+ * Sessions are stored in RAM only (never persisted to disk).
  * Sessions automatically rotate every 2 hours.
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 /**
  * Manages session ID generation and rotation.
@@ -17,8 +17,8 @@
  * - Rotated automatically every 2 hours
  * - Regenerated on every app restart (new instance = new session)
  *
- * This RAM-only approach ensures GDPR/ePrivacy compliance:
- * - No device storage = No consent required under ePrivacy Directive Article 5(3)
+ * This RAM-only approach means session data never touches device storage:
+ * - Sessions exist only in memory and are lost on app restart
  * - Each app launch creates a fresh, unlinked session
  */
 export declare class SessionManager {

package/lib/typescript/Storage.d.ts

@@ -4,7 +4,7 @@
  *
  * Wrapper around AsyncStorage for persisting SDK data.
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 /**
  * Storage wrapper providing typed access to AsyncStorage

package/lib/typescript/index.d.ts

@@ -5,11 +5,11 @@
  *
  * v2.0.0 Features:
  * - Session-based analytics (no persistent user tracking)
- * - RAM-only session storage (GDPR/ePrivacy compliant)
+ * - RAM-only session storage (never persisted to disk)
  * - Automatic 2-hour session rotation
  * - New session on every app restart
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 import Respectlytics from './Respectlytics';
 export default Respectlytics;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAG5C,eAAe,aAAa,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAG5C,eAAe,aAAa,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/types.d.ts

@@ -2,35 +2,31 @@
  * types.ts
  * Respectlytics React Native SDK
  *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- * This SDK is provided under a proprietary license.
- * See LICENSE file for details.
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 /**
  * Represents an analytics event - flat structure matching API payload
  *
- * This interface only contains fields accepted by the Respectlytics API.
- * The API uses a strict allowlist for privacy protection.
- * Custom properties are NOT supported - this is by design for privacy.
+ * The SDK sends these 4 fields. The API stores 5 total
+ * (adding country, derived server-side from IP which is immediately discarded):
+ * - event_name (required)
+ * - timestamp
+ * - session_id
+ * - platform
  *
- * Note: As of v2.0.0, there is no userId field. Session-based analytics only.
+ * Country is derived server-side from IP (which is immediately discarded).
  */
 export interface Event {
     eventName: string;
     timestamp: string;
     sessionId: string;
-    screen: string | null;
     platform: string;
-    osVersion: string;
-    appVersion: string;
-    locale: string;
-    deviceType: string;
 }
 /**
  * Storage keys used by the SDK
  *
- * Note: As of v2.0.0, we only persist the event queue.
- * Session IDs are RAM-only for GDPR/ePrivacy compliance.
+ * Note: Only the event queue is persisted.
+ * Session IDs are RAM-only for privacy.
  */
 export declare const STORAGE_KEYS: {
     readonly EVENT_QUEUE: "com.respectlytics.eventQueue";

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;CAEf,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;CAEf,CAAC"}