respectlytics-react-native 1.0.1 → 2.0.0

package/lib/module/Respectlytics.js

@@ -0,0 +1,162 @@
+/**
+ * Respectlytics.ts
+ * Respectlytics React Native SDK
+ * 
+ * Main entry point for the SDK.
+ * Copyright (c) 2025 Respectlytics. All rights reserved.
+ */
+
+import { Platform, Dimensions, NativeModules } 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:
+ * - 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();
+    this.eventQueue = new EventQueue(this.networkClient);
+    this.sessionManager = new 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 = 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
+const Respectlytics = new RespectlyticsSDK();
+export default Respectlytics;
+export { RespectlyticsSDK };
+//# sourceMappingURL=Respectlytics.js.map

package/lib/module/Respectlytics.js.map

@@ -0,0 +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":[]}

package/lib/module/SessionManager.js

@@ -0,0 +1,68 @@
+/**
+ * SessionManager.ts
+ * Respectlytics React Native SDK
+ *
+ * Manages session ID generation and rotation.
+ * 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.
+ */
+
+/**
+ * Generate a UUID v4 string
+ */
+function generateUUID() {
+  return '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);
+  });
+}
+
+/**
+ * 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 {
+  // Session ID generated immediately at class instantiation
+  sessionId = this.generateSessionId();
+  sessionStart = new Date();
+
+  // 2 hours in milliseconds
+  SESSION_TIMEOUT_MS = 2 * 60 * 60 * 1000;
+
+  /**
+   * Get current session ID, rotating if necessary.
+   * Session rotates after 2 hours of continuous use.
+   */
+  getSessionId() {
+    const now = new Date();
+    const elapsed = now.getTime() - this.sessionStart.getTime();
+
+    // Rotate session after 2 hours
+    if (elapsed > this.SESSION_TIMEOUT_MS) {
+      this.sessionId = this.generateSessionId();
+      this.sessionStart = now;
+    }
+    return this.sessionId;
+  }
+
+  /**
+   * Generate a new session ID (32 lowercase hex characters)
+   * UUID without dashes, all lowercase
+   */
+  generateSessionId() {
+    return generateUUID().toLowerCase().replace(/-/g, '');
+  }
+}
+//# sourceMappingURL=SessionManager.js.map

package/lib/module/SessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["generateUUID","replace","c","r","Math","random","v","toString","SessionManager","sessionId","generateSessionId","sessionStart","Date","SESSION_TIMEOUT_MS","getSessionId","now","elapsed","getTime","toLowerCase"],"sourceRoot":"../../src","sources":["SessionManager.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA,SAASA,YAAYA,CAAA,EAAW;EAC9B,OAAO,sCAAsC,CAACC,OAAO,CAAC,OAAO,EAAGC,CAAC,IAAK;IACpE,MAAMC,CAAC,GAAIC,IAAI,CAACC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAI,CAAC;IAClC,MAAMC,CAAC,GAAGJ,CAAC,KAAK,GAAG,GAAGC,CAAC,GAAIA,CAAC,GAAG,GAAG,GAAI,GAAG;IACzC,OAAOG,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC;EACvB,CAAC,CAAC;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,CAAC;EAC1B;EACQC,SAAS,GAAW,IAAI,CAACC,iBAAiB,CAAC,CAAC;EAC5CC,YAAY,GAAS,IAAIC,IAAI,CAAC,CAAC;;EAEvC;EACiBC,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;;EAExD;AACF;AACA;AACA;EACEC,YAAYA,CAAA,EAAW;IACrB,MAAMC,GAAG,GAAG,IAAIH,IAAI,CAAC,CAAC;IACtB,MAAMI,OAAO,GAAGD,GAAG,CAACE,OAAO,CAAC,CAAC,GAAG,IAAI,CAACN,YAAY,CAACM,OAAO,CAAC,CAAC;;IAE3D;IACA,IAAID,OAAO,GAAG,IAAI,CAACH,kBAAkB,EAAE;MACrC,IAAI,CAACJ,SAAS,GAAG,IAAI,CAACC,iBAAiB,CAAC,CAAC;MACzC,IAAI,CAACC,YAAY,GAAGI,GAAG;IACzB;IAEA,OAAO,IAAI,CAACN,SAAS;EACvB;;EAEA;AACF;AACA;AACA;EACUC,iBAAiBA,CAAA,EAAW;IAClC,OAAOV,YAAY,CAAC,CAAC,CAACkB,WAAW,CAAC,CAAC,CAACjB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;EACvD;AACF","ignoreList":[]}

package/lib/module/Storage.js

@@ -0,0 +1,50 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/module/index.js

@@ -0,0 +1,23 @@
+/**
+ * Respectlytics React Native SDK
+ * 
+ * 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.
+ */
+
+import Respectlytics from './Respectlytics';
+
+// Default export - the main SDK instance
+export default Respectlytics;
+
+// Named exports for advanced usage
+export { RespectlyticsSDK } from './Respectlytics';
+export { Event } from './types';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/types.js

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+
+/**
+ * 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 = {
+  EVENT_QUEUE: 'com.respectlytics.eventQueue'
+};
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +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":[]}

package/lib/typescript/EventQueue.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+import { Event } from './types';
+import { NetworkClient } from './NetworkClient';
+export declare class EventQueue {
+    private events;
+    private isOnline;
+    private flushTimer;
+    private networkClient;
+    private isFlushing;
+    private unsubscribeNetInfo;
+    private appStateSubscription;
+    constructor(networkClient: NetworkClient);
+    /**
+     * Initialize the queue - load persisted events and set up listeners
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the queue and clean up resources
+     */
+    stop(): void;
+    /**
+     * Add an event to the queue
+     * CRITICAL: Events are persisted IMMEDIATELY before any async operations
+     */
+    add(event: Event): Promise<void>;
+    /**
+     * Force flush all queued events
+     */
+    flush(): Promise<void>;
+    /**
+     * Get current queue size (for testing)
+     */
+    getQueueSize(): number;
+    private scheduleFlush;
+    private setupNetworkMonitor;
+    private setupAppStateMonitor;
+    private persistQueue;
+    private loadPersistedQueue;
+}
+//# sourceMappingURL=EventQueue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventQueue.d.ts","sourceRoot":"","sources":["../../src/EventQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,oBAAoB,CAAuC;gBAEvD,aAAa,EAAE,aAAa;IAIxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;IACH,YAAY,IAAI,MAAM;IAMtB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;YAYd,YAAY;YAQZ,kBAAkB;CAejC"}

package/lib/typescript/NetworkClient.d.ts

@@ -0,0 +1,48 @@
+/**
+ * NetworkClient.ts
+ * Respectlytics React Native SDK
+ *
+ * Handles HTTP communication with the Respectlytics API.
+ * Copyright (c) 2025 Respectlytics. All rights reserved.
+ */
+import { Event } from './types';
+export declare enum NetworkError {
+    NotConfigured = "NOT_CONFIGURED",
+    InvalidResponse = "INVALID_RESPONSE",
+    Unauthorized = "UNAUTHORIZED",
+    BadRequest = "BAD_REQUEST",
+    RateLimited = "RATE_LIMITED",
+    ServerError = "SERVER_ERROR",
+    NetworkError = "NETWORK_ERROR",
+    Timeout = "TIMEOUT"
+}
+export declare class NetworkClient {
+    private apiKey;
+    /**
+     * Configure the network client with an API key
+     */
+    configure(apiKey: string): void;
+    /**
+     * Check if the client is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Send events to the API
+     */
+    send(events: Event[]): Promise<void>;
+    /**
+     * Send a single event with retry logic
+     */
+    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)
+     */
+    private eventToPayload;
+    /**
+     * Helper to delay for exponential backoff
+     */
+    private delay;
+}
+export declare const networkClient: NetworkClient;
+//# sourceMappingURL=NetworkClient.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/Respectlytics.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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');
+ * ```
+ */
+declare class RespectlyticsSDK {
+    private isConfigured;
+    private networkClient;
+    private eventQueue;
+    private sessionManager;
+    constructor();
+    /**
+     * Initialize the SDK with your API key.
+     * Call once at app startup.
+     *
+     * @param apiKey Your Respectlytics API key from the dashboard
+     */
+    configure(apiKey: string): void;
+    /**
+     * 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: string, screen?: 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;
+export { RespectlyticsSDK };
+//# sourceMappingURL=Respectlytics.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/SessionManager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SessionManager.ts
+ * Respectlytics React Native SDK
+ *
+ * Manages session ID generation and rotation.
+ * 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.
+ */
+/**
+ * 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 declare class SessionManager {
+    private sessionId;
+    private sessionStart;
+    private readonly SESSION_TIMEOUT_MS;
+    /**
+     * Get current session ID, rotating if necessary.
+     * Session rotates after 2 hours of continuous use.
+     */
+    getSessionId(): string;
+    /**
+     * Generate a new session ID (32 lowercase hex characters)
+     * UUID without dashes, all lowercase
+     */
+    private generateSessionId;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,YAAY,CAAoB;IAGxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEzD;;;OAGG;IACH,YAAY,IAAI,MAAM;IAatB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAG1B"}

package/lib/typescript/Storage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/lib/typescript/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Respectlytics React Native SDK
+ *
+ * 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.
+ */
+import Respectlytics from './Respectlytics';
+export default Respectlytics;
+export { RespectlyticsSDK } from './Respectlytics';
+export { Event } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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.
+ */
+/**
+ * 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.
+ */
+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.
+ */
+export declare const STORAGE_KEYS: {
+    readonly EVENT_QUEUE: "com.respectlytics.eventQueue";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}