[1.x] Add Event

src/Events/LaravelCartDecreaseQuantityEvent.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Binafy\LaravelCart\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class LaravelCartDecreaseQuantityEvent
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Get the channels the event should broadcast on.
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PrivateChannel('channel-name'),
+        ];
+    }
+}

src/Events/LaravelCartEmptyEvent.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Binafy\LaravelCart\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class LaravelCartEmptyEvent
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Get the channels the event should broadcast on.
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PrivateChannel('channel-name'),
+        ];
+    }
+}

src/Events/LaravelCartIncreaseQuantityEvent.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Binafy\LaravelCart\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class LaravelCartIncreaseQuantityEvent
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Get the channels the event should broadcast on.
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PrivateChannel('channel-name'),
+        ];
+    }
+}

src/Events/LaravelCartRemoveItemEvent.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Binafy\LaravelCart\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class LaravelCartRemoveItemEvent
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Get the channels the event should broadcast on.
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PrivateChannel('channel-name'),
+        ];
+    }
+}

src/Events/LaravelCartStoreItemEvent.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Binafy\LaravelCart\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class LaravelCartStoreItemEvent
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * Create a new event instance.
+     */
+    public function __construct()
+    {
+        //
+    }
+
+    /**
+     * Get the channels the event should broadcast on.
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PrivateChannel('channel-name'),
+        ];
+    }
+}

src/Models/Cart.php

@@ -2,7 +2,12 @@
 
 namespace Binafy\LaravelCart\Models;
 
+use Binafy\LaravelCart\Events\LaravelCartStoreItemEvent;
 use Binafy\LaravelCart\Cartable;
+use Binafy\LaravelCart\Events\LaravelCartDecreaseQuantityEvent;
+use Binafy\LaravelCart\Events\LaravelCartEmptyEvent;
+use Binafy\LaravelCart\Events\LaravelCartIncreaseQuantityEvent;
+use Binafy\LaravelCart\Events\LaravelCartRemoveItemEvent;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
 
@@ -122,6 +127,9 @@ public function storeItem(Model|array $item): static
             ]);
         }
 
+        // Dispatch Event
+        LaravelCartStoreItemEvent::dispatch();
+
         return $this;
     }
 
@@ -136,6 +144,9 @@ public function removeItem(Model $item): static
             $itemToDelete->delete();
         }
 
+        // Dispatch Event
+        LaravelCartRemoveItemEvent::dispatch();
+
         return $this;
     }
 
@@ -146,6 +157,9 @@ public function emptyCart(): static
     {
         $this->items()->delete();
 
+        // Dispatch Event
+        LaravelCartEmptyEvent::dispatch();
+
         return $this;
     }
 
@@ -161,6 +175,9 @@ public function increaseQuantity(Model $item, int $quantity = 1): static
 
         $item->increment('quantity', $quantity);
 
+        // Dispatch Event
+        LaravelCartIncreaseQuantityEvent::dispatch($item);
+
         return $this;
     }
 
@@ -176,6 +193,9 @@ public function decreaseQuantity(Model $item, int $quantity = 1): static
 
         $item->decrement('quantity', $quantity);
 
+        // Dispatch Event
+        LaravelCartDecreaseQuantityEvent::dispatch($item);
+
         return $this;
     }
 }

tests/Feature/Models/CartDeleteTest.php

@@ -1,7 +1,11 @@
 <?php
 
+use Binafy\LaravelCart\Events\LaravelCartEmptyEvent;
+use Binafy\LaravelCart\Events\LaravelCartRemoveItemEvent;
+use Binafy\LaravelCart\Events\LaravelCartStoreItemEvent;
 use Binafy\LaravelCart\Models\Cart;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Event;
 use Tests\SetUp\Models\Product;
 use Tests\SetUp\Models\User;
 
@@ -12,7 +16,9 @@
  */
 uses(RefreshDatabase::class);
 
-test('can remove an item from the cart', function () {
+test('can remove an item from the cart', closure: function () {
+    Event::fake();
+
     $user = User::query()->create(['name' => 'Milwad', 'email' => 'milwad.dev@gmail.comd']);
     $product1 = Product::query()->create(['title' => 'Product 1']);
     $product2 = Product::query()->create(['title' => 'Product 2']);
@@ -54,9 +60,15 @@
 
     $cart->removeItem($product1);
     assertDatabaseCount('cart_items', 2);
+
+    // Event Assertions
+    Event::assertDispatched(LaravelCartStoreItemEvent::class);
+    Event::assertDispatched(LaravelCartRemoveItemEvent::class);
 });
 
 test('can empty the cart', function () {
+    Event::fake();
+
     $user = User::query()->create(['name' => 'Milwad', 'email' => 'milwad.dev@gmail.comd']);
     $product1 = Product::query()->create(['title' => 'Product 1']);
     $product2 = Product::query()->create(['title' => 'Product 2']);
@@ -91,4 +103,8 @@
     // Remove all items from cart
     $cart->emptyCart();
     assertDatabaseCount('cart_items', 0);
+
+    // Event Assertions
+    Event::assertDispatched(LaravelCartStoreItemEvent::class);
+    Event::assertDispatched(LaravelCartEmptyEvent::class);
 });