respectlytics-react-native 1.0.1 → 2.0.0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "respectlytics-react-native",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "Official Respectlytics SDK for React Native. Privacy-first analytics with automatic session management, offline event queuing, and zero device identifier collection.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
-  "types": "lib/typescript/src/index.d.ts",
+  "types": "lib/typescript/index.d.ts",
   "react-native": "src/index.ts",
   "source": "src/index.ts",
   "files": [

package/src/NetworkClient.ts

@@ -138,13 +138,13 @@ 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)
    */
   private eventToPayload(event: Event): Record<string, unknown> {
     return {
       event_name: event.eventName,
       timestamp: event.timestamp,
       session_id: event.sessionId,
-      user_id: event.userId || undefined,
       screen: event.screen || undefined,
       platform: event.platform,
       os_version: event.osVersion,

package/src/Respectlytics.ts

@@ -9,22 +9,24 @@
 import { Platform, Dimensions, NativeModules } from 'react-native';
 import { Event } from './types';
 import { SessionManager } from './SessionManager';
-import { UserManager } from './UserManager';
 import { NetworkClient } from './NetworkClient';
 import { EventQueue } from './EventQueue';
 
 /**
  * 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. Enable user tracking (optional)
- * Respectlytics.identify();
- * 
- * // 3. Track events
+ * // 2. Track events
  * Respectlytics.track('purchase');
  * Respectlytics.track('view_product', 'ProductScreen');
  * ```
@@ -34,13 +36,11 @@ class RespectlyticsSDK {
   private networkClient: NetworkClient;
   private eventQueue: EventQueue;
   private sessionManager: SessionManager;
-  private userManager: UserManager;
 
   constructor() {
     this.networkClient = new NetworkClient();
     this.eventQueue = new EventQueue(this.networkClient);
     this.sessionManager = new SessionManager();
-    this.userManager = new UserManager();
   }
 
   /**
@@ -57,7 +57,6 @@ class RespectlyticsSDK {
 
     this.networkClient.configure(apiKey);
     this.eventQueue.start();
-    this.userManager.loadUserId();
     this.isConfigured = true;
 
     console.log('[Respectlytics] ✓ SDK configured');
@@ -92,26 +91,6 @@ class RespectlyticsSDK {
     this.eventQueue.add(event);
   }
 
-  /**
-   * Enable cross-session user tracking.
-   * Generates and persists a random user ID that will be included in all subsequent events.
-   * 
-   * Note: User IDs are auto-generated and cannot be overridden. This is by design for privacy.
-   */
-  async identify(): Promise<void> {
-    await this.userManager.identify();
-    console.log('[Respectlytics] ✓ User identified');
-  }
-
-  /**
-   * Clear the user ID.
-   * Call when the user logs out. Subsequent events will be anonymous until identify() is called again.
-   */
-  async reset(): Promise<void> {
-    await this.userManager.reset();
-    console.log('[Respectlytics] ✓ User reset');
-  }
-
   /**
    * Force send all queued events immediately.
    * Rarely needed - the SDK auto-flushes every 30 seconds or when the queue reaches 10 events.
@@ -129,7 +108,6 @@ class RespectlyticsSDK {
       eventName,
       timestamp: new Date().toISOString(),
       sessionId: this.sessionManager.getSessionId(),
-      userId: this.userManager.getUserId(),
       screen: screen || null,
       ...metadata,
     };

package/src/SessionManager.ts

@@ -3,7 +3,8 @@
  * Respectlytics React Native SDK
  *
  * Manages session ID generation and rotation.
- * Sessions automatically rotate after 30 minutes of inactivity.
+ * Sessions are stored in RAM only (never persisted) for GDPR/ePrivacy compliance.
+ * Sessions automatically rotate every 2 hours.
  *
  * Copyright (c) 2025 Respectlytics. All rights reserved.
  */
@@ -20,37 +21,40 @@ function generateUUID(): string {
 }
 
 /**
- * Manages session ID generation and rotation
+ * 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)
+ * - Each app launch creates a fresh, unlinked session
  */
 export class SessionManager {
-  private sessionId: string | null = null;
-  private lastEventTime: number | null = null;
+  // Session ID generated immediately at class instantiation
+  private sessionId: string = this.generateSessionId();
+  private sessionStart: Date = new Date();
 
-  // 30 minutes in milliseconds
-  private readonly SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+  // 2 hours in milliseconds
+  private readonly SESSION_TIMEOUT_MS = 2 * 60 * 60 * 1000;
 
   /**
    * Get current session ID, rotating if necessary.
-   * Session rotates after 30 minutes of inactivity.
+   * Session rotates after 2 hours of continuous use.
    */
   getSessionId(): string {
-    const now = Date.now();
-
-    // Check if session expired
-    if (
-      this.lastEventTime !== null &&
-      now - this.lastEventTime > this.SESSION_TIMEOUT_MS
-    ) {
-      // Force new session
-      this.sessionId = null;
-    }
+    const now = new Date();
+    const elapsed = now.getTime() - this.sessionStart.getTime();
 
-    // Generate new session if needed
-    if (this.sessionId === null) {
+    // Rotate session after 2 hours
+    if (elapsed > this.SESSION_TIMEOUT_MS) {
       this.sessionId = this.generateSessionId();
+      this.sessionStart = now;
     }
 
-    this.lastEventTime = now;
     return this.sessionId;
   }
 

package/src/index.ts

@@ -1,7 +1,14 @@
 /**
  * Respectlytics React Native SDK
  * 
- * Official SDK for privacy-first analytics.
+ * Official SDK for privacy-first, session-based analytics.
+ * 
+ * v2.0.0 Features:
+ * - Session-based analytics (no persistent user tracking)
+ * - RAM-only session storage (GDPR/ePrivacy compliant)
+ * - Automatic 2-hour session rotation
+ * - New session on every app restart
+ * 
  * Copyright (c) 2025 Respectlytics. All rights reserved.
  */
 

package/src/types.ts

@@ -13,12 +13,13 @@
  * 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.
  */
 export interface Event {
   eventName: string;
   timestamp: string;
   sessionId: string;
-  userId: string | null;
   screen: string | null;
   platform: string;
   osVersion: string;
@@ -29,8 +30,10 @@ export interface Event {
 
 /**
  * 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.
  */
 export const STORAGE_KEYS = {
-  USER_ID: 'com.respectlytics.userId',
   EVENT_QUEUE: 'com.respectlytics.eventQueue',
 } as const;

package/src/UserManager.ts

@@ -1,74 +0,0 @@
-/**
- * UserManager.ts
- * Respectlytics React Native SDK
- *
- * Manages user ID generation, persistence, and reset.
- * User IDs are auto-generated and cannot be overridden.
- * This is by design for maximum privacy.
- *
- * Copyright (c) 2025 Respectlytics. All rights reserved.
- */
-
-import { Storage } from './Storage';
-import { STORAGE_KEYS } from './types';
-
-/**
- * Manages user ID generation, persistence, and reset
- */
-export class UserManager {
-  private _userId: string | null = null;
-
-  /**
-   * Current user ID (null if not identified)
-   */
-  getUserId(): string | null {
-    return this._userId;
-  }
-
-  /**
-   * Load any persisted user ID from storage
-   */
-  async loadUserId(): Promise<void> {
-    this._userId = await Storage.getItem(STORAGE_KEYS.USER_ID);
-  }
-
-  /**
-   * Generate or retrieve user ID.
-   * If already identified, returns existing ID.
-   * If not, generates a new ID and persists it.
-   */
-  async identify(): Promise<void> {
-    // Check storage first
-    const stored = await Storage.getItem(STORAGE_KEYS.USER_ID);
-    if (stored) {
-      this._userId = stored;
-      return;
-    }
-
-    // Generate new ID (32 lowercase hex chars)
-    const newId = this.generateUserId();
-    await Storage.setItem(STORAGE_KEYS.USER_ID, newId);
-    this._userId = newId;
-  }
-
-  /**
-   * Clear user ID. Call on logout.
-   */
-  async reset(): Promise<void> {
-    await Storage.removeItem(STORAGE_KEYS.USER_ID);
-    this._userId = null;
-  }
-
-  /**
-   * Generate a new user ID (32 lowercase hex characters)
-   * UUID without dashes, all lowercase
-   */
-  private generateUserId(): string {
-    const uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-      const r = (Math.random() * 16) | 0;
-      const v = c === 'x' ? r : (r & 0x3) | 0x8;
-      return v.toString(16);
-    });
-    return uuid.toLowerCase().replace(/-/g, '');
-  }
-}