respectlytics-react-native 1.0.1 → 2.0.0

package/lib/commonjs/SessionManager.js

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SessionManager = void 0;
+/**
+ * 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
+ */
+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, '');
+  }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=SessionManager.js.map

package/lib/commonjs/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","exports"],"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;AACO,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;AAACkB,OAAA,CAAAX,cAAA,GAAAA,cAAA","ignoreList":[]}

package/lib/commonjs/Storage.js

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

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

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Event", {
+  enumerable: true,
+  get: function () {
+    return _types.Event;
+  }
+});
+Object.defineProperty(exports, "RespectlyticsSDK", {
+  enumerable: true,
+  get: function () {
+    return _Respectlytics.RespectlyticsSDK;
+  }
+});
+exports.default = void 0;
+var _Respectlytics = _interopRequireWildcard(require("./Respectlytics"));
+var _types = require("./types");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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.
+ */
+// Default export - the main SDK instance
+var _default = exports.default = _Respectlytics.default; // Named exports for advanced usage
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_Respectlytics","_interopRequireWildcard","require","_types","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_default","exports","Respectlytics"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;AAcA,IAAAA,cAAA,GAAAC,uBAAA,CAAAC,OAAA;AAOA,IAAAC,MAAA,GAAAD,OAAA;AAAgC,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AArBhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA;AAAA,IAAAkB,QAAA,GAAAC,OAAA,CAAAV,OAAA,GACeW,sBAAa,EAE5B","ignoreList":[]}

package/lib/commonjs/types.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.STORAGE_KEYS = void 0;
+/**
+ * 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.
+ */
+const STORAGE_KEYS = exports.STORAGE_KEYS = {
+  EVENT_QUEUE: 'com.respectlytics.eventQueue'
+};
+//# sourceMappingURL=types.js.map

package/lib/commonjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_KEYS","exports","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;AACO,MAAMA,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG;EAC1BE,WAAW,EAAE;AACf,CAAU","ignoreList":[]}

package/lib/module/EventQueue.js

@@ -0,0 +1,166 @@
+/**
+ * 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 { AppState } from 'react-native';
+import NetInfo from '@react-native-community/netinfo';
+import { Storage } from './Storage';
+const MAX_QUEUE_SIZE = 10;
+const FLUSH_INTERVAL_MS = 30000; // 30 seconds
+const QUEUE_STORAGE_KEY = 'com.respectlytics.eventQueue';
+export 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.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 = AppState.addEventListener('change', nextAppState => {
+      // Flush when app goes to background
+      if (nextAppState === 'background' || nextAppState === 'inactive') {
+        this.flush();
+      }
+    });
+  }
+  async persistQueue() {
+    try {
+      await 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.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 = [];
+    }
+  }
+}
+//# sourceMappingURL=EventQueue.js.map

package/lib/module/EventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AppState","NetInfo","Storage","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","addEventListener","state","wasOffline","isConnected","nextAppState","setItem","JSON","stringify","data","getItem","parsed","parse","Array","isArray"],"sourceRoot":"../../src","sources":["EventQueue.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/NetworkClient.js

@@ -0,0 +1,151 @@
+/**
+ * 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;
+export let 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;
+}({});
+export 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));
+  }
+}
+export const networkClient = new NetworkClient();
+//# sourceMappingURL=NetworkClient.js.map

package/lib/module/NetworkClient.js.map

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