Add SubscriptionCreated event

CHANGELOG.md

@@ -9,6 +9,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 - `canceled_immediately` column to `plan_subscriptions` table
 - `isCanceledImmediately()` method to `PlanSubscription` model.
 - `SubscriptionBuilderInterface`
+- `SubscriptionCreated` event.
 
 ### Changed
 - Now when a subscription is *immediately* canceled the `canceled_immediately` column will be set to true.

README.md

@@ -32,6 +32,7 @@ SaaS style recurring plans for Laravel 5.
     - [Cancel a Subscription](#cancel-a-subscription)
     - [Scopes](#scopes)
 - [Events](#events)
+    - [`SubscriptionCreated`](#subscriptioncreated)
     - [`SubscriptionRenewed`](#subscriptionrenewed)
     - [`SubscriptionCanceled`](#subscriptioncanceled)
     - [`SubscriptionPlanChanged`](#subscriptionplanchanged)
@@ -301,6 +302,10 @@ $subscriptions = PlanSubscription::findEndedPeriod()->get();
 
 Events are under the namespace `Gerardojbaez\Laraplans\Events`. The following are the events triggered by the package.
 
+### `SubscriptionCreated`
+
+Fired when a subscription is created.
+
 ### `SubscriptionRenewed`
 
 Fired when a subscription is renewed using the `renew()` method.

src/Laraplans/Events/SubscriptionCreated.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Gerardojbaez\Laraplans\Events;
+
+use Gerardojbaez\Laraplans\Models\PlanSubscription;
+use Illuminate\Queue\SerializesModels;
+
+class SubscriptionCreated
+{
+    use SerializesModels;
+
+    /**
+     * @var \Laraplans\Models\PlanSubscription
+     */
+    public $subscription;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  \Laraplans\Models\PlanSubscription  $subscription
+     * @return void
+     */
+    public function __construct(PlanSubscription $subscription)
+    {
+        $this->subscription = $subscription;
+    }
+}

src/Laraplans/Models/PlanSubscription.php

@@ -7,12 +7,14 @@
 use Carbon\Carbon;
 use LogicException;
 use Gerardojbaez\Laraplans\Period;
+use Illuminate\Support\Facades\Event;
 use Illuminate\Database\Eloquent\Model;
 use Gerardojbaez\Laraplans\Models\PlanFeature;
 use Gerardojbaez\Laraplans\SubscriptionAbility;
 use Gerardojbaez\Laraplans\Traits\BelongsToPlan;
 use Gerardojbaez\Laraplans\Contracts\PlanInterface;
 use Gerardojbaez\Laraplans\SubscriptionUsageManager;
+use Gerardojbaez\Laraplans\Events\SubscriptionCreated;
 use Gerardojbaez\Laraplans\Events\SubscriptionRenewed;
 use Gerardojbaez\Laraplans\Events\SubscriptionCanceled;
 use Gerardojbaez\Laraplans\Events\SubscriptionPlanChanged;
@@ -81,6 +83,10 @@ protected static function boot()
     {
         parent::boot();
 
+        static::created(function ($model) {
+            Event::fire(new SubscriptionCreated($model));
+        });
+
         static::saving(function ($model) {
             // Set period if it wasn't set
             if (! $model->ends_at) {

tests/integration/Models/PlanSubscriptionTest.php

@@ -13,6 +13,7 @@
 use Gerardojbaez\Laraplans\Tests\Models\User;
 use Gerardojbaez\Laraplans\Models\PlanFeature;
 use Gerardojbaez\Laraplans\Models\PlanSubscription;
+use Gerardojbaez\Laraplans\Events\SubscriptionCreated;
 use Gerardojbaez\Laraplans\Events\SubscriptionRenewed;
 use Gerardojbaez\Laraplans\Events\SubscriptionCanceled;
 use Gerardojbaez\Laraplans\Models\PlanSubscriptionUsage;
@@ -71,6 +72,21 @@ public function setUp()
         $this->subscription = $this->user->subscription('main');
     }
 
+    /** @test */
+    public function it_triggers_create_event_when_created()
+    {
+        // Arrange
+        Event::fake();
+
+        // Act
+        $subscription = factory(PlanSubscription::class)->create();
+
+        // Assert
+        Event::assertFired(SubscriptionCreated::class, function ($event) use ($subscription) {
+            return (int) $event->subscription->id === (int) $subscription->id;
+        });
+    }
+
     /**
      * Can get subscription user.
      *