mixpanel-browser 2.77.0 → 2.79.0

package/dist/async-modules/{mixpanel-targeting-CmVvUyFM.js → mixpanel-targeting-BBMVbgJF.js}

@@ -27,7 +27,7 @@
     }
 
     var Config = {
-        LIB_VERSION: '2.77.0'
+        LIB_VERSION: '2.79.0'
     };
 
     // Window global names for async modules
@@ -1340,7 +1340,8 @@
         if (_localStorageSupported !== null && !forceCheck) {
             return _localStorageSupported;
         }
-        return _localStorageSupported = _testStorageSupported(storage || win.localStorage);
+
+        return _localStorageSupported = _testStorageSupported(storage);
     };
 
     var _sessionStorageSupported = null;
@@ -1348,7 +1349,8 @@
         if (_sessionStorageSupported !== null && !forceCheck) {
             return _sessionStorageSupported;
         }
-        return _sessionStorageSupported = _testStorageSupported(storage || win.sessionStorage);
+
+        return _sessionStorageSupported = _testStorageSupported(storage);
     };
 
     function _storageWrapper(storage, name, is_supported_fn) {
@@ -1391,17 +1393,26 @@
         };
     }
 
-    // Safari errors out accessing localStorage/sessionStorage when cookies are disabled,
-    // so create dummy storage wrappers that silently fail as a fallback.
-    var windowLocalStorage = null, windowSessionStorage = null;
-    try {
-        windowLocalStorage = win.localStorage;
-        windowSessionStorage = win.sessionStorage;
-        // eslint-disable-next-line no-empty
-    } catch (_err) {}
+    // Safari and other browsers may error out accessing localStorage/sessionStorage
+    // when cookies are disabled, so wrap access in a try-catch.
+    var getLocalStorage = function() {
+        try {
+            return win.localStorage; // eslint-disable-line no-restricted-properties
+        } catch (_err) {
+            return null;
+        }
+    };
+
+    var getSessionStorage = function() {
+        try {
+            return win.sessionStorage; // eslint-disable-line no-restricted-properties
+        } catch (_err) {
+            return null;
+        }
+    };
 
-    _.localStorage = _storageWrapper(windowLocalStorage, 'localStorage', localStorageSupported);
-    _.sessionStorage = _storageWrapper(windowSessionStorage, 'sessionStorage', sessionStorageSupported);
+    _.localStorage = _storageWrapper(getLocalStorage(), 'localStorage', localStorageSupported);
+    _.sessionStorage = _storageWrapper(getSessionStorage(), 'sessionStorage', sessionStorageSupported);
 
     _.register_event = (function() {
         // written by Dean Edwards, 2005

package/dist/mixpanel-core.cjs.d.ts

@@ -165,8 +165,47 @@ export interface AutocaptureConfig {
   block_element_callback?: (element: Element, event: Event) => boolean;
 }
 
+/**
+ * Network-only variant lookup - no persistence. Default behavior.
+ */
+export interface NetworkOnlyFlagsPolicy {
+  variantLookupPolicy: "networkOnly";
+}
+
+/**
+ * Network-first variant lookup - prioritizes freshness.
+ * Attempts network fetch first, falls back to persisted variants on failure.
+ */
+export interface NetworkFirstFlagsPolicy {
+  variantLookupPolicy: "networkFirst";
+  /**
+   * Time-to-live in milliseconds. Persisted variants older than this are discarded.
+   * Defaults to 24 hours.
+   */
+  persistenceTtlMs?: number;
+}
+
+/**
+ * Serves persisted variants immediately while a network fetch runs in the background.
+ * Once the fetch succeeds, its result replaces the cached variants for the rest of the session.
+ */
+export interface PersistenceUntilNetworkSuccessFlagsPolicy {
+  variantLookupPolicy: "persistenceUntilNetworkSuccess";
+  /**
+   * Time-to-live in milliseconds. Persisted variants older than this are discarded.
+   * Defaults to 24 hours.
+   */
+  persistenceTtlMs?: number;
+}
+
+export type FlagsPersistencePolicy =
+  | NetworkOnlyFlagsPolicy
+  | NetworkFirstFlagsPolicy
+  | PersistenceUntilNetworkSuccessFlagsPolicy;
+
 export interface FlagsConfig {
-  context: Dict;
+  context?: Dict;
+  persistence?: FlagsPersistencePolicy;
 }
 
 export interface BeforeSendHookPayload {
@@ -349,6 +388,8 @@ export interface FlagsVariant {
   experiment_id?: string;
   is_experiment_active?: boolean;
   is_qa_tester?: boolean;
+  variant_source?: string;
+  persisted_at_in_ms?: number;
 }
 
 export interface FlagsUpdateContextOptions {
@@ -357,6 +398,7 @@ export interface FlagsUpdateContextOptions {
 
 export interface FlagsManager {
   are_flags_ready(): boolean;
+  load_flags(): Promise<void>;
   get_variant(
     featureName: string,
     fallback: FlagsVariant
@@ -364,12 +406,15 @@ export interface FlagsManager {
   get_variant_sync(featureName: string, fallback: FlagsVariant): FlagsVariant;
   get_variant_value(featureName: string, fallbackValue: any): Promise<any>;
   get_variant_value_sync(featureName: string, fallbackValue: any): any;
+  get_all_variants(): Promise<Map<string, FlagsVariant>>;
+  get_all_variants_sync(): Map<string, FlagsVariant>;
   is_enabled(featureName: string, fallbackValue?: boolean): Promise<boolean>;
   is_enabled_sync(featureName: string, fallbackValue?: boolean): boolean;
   update_context(
     context: Dict,
     options?: FlagsUpdateContextOptions
   ): Promise<void>;
+  when_ready(): Promise<void>;
 }
 
 export interface Mixpanel {