@loyalytics/swan-react-native-sdk 2.0.1

package/lib/module/utils/SharedCredentialsManager.js

@@ -0,0 +1,140 @@
+"use strict";
+
+/**
+ * SharedCredentialsManager
+ *
+ * Manages credentials storage in iOS App Groups for sharing between
+ * the main app and Notification Service Extension.
+ *
+ * This allows the extension to send delivery ACKs even when the app is killed.
+ */
+
+import { Platform } from 'react-native';
+import SharedGroupPreferences from 'react-native-shared-group-preferences';
+import Base64 from 'react-native-base64';
+import Logger from "./Logger.js";
+export class SharedCredentialsManager {
+  static APP_GROUP_ID = 'group.swan.sdk.notifications';
+  static CREDENTIALS_KEY = 'swanCredentials';
+
+  /**
+   * Save credentials to iOS App Group (for Notification Service Extension)
+   * On Android, this is a no-op as extensions don't exist.
+   */
+  static async saveToAppGroup(credentials) {
+    if (Platform.OS !== 'ios') {
+      // Android doesn't need shared App Group
+      Logger.log('[SharedCredentials] Skipping App Group save on Android');
+      return;
+    }
+    try {
+      // Encode credentials as base64 JSON
+      const credentialsJson = JSON.stringify(credentials);
+      const credentialsBase64 = Base64.encode(credentialsJson);
+
+      // Save to App Group
+      await SharedGroupPreferences.setItem(this.CREDENTIALS_KEY, credentialsBase64, this.APP_GROUP_ID);
+      Logger.log('[SharedCredentials] ✅ Credentials saved to iOS App Group');
+      Logger.log('[SharedCredentials] App Group ID:', this.APP_GROUP_ID);
+      Logger.log('[SharedCredentials] Saved credentials:', {
+        appId: credentials.appId,
+        deviceId: credentials.deviceId,
+        hasCDID: !!credentials.cdid,
+        isProduction: credentials.isProduction
+      });
+    } catch (error) {
+      Logger.error('[SharedCredentials] ❌ Failed to save to App Group:', error);
+      Logger.error('[SharedCredentials] Make sure react-native-shared-group-preferences is installed');
+      Logger.error('[SharedCredentials] Make sure App Group is configured in Xcode');
+      // Don't throw - this is not critical for main app functionality
+    }
+  }
+
+  /**
+   * Read credentials from iOS App Group
+   * Useful for debugging or fallback scenarios.
+   */
+  static async readFromAppGroup() {
+    if (Platform.OS !== 'ios') {
+      return null;
+    }
+    try {
+      const credentialsBase64 = await SharedGroupPreferences.getItem(this.CREDENTIALS_KEY, this.APP_GROUP_ID);
+      if (!credentialsBase64) {
+        Logger.log('[SharedCredentials] No credentials found in App Group');
+        return null;
+      }
+      const credentialsJson = Base64.decode(credentialsBase64);
+      const credentials = JSON.parse(credentialsJson);
+      Logger.log('[SharedCredentials] ✅ Credentials read from App Group');
+      return credentials;
+    } catch (error) {
+      Logger.error('[SharedCredentials] ❌ Failed to read from App Group:', error);
+      return null;
+    }
+  }
+
+  /**
+   * Clear credentials from iOS App Group
+   * Useful during logout or SDK reset.
+   */
+  static async clearFromAppGroup() {
+    if (Platform.OS !== 'ios') {
+      return;
+    }
+    try {
+      await SharedGroupPreferences.setItem(this.CREDENTIALS_KEY, '', this.APP_GROUP_ID);
+      Logger.log('[SharedCredentials] ✅ Credentials cleared from App Group');
+    } catch (error) {
+      Logger.error('[SharedCredentials] ❌ Failed to clear from App Group:', error);
+    }
+  }
+
+  /**
+   * Configure custom App Group ID
+   * Call this before SDK init if you want to use a different App Group ID.
+   *
+   * @param appGroupId - Custom App Group ID (e.g., "group.com.yourcompany.app")
+   */
+  static setAppGroupId(appGroupId) {
+    this.APP_GROUP_ID = appGroupId;
+    Logger.log('[SharedCredentials] App Group ID configured:', appGroupId);
+  }
+
+  /**
+   * Get current App Group ID
+   */
+  static getAppGroupId() {
+    return this.APP_GROUP_ID;
+  }
+
+  /**
+   * Check if iOS Notification Service Extension is active/configured
+   * Returns true if App Group is accessible (meaning NES is configured)
+   *
+   * This is used to determine if delivery ACKs should be skipped in the
+   * React Native background handler (since NES handles them)
+   */
+  static async isNotificationServiceExtensionActive() {
+    if (Platform.OS !== 'ios') {
+      return false; // Android doesn't have extension
+    }
+    try {
+      // Try to access App Group - if successful, NES is configured
+      const isNesActive = await SharedGroupPreferences.getItem('swanNESActive', this.APP_GROUP_ID);
+      if (!isNesActive) {
+        Logger.log('[SharedCredentials] Notification Service Extension is not configured');
+        return false;
+      }
+
+      // If we can access App Group, NES is configured
+      Logger.log('[SharedCredentials] ✅ Notification Service Extension is active');
+      return true;
+    } catch (error) {
+      // If App Group is not accessible, NES is not configured
+      Logger.log('[SharedCredentials] Notification Service Extension is not configured');
+      return false;
+    }
+  }
+}
+//# sourceMappingURL=SharedCredentialsManager.js.map

package/lib/module/utils/SharedCredentialsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","SharedGroupPreferences","Base64","Logger","SharedCredentialsManager","APP_GROUP_ID","CREDENTIALS_KEY","saveToAppGroup","credentials","OS","log","credentialsJson","JSON","stringify","credentialsBase64","encode","setItem","appId","deviceId","hasCDID","cdid","isProduction","error","readFromAppGroup","getItem","decode","parse","clearFromAppGroup","setAppGroupId","appGroupId","getAppGroupId","isNotificationServiceExtensionActive","isNesActive"],"sourceRoot":"../../../src","sources":["utils/SharedCredentialsManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/version.js

@@ -0,0 +1,8 @@
+"use strict";
+
+// Auto-generated file. Do not edit manually.
+// This file is generated from package.json version during build.
+// See scripts/generate-version.js
+
+export const SDK_VERSION = '2.0.1';
+//# sourceMappingURL=version.js.map

package/lib/module/version.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SDK_VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,OAAO,MAAMA,WAAW,GAAG,OAAO","ignoreList":[]}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/typescript/commonjs/src/components/FooterView.d.ts

@@ -0,0 +1,3 @@
+declare const FooterNotification: ({ designConfig, onClose, onButtonClick }: any) => import("react/jsx-runtime").JSX.Element;
+export default FooterNotification;
+//# sourceMappingURL=FooterView.d.ts.map

package/lib/typescript/commonjs/src/components/FooterView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FooterView.d.ts","sourceRoot":"","sources":["../../../../../src/components/FooterView.tsx"],"names":[],"mappings":"AAWA,QAAA,MAAM,kBAAkB,GAAI,0CAA0C,GAAG,4CA+DxE,CAAC;AAiDF,eAAe,kBAAkB,CAAC"}

package/lib/typescript/commonjs/src/components/FullScreenView.d.ts

@@ -0,0 +1,3 @@
+declare const FullScreenView: ({ designConfig, onClose, onButtonClick }: any) => import("react/jsx-runtime").JSX.Element;
+export default FullScreenView;
+//# sourceMappingURL=FullScreenView.d.ts.map

package/lib/typescript/commonjs/src/components/FullScreenView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullScreenView.d.ts","sourceRoot":"","sources":["../../../../../src/components/FullScreenView.tsx"],"names":[],"mappings":"AAGA,QAAA,MAAM,cAAc,GAAI,0CAA0C,GAAG,4CAsGpE,CAAC;AA+DF,eAAe,cAAc,CAAC"}

package/lib/typescript/commonjs/src/components/HeaderView.d.ts

@@ -0,0 +1,3 @@
+declare const HeaderView: ({ designConfig, onClose, onButtonClick }: any) => import("react/jsx-runtime").JSX.Element;
+export default HeaderView;
+//# sourceMappingURL=HeaderView.d.ts.map

package/lib/typescript/commonjs/src/components/HeaderView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderView.d.ts","sourceRoot":"","sources":["../../../../../src/components/HeaderView.tsx"],"names":[],"mappings":"AAYA,QAAA,MAAM,UAAU,GAAI,0CAA+C,GAAG,4CAoIrE,CAAC;AA+EF,eAAe,UAAU,CAAC"}

package/lib/typescript/commonjs/src/components/PopUpView.d.ts

@@ -0,0 +1,3 @@
+declare const PopUpView: ({ designConfig, onClose, onButtonClick }: any) => import("react/jsx-runtime").JSX.Element;
+export default PopUpView;
+//# sourceMappingURL=PopUpView.d.ts.map

package/lib/typescript/commonjs/src/components/PopUpView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopUpView.d.ts","sourceRoot":"","sources":["../../../../../src/components/PopUpView.tsx"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS,GAAI,0CAA0C,GAAG,4CAoH/D,CAAC;AAuEF,eAAe,SAAS,CAAC"}

package/lib/typescript/commonjs/src/config/BatchConfig.d.ts

@@ -0,0 +1,7 @@
+import { type BatchConfiguration } from '../types/EventQueue';
+/**
+ * Default configuration for event batching
+ * Based on industry standards (CleverTap, Segment, Mixpanel)
+ */
+export declare const DEFAULT_BATCH_CONFIG: BatchConfiguration;
+//# sourceMappingURL=BatchConfig.d.ts.map

package/lib/typescript/commonjs/src/config/BatchConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchConfig.d.ts","sourceRoot":"","sources":["../../../../../src/config/BatchConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBA+ClC,CAAC"}

package/lib/typescript/commonjs/src/constants/ApiUrls.d.ts

@@ -0,0 +1,56 @@
+/**
+ * API URLs used across the SDK
+ * Centralized to avoid circular dependencies
+ */
+export declare const ECOM_ENRICH_PROFILE_URL: {
+    STAGE: string;
+    PROD: string;
+};
+export declare const ECOM_TRACK_EVENT_URL: {
+    STAGE: string;
+    PROD: string;
+};
+export declare const ECOM_DEVICE_REGISTER_URL: {
+    STAGE: string;
+    PROD: string;
+};
+export declare const ECOM_PUSH_SUBSCRIPTION_URL: {
+    STAGE: string;
+    PROD: string;
+};
+export declare const WEBHOOK_MOBILE_PUSH_URL: {
+    STAGE: string;
+    PROD: string;
+};
+export declare const NOTIFICATION_GET_URL: {
+    STAGE: string;
+    PROD: string;
+};
+declare const _default: {
+    ECOM_ENRICH_PROFILE_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+    ECOM_TRACK_EVENT_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+    ECOM_DEVICE_REGISTER_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+    ECOM_PUSH_SUBSCRIPTION_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+    WEBHOOK_MOBILE_PUSH_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+    NOTIFICATION_GET_URL: {
+        STAGE: string;
+        PROD: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=ApiUrls.d.ts.map

package/lib/typescript/commonjs/src/constants/ApiUrls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiUrls.d.ts","sourceRoot":"","sources":["../../../../../src/constants/ApiUrls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,eAAO,MAAM,uBAAuB;;;CAGnC,CAAA;AAED,eAAO,MAAM,oBAAoB;;;CAGhC,CAAA;AAED,eAAO,MAAM,wBAAwB;;;CAGpC,CAAA;AAED,eAAO,MAAM,0BAA0B;;;CAGtC,CAAA;AAED,eAAO,MAAM,uBAAuB;;;CAGnC,CAAA;AAED,eAAO,MAAM,oBAAoB;;;CAGhC,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,wBAOC"}

package/lib/typescript/commonjs/src/core/EventQueueManager.d.ts

@@ -0,0 +1,63 @@
+import { type QueuedEvent } from '../types/EventQueue';
+/**
+ * EventQueueManager
+ * Manages persistent event queue using SQLite
+ * Handles enqueue, dequeue, status updates, and cleanup operations
+ */
+export declare class EventQueueManager {
+    private db;
+    private maxRetries;
+    constructor(db: any, maxRetries?: number);
+    /**
+     * Create EventQueue table with indexes
+     * Called during SDK initialization
+     */
+    createTable(): Promise<void>;
+    /**
+     * Add event to queue
+     * @param event Event to enqueue
+     */
+    enqueue(event: QueuedEvent): Promise<void>;
+    /**
+     * Retrieve events from queue for batch sending
+     * Priority events first, then FIFO
+     * @param batchSize Maximum number of events to retrieve
+     * @returns Array of queued events
+     */
+    dequeue(batchSize: number): Promise<QueuedEvent[]>;
+    /**
+     * Mark events as successfully sent and remove from queue
+     * @param eventIds Array of event IDs to mark as sent
+     */
+    markAsSent(eventIds: string[]): Promise<void>;
+    /**
+     * Mark events as failed and update retry count
+     * @param eventIds Array of event IDs that failed
+     * @param retryCount New retry count
+     */
+    markAsFailed(eventIds: string[], retryCount: number): Promise<void>;
+    /**
+     * Get current queue size (pending events only)
+     * @returns Number of pending events in queue
+     */
+    getQueueSize(): Promise<number>;
+    /**
+     * Clean up old failed events
+     * Deletes events older than specified days with status 'failed'
+     * @param daysOld Number of days old to consider for deletion
+     */
+    clearOldEvents(daysOld: number): Promise<void>;
+    /**
+     * Drop oldest events when queue is full
+     * Keeps queue size within limits by removing oldest pending events
+     * @param maxSize Maximum queue size to maintain
+     */
+    enforceQueueLimit(maxSize: number): Promise<void>;
+    /**
+     * Recover stale 'sending' events back to 'pending'
+     * Called on SDK initialization to handle app crashes during flush
+     * Resets events stuck in 'sending' status for more than 5 minutes
+     */
+    recoverStaleEvents(): Promise<void>;
+}
+//# sourceMappingURL=EventQueueManager.d.ts.map

package/lib/typescript/commonjs/src/core/EventQueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventQueueManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/EventQueueManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,UAAU,CAAS;gBAEf,EAAE,EAAE,GAAG,EAAE,UAAU,GAAE,MAAU;IAK3C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkElC;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuChD;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA2ExD;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCnD;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CzE;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BrC;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpD;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvD;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC1C"}

package/lib/typescript/commonjs/src/core/FlushManager.d.ts

@@ -0,0 +1,63 @@
+import { EventQueueManager } from './EventQueueManager';
+import { NetworkMonitor } from './NetworkMonitor';
+import { type BatchConfiguration, type QueuedEvent } from '../types/EventQueue';
+/**
+ * FlushManager
+ * Orchestrates batch sending with multiple flush triggers:
+ * - Time interval (every 30s)
+ * - Queue size (when batchSize reached)
+ * - App lifecycle (on background)
+ * - Network restoration (when back online)
+ */
+export declare class FlushManager {
+    private queueManager;
+    private networkMonitor;
+    private config;
+    private sendBatchCallback;
+    private flushTimer;
+    private isFlushing;
+    private appStateSubscription;
+    private retryTimeouts;
+    constructor(queueManager: EventQueueManager, networkMonitor: NetworkMonitor, config: BatchConfiguration, sendBatchCallback: (events: QueuedEvent[]) => Promise<any>);
+    /**
+     * Start flush manager
+     * - Initializes timer-based flushing
+     * - Sets up AppState listener
+     * - Sets up network state listener
+     */
+    start(): void;
+    /**
+     * Stop flush manager
+     * - Clears timer
+     * - Removes listeners
+     * - Cancels pending retries
+     */
+    stop(): void;
+    /**
+     * Trigger batch flush
+     * Prevents concurrent flushes using promise-based lock
+     * @param force If true, bypasses online check
+     * @returns Batch response from server
+     */
+    flush(force?: boolean): Promise<any>;
+    /**
+     * Handle batch response with granular event-level success/failure
+     * Parses individual event results and handles each one appropriately
+     * @param events Events that were sent in the batch
+     * @param batchResponse Response from server with individual event results
+     */
+    private handleBatchResponse;
+    /**
+     * Handle failed batch with retry logic (entire batch failed due to network/server error)
+     * Implements exponential backoff: 2s, 4s, 8s, 16s, 32s
+     * @param events Events that failed to send
+     * @param error Error that occurred
+     */
+    private handleFailedBatch;
+    /**
+     * Check if flush is needed based on queue size
+     * Called after each event is enqueued
+     */
+    checkFlushNeeded(): Promise<void>;
+}
+//# sourceMappingURL=FlushManager.d.ts.map

package/lib/typescript/commonjs/src/core/FlushManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlushManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/FlushManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGhF;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,iBAAiB,CAA0C;IAEnE,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,aAAa,CAA0C;gBAG7D,YAAY,EAAE,iBAAiB,EAC/B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC;IAQ5D;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IA8Bb;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAoBZ;;;;;OAKG;IACG,KAAK,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAoDjD;;;;;OAKG;YACW,mBAAmB;IAgFjC;;;;;OAKG;YACW,iBAAiB;IAmC/B;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAcxC"}

package/lib/typescript/commonjs/src/core/NetworkMonitor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * NetworkMonitor
+ * Monitors network connectivity status
+ * Notifies when connection status changes
+ */
+export declare class NetworkMonitor {
+    private isOnline;
+    private unsubscribe;
+    private listeners;
+    /**
+     * Start monitoring network state
+     */
+    start(): void;
+    /**
+     * Stop monitoring network state
+     */
+    stop(): void;
+    /**
+     * Check if currently connected to network
+     * @returns true if connected, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Add listener for connection state changes
+     * @param callback Function called when connection state changes
+     */
+    addListener(callback: (isOnline: boolean) => void): void;
+    /**
+     * Remove listener
+     * @param callback Listener to remove
+     */
+    removeListener(callback: (isOnline: boolean) => void): void;
+    /**
+     * Notify all listeners of connection state change
+     */
+    private notifyListeners;
+}
+//# sourceMappingURL=NetworkMonitor.d.ts.map

package/lib/typescript/commonjs/src/core/NetworkMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkMonitor.d.ts","sourceRoot":"","sources":["../../../../../src/core/NetworkMonitor.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,SAAS,CAA+C;IAEhE;;OAEG;IACH,KAAK,IAAI,IAAI;IA8Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIxD;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI3D;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}