[10.x] Webhook events

src/Events/WebhookHandled.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Laravel\Cashier\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class WebhookHandled
+{
+    use Dispatchable, SerializesModels;
+
+    /**
+     * The webhook payload.
+     *
+     * @var array
+     */
+    public $payload;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  array  $payload
+     * @return void
+     */
+    public function __construct(array $payload)
+    {
+        $this->payload = $payload;
+    }
+}

src/Events/WebhookReceived.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Laravel\Cashier\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class WebhookReceived
+{
+    use Dispatchable, SerializesModels;
+
+    /**
+     * The webhook payload.
+     *
+     * @var array
+     */
+    public $payload;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  array  $payload
+     * @return void
+     */
+    public function __construct(array $payload)
+    {
+        $this->payload = $payload;
+    }
+}

src/Http/Controllers/WebhookController.php

@@ -7,6 +7,8 @@
 use Illuminate\Routing\Controller;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Str;
+use Laravel\Cashier\Events\WebhookHandled;
+use Laravel\Cashier\Events\WebhookReceived;
 use Laravel\Cashier\Http\Middleware\VerifyWebhookSignature;
 use Laravel\Cashier\Payment;
 use Laravel\Cashier\Subscription;
@@ -38,8 +40,14 @@ public function handleWebhook(Request $request)
         $payload = json_decode($request->getContent(), true);
         $method = 'handle'.Str::studly(str_replace('.', '_', $payload['type']));
 
+        WebhookReceived::dispatch($payload);
+
         if (method_exists($this, $method)) {
-            return $this->{$method}($payload);
+            $response = $this->{$method}($payload);
+
+            WebhookHandled::dispatch($payload);
+
+            return $response;
         }
 
         return $this->missingMethod();

tests/Unit/WebhookControllerTest.php

@@ -3,8 +3,11 @@
 namespace Laravel\Cashier\Tests\Unit;
 
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Event;
+use Laravel\Cashier\Events\WebhookHandled;
+use Laravel\Cashier\Events\WebhookReceived;
 use Laravel\Cashier\Http\Controllers\WebhookController;
-use PHPUnit\Framework\TestCase;
+use Laravel\Cashier\Tests\TestCase;
 use Symfony\Component\HttpFoundation\Response;
 
 class WebhookControllerTest extends TestCase
@@ -13,17 +16,41 @@ public function test_proper_methods_are_called_based_on_stripe_event()
     {
         $request = $this->request('charge.succeeded');
 
+        Event::fake([
+            WebhookHandled::class,
+            WebhookReceived::class,
+        ]);
+
         $response = (new WebhookControllerTestStub)->handleWebhook($request);
 
+        Event::assertDispatched(WebhookReceived::class, function (WebhookReceived $event) use ($request) {
+            return $request->getContent() == json_encode($event->payload);
+        });
+
+        Event::assertDispatched(WebhookHandled::class, function (WebhookHandled $event) use ($request) {
+            return $request->getContent() == json_encode($event->payload);
+        });
+
         $this->assertEquals('Webhook Handled', $response->getContent());
     }
 
     public function test_normal_response_is_returned_if_method_is_missing()
     {
         $request = $this->request('foo.bar');
 
+        Event::fake([
+            WebhookHandled::class,
+            WebhookReceived::class,
+        ]);
+
         $response = (new WebhookControllerTestStub)->handleWebhook($request);
 
+        Event::assertDispatched(WebhookReceived::class, function (WebhookReceived $event) use ($request) {
+            return $request->getContent() == json_encode($event->payload);
+        });
+
+        Event::assertNotDispatched(WebhookHandled::class);
+
         $this->assertEquals(200, $response->getStatusCode());
     }