Loren/embedded/all

.eslintrc.js

@@ -8,6 +8,7 @@ module.exports = {
   ],
   rules: {
     'react/react-in-jsx-scope': 'off',
+    'no-bitwise': 'off',
   },
   overrides: [
     {

src/core/classes/Iterable.ts

@@ -3,34 +3,39 @@ import { Linking, NativeEventEmitter, Platform } from 'react-native';
 import { buildInfo } from '../../itblBuildInfo';
 
 import { RNIterableAPI } from '../../api';
-// TODO: Organize these so that there are no circular dependencies
-// See https://github.com/expo/expo/issues/35100
+
+import { IterableInAppManager } from '../../inApp/classes/IterableInAppManager';
 import { IterableInAppMessage } from '../../inApp/classes/IterableInAppMessage';
 import { IterableInAppCloseSource } from '../../inApp/enums/IterableInAppCloseSource';
 import { IterableInAppDeleteSource } from '../../inApp/enums/IterableInAppDeleteSource';
 import { IterableInAppLocation } from '../../inApp/enums/IterableInAppLocation';
+import {
+  defaultAuthManager,
+  defaultConfig,
+  defaultInAppManager,
+  defaultLogger,
+} from '../constants/defaults';
 import { IterableAuthResponseResult } from '../enums/IterableAuthResponseResult';
 import { IterableEventName } from '../enums/IterableEventName';
-
-// Add this type-only import to avoid circular dependency
-import { IterableInAppManager } from '../../inApp/classes/IterableInAppManager';
-
+import type { IterableAuthFailure } from '../types/IterableAuthFailure';
+import {
+  trackEmbeddedSession,
+  trackEvent,
+  trackInAppClick,
+  trackInAppClose,
+  trackInAppOpen,
+  trackPurchase,
+  trackPushOpenWithCampaignId,
+} from '../utils';
 import { IterableAction } from './IterableAction';
 import { IterableActionContext } from './IterableActionContext';
+import { IterableApi } from './IterableApi';
 import { IterableAttributionInfo } from './IterableAttributionInfo';
+import { IterableAuthManager } from './IterableAuthManager';
 import { IterableAuthResponse } from './IterableAuthResponse';
 import type { IterableCommerceItem } from './IterableCommerceItem';
 import { IterableConfig } from './IterableConfig';
 import { IterableLogger } from './IterableLogger';
-import type { IterableAuthFailure } from '../types/IterableAuthFailure';
-import {
-  defaultAuthManager,
-  defaultConfig,
-  defaultInAppManager,
-  defaultLogger,
-} from '../constants/defaults';
-import { IterableApi } from './IterableApi';
-import { IterableAuthManager } from './IterableAuthManager';
 
 const RNEventEmitter = new NativeEventEmitter(RNIterableAPI);
 
@@ -96,6 +101,26 @@ export class Iterable {
    */
   static authManager: IterableAuthManager = defaultAuthManager;
 
+  /**
+   * Tracking manager for the current user.
+   *
+   * This property provides access to tracking functionality including
+   * tracking purchases, in-app messages, and more.
+   *
+   * @example
+   * ```typescript
+   * Iterable.tracker.trackPurchase(100, [new IterableCommerceItem('item1', 'Item 1', 10.0, 1)], { key: 'value' });
+   * ```
+   */
+  static tracker = {
+    trackPushOpenWithCampaignId,
+    trackPurchase,
+    trackInAppOpen,
+    trackInAppClick,
+    trackInAppClose,
+    trackEvent,
+    trackEmbeddedSession,
+  };
   /**
    * Initializes the Iterable React Native SDK in your app's Javascript or Typescript code.
    *
@@ -391,6 +416,9 @@ export class Iterable {
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackPushOpenWithCampaignId` instead.
+   *
    * Create a `pushOpen` event on the current user's Iterable profile, populating
    * it with data provided to the method call.
    *
@@ -480,6 +508,9 @@ export class Iterable {
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackPurchase` instead.
+   *
    * Create a purchase event on the current user's Iterable profile.
    *
    * Represent each item in the purchase event with an {@link IterableCommerceItem} object.
@@ -508,10 +539,13 @@ export class Iterable {
     items: IterableCommerceItem[],
     dataFields?: unknown
   ) {
-    return IterableApi.trackPurchase(total, items, dataFields);
+    return Iterable.tracker.trackPurchase(total, items, dataFields);
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackInAppOpen` instead.
+   *
    * Create an `inAppOpen` event for the specified message on the current user's profile
    * for manual tracking purposes. Iterable's SDK automatically tracks in-app message opens when you use the
    * SDK's default rendering.
@@ -534,10 +568,13 @@ export class Iterable {
     message: IterableInAppMessage,
     location: IterableInAppLocation
   ) {
-    return IterableApi.trackInAppOpen(message, location);
+    return Iterable.tracker.trackInAppOpen(message, location);
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackInAppClick` instead.
+   *
    * Create an `inAppClick` event for the specified message on the current user's profile
    * for manual tracking purposes. Iterable's SDK automatically tracks in-app message clicks when you use the
    * SDK's default rendering. Click events refer to click events within the in-app message to distinguish
@@ -563,10 +600,13 @@ export class Iterable {
     location: IterableInAppLocation,
     clickedUrl: string
   ) {
-    return IterableApi.trackInAppClick(message, location, clickedUrl);
+    return Iterable.tracker.trackInAppClick(message, location, clickedUrl);
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackInAppClose` instead.
+   *
    * Create an `inAppClose` event for the specified message on the current
    * user's profile for manual tracking purposes. Iterable's SDK automatically
    * tracks in-app message close events when you use the SDK's default
@@ -594,7 +634,12 @@ export class Iterable {
     source: IterableInAppCloseSource,
     clickedUrl?: string
   ) {
-    return IterableApi.trackInAppClose(message, location, source, clickedUrl);
+    return Iterable.tracker.trackInAppClose(
+      message,
+      location,
+      source,
+      clickedUrl
+    );
   }
 
   /**
@@ -642,6 +687,9 @@ export class Iterable {
   }
 
   /**
+   * @deprecated -- This method is deprecated and may be removed in a future
+   * release. Use `Iterable.tracker.trackEvent` instead.
+   *
    * Create a custom event to the current user's Iterable profile.
    *
    * Pass in the name of the event stored in eventName key and the data associated with the event.
@@ -662,7 +710,7 @@ export class Iterable {
    * ```
    */
   static trackEvent(name: string, dataFields?: unknown) {
-    return IterableApi.trackEvent(name, dataFields);
+    return Iterable.tracker.trackEvent(name, dataFields);
   }
 
   /**

src/core/classes/IterableApi.ts

@@ -13,6 +13,7 @@ import type { IterableInAppDeleteSource } from '../../inApp/enums/IterableInAppD
 import type { IterableHtmlInAppContent } from '../../inApp/classes/IterableHtmlInAppContent';
 import type { IterableInAppShowResponse } from '../../inApp/enums/IterableInAppShowResponse';
 import type { IterableInboxImpressionRowInfo } from '../../inbox/types/IterableInboxImpressionRowInfo';
+import type { IterableEmbeddedSession } from '../../embedded/classes/IterableEmbeddedSession';
 
 export class IterableApi {
   static logger: IterableLogger = defaultLogger;
@@ -105,8 +106,8 @@ export class IterableApi {
   /**
    * Associate the current user with the passed in `userId` parameter.
    *
-   * WARNING: specify a user by calling `Iterable.setEmail` or
-   * `Iterable.setUserId`, but **NOT** both.
+   * WARNING: specify a user by calling `IterableApi.setEmail` or
+   * `IterableApi.setUserId`, but **NOT** both.
    *
    * @param userId - User ID to associate with the current user
    * @param authToken - Valid, pre-fetched JWT the SDK
@@ -298,6 +299,16 @@ export class IterableApi {
     return RNIterableAPI.trackEvent(name, dataFields);
   }
 
+  /**
+   * Track an embedded session.
+   *
+   * @param session - The session to track
+   */
+  static trackEmbeddedSession(session: IterableEmbeddedSession) {
+    IterableApi.logger.log('trackEmbeddedSession: ', session);
+    return RNIterableAPI.trackEmbeddedSession(session);
+  }
+
   // ---- End TRACKING ---- //
 
   // ====================================================== //

src/core/classes/IterableUtil.ts

@@ -18,4 +18,34 @@ export class IterableUtil {
       return false;
     }
   }
+
+  static generateUUID(): string {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g: any = typeof global !== 'undefined' ? (global as any) : undefined;
+
+    if (g?.crypto?.getRandomValues) {
+      const bytes = new Uint8Array(16);
+      g.crypto.getRandomValues(bytes);
+
+      // RFC 4122 compliance
+      bytes[6] = (bytes[6] ?? 0 & 0x0f) | 0x40; // version 4
+      bytes[8] = (bytes[8] ?? 0 & 0x3f) | 0x80; // variant 10
+
+      const hex = Array.from(bytes, (b) =>
+        b.toString(16).padStart(2, '0')
+      ).join('');
+      return `${hex.substring(0, 8)}-${hex.substring(8, 12)}-${hex.substring(12, 16)}-${hex.substring(16, 20)}-${hex.substring(20)}`;
+    }
+
+    // Fallback using Math.random (not cryptographically strong)
+    const hexDigits = '0123456789abcdef';
+    const s: string[] = Array(36);
+    for (let i = 0; i < 36; i++) {
+      s[i] = hexDigits.charAt(Math.floor(Math.random() * 16));
+    }
+    s[14] = '4';
+    s[19] = hexDigits.charAt((parseInt(s[19] ?? '0', 16) & 0x3) | 0x8);
+    s[8] = s[13] = s[18] = s[23] = '-';
+    return s.join('');
+  }
 }

src/core/utils/index.ts

@@ -0,0 +1 @@
+export * from './trackingUtils';