feat(auth): add /login endpoint for authentication

app/Http/Controllers/AuthController.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class AuthController extends Controller
+{
+    /**
+     * Handle user login.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function login(Request $request)
+    {
+        $credentials = $request->validate([
+            'email' => ['required', 'string', 'email'],
+            'password' => ['required']
+        ]);
+
+        if (!auth()->attempt($credentials)) {
+            return response()->json([
+                'message' => 'Invalid login credentials'
+            ], Response::HTTP_UNAUTHORIZED);
+        }
+
+        /** @var \App\Models\User $user */
+        $user = auth()->user();
+        $token = $user->createToken('authToken')->plainTextToken;
+
+        return response()->json([
+            'user' => $user,
+            'access_token' => $token
+        ], Response::HTTP_OK);
+    }
+}

database/seeders/DatabaseSeeder.php

@@ -17,6 +17,8 @@ public function run(): void
         // \App\Models\User::factory()->create([
         //     'name' => 'Test User',
         //     'email' => 'test@example.com',
+        //     'email_verified_at' => now(),
+        //     'password' => bcrypt('test1234'),
         // ]);
     }
 }

routes/api.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Http\Controllers\AuthController;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
@@ -14,6 +15,11 @@
 |
 */
 
-Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
-    return $request->user();
+/**
+ * Defines the API routes for version 1.
+ *
+ * @group v1
+ */
+Route::group(['prefix' => 'v1'], function () {
+    require __DIR__ . '/api/v1/auth.php';
 });

routes/api/v1/auth.php

@@ -0,0 +1,6 @@
+<?php
+
+use App\Http\Controllers\AuthController;
+use Illuminate\Support\Facades\Route;
+
+Route::post('/login', [AuthController::class, 'login']);

tests/Feature/AuthControllerTest.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Foundation\Testing\WithFaker;
+use Illuminate\Http\Response;
+use Tests\TestCase;
+
+class AuthControllerTest extends TestCase
+{
+    use RefreshDatabase, WithFaker;
+
+    /**
+     * Test login with valid credentials.
+     *
+     * @return void
+     */
+    public function test_login_with_valid_credentials(): void
+    {
+
+        $user = User::factory()->create([
+            'email' => 'valid@example.com',
+            'password' => bcrypt('ValidPassword'),
+        ]);
+
+        $response = $this->postJson('/api/v1/login', [
+            'email' => 'valid@example.com',
+            'password' => 'ValidPassword',
+        ]);
+
+        $response->assertStatus(Response::HTTP_OK)
+            ->assertJsonStructure([
+                'user' => [
+                    'id',
+                    'name',
+                    'email',
+                    'email_verified_at',
+                    'created_at',
+                    'updated_at',
+                ],
+                'access_token',
+            ]);
+
+        $this->assertAuthenticatedAs($user);
+    }
+
+    /**
+     * Test login with invalid credentials.
+     *
+     * @return void
+     */
+    public function test_login_with_invalid_credentials(): void
+    {
+        $response = $this->postJson('/api/v1/login', [
+            'email' => 'invalid@example.com',
+            'password' => 'invalidpassword',
+        ]);
+
+        $response->assertStatus(Response::HTTP_UNAUTHORIZED)
+            ->assertJson([
+                'message' => 'Invalid login credentials',
+            ]);
+
+        $this->assertGuest();
+    }
+}