User Login

<?php
namespace App\Api;

use App\Controller\UserController;
use Gemvc\Core\ApiService;
use Gemvc\Http\Request;
use Gemvc\Http\JsonResponse;

class User extends ApiService
{
    // ... existing methods (create, read, update, delete, list) ...

    /**
     * User Login
     * 
     * @return JsonResponse
     * @http POST
     * @description Authenticate user and return JWT tokens
     * @example /api/User/login
     */
    public function login(): JsonResponse
    {
        // Validate POST schema (email and password required)
        if(!$this->request->definePostSchema([
            'email' => 'email',
            'password' => 'string'
        ])) {
            return $this->request->returnResponse();
        }
        
        // Delegate to Controller layer
        return (new UserController($this->request))->login();
    }
}

<?php
namespace App\Controller;

use App\Model\UserModel;
use Gemvc\Core\Controller;
use Gemvc\Http\Request;
use Gemvc\Http\JsonResponse;

class UserController extends Controller
{
    // ... existing methods (create, read, update, delete, list) ...

    /**
     * User Login
     * 
     * @return JsonResponse
     */
    public function login(): JsonResponse
    {
        // Map POST data to UserModel
        $model = $this->request->mapPostToObject(
            new UserModel(),
            ['email' => 'email', 'password' => 'password']
        );
        
        if(!$model instanceof UserModel) {
            return $this->request->returnResponse();
        }
        
        // Delegate to Model layer for authentication and token generation
        return $model->loginModel();
    }
}

<?php
namespace App\Model;

use App\Table\UserTable;
use Gemvc\Helper\CryptHelper;
use Gemvc\Http\JWTToken;
use Gemvc\Http\JsonResponse;
use Gemvc\Http\Response;

class UserModel extends UserTable
{
    // ... existing methods (createModel, readModel, updateModel, deleteModel, setPassword) ...

    /**
     * User Login - Verify credentials and generate JWT tokens
     * 
     * @return JsonResponse
     */
    public function loginModel(): JsonResponse
    {
        // Normalize email to lowercase
        $this->email = strtolower($this->email);
        
        // Find user by email
        $user = $this->selectByEmail($this->email);
        if (!$user) {
            return Response::unprocessableEntity('Invalid email or password');
        }
        
        // Verify password
        if (!CryptHelper::verifyPassword($this->password, $user->getPassword())) {
            return Response::unprocessableEntity('Invalid email or password');
        }
        
        // Generate JWT tokens
        $jwtToken = new JWTToken();
        $accessToken = $jwtToken->createAccessToken($user->id);
        $refreshToken = $jwtToken->createRefreshToken($user->id);
        $loginToken = $jwtToken->createLoginToken($user->id);
        
        // Prepare response data
        $userData = [
            'id' => $user->id,
            'name' => $user->name,
            'email' => $user->email,
            'description' => $user->description
        ];
        
        $tokenData = [
            'access_token' => $accessToken,
            'refresh_token' => $refreshToken,
            'login_token' => $loginToken,
            'user' => $userData
        ];
        
        return Response::success($tokenData, 1, 'Login successful');
    }
}