Feature/user me controller

app/Http/Controllers/Api/V1/User/MeController.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api\V1\User;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\V1\Auth\UserResource;
+use Dedoc\Scramble\Attributes\Group;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+#[Group('User', weight: 0)]
+class MeController extends Controller
+{
+    /**
+     * User Profile API
+     *
+     * Handle the incoming request to get the authenticated user.
+     *
+     * @response array{status: true, message: string, data: UserResource}
+     */
+    public function __invoke(Request $request): JsonResponse
+    {
+        /**
+         * Successful response
+         */
+
+        /** @var \App\Models\User $user */
+        $user = $request->user();
+        $user->load(['roles.permissions']);
+
+        return response()->apiSuccess(
+            new \App\Http\Resources\V1\Auth\UserResource($user),
+            __('common.success')
+        );
+    }
+}

app/Http/Resources/V1/Auth/UserResource.php

@@ -49,13 +49,16 @@ public function toArray(Request $request): array
 
                 return array_values(array_unique($permissionSlugs));
             }),
-            $this->mergeWhen(isset($this->resource->access_token), [
-                'access_token' => $this->resource->access_token,
-                'refresh_token' => $this->resource->refresh_token,
-                'access_token_expires_at' => $this->resource->access_token_expires_at?->toISOString(),
-                'refresh_token_expires_at' => $this->resource->refresh_token_expires_at?->toISOString(),
-                'token_type' => 'Bearer',
-            ]),
+            $this->mergeWhen(
+                array_key_exists('access_token', $this->resource->getAttributes()),
+                fn () => [
+                    'access_token' => $this->resource->getAttributes()['access_token'],
+                    'refresh_token' => $this->resource->getAttributes()['refresh_token'] ?? null,
+                    'access_token_expires_at' => optional($this->resource->getAttributes()['access_token_expires_at'] ?? null)?->toISOString(),
+                    'refresh_token_expires_at' => optional($this->resource->getAttributes()['refresh_token_expires_at'] ?? null)?->toISOString(),
+                    'token_type' => 'Bearer',
+                ]
+            ),
         ];
     }
 }

lang/en/common.php

@@ -11,4 +11,5 @@
     */
 
     'something_went_wrong' => 'Something went wrong! Try again later.',
+    'success' => 'Response returned successfully.',
 ];

routes/api_v1.php

@@ -18,8 +18,6 @@
 
     // User Routes
     Route::middleware(['auth:sanctum', 'ability:access-api'])->group(function () {
-        Route::get('/me', function (Request $request) {
-            return auth()->user();
-        });
+        Route::get('/me', \App\Http\Controllers\Api\V1\User\MeController::class);
     });
 });

tests/Feature/API/V1/User/MeControllerTest.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+describe('API/V1/User/MeController', function () {
+    it('returns authenticated user profile with roles and permissions', function () {
+        // Create a test user
+        $user = User::factory()->create([
+            'name' => 'John Doe',
+            'email' => 'john@example.com',
+        ]);
+
+        // Authenticate the user with Sanctum
+        Sanctum::actingAs($user, ['access-api']);
+
+        // Make request to /me endpoint
+        $response = $this->getJson('/api/v1/me');
+
+        // Assert response structure
+        $response
+            ->assertStatus(200)
+            ->assertJsonStructure([
+                'status',
+                'message',
+                'data' => [
+                    'id',
+                    'name',
+                    'email',
+                    'email_verified_at',
+                    'bio',
+                    'avatar_url',
+                    'twitter',
+                    'facebook',
+                    'linkedin',
+                    'github',
+                    'website',
+                ],
+            ])
+            ->assertJson([
+                'status' => true,
+                'data' => [
+                    'id' => $user->id,
+                    'name' => 'John Doe',
+                    'email' => 'john@example.com',
+                ],
+            ]);
+    });
+});