Add now methods to interface and Fake (#18)

* add now methods to interface and Fake

* add test

* improve dockblocks for testing

---------

Co-authored-by: Luke Renfrew <[email protected]>

src/Contracts/SegmentServiceContract.php

@@ -18,11 +18,22 @@ public function setGlobalContext(array $globalContext): void;
      */
     public function track(string $event, ?array $eventData = null): void;
 
+    /**
+     * @param  array<string, mixed>  $eventData
+     */
+    public function trackNow(string $event, ?array $eventData = null): void;
+
     /**
      * @param  array<string, mixed>  $identifyData
      */
     public function identify(?array $identifyData = null): void;
 
+    /**
+     * @param  array<string, mixed>  $identifyData
+     */
+    public function identifyNow(?array $identifyData = null): void;
+
+
     public function forUser(CanBeIdentifiedForSegment $user): PendingUserSegment;
 
     public function push(CanBeSentToSegment $segment): void;

src/Facades/Fakes/SegmentFake.php

@@ -46,6 +46,14 @@ public function identify(?array $identifyData = []): void
         $this->identities[] = new SimpleSegmentIdentify($this->user, $identifyData);
     }
 
+    /**
+     * @param  array<string, mixed>  $identifyData
+     */
+    public function identifyNow(?array $identifyData = []): void
+    {
+        $this->identities[] = new SimpleSegmentIdentify($this->user, $identifyData);
+    }
+
     /**
      * @param  array<string, mixed>  $eventData
      */
@@ -54,6 +62,14 @@ public function track(string $event, ?array $eventData = null): void
         $this->events[] = new SimpleSegmentEvent($this->user, $event, $eventData);
     }
 
+    /**
+     * @param  array<string, mixed>  $eventData
+     */
+    public function trackNow(string $event, ?array $eventData = null): void
+    {
+        $this->events[] = new SimpleSegmentEvent($this->user, $event, $eventData);
+    }
+
     public function forUser(CanBeIdentifiedForSegment $user): PendingUserSegment
     {
         $this->user = $user;

src/Facades/Segment.php

@@ -2,6 +2,7 @@
 
 namespace SlashEquip\LaravelSegment\Facades;
 
+use Closure;
 use Illuminate\Support\Facades\Facade;
 use SlashEquip\LaravelSegment\Contracts\CanBeIdentifiedForSegment;
 use SlashEquip\LaravelSegment\Contracts\CanBeSentToSegment;
@@ -19,7 +20,16 @@
  * @method static PendingUserSegment forUser(CanBeIdentifiedForSegment $user)
  * @method static void push(CanBeSentToSegment $segment)
  * @method static void terminate()
- *
+ * @method static void assertIdentified(Closure|int|null $callback = null)
+ * @method static void assertIdentifiedTimes(int $times)
+ * @method static void assertNotIdentified(Closure $callback = null)
+ * @method static void assertNothingIdentified()
+ * @method static void assertTracked(Closure|int|null $callback = null)
+ * @method static void assertTrackedTimes(int $times)
+ * @method static void assertEventTracked(string $event,Closure|int|null $callback = null)
+ * @method static void assertNotTracked(Closure $callback = null)
+ * @method static void assertNothingTracked()
+
  * @see \SlashEquip\LaravelSegment\SegmentService
  * @see SegmentFake
  */

tests/Unit/SegmentFakeTest.php

@@ -38,6 +38,18 @@ public function getSegmentIdentifier(): string
     Segment::assertIdentifiedTimes(1);
 });
 
+it('can test that an identity was called immediately', function () {
+    Segment::fake();
+
+    Segment::forUser($this->user)->identifyNow([
+        'first_name' => 'Lorem',
+        'last_name' => 'Ipsum',
+    ]);
+
+    Segment::assertIdentified();
+    Segment::assertIdentifiedTimes(1);
+});
+
 it('can test that an identity was called one times', function () {
     Segment::fake();
 
@@ -116,6 +128,19 @@ public function getSegmentIdentifier(): string
     Segment::assertTrackedTimes(1);
 });
 
+
+it('can test that an event was tracked immediately', function () {
+    Segment::fake();
+
+    Segment::forUser($this->user)->trackNow('some_event', [
+        'first_name' => 'Lorem',
+        'last_name' => 'Ipsum',
+    ]);
+
+    Segment::assertTracked();
+    Segment::assertTrackedTimes(1);
+});
+
 it('it can assert an event was tracked one time', function () {
     Segment::fake();