respectlytics-react-native 2.1.0 → 3.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "respectlytics-react-native",
-  "version": "2.1.0",
-  "description": "Official Respectlytics SDK for React Native. Privacy-first analytics with automatic session management, offline event queuing, and zero device identifier collection.",
+  "version": "3.0.0",
+  "description": "Official Respectlytics SDK for React Native. Privacy-first analytics with automatic session management, zero device storage, and no device identifier collection.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "types": "lib/typescript/index.d.ts",
@@ -16,7 +16,7 @@
     "!**/.*"
   ],
   "scripts": {
-    "typescript": "tsc --noEmit",
+    "typescript": "tsc --noEmit --project tsconfig.build.json",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "build": "bob build",
     "test": "jest",
@@ -38,7 +38,7 @@
     "url": "git+https://github.com/respectlytics/respectlytics-react-native.git"
   },
   "author": "Respectlytics <respectlytics@loheden.com>",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/respectlytics/respectlytics-react-native/issues"
   },
@@ -49,7 +49,6 @@
   "devDependencies": {
     "@babel/preset-env": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^11.3.0",
     "@types/jest": "^29.5.12",
     "@types/react": "^18.2.0",
@@ -64,15 +63,11 @@
     "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "@react-native-async-storage/async-storage": ">=1.17.0",
     "@react-native-community/netinfo": ">=9.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0"
   },
   "peerDependenciesMeta": {
-    "@react-native-async-storage/async-storage": {
-      "optional": false
-    },
     "@react-native-community/netinfo": {
       "optional": false
     }

package/src/EventQueue.ts

@@ -1,21 +1,28 @@
 /**
  * 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.
+ *
+ * Manages event batching and automatic flushing.
+ *
+ * Event queue is RAM-only by design. No data is written to device storage
+ * (no AsyncStorage, no files, no databases) for analytics purposes.
+ * If the app is force-quit before the next flush, unsent events are lost.
+ * This is a deliberate privacy-first design choice — zero bytes are written
+ * to the user's device for analytics purposes.
+ *
+ * The SDK auto-flushes every 30 seconds, on 10 queued events, and when the
+ * app enters background, so the loss window is narrow.
+ *
+ * Copyright (c) 2025 Respectlytics. Licensed under MIT.
  */
 
 import { AppState, AppStateStatus } from 'react-native';
 import NetInfo, { NetInfoState } from '@react-native-community/netinfo';
 import { Event } from './types';
-import { Storage } from './Storage';
 import { NetworkClient } from './NetworkClient';
 
 const MAX_QUEUE_SIZE = 10;
 const FLUSH_INTERVAL_MS = 30000; // 30 seconds
-const QUEUE_STORAGE_KEY = 'com.respectlytics.eventQueue';
 
 export class EventQueue {
   private events: Event[] = [];
@@ -31,10 +38,9 @@ export class EventQueue {
   }
 
   /**
-   * Initialize the queue - load persisted events and set up listeners
+   * Initialize the queue — set up listeners and start flush timer
    */
-  async start(): Promise<void> {
-    await this.loadPersistedQueue();
+  start(): void {
     this.setupNetworkMonitor();
     this.setupAppStateMonitor();
     this.scheduleFlush();
@@ -60,15 +66,11 @@ export class EventQueue {
   }
 
   /**
-   * Add an event to the queue
-   * CRITICAL: Events are persisted IMMEDIATELY before any async operations
+   * Add an event to the in-memory queue.
    */
-  async add(event: Event): Promise<void> {
+  add(event: Event): void {
     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();
@@ -98,7 +100,6 @@ export class EventQueue {
     // Take a snapshot of events to send
     const batch = [...this.events];
     this.events = [];
-    await this.persistQueue();
 
     try {
       await this.networkClient.send(batch);
@@ -106,7 +107,6 @@ export class EventQueue {
     } 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;
@@ -155,28 +155,4 @@ export class EventQueue {
       }
     );
   }
-
-  private async persistQueue(): Promise<void> {
-    try {
-      await Storage.setItem(QUEUE_STORAGE_KEY, JSON.stringify(this.events));
-    } catch (error) {
-      console.log('[Respectlytics] Failed to persist queue:', error);
-    }
-  }
-
-  private async loadPersistedQueue(): Promise<void> {
-    try {
-      const data = await 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 = [];
-    }
-  }
 }

package/src/NetworkClient.ts

@@ -3,12 +3,12 @@
  * 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';
 
-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;
 
@@ -25,12 +25,16 @@ export enum NetworkError {
 
 export class NetworkClient {
   private apiKey: string | null = null;
+  private apiEndpoint: string = 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: string): void {
+  configure(apiKey: string, apiEndpoint?: string): void {
     this.apiKey = apiKey;
+    if (apiEndpoint) {
+      this.apiEndpoint = apiEndpoint;
+    }
   }
 
   /**
@@ -65,7 +69,7 @@ export class NetworkClient {
     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',
@@ -137,8 +141,8 @@ export class NetworkClient {
   }
 
   /**
-   * Convert Event object to API payload format
-   * v2.1.0: Only 4 fields are sent
+   * Convert Event object to API payload format.
+   * The SDK sends 4 fields; the API stores 5 (adding country derived from IP).
    */
   private eventToPayload(event: Event): Record<string, unknown> {
     return {

package/src/Respectlytics.ts

@@ -3,7 +3,7 @@
  * 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 } from 'react-native';
@@ -15,17 +15,21 @@ import { EventQueue } from './EventQueue';
 /**
  * Main entry point for the Respectlytics SDK.
  *
- * v2.1.0 uses session-based analytics only:
+ * v3.0.0 uses session-based analytics only:
  * - Session IDs are generated automatically in RAM
+ * - Event queue is RAM-only (zero device storage)
  * - Sessions rotate every 2 hours
  * - New session on every app restart
- * - Only 4 fields sent: event_name, timestamp, session_id, platform
+ * - 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');
  * ```
@@ -49,25 +53,26 @@ class RespectlyticsSDK {
    * 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 {
     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 (v2.1.0)');
+    console.log('[Respectlytics] ✓ SDK configured (v3.0.0)');
   }
 
   /**
    * Track an event.
    *
    * Custom properties are NOT supported - this is by design for privacy.
-   * The API uses a strict 4-field allowlist.
+   * The API stores 5 fields (these 4 plus country derived server-side).
    *
    * @param eventName Name of the event (e.g., "purchase", "button_clicked")
    */

package/src/SessionManager.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.
  */
 
 /**
@@ -22,15 +22,15 @@ function generateUUID(): string {
 
 /**
  * Manages session ID generation and rotation.
- * 
+ *
  * Session IDs are:
  * - Generated immediately when the SDK initializes
  * - Stored in RAM only (never persisted to AsyncStorage)
  * - 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/src/index.ts

@@ -1,17 +1,17 @@
 /**
  * Respectlytics React Native SDK
- * 
+ *
  * Official SDK for privacy-first, session-based analytics.
- * 
- * v2.0.0 Features:
+ *
+ * v3.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)
+ * - RAM-only event queue (zero device storage)
  * - 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/src/types.ts

@@ -2,15 +2,14 @@
  * 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
  *
- * v2.1.0: Only 4 fields are sent (strict API allowlist):
+ * 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
@@ -24,13 +23,3 @@ export interface Event {
   sessionId: string;
   platform: string;
 }
-
-/**
- * Storage keys used by the SDK
- *
- * Note: Only the event queue is persisted.
- * Session IDs are RAM-only for privacy.
- */
-export const STORAGE_KEYS = {
-  EVENT_QUEUE: 'com.respectlytics.eventQueue',
-} as const;

package/lib/commonjs/Storage.js

@@ -1,57 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Storage = void 0;
-var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Storage.ts
- * Respectlytics React Native SDK
- *
- * Wrapper around AsyncStorage for persisting SDK data.
- *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- */
-
-/**
- * Storage wrapper providing typed access to AsyncStorage
- */
-class Storage {
-  /**
-   * Get a string value from storage
-   */
-  static async getItem(key) {
-    try {
-      return await _asyncStorage.default.getItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to read from storage: ${key}`);
-      return null;
-    }
-  }
-
-  /**
-   * Set a string value in storage
-   */
-  static async setItem(key, value) {
-    try {
-      await _asyncStorage.default.setItem(key, value);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to write to storage: ${key}`);
-    }
-  }
-
-  /**
-   * Remove a value from storage
-   */
-  static async removeItem(key) {
-    try {
-      await _asyncStorage.default.removeItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to remove from storage: ${key}`);
-    }
-  }
-}
-exports.Storage = Storage;
-//# sourceMappingURL=Storage.js.map

package/lib/commonjs/Storage.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_asyncStorage","_interopRequireDefault","require","e","__esModule","default","Storage","getItem","key","AsyncStorage","error","console","log","setItem","value","removeItem","exports"],"sourceRoot":"../../src","sources":["Storage.ts"],"mappings":";;;;;;AASA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAqE,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AATrE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACO,MAAMG,OAAO,CAAC;EACnB;AACF;AACA;EACE,aAAaC,OAAOA,CAACC,GAAW,EAA0B;IACxD,IAAI;MACF,OAAO,MAAMC,qBAAY,CAACF,OAAO,CAACC,GAAG,CAAC;IACxC,CAAC,CAAC,OAAOE,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,gDAAgDJ,GAAG,EAAE,CAAC;MAClE,OAAO,IAAI;IACb;EACF;;EAEA;AACF;AACA;EACE,aAAaK,OAAOA,CAACL,GAAW,EAAEM,KAAa,EAAiB;IAC9D,IAAI;MACF,MAAML,qBAAY,CAACI,OAAO,CAACL,GAAG,EAAEM,KAAK,CAAC;IACxC,CAAC,CAAC,OAAOJ,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,+CAA+CJ,GAAG,EAAE,CAAC;IACnE;EACF;;EAEA;AACF;AACA;EACE,aAAaO,UAAUA,CAACP,GAAW,EAAiB;IAClD,IAAI;MACF,MAAMC,qBAAY,CAACM,UAAU,CAACP,GAAG,CAAC;IACpC,CAAC,CAAC,OAAOE,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,kDAAkDJ,GAAG,EAAE,CAAC;IACtE;EACF;AACF;AAACQ,OAAA,CAAAV,OAAA,GAAAA,OAAA","ignoreList":[]}

package/lib/module/Storage.js

@@ -1,50 +0,0 @@
-/**
- * Storage.ts
- * Respectlytics React Native SDK
- *
- * Wrapper around AsyncStorage for persisting SDK data.
- *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- */
-
-import AsyncStorage from '@react-native-async-storage/async-storage';
-
-/**
- * Storage wrapper providing typed access to AsyncStorage
- */
-export class Storage {
-  /**
-   * Get a string value from storage
-   */
-  static async getItem(key) {
-    try {
-      return await AsyncStorage.getItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to read from storage: ${key}`);
-      return null;
-    }
-  }
-
-  /**
-   * Set a string value in storage
-   */
-  static async setItem(key, value) {
-    try {
-      await AsyncStorage.setItem(key, value);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to write to storage: ${key}`);
-    }
-  }
-
-  /**
-   * Remove a value from storage
-   */
-  static async removeItem(key) {
-    try {
-      await AsyncStorage.removeItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to remove from storage: ${key}`);
-    }
-  }
-}
-//# sourceMappingURL=Storage.js.map

package/lib/module/Storage.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["AsyncStorage","Storage","getItem","key","error","console","log","setItem","value","removeItem"],"sourceRoot":"../../src","sources":["Storage.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,YAAY,MAAM,2CAA2C;;AAEpE;AACA;AACA;AACA,OAAO,MAAMC,OAAO,CAAC;EACnB;AACF;AACA;EACE,aAAaC,OAAOA,CAACC,GAAW,EAA0B;IACxD,IAAI;MACF,OAAO,MAAMH,YAAY,CAACE,OAAO,CAACC,GAAG,CAAC;IACxC,CAAC,CAAC,OAAOC,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,gDAAgDH,GAAG,EAAE,CAAC;MAClE,OAAO,IAAI;IACb;EACF;;EAEA;AACF;AACA;EACE,aAAaI,OAAOA,CAACJ,GAAW,EAAEK,KAAa,EAAiB;IAC9D,IAAI;MACF,MAAMR,YAAY,CAACO,OAAO,CAACJ,GAAG,EAAEK,KAAK,CAAC;IACxC,CAAC,CAAC,OAAOJ,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,+CAA+CH,GAAG,EAAE,CAAC;IACnE;EACF;;EAEA;AACF;AACA;EACE,aAAaM,UAAUA,CAACN,GAAW,EAAiB;IAClD,IAAI;MACF,MAAMH,YAAY,CAACS,UAAU,CAACN,GAAG,CAAC;IACpC,CAAC,CAAC,OAAOC,KAAK,EAAE;MACdC,OAAO,CAACC,GAAG,CAAC,kDAAkDH,GAAG,EAAE,CAAC;IACtE;EACF;AACF","ignoreList":[]}

package/lib/typescript/Storage.d.ts

@@ -1,26 +0,0 @@
-/**
- * Storage.ts
- * Respectlytics React Native SDK
- *
- * Wrapper around AsyncStorage for persisting SDK data.
- *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- */
-/**
- * Storage wrapper providing typed access to AsyncStorage
- */
-export declare class Storage {
-    /**
-     * Get a string value from storage
-     */
-    static getItem(key: string): Promise<string | null>;
-    /**
-     * Set a string value in storage
-     */
-    static setItem(key: string, value: string): Promise<void>;
-    /**
-     * Remove a value from storage
-     */
-    static removeItem(key: string): Promise<void>;
-}
-//# sourceMappingURL=Storage.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../src/Storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,qBAAa,OAAO;IAClB;;OAEG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzD;;OAEG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D;;OAEG;WACU,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOpD"}

package/src/Storage.ts

@@ -1,49 +0,0 @@
-/**
- * Storage.ts
- * Respectlytics React Native SDK
- *
- * Wrapper around AsyncStorage for persisting SDK data.
- *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- */
-
-import AsyncStorage from '@react-native-async-storage/async-storage';
-
-/**
- * Storage wrapper providing typed access to AsyncStorage
- */
-export class Storage {
-  /**
-   * Get a string value from storage
-   */
-  static async getItem(key: string): Promise<string | null> {
-    try {
-      return await AsyncStorage.getItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to read from storage: ${key}`);
-      return null;
-    }
-  }
-
-  /**
-   * Set a string value in storage
-   */
-  static async setItem(key: string, value: string): Promise<void> {
-    try {
-      await AsyncStorage.setItem(key, value);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to write to storage: ${key}`);
-    }
-  }
-
-  /**
-   * Remove a value from storage
-   */
-  static async removeItem(key: string): Promise<void> {
-    try {
-      await AsyncStorage.removeItem(key);
-    } catch (error) {
-      console.log(`[Respectlytics] Failed to remove from storage: ${key}`);
-    }
-  }
-}