Added event for handling soft-deleted users during authentication

- Closes #184

Author: stevebauman

src/AdldapAuthUserProvider.php

@@ -2,6 +2,7 @@
 
 namespace Adldap\Laravel;
 
+use Adldap\Laravel\Events\AuthenticatedModelTrashed;
 use Adldap\Models\User;
 use Adldap\Laravel\Traits\ImportsUsers;
 use Adldap\Laravel\Events\DiscoveredWithCredentials;
@@ -57,7 +58,11 @@ public function retrieveByCredentials(array $credentials)
             $model = $this->getModelFromAdldap($user, $password);
 
             if (method_exists($model, 'trashed') && $model->trashed()) {
-                // We won't allow deleted users to authenticate.
+                // If the model is soft-deleted, we'll fire an event
+                // with the affected LDAP user and their model.
+                $this->handleAuthenticatedModelTrashed($user, $model);
+
+                // We also won't allow soft-deleted users to authenticate.
                 return;
             }
 
@@ -109,6 +114,17 @@ protected function handleAuthenticatedWithCredentials(User $user, $model)
         Event::fire(new AuthenticatedWithCredentials($user, $model));
     }
 
+    /**
+     * Handle an authenticated users model that has been soft deleted.
+     *
+     * @param \Adldap\Models\User $user
+     * @param Authenticatable     $model
+     */
+    protected function handleAuthenticatedModelTrashed(User $user, $model)
+    {
+        Event::fire(new AuthenticatedModelTrashed($user, $model));
+    }
+
     /**
      * Handle discovered LDAP users before they are authenticated.
      *

src/Events/AuthenticatedModelTrashed.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Adldap\Laravel\Events;
+
+use Adldap\Models\User;
+use Illuminate\Contracts\Auth\Authenticatable;
+
+class AuthenticatedModelTrashed
+{
+    /**
+     * The authenticated LDAP user.
+     *
+     * @var User
+     */
+    public $user;
+
+    /**
+     * The authenticated LDAP users model.
+     *
+     * @var Authenticatable
+     */
+    public $model;
+
+    /**
+     * Constructor.
+     *
+     * @param User            $user
+     * @param Authenticatable $model
+     */
+    public function __construct(User $user, Authenticatable $model)
+    {
+        $this->user = $user;
+        $this->model = $model;
+    }
+}