@keak/sdk 1.0.5 → 1.0.7

package/dist/index.js

@@ -2901,6 +2901,12 @@ const Experiment = ({ name, children, active = true }) => {
             contentLength: variantContent.length
         };
     });
+    // Determine if we're in development/preview mode (Keak Code desktop app)
+    // Calculate this before registration effect so it's available there
+    const isDevMode = typeof window !== 'undefined' && (window.location.hostname === 'localhost' ||
+        window.location.hostname === '127.0.0.1' ||
+        window.location.port !== '' ||
+        keakInstance?.config.debug);
     // Register experiment with SDK for live management
     useEffect(() => {
         if (keakInstance && variantElements.length > 0) {
@@ -2924,11 +2930,22 @@ const Experiment = ({ name, children, active = true }) => {
             keakInstance.registerLiveExperiment(experimentData);
             // Only track impressions if experiment is active
             if (active) {
-                // Log split testing assignment and track impression immediately
                 const variantNames = variantMetadata.map(v => v.name);
-                const assignedVariant = keakInstance.getVariant(name, variantNames);
-                if (keakInstance.config.debug) {
-                    console.log(`🎯 [Keak SDK] Split test assignment for "${name}": → Variant "${assignedVariant}"`);
+                // In dev mode, don't call getVariant (which stores in localStorage)
+                // Instead, use "treatment" for tracking purposes
+                let assignedVariant;
+                if (isDevMode) {
+                    assignedVariant = variantNames.includes('treatment') ? 'treatment' : variantNames[0];
+                    if (keakInstance.config.debug) {
+                        console.log(`🎯 [Keak SDK] Experiment "${name}" in dev mode, using "${assignedVariant}" for tracking (not stored)`);
+                    }
+                }
+                else {
+                    // Production mode: use normal assignment (stores in localStorage)
+                    assignedVariant = keakInstance.getVariant(name, variantNames);
+                    if (keakInstance.config.debug) {
+                        console.log(`🎯 [Keak SDK] Split test assignment for "${name}": → Variant "${assignedVariant}"`);
+                    }
                 }
                 // Track impression immediately when variant is determined
                 if (assignedVariant) {
@@ -2941,46 +2958,55 @@ const Experiment = ({ name, children, active = true }) => {
                 }
             }
         }
-    }, [name, variantElements.length, variantMetadata, active]);
+    }, [name, variantElements.length, variantMetadata, active, isDevMode]);
     // Get variant assignment from SDK (with proper split testing)
     const variantNames = variantMetadata.map(v => v.name);
-    // Determine if we're in development/preview mode (Keak Code desktop app)
-    const isDevMode = typeof window !== 'undefined' && (window.location.hostname === 'localhost' ||
-        window.location.hostname === '127.0.0.1' ||
-        window.location.port !== '' ||
-        keakInstance?.config.debug);
     let selectedIndex;
-    if (!active) {
-        // Inactive: Always show control variant (original)
-        selectedIndex = variantElements.findIndex((variant) => variant.props.name === 'control');
-        if (selectedIndex === -1) {
-            selectedIndex = 0; // Fallback to first variant if no "control" named variant
-        }
-        if (keakInstance?.config.debug) {
-            console.log(`🔇 [Keak SDK] Experiment "${name}" is inactive, showing control (original)`);
+    // Priority 1: Check for forced variant from setExperimentVariant (highest priority)
+    const forcedVariant = keakInstance?.assignments[name] || assignments[name];
+    if (forcedVariant) {
+        const forcedIndex = variantElements.findIndex((variant) => variant.props.name === forcedVariant);
+        if (forcedIndex !== -1) {
+            selectedIndex = forcedIndex;
+            if (keakInstance?.config.debug) {
+                console.log(`🎯 [Keak SDK] Experiment "${name}" using forced variant: "${forcedVariant}"`);
+            }
         }
     }
-    else if (isDevMode) {
-        // Active in dev mode: Show treatment variant (for preview purposes)
-        selectedIndex = variantElements.findIndex((variant) => variant.props.name === 'treatment');
-        if (selectedIndex === -1) {
-            // Fallback: show the last variant (usually treatment) or first if only one
-            selectedIndex = variantElements.length > 1 ? 1 : 0;
-        }
-        if (keakInstance?.config.debug) {
-            console.log(`🎯 [Keak SDK] Experiment "${name}" is active (dev mode), showing treatment (variant)`);
+    // If no forced variant, use normal logic
+    if (selectedIndex === undefined) {
+        if (!active) {
+            // Inactive: Always show control variant (original)
+            selectedIndex = variantElements.findIndex((variant) => variant.props.name === 'control');
+            if (selectedIndex === -1) {
+                selectedIndex = 0; // Fallback to first variant if no "control" named variant
+            }
+            if (keakInstance?.config.debug) {
+                console.log(`🔇 [Keak SDK] Experiment "${name}" is inactive, showing control (original)`);
+            }
         }
-    }
-    else {
-        // Active in production: Normal A/B split testing
-        const assignedVariantName = keakInstance?.getVariant(name, variantNames) || variantNames[0];
-        // Find the index of the assigned variant
-        selectedIndex = variantElements.findIndex((variant) => variant.props.name === assignedVariantName);
-        // Safety fallback - if assigned variant not found, use first variant
-        if (selectedIndex === -1 && variantElements.length > 0) {
-            selectedIndex = 0;
+        else if (isDevMode) {
+            // Active in dev mode: Show treatment variant (for preview purposes)
+            selectedIndex = variantElements.findIndex((variant) => variant.props.name === 'treatment');
+            if (selectedIndex === -1) {
+                // Fallback: show the last variant (usually treatment) or first if only one
+                selectedIndex = variantElements.length > 1 ? 1 : 0;
+            }
             if (keakInstance?.config.debug) {
-                console.warn(`⚠️ [Keak SDK] Assigned variant "${assignedVariantName}" not found, using first variant`);
+                console.log(`🎯 [Keak SDK] Experiment "${name}" is active (dev mode), showing treatment (variant)`);
+            }
+        }
+        else {
+            // Active in production: Normal A/B split testing
+            const assignedVariantName = keakInstance?.getVariant(name, variantNames) || variantNames[0];
+            // Find the index of the assigned variant
+            selectedIndex = variantElements.findIndex((variant) => variant.props.name === assignedVariantName);
+            // Safety fallback - if assigned variant not found, use first variant
+            if (selectedIndex === -1 && variantElements.length > 0) {
+                selectedIndex = 0;
+                if (keakInstance?.config.debug) {
+                    console.warn(`⚠️ [Keak SDK] Assigned variant "${assignedVariantName}" not found, using first variant`);
+                }
             }
         }
     }