@loyalytics/swan-react-native-sdk 2.0.1

package/lib/commonjs/state/AuthStateMachine.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AuthStateMachine = exports.AuthState = void 0;
+var _Logger = _interopRequireDefault(require("../utils/Logger.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+let AuthState = exports.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
+ */
+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.default.warn('[AuthStateMachine] Already logged in');
+      return;
+    }
+
+    // Login in progress - wait for existing promise
+    if (this.state === AuthState.LOGGING_IN && this.loginPromise) {
+      _Logger.default.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.default.warn('[AuthStateMachine] Already logged out');
+      return;
+    }
+
+    // Logout in progress - wait for existing promise
+    if (this.state === AuthState.LOGGING_OUT && this.logoutPromise) {
+      _Logger.default.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.default.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.default.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.default.log(`[AuthStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        _Logger.default.error('[AuthStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+}
+exports.AuthStateMachine = AuthStateMachine;
+//# sourceMappingURL=AuthStateMachine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_Logger","_interopRequireDefault","require","e","__esModule","default","AuthState","exports","AuthStateMachine","state","LOGGED_OUT","listeners","loginPromise","logoutPromise","getState","on","listener","push","filter","l","login","loginFn","LOGGED_IN","Logger","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/commonjs/state/DeviceStateMachine.js

@@ -0,0 +1,104 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DeviceStateMachine = exports.DeviceState = void 0;
+var _Logger = _interopRequireDefault(require("../utils/Logger.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+let DeviceState = exports.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
+ */
+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.default.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.default.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.default.log('[DeviceStateMachine] State reset to UNINITIALIZED');
+  }
+  transition(newState) {
+    const oldState = this.state;
+    if (oldState === newState) {
+      return; // No transition needed
+    }
+    this.state = newState;
+    _Logger.default.log(`[DeviceStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        _Logger.default.error('[DeviceStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+}
+exports.DeviceStateMachine = DeviceStateMachine;
+//# sourceMappingURL=DeviceStateMachine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_Logger","_interopRequireDefault","require","e","__esModule","default","DeviceState","exports","DeviceStateMachine","state","UNINITIALIZED","registrationPromise","listeners","getState","on","listener","push","filter","l","register","registrationFn","REGISTERED","Logger","log","REGISTERING","transition","then","credentials","catch","error","FAILED","reset","newState","oldState","change","from","to","forEach"],"sourceRoot":"../../../src","sources":["state/DeviceStateMachine.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/state/PushStateMachine.js

@@ -0,0 +1,129 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PushStateMachine = exports.PushState = void 0;
+var _Logger = _interopRequireDefault(require("../utils/Logger.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+let PushState = exports.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
+ */
+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.default.warn(`[PushStateMachine] Unexpected state transition: ${oldState} → ${newState}`);
+    }
+    this.state = newState;
+    _Logger.default.log(`[PushStateMachine] State transition: ${oldState} → ${newState}`);
+
+    // Notify listeners
+    const change = {
+      from: oldState,
+      to: newState
+    };
+    this.listeners.forEach(listener => {
+      try {
+        listener(change);
+      } catch (error) {
+        _Logger.default.error('[PushStateMachine] Error in state change listener:', error);
+      }
+    });
+  }
+
+  /**
+   * Reset to disabled state
+   */
+  reset() {
+    this.state = PushState.DISABLED;
+    _Logger.default.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;
+  }
+}
+exports.PushStateMachine = PushStateMachine;
+//# sourceMappingURL=PushStateMachine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_Logger","_interopRequireDefault","require","e","__esModule","default","PushState","exports","PushStateMachine","state","DISABLED","listeners","getState","on","listener","push","filter","l","transition","newState","oldState","isValidTransition","Logger","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/commonjs/types/EventQueue.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.QUEUE_CALL_TYPES = void 0;
+/**
+ * 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
+ */
+const QUEUE_CALL_TYPES = exports.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/commonjs/types/EventQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["QUEUE_CALL_TYPES","exports","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;AACO,MAAMA,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAG;EAC9B;EACA;;EAEA;EACAE,cAAc,EAAE,gBAAgB;EAChCC,gBAAgB,EAAE,kBAAkB;EACpCC,cAAc,EAAE,gBAAgB;EAChCC,gBAAgB,EAAE,uBAAuB,CAAE;AAC7C,CAAU","ignoreList":[]}

package/lib/commonjs/types/SDK.js

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

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

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