perf: queue user login/logout recording to avoid slow DNS lookups (#83)

The gethostbyaddr() call was blocking the login/logout response,
causing delays of 1-30+ seconds depending on network conditions.

Now the recording is dispatched to a queue job, so the user gets
an instant response while the DNS lookup happens in the background.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: Baspa

src/Jobs/RecordUserLogin.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Backstage\Laravel\Users\Jobs;
+
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Queue\Queueable;
+
+class RecordUserLogin implements ShouldQueue
+{
+    use Queueable;
+
+    /**
+     * @param  array<string, mixed>|null  $inputs
+     */
+    public function __construct(
+        public int $userId,
+        public string $type,
+        public ?string $url,
+        public ?string $referrer,
+        public ?array $inputs,
+        public ?string $userAgent,
+        public ?string $ipAddress,
+    ) {}
+
+    public function handle(): void
+    {
+        $userModel = config('users.eloquent.user.model');
+        $user = $userModel::find($this->userId);
+
+        if (! $user) {
+            return;
+        }
+
+        $user->logins()->create([
+            'user_id' => $this->userId,
+            'type' => $this->type,
+            'url' => $this->url,
+            'referrer' => $this->referrer,
+            'inputs' => $this->inputs ? json_encode($this->inputs) : null,
+            'user_agent' => $this->userAgent,
+            'ip_address' => $this->ipAddress,
+            'hostname' => $this->ipAddress ? gethostbyaddr($this->ipAddress) : null,
+        ]);
+    }
+}

src/Listeners/Auth/HandleUserLogin.php

@@ -2,28 +2,26 @@
 
 namespace Backstage\Laravel\Users\Listeners\Auth;
 
+use Backstage\Laravel\Users\Jobs\RecordUserLogin;
 use Illuminate\Auth\Events\Login;
 
 class HandleUserLogin
 {
-    public function handle(Login $event)
+    public function handle(Login $event): void
     {
-        /**
-         * @var \Backstage\Laravel\Users\Eloquent\Models\User $user
-         */
+        /** @var \Backstage\Laravel\Users\Eloquent\Models\User $user */
         $user = $event->user;
 
         $inputs = request()->except('_method', '_token', 'password');
 
-        $user->logins()->create([
-            'user_id' => $user->id,
-            'type' => 'login',
-            'url' => request()->url(),
-            'referrer' => request()->server('HTTP_REFERER'),
-            'inputs' => count($inputs) ? json_encode($inputs) : null,
-            'user_agent' => request()->server('HTTP_USER_AGENT'),
-            'ip_address' => request()->ip(),
-            'hostname' => gethostbyaddr(request()->ip()),
-        ]);
+        RecordUserLogin::dispatch(
+            userId: $user->id,
+            type: 'login',
+            url: request()->url(),
+            referrer: request()->server('HTTP_REFERER'),
+            inputs: count($inputs) ? $inputs : null,
+            userAgent: request()->server('HTTP_USER_AGENT'),
+            ipAddress: request()->ip(),
+        );
     }
 }

src/Listeners/Auth/HandleUserLogout.php

@@ -2,28 +2,30 @@
 
 namespace Backstage\Laravel\Users\Listeners\Auth;
 
+use Backstage\Laravel\Users\Jobs\RecordUserLogin;
 use Illuminate\Auth\Events\Logout;
 
 class HandleUserLogout
 {
-    public function handle(Logout $event)
+    public function handle(Logout $event): void
     {
-        /**
-         * @var \Backstage\Laravel\Users\Eloquent\Models\User $user
-         */
+        /** @var \Backstage\Laravel\Users\Eloquent\Models\User|null $user */
         $user = $event->user;
 
+        if (! $user) {
+            return;
+        }
+
         $inputs = request()->except('_method', '_token', 'password');
 
-        $user->logins()->create([
-            'user_id' => $user->id,
-            'type' => 'logout',
-            'url' => request()->url(),
-            'referrer' => request()->server('HTTP_REFERER'),
-            'inputs' => count($inputs) ? json_encode($inputs) : null,
-            'user_agent' => request()->server('HTTP_USER_AGENT'),
-            'ip_address' => request()->ip(),
-            'hostname' => gethostbyaddr(request()->ip()),
-        ]);
+        RecordUserLogin::dispatch(
+            userId: $user->id,
+            type: 'logout',
+            url: request()->url(),
+            referrer: request()->server('HTTP_REFERER'),
+            inputs: count($inputs) ? $inputs : null,
+            userAgent: request()->server('HTTP_USER_AGENT'),
+            ipAddress: request()->ip(),
+        );
     }
 }