add alias functionality and some related tests

Author: elliot

src/LaunchDarkly/Impl/EventFactory.php

@@ -39,6 +39,9 @@ public function newEvalEvent($flag, $user, $detail, $default, $prereqOfFlag = nu
         if (($addExperimentData || $this->_withReasons) && $detail->getReason()) {
             $e['reason'] = $detail->getReason()->jsonSerialize();
         }
+        if ($user->getAnonymous()) {
+            $e['contextKind'] = 'anonymousUser';
+        }
         return $e;
     }
 
@@ -63,6 +66,9 @@ public function newDefaultEvent($flag, $user, $detail)
         if ($this->_withReasons && $detail->getReason()) {
             $e['reason'] = $detail->getReason()->jsonSerialize();
         }
+        if ($user->getAnonymous()) {
+            $e['contextKind'] = 'anonymousUser';
+        }
         return $e;
     }
 
@@ -80,6 +86,9 @@ public function newUnknownFlagEvent($key, $user, $detail)
         if ($this->_withReasons && $detail->getReason()) {
             $e['reason'] = $detail->getReason()->jsonSerialize();
         }
+        if ($user->getAnonymous()) {
+            $e['contextKind'] = 'anonymousUser';
+        }
         return $e;
     }
 
@@ -107,9 +116,35 @@ public function newCustomEvent($eventName, $user, $data, $metricValue)
         if (isset($metricValue)) {
             $e['metricValue'] = $metricValue;
         }
+        if ($user->getAnonymous()) {
+            $e['contextKind'] = 'anonymousUser';
+        }
+        return $e;
+    }
+
+    public function newAliasEvent($user, $previousUser) 
+    {
+        $e = array(
+            'kind' => 'alias',
+            'key' => strval($user->getKey()),
+            'contextKind' => static::contextKind($user),
+            'previousKey' => strval($previousUser->getKey()),
+            'previousContextKind' => static::contextKind($previousUser),
+            'creationDate' => Util::currentTimeUnixMillis()
+        );
+
         return $e;
     }
 
+    private static function contextKind($user)
+    {
+        if ($user->getAnonymous()) {
+            return 'anonymousUser';
+        } else {
+            return 'user';
+        }
+    }
+
     private static function isExperiment($flag, $reason)
     {
         if ($reason) {

src/LaunchDarkly/LDClient.php

@@ -408,6 +408,12 @@ public function allFlagsState($user, $options = array())
         return $state;
     }
 
+    public function alias($user, $previousUser) 
+    {
+        $event = $this->_eventFactoryDefault->newAliasEvent($user, $previousUser);
+        $this->_eventProcessor->enqueue($event);
+    }
+
     /**
      * Generates an HMAC sha256 hash for use in Secure mode.
      *

tests/LDClientTest.php

@@ -593,6 +593,67 @@ public function testTrackSendsEventWithDataAndMetricValue()
         $this->assertEquals($metricValue, $event['metricValue']);
     }
 
+    public function testAliasEventsAreCorrect()
+    {
+        $ep = new MockEventProcessor();
+        $client = $this->makeClient(array('event_processor' => $ep));
+        
+        $user_builder = new LDUserBuilder("[email protected]");
+        $user = $user_builder->anonymous(false)->build();
+        $anon_builder = new LDUserBuilder("[email protected]");
+        $anon = $anon_builder->anonymous(true)->build();
+
+        $client->alias($user, $anon);
+
+        $queue = $ep->getEvents();
+        $this->assertEquals(1, sizeof($queue));
+
+        $event = $queue[0];
+
+        $this->assertEquals('alias', $event['kind']);
+        $this->assertEquals($user->getKey(), $event['key']);
+        $this->assertEquals('user', $event['contextKind']);
+        $this->assertEquals($anon->getKey(), $event['previousKey']);
+        $this->assertEquals('anonymousUser', $event['previousContextKind']);
+    }
+
+    public function testAnonymousVariationHasContextKind()
+    {
+        $ep = new MockEventProcessor();
+        $client = $this->makeClient(array('event_processor' => $ep));
+
+        $flag = $this->makeOffFlagWithValue('feature', 'value');
+
+        $anon_builder = new LDUserBuilder("[email protected]");
+        $anon = $anon_builder->anonymous(true)->build();
+
+        $client->variation('feature', $anon, 'default');
+
+        $queue = $ep->getEvents();
+        $this->assertEquals(1, sizeof($queue));
+
+        $event = $queue[0];
+
+        $this->assertEquals('anonymousUser', $event['contextKind']);
+    }
+
+    public function testCustomEventHasContextKind()
+    {
+        $ep = new MockEventProcessor();
+        $client = $this->makeClient(array('event_processor' => $ep));
+
+        
+        $anon_builder = new LDUserBuilder("[email protected]");
+        $anon = $anon_builder->anonymous(true)->build();
+
+        $client->track('eventkey', $anon);
+        $queue = $ep->getEvents();
+        $this->assertEquals(1, sizeof($queue));
+        $event = $queue[0];
+        $this->assertEquals('custom', $event['kind']);
+        $this->assertEquals('anonymousUser', $event['contextKind']);
+    }
+
     public function testEventsAreNotPublishedIfSendEventsIsFalse()
     {
         // In order to do this test, we cannot provide a mock object for Event_Processor_,