@loyalytics/swan-react-native-sdk 2.0.1

package/lib/module/state/AuthStateMachine.js

@@ -0,0 +1,155 @@
+"use strict";
+
+import Logger from "../utils/Logger.js";
+export let AuthState = /*#__PURE__*/function (AuthState) {
+  AuthState["LOGGED_OUT"] = "logged_out";
+  AuthState["LOGGING_IN"] = "logging_in";
+  AuthState["LOGGED_IN"] = "logged_in";
+  AuthState["LOGGING_OUT"] = "logging_out";
+  AuthState["ERROR"] = "error";
+  return AuthState;
+}({});
+/**
+ * State machine for authentication flow (login/logout).
+ * Replaces isLoggingIn and isLoggingOut boolean flags.
+ *
+ * States:
+ * - LOGGED_OUT: No user logged in (anonymous profile)
+ * - LOGGING_IN: Login in progress
+ * - LOGGED_IN: User logged in (currentCDID set)
+ * - LOGGING_OUT: Logout in progress
+ * - ERROR: Login/logout failed
+ */
+export class AuthStateMachine {
+  state = AuthState.LOGGED_OUT;
+  listeners = [];
+  loginPromise = null;
+  logoutPromise = null;
+  getState() {
+    return this.state;
+  }
+
+  /**
+   * Subscribe to state changes
+   */
+  on(listener) {
+    this.listeners.push(listener);
+    // Return unsubscribe function
+    return () => {
+      this.listeners = this.listeners.filter(l => l !== listener);
+    };
+  }
+
+  /**
+   * Execute login with duplicate call protection
+   */
+  async login(loginFn) {
+    // Already logged in
+    if (this.state === AuthState.LOGGED_IN) {
+      Logger.warn('[AuthStateMachine] Already logged in');
+      return;
+    }
+
+    // Login in progress - wait for existing promise
+    if (this.state === AuthState.LOGGING_IN && this.loginPromise) {
+      Logger.warn('[AuthStateMachine] Login already in progress, ignoring duplicate call');
+      return this.loginPromise;
+    }
+    this.transition(AuthState.LOGGING_IN);
+    this.loginPromise = loginFn().then(result => {
+      this.transition(AuthState.LOGGED_IN);
+      return result;
+    }).catch(error => {
+      this.transition(AuthState.ERROR);
+      this.loginPromise = null;
+      throw error;
+    }).finally(() => {
+      this.loginPromise = null;
+    });
+    return this.loginPromise;
+  }
+
+  /**
+   * Execute logout with duplicate call protection
+   */
+  async logout(logoutFn) {
+    // Already logged out
+    if (this.state === AuthState.LOGGED_OUT) {
+      Logger.warn('[AuthStateMachine] Already logged out');
+      return;
+    }
+
+    // Logout in progress - wait for existing promise
+    if (this.state === AuthState.LOGGING_OUT && this.logoutPromise) {
+      Logger.warn('[AuthStateMachine] Logout already in progress, ignoring duplicate call');
+      return this.logoutPromise;
+    }
+    this.transition(AuthState.LOGGING_OUT);
+    this.logoutPromise = logoutFn().then(result => {
+      this.transition(AuthState.LOGGED_OUT);
+      return result;
+    }).catch(error => {
+      this.transition(AuthState.ERROR);
+      this.logoutPromise = null;
+      throw error;
+    }).finally(() => {
+      this.logoutPromise = null;
+    });
+    return this.logoutPromise;
+  }
+
+  /**
+   * Check if user is logged in
+   */
+  isLoggedIn() {
+    return this.state === AuthState.LOGGED_IN;
+  }
+
+  /**
+   * Check if login/logout operation is in progress
+   */
+  isOperationInProgress() {
+    return this.state === AuthState.LOGGING_IN || this.state === AuthState.LOGGING_OUT;
+  }
+
+  /**
+   * Reset to logged out state
+   */
+  reset() {
+    this.state = AuthState.LOGGED_OUT;
+    this.loginPromise = null;
+    this.logoutPromise = null;
+    Logger.log('[AuthStateMachine] State reset to LOGGED_OUT');
+  }
+
+  /**
+   * Restore state from stored credentials (used during SDK initialization)
+   * @param isLoggedIn Whether user has currentCDID in stored credentials
+   */
+  restoreState(isLoggedIn) {
+    this.state = isLoggedIn ? AuthState.LOGGED_IN : AuthState.LOGGED_OUT;
+    Logger.log(`[AuthStateMachine] State restored: ${this.state} (from credentials)`);
+  }
+  transition(newState) {
+    const oldState = this.state;
+    if (oldState === newState) {
+      return; // No transition needed
+    }
+    this.state = newState;
+    Logger.log(`[AuthStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        Logger.error('[AuthStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+}
+//# sourceMappingURL=AuthStateMachine.js.map

package/lib/module/state/AuthStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Logger","AuthState","AuthStateMachine","state","LOGGED_OUT","listeners","loginPromise","logoutPromise","getState","on","listener","push","filter","l","login","loginFn","LOGGED_IN","warn","LOGGING_IN","transition","then","result","catch","error","ERROR","finally","logout","logoutFn","LOGGING_OUT","isLoggedIn","isOperationInProgress","reset","log","restoreState","newState","oldState","change","from","to","forEach"],"sourceRoot":"../../../src","sources":["state/AuthStateMachine.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/state/DeviceStateMachine.js

@@ -0,0 +1,98 @@
+"use strict";
+
+import Logger from "../utils/Logger.js";
+export let DeviceState = /*#__PURE__*/function (DeviceState) {
+  DeviceState["UNINITIALIZED"] = "uninitialized";
+  DeviceState["REGISTERING"] = "registering";
+  DeviceState["REGISTERED"] = "registered";
+  DeviceState["FAILED"] = "failed";
+  return DeviceState;
+}({});
+/**
+ * State machine for device registration flow.
+ * Eliminates race conditions from boolean flags.
+ *
+ * States: UNINITIALIZED → REGISTERING → REGISTERED → FAILED
+ */
+export class DeviceStateMachine {
+  state = DeviceState.UNINITIALIZED;
+  registrationPromise = null;
+  listeners = [];
+  getState() {
+    return this.state;
+  }
+
+  /**
+   * Subscribe to state changes
+   */
+  on(listener) {
+    this.listeners.push(listener);
+    // Return unsubscribe function
+    return () => {
+      this.listeners = this.listeners.filter(l => l !== listener);
+    };
+  }
+
+  /**
+   * Register device with race condition protection.
+   * If already registered, returns cached credentials.
+   * If registration in progress, waits for existing promise.
+   * Otherwise, starts new registration.
+   */
+  async register(registrationFn) {
+    // Already registered - return cached result
+    if (this.state === DeviceState.REGISTERED && this.registrationPromise) {
+      Logger.log('[DeviceStateMachine] Device already registered, returning cached credentials');
+      return this.registrationPromise;
+    }
+
+    // Registration in progress - wait for it
+    if (this.state === DeviceState.REGISTERING && this.registrationPromise) {
+      Logger.log('[DeviceStateMachine] Device registration in progress, waiting...');
+      return this.registrationPromise;
+    }
+
+    // Start new registration
+    this.transition(DeviceState.REGISTERING);
+    this.registrationPromise = registrationFn().then(credentials => {
+      this.transition(DeviceState.REGISTERED);
+      return credentials;
+    }).catch(error => {
+      this.transition(DeviceState.FAILED);
+      this.registrationPromise = null; // Allow retry on failure
+      throw error;
+    });
+    return this.registrationPromise;
+  }
+
+  /**
+   * Reset state machine (useful for testing or logout scenarios)
+   */
+  reset() {
+    this.state = DeviceState.UNINITIALIZED;
+    this.registrationPromise = null;
+    Logger.log('[DeviceStateMachine] State reset to UNINITIALIZED');
+  }
+  transition(newState) {
+    const oldState = this.state;
+    if (oldState === newState) {
+      return; // No transition needed
+    }
+    this.state = newState;
+    Logger.log(`[DeviceStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        Logger.error('[DeviceStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+}
+//# sourceMappingURL=DeviceStateMachine.js.map

package/lib/module/state/DeviceStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Logger","DeviceState","DeviceStateMachine","state","UNINITIALIZED","registrationPromise","listeners","getState","on","listener","push","filter","l","register","registrationFn","REGISTERED","log","REGISTERING","transition","then","credentials","catch","error","FAILED","reset","newState","oldState","change","from","to","forEach"],"sourceRoot":"../../../src","sources":["state/DeviceStateMachine.ts"],"mappings":";;AAAA,OAAOA,MAAM,MAAM,oBAAiB;AAEpC,WAAYC,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAqBvB;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,CAAC;EACtBC,KAAK,GAAgBF,WAAW,CAACG,aAAa;EAC9CC,mBAAmB,GAAsC,IAAI;EAC7DC,SAAS,GAA0B,EAAE;EAE7CC,QAAQA,CAAA,EAAgB;IACtB,OAAO,IAAI,CAACJ,KAAK;EACnB;;EAEA;AACF;AACA;EACEK,EAAEA,CAACC,QAA6B,EAAc;IAC5C,IAAI,CAACH,SAAS,CAACI,IAAI,CAACD,QAAQ,CAAC;IAC7B;IACA,OAAO,MAAM;MACX,IAAI,CAACH,SAAS,GAAG,IAAI,CAACA,SAAS,CAACK,MAAM,CAACC,CAAC,IAAIA,CAAC,KAAKH,QAAQ,CAAC;IAC7D,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,MAAMI,QAAQA,CACZC,cAAgD,EACpB;IAC5B;IACA,IAAI,IAAI,CAACX,KAAK,KAAKF,WAAW,CAACc,UAAU,IAAI,IAAI,CAACV,mBAAmB,EAAE;MACrEL,MAAM,CAACgB,GAAG,CAAC,8EAA8E,CAAC;MAC1F,OAAO,IAAI,CAACX,mBAAmB;IACjC;;IAEA;IACA,IAAI,IAAI,CAACF,KAAK,KAAKF,WAAW,CAACgB,WAAW,IAAI,IAAI,CAACZ,mBAAmB,EAAE;MACtEL,MAAM,CAACgB,GAAG,CAAC,kEAAkE,CAAC;MAC9E,OAAO,IAAI,CAACX,mBAAmB;IACjC;;IAEA;IACA,IAAI,CAACa,UAAU,CAACjB,WAAW,CAACgB,WAAW,CAAC;IAExC,IAAI,CAACZ,mBAAmB,GAAGS,cAAc,CAAC,CAAC,CACxCK,IAAI,CAACC,WAAW,IAAI;MACnB,IAAI,CAACF,UAAU,CAACjB,WAAW,CAACc,UAAU,CAAC;MACvC,OAAOK,WAAW;IACpB,CAAC,CAAC,CACDC,KAAK,CAACC,KAAK,IAAI;MACd,IAAI,CAACJ,UAAU,CAACjB,WAAW,CAACsB,MAAM,CAAC;MACnC,IAAI,CAAClB,mBAAmB,GAAG,IAAI,CAAC,CAAC;MACjC,MAAMiB,KAAK;IACb,CAAC,CAAC;IAEJ,OAAO,IAAI,CAACjB,mBAAmB;EACjC;;EAEA;AACF;AACA;EACEmB,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACrB,KAAK,GAAGF,WAAW,CAACG,aAAa;IACtC,IAAI,CAACC,mBAAmB,GAAG,IAAI;IAC/BL,MAAM,CAACgB,GAAG,CAAC,mDAAmD,CAAC;EACjE;EAEQE,UAAUA,CAACO,QAAqB,EAAQ;IAC9C,MAAMC,QAAQ,GAAG,IAAI,CAACvB,KAAK;IAE3B,IAAIuB,QAAQ,KAAKD,QAAQ,EAAE;MACzB,OAAO,CAAC;IACV;IAEA,IAAI,CAACtB,KAAK,GAAGsB,QAAQ;IACrBzB,MAAM,CAACgB,GAAG,CAAC,0CAA0CU,QAAQ,MAAMD,QAAQ,EAAE,CAAC;;IAE9E;IACA,MAAME,MAAM,GAAG;MAAEC,IAAI,EAAEF,QAAQ;MAAEG,EAAE,EAAEJ;IAAS,CAAC;IAC/C,IAAI,CAACnB,SAAS,CAACwB,OAAO,CAACrB,QAAQ,IAAI;MACjC,IAAI;QACFA,QAAQ,CAACkB,MAAM,CAAC;MAClB,CAAC,CAAC,OAAOL,KAAK,EAAE;QACdtB,MAAM,CAACsB,KAAK,CAAC,sDAAsD,EAAEA,KAAK,CAAC;MAC7E;IACF,CAAC,CAAC;EACJ;AACF","ignoreList":[]}

package/lib/module/state/PushStateMachine.js

@@ -0,0 +1,123 @@
+"use strict";
+
+import Logger from "../utils/Logger.js";
+export let PushState = /*#__PURE__*/function (PushState) {
+  PushState["DISABLED"] = "disabled";
+  PushState["INITIALIZING"] = "initializing";
+  PushState["READY"] = "ready";
+  PushState["PERMISSION_DENIED"] = "permission_denied";
+  PushState["TOKEN_PENDING"] = "token_pending";
+  PushState["ACTIVE"] = "active";
+  PushState["ERROR"] = "error";
+  return PushState;
+}({});
+/**
+ * State machine for push notification lifecycle.
+ * Manages the complex flow of permission → token → active states.
+ *
+ * States:
+ * - DISABLED: Push notifications not enabled in config
+ * - INITIALIZING: Loading Firebase provider
+ * - READY: Provider initialized, ready to request permission
+ * - PERMISSION_DENIED: User denied permission
+ * - TOKEN_PENDING: Permission granted, waiting for FCM token
+ * - ACTIVE: Token received and registered with backend
+ * - ERROR: Push initialization failed
+ */
+export class PushStateMachine {
+  state = PushState.DISABLED;
+  listeners = [];
+  getState() {
+    return this.state;
+  }
+
+  /**
+   * Subscribe to state changes
+   */
+  on(listener) {
+    this.listeners.push(listener);
+    // Return unsubscribe function
+    return () => {
+      this.listeners = this.listeners.filter(l => l !== listener);
+    };
+  }
+
+  /**
+   * Transition to a new state
+   */
+  transition(newState) {
+    const oldState = this.state;
+    if (oldState === newState) {
+      return; // No transition needed
+    }
+
+    // Validate state transitions (optional - can be removed for flexibility)
+    if (!this.isValidTransition(oldState, newState)) {
+      Logger.warn(`[PushStateMachine] Unexpected state transition: ${oldState} → ${newState}`);
+    }
+    this.state = newState;
+    Logger.log(`[PushStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        Logger.error('[PushStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+
+  /**
+   * Reset to disabled state
+   */
+  reset() {
+    this.state = PushState.DISABLED;
+    Logger.log('[PushStateMachine] State reset to DISABLED');
+  }
+
+  /**
+   * Check if push is active (token received and synced)
+   */
+  isActive() {
+    return this.state === PushState.ACTIVE;
+  }
+
+  /**
+   * Check if push is in error state
+   */
+  isError() {
+    return this.state === PushState.ERROR;
+  }
+
+  /**
+   * Check if push is disabled
+   */
+  isDisabled() {
+    return this.state === PushState.DISABLED;
+  }
+
+  /**
+   * Validate state transitions (optional - for debugging)
+   */
+  isValidTransition(from, to) {
+    const validTransitions = {
+      [PushState.DISABLED]: [PushState.INITIALIZING],
+      [PushState.INITIALIZING]: [PushState.READY, PushState.ERROR],
+      [PushState.READY]: [PushState.PERMISSION_DENIED, PushState.TOKEN_PENDING, PushState.ERROR],
+      [PushState.PERMISSION_DENIED]: [PushState.READY],
+      // Can retry permission
+      [PushState.TOKEN_PENDING]: [PushState.ACTIVE, PushState.ERROR],
+      [PushState.ACTIVE]: [PushState.TOKEN_PENDING],
+      // Token refresh
+      [PushState.ERROR]: [PushState.INITIALIZING] // Can retry initialization
+    };
+    const allowedTransitions = validTransitions[from];
+    return allowedTransitions ? allowedTransitions.includes(to) : false;
+  }
+}
+//# sourceMappingURL=PushStateMachine.js.map

package/lib/module/state/PushStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Logger","PushState","PushStateMachine","state","DISABLED","listeners","getState","on","listener","push","filter","l","transition","newState","oldState","isValidTransition","warn","log","change","from","to","forEach","error","reset","isActive","ACTIVE","isError","ERROR","isDisabled","validTransitions","INITIALIZING","READY","PERMISSION_DENIED","TOKEN_PENDING","allowedTransitions","includes"],"sourceRoot":"../../../src","sources":["state/PushStateMachine.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types/EventQueue.js

@@ -0,0 +1,46 @@
+"use strict";
+
+/**
+ * Type definitions for Event Batching System
+ * Supports offline queuing, batching, and fault-tolerant event delivery
+ */
+
+/**
+ * Event stored in the queue
+ */
+
+/**
+ * Configuration for batch processing
+ */
+
+/**
+ * Batch payload sent to backend
+ */
+
+/**
+ * Individual event within a batch
+ */
+
+/**
+ * Response from batch endpoint
+ */
+
+/**
+ * Result for individual event in batch
+ */
+
+/**
+ * Queue call type constants
+ * Used to distinguish different network call types in the queue
+ */
+export const QUEUE_CALL_TYPES = {
+  // Standard events use their actual event names (no prefix)
+  // e.g., 'productViewed', 'userLogin', etc.
+
+  // Special call types for non-event network operations
+  PUSH_SUBSCRIBE: 'PUSH_SUBSCRIBE',
+  PUSH_UNSUBSCRIBE: 'PUSH_UNSUBSCRIBE',
+  PROFILE_ENRICH: 'PROFILE_ENRICH',
+  NOTIFICATION_ACK: 'SWAN_NOTIFICATION_ACK' // Already exists
+};
+//# sourceMappingURL=EventQueue.js.map

package/lib/module/types/EventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["QUEUE_CALL_TYPES","PUSH_SUBSCRIBE","PUSH_UNSUBSCRIBE","PROFILE_ENRICH","NOTIFICATION_ACK"],"sourceRoot":"../../../src","sources":["types/EventQueue.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAaA;AACA;AACA;;AAWA;AACA;AACA;;AAYA;AACA;AACA;;AAWA;AACA;AACA;;AAQA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA,OAAO,MAAMA,gBAAgB,GAAG;EAC9B;EACA;;EAEA;EACAC,cAAc,EAAE,gBAAgB;EAChCC,gBAAgB,EAAE,kBAAkB;EACpCC,cAAc,EAAE,gBAAgB;EAChCC,gBAAgB,EAAE,uBAAuB,CAAE;AAC7C,CAAU","ignoreList":[]}

package/lib/module/types/SDK.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=SDK.js.map

package/lib/module/types/SDK.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/SDK.ts"],"mappings":"","ignoreList":[]}