//go:build test // +build test package auth // Package auth contains tests for authentication and verification endpoints. // // Test Coverage: // - RegisterHandler: POST /api/register - User registration // * Validates: required fields, email format, UK phone, age >= 16, duplicate email // - LoginHandler: POST /api/login - User login // * Validates credentials, returns JWT token // - RefreshTokenHandler: POST /api/refresh-token - Refresh JWT token // - GenerateVerificationCodeHandler: POST /api/verify/generate - Send verification code // * Returns success even for non-existent emails (security) // - VerifyCodeHandler: POST /api/verify/check - Verify code and update user role // * Validates: correct code, not expired, not already used // * Updates user role from unverified_email to verified_email on success // // Validation: Comprehensive tests for invalid inputs (bad email, bad phone, underage, etc.) import ( "bytes" "context" "fmt" "net/http" "net/http/httptest" "strings" "testing" "time" "crussell/auth" "crussell/db" "crussell/internal/dav" "crussell/mw" "crussell/testutils" "crussell/testutils/fixtures" "crussell/testutils/jwt" "github.com/go-chi/chi/v5" "github.com/jackc/pgx/v5/pgxpool" ) func resetTestData(t *testing.T) (context.Context, db.Querier) { t.Helper() ctx, tx := testutils.SetupTestTx(t) dav.Service = &dav.BaseService{} return ctx, tx } // ============================================================================= // Register Handler Tests // ============================================================================= // TestRegister_Success verifies that a new user can successfully register with // valid credentials. It tests the happy path: valid name, email, password, // UK phone number, date of birth, and policy agreement. The test confirms // the user is created in the database with status 201. func TestRegister_Success(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: "john.doe@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusCreated { t.Errorf("expected status 201, got %d. body: %s", w.Code, w.Body.String()) } // Verify user was created in DB var userID string err := tx.QueryRow(ctx, "SELECT id FROM users WHERE email = $1", "john.doe@test.com").Scan(&userID) if err != nil { t.Errorf("failed to find user in DB: %v", err) } // Clean up tx.Exec(ctx, "DELETE FROM users WHERE id = $1", userID) } // TestRegister_InvalidInput_MissingFields tests that registration fails with // HTTP 400 when required fields are missing. It covers missing firstName, // lastName, email, phone, dateOfBirth, and when policy agreement is not given. func TestRegister_InvalidInput_MissingFields(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) tests := []struct { name string body RegisterRequest }{ { name: "missing firstName", body: RegisterRequest{LastName: "Doe", Email: "test@test.com", Password: "pass", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true}, }, { name: "missing lastName", body: RegisterRequest{FirstName: "John", Email: "test@test.com", Password: "pass", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true}, }, { name: "missing email", body: RegisterRequest{FirstName: "John", LastName: "Doe", Password: "pass", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true}, }, { name: "missing phone", body: RegisterRequest{FirstName: "John", LastName: "Doe", Email: "test@test.com", Password: "pass", DateOfBirth: "1990-01-15", AgreedToPolicy: true}, }, { name: "missing dateOfBirth", body: RegisterRequest{FirstName: "John", LastName: "Doe", Email: "test@test.com", Password: "pass", Phone: "07123456789", AgreedToPolicy: true}, }, { name: "did not agree to policy", body: RegisterRequest{FirstName: "John", LastName: "Doe", Email: "test@test.com", Password: "pass", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: false}, }, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", tt.body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d", w.Code) } }) } } // TestRegister_InvalidInput_InvalidEmail verifies that registration fails // with HTTP 400 when an invalid email format is provided (e.g., "not-an-email"). func TestRegister_InvalidInput_InvalidEmail(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: "not-an-email", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestRegister_InvalidInput_InvalidPhone tests that registration fails // with HTTP 400 when an invalid UK phone number is provided (e.g., too short). func TestRegister_InvalidInput_InvalidPhone(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: "john@test.com", Password: "password123", Phone: "12345", // Not a valid UK phone DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestRegister_ValidUKPhoneNumbers verifies that registration accepts all // valid UK mobile phone formats including 07x numbers and E.164 format (+447...). func TestRegister_ValidUKPhoneNumbers(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Valid UK mobile numbers (07x numbers) validPhones := []struct { name string phone string }{ {"07123456789", "07123456789"}, // Standard mobile {"07234567890", "07234567890"}, // 072 {"07345678901", "07345678901"}, // 073 {"07456789012", "07456789012"}, // 074 {"07567890123", "07567890123"}, // 075 {"07712345678", "07712345678"}, // 077 {"07812345678", "07812345678"}, // 078 {"07912345678", "07912345678"}, // 079 {"+447123456789", "+447123456789"}, // E.164 format } for _, tc := range validPhones { t.Run(tc.name, func(t *testing.T) { body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: fmt.Sprintf("john.%s@test.com", tc.phone), Password: "password123", Phone: tc.phone, DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusCreated { t.Errorf("expected status 201 for %s, got %d. body: %s", tc.phone, w.Code, w.Body.String()) } }) } } // TestRegister_InvalidPhoneNumbers verifies that registration rejects // invalid phone numbers including too short, invalid formats, US numbers, and // numbers with special characters. func TestRegister_InvalidPhoneNumbers(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Invalid phone numbers - should all be rejected invalidPhones := []struct { name string phone string }{ {"too_short", "12345"}, {"invalid_07700900000", "07700900000"}, // Invalid number per libphonenumber {"us_number", "+12025551234"}, // US number - not UK {"letters", "ABCDEFGHIJK"}, {"empty", ""}, {"special_chars", "+44!@#$%^&*()"}, } for _, tc := range invalidPhones { t.Run(tc.name, func(t *testing.T) { body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: fmt.Sprintf("john.%s@test.com", tc.phone), Password: "password123", Phone: tc.phone, DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400 for invalid phone %s, got %d. body: %s", tc.phone, w.Code, w.Body.String()) } }) } } // TestRegister_InvalidInput_Under16 tests that users under 16 years old cannot // register. The system enforces a minimum age of 16 for account creation. func TestRegister_InvalidInput_Under16(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Calculate a date that makes them under 16 under16DOB := time.Now().AddDate(-15, 0, 0).Format("2006-01-02") body := RegisterRequest{ FirstName: "Young", LastName: "User", Email: "young@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: under16DOB, AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestRegister_DuplicateEmail verifies that attempting to register with // an email that already exists returns HTTP 409 Conflict. func TestRegister_DuplicateEmail(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // First create a user with specific email _, err := tx.Exec(ctx, ` INSERT INTO users (n_first_name, n_last_name, email, phone, date_of_birth, password_hash, account_role, account_type) VALUES ('Test', 'User', 'user@test.com', '+447123456789', '1990-01-01', 'hash', 'verified_email', 'email') `) if err != nil { t.Fatalf("failed to create test user: %v", err) } // Now try to register with same email body := RegisterRequest{ FirstName: "John", LastName: "Doe", Email: "user@test.com", // Same as fixture Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusConflict { t.Errorf("expected status 409, got %d. body: %s", w.Code, w.Body.String()) } } // ============================================================================= // Login Handler Tests // ============================================================================= // TestLogin_Success tests that an existing user can successfully log in // with correct email and password, receiving a JWT token in the response. func TestLogin_Success(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) // Create a test user with known email userID, err := fixtures.CreateTestUserWithEmail(tx, "user@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) body := LoginRequest{ Email: "user@test.com", Password: "testpassword123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp struct { Token string `json:"token"` } if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if resp.Token == "" { t.Error("expected token in response, got empty string") } } // TestLogin_InvalidCredentials_WrongPassword verifies that login fails with // HTTP 401 when the correct email exists but the password is incorrect. func TestLogin_InvalidCredentials_WrongPassword(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) body := LoginRequest{ Email: "user@test.com", Password: "wrongpassword", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusUnauthorized { t.Errorf("expected status 401, got %d. body: %s", w.Code, w.Body.String()) } } // TestLogin_InvalidCredentials_NonExistentEmail verifies that login fails // with HTTP 401 when the email does not exist in the database. func TestLogin_InvalidCredentials_NonExistentEmail(t *testing.T) { ctx, _ := resetTestData(t) handler := http.HandlerFunc(LoginHandler) body := LoginRequest{ Email: "nonexistent@test.com", Password: "password123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusUnauthorized { t.Errorf("expected status 401, got %d. body: %s", w.Code, w.Body.String()) } } // ============================================================================= // Refresh Token Handler Tests // ============================================================================= // TestRefreshToken_Success tests that a valid JWT token can be refreshed // to obtain a new token with extended expiry. func TestRefreshToken_Success(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(RefreshTokenHandler) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Generate a valid token token := jwt.GenerateTestToken(userID, "verified_email") req := httptest.NewRequest("POST", "/api/refresh-token", nil) req.Header.Set("Authorization", "Bearer "+token) w := httptest.NewRecorder() // Use the middleware keys to set up context (matching what mw.RequireAuth does) reqCtx := ctx reqCtx = context.WithValue(reqCtx, mw.UserIDKey, userID) reqCtx = context.WithValue(reqCtx, mw.UserRoleKey, "verified_email") req = req.WithContext(reqCtx) handler.ServeHTTP(w, req) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp struct { Token string `json:"token"` } if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if resp.Token == "" { t.Error("expected new token in response, got empty string") } } // TestRefreshToken_Unauthorized_NoToken verifies that attempting to refresh // a token without providing one results in HTTP 401 Unauthorized. func TestRefreshToken_Unauthorized_NoToken(t *testing.T) { t.Parallel() _, _ = resetTestData(t) handler := http.HandlerFunc(RefreshTokenHandler) req := httptest.NewRequest("POST", "/api/refresh-token", nil) w := httptest.NewRecorder() handler.ServeHTTP(w, req) // Without proper auth middleware, userID/role won't be in context // The handler tries to query DB with empty userID, which should fail if w.Code != http.StatusUnauthorized && w.Code != http.StatusInternalServerError { t.Errorf("expected status 401 or 500, got %d. body: %s", w.Code, w.Body.String()) } } // ============================================================================= // Verify Generate Handler Tests // ============================================================================= // TestVerifyGenerate_ValidEmail tests that a verification code can be // generated for an existing user email. The code is stored in the database // for subsequent verification. func TestVerifyGenerate_ValidEmail(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(GenerateVerificationCodeHandler) // Create a test user with known email userID, err := fixtures.CreateTestUserWithEmail(tx, "user@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) body := VerificationCodeRequest{ Email: "user@test.com", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/generate", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp VerificationResponse if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if !resp.Success { t.Error("expected success=true in response") } // Verify a code was created in DB var codeID string err = tx.QueryRow(ctx, "SELECT id FROM verification_codes WHERE user_id = $1", userID).Scan(&codeID) if err != nil { t.Errorf("failed to find verification code in DB: %v", err) } // Clean up tx.Exec(ctx, "DELETE FROM verification_codes WHERE user_id = $1", userID) } // TestVerifyGenerate_NonExistentEmail verifies that the verification code // generation endpoint returns HTTP 200 even for non-existent emails. This is // a security measure to prevent email enumeration attacks. func TestVerifyGenerate_NonExistentEmail(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(GenerateVerificationCodeHandler) // Security: should return success even if email doesn't exist body := VerificationCodeRequest{ Email: "nonexistent@test.com", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/generate", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp VerificationResponse if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } // Should return success for security (don't reveal if email exists) if !resp.Success { t.Error("expected success=true in response for non-existent email") } } // ============================================================================= // Verify Check Handler Tests // ============================================================================= // TestVerifyCheck_ValidCode tests that a valid, non-expired, unused // verification code successfully verifies a user's email and updates their // account role from unverified_email to verified_email. func TestVerifyCheck_ValidCode(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(VerifyCodeHandler) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Create a verification code var code string expiresAt := time.Now().Add(24 * time.Hour) err = tx.QueryRow(ctx, `INSERT INTO verification_codes (user_id, purpose, expires_at) VALUES ($1, 'email_verify', $2) RETURNING code`, userID, expiresAt).Scan(&code) if err != nil { t.Fatalf("failed to create verification code: %v", err) } defer tx.Exec(ctx, "DELETE FROM verification_codes WHERE user_id = $1", userID) body := VerifyCodeRequest{ Code: code, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp VerificationResponse if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if !resp.Success { t.Error("expected success=true in response") } // Verify code is marked as used var usedAt *time.Time err = tx.QueryRow(ctx, "SELECT used_at FROM verification_codes WHERE code = $1", code).Scan(&usedAt) if err != nil || usedAt == nil { t.Error("expected verification code to be marked as used") } } // TestVerifyCheck_InvalidCode verifies that attempting to verify with // a non-existent code returns HTTP 400 Bad Request. func TestVerifyCheck_InvalidCode(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(VerifyCodeHandler) body := VerifyCodeRequest{ Code: "nonexistent-code-12345", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestVerifyCheck_ExpiredCode tests that verification fails with HTTP 400 // when the code has expired (past its expires_at timestamp). func TestVerifyCheck_ExpiredCode(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(VerifyCodeHandler) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Create an expired verification code var code string expiresAt := time.Now().Add(-1 * time.Hour) // Expired 1 hour ago err = tx.QueryRow(ctx, `INSERT INTO verification_codes (user_id, purpose, expires_at) VALUES ($1, 'email_verify', $2) RETURNING code`, userID, expiresAt).Scan(&code) if err != nil { t.Fatalf("failed to create verification code: %v", err) } defer tx.Exec(ctx, "DELETE FROM verification_codes WHERE user_id = $1", userID) body := VerifyCodeRequest{ Code: code, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // ============================================================================= // Additional Edge Case Tests // ============================================================================= // TestLogin_InvalidRequest verifies that sending malformed JSON to the login // endpoint returns HTTP 400 Bad Request. func TestLogin_InvalidRequest(t *testing.T) { _, _ = resetTestData(t) handler := http.HandlerFunc(LoginHandler) // Send invalid JSON req := httptest.NewRequest("POST", "/api/login", bytes.NewReader([]byte("not json"))) req.Header.Set("Content-Type", "application/json") w := httptest.NewRecorder() handler.ServeHTTP(w, req) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d", w.Code) } } // TestRegister_NameTooLong tests that registration fails when the first name // exceeds 50 characters (the maximum allowed length). func TestRegister_NameTooLong(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // First name > 50 chars longName := string(bytes.Repeat([]byte("a"), 51)) body := RegisterRequest{ FirstName: longName, LastName: "Doe", Email: "john@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestRegister_InvalidNameCharacters verifies that registration fails when // names contain invalid characters (e.g., numbers). func TestRegister_InvalidNameCharacters(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Name with numbers (invalid) body := RegisterRequest{ FirstName: "John123", LastName: "Doe", Email: "john@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestVerifyCheck_AlreadyUsed tests that attempting to verify with a code // that has already been used returns HTTP 403 Forbidden. func TestVerifyCheck_AlreadyUsed(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(VerifyCodeHandler) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Create a verification code var code string expiresAt := time.Now().Add(24 * time.Hour) err = tx.QueryRow(ctx, `INSERT INTO verification_codes (user_id, purpose, expires_at) VALUES ($1, 'email_verify', $2) RETURNING code`, userID, expiresAt).Scan(&code) if err != nil { t.Fatalf("failed to create verification code: %v", err) } defer tx.Exec(ctx, "DELETE FROM verification_codes WHERE user_id = $1", userID) // First verification should succeed body := VerifyCodeRequest{ Code: code, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusOK { t.Errorf("first verification: expected status 200, got %d", w.Code) } // Second verification with same code should return 403 (already used) w = testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusForbidden { t.Errorf("second verification: expected status 403, got %d", w.Code) } } // TestVerifyCheck_RoleChangeToVerified confirms that after a successful // verification, the user's account_role changes from unverified_email to // verified_email, granting them full account access. func TestVerifyCheck_RoleChangeToVerified(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(VerifyCodeHandler) // Create an unverified user userID, err := fixtures.CreateTestUnverifiedUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Verify initial role is unverified_email var initialRole string err = tx.QueryRow(ctx, "SELECT account_role FROM users WHERE id = $1", userID).Scan(&initialRole) if err != nil { t.Fatalf("failed to check initial role: %v", err) } if initialRole != "unverified_email" { t.Errorf("expected initial role 'unverified_email', got %s", initialRole) } // Create a verification code var code string expiresAt := time.Now().Add(24 * time.Hour) err = tx.QueryRow(ctx, `INSERT INTO verification_codes (user_id, purpose, expires_at) VALUES ($1, 'email_verify', $2) RETURNING code`, userID, expiresAt).Scan(&code) if err != nil { t.Fatalf("failed to create verification code: %v", err) } defer tx.Exec(ctx, "DELETE FROM verification_codes WHERE user_id = $1", userID) // Verify the code body := VerifyCodeRequest{ Code: code, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/verify/check", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } // Check that user's role changed to verified_email var newRole string err = tx.QueryRow(ctx, "SELECT account_role FROM users WHERE id = $1", userID).Scan(&newRole) if err != nil { t.Errorf("failed to check new role: %v", err) } if newRole != "verified_email" { t.Errorf("expected role to change to 'verified_email', got %s", newRole) } } // ============================================================================= // Password Length Tests (Registration) // ============================================================================= // TestRegister_PasswordLength_Minimum verifies that registration enforces // a minimum password length of 6 characters (new requirement from security pass). // bcrypt handles passwords up to 72 chars internally (truncates longer ones). func TestRegister_PasswordLength_Minimum(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) tests := []struct { name string password string expectError bool }{ { name: "1_char_password_too_short", password: "x", expectError: true, // Below 6 char minimum }, { name: "5_char_password_too_short", password: "short", expectError: true, // Below 6 char minimum }, { name: "6_char_password_minimum", password: "pass12", expectError: false, // Meets minimum }, { name: "72_char_password_exact_bcrypt_limit", password: strings.Repeat("a", 72), expectError: false, }, { name: "73_char_password_exceeds_limit", password: strings.Repeat("a", 73), expectError: true, // Exceeds bcrypt limit }, { name: "100_char_password_exceeds_limit", password: strings.Repeat("a", 100), expectError: true, // Exceeds bcrypt limit }, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { body := RegisterRequest{ FirstName: "Test", LastName: "User", Email: fmt.Sprintf("test-%s@test.com", tt.name), Password: tt.password, Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if tt.expectError { if w.Code == http.StatusCreated { t.Errorf("expected non-201 status for password '%s', got 201", tt.password) } } else { if w.Code != http.StatusCreated { t.Errorf("expected status 201 for password len=%d, got %d. body: %s", len(tt.password), w.Code, w.Body.String()) } } }) } } // TestRegister_EmptyPassword verifies that an empty password is rejected // because it's a required field (not because of minimum length). func TestRegister_EmptyPassword(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) body := RegisterRequest{ FirstName: "Test", LastName: "User", Email: "empty@test.com", Password: "", // Empty - should fail as required field Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) // Empty password fails because it's a required field if w.Code != http.StatusBadRequest { t.Errorf("expected status 400 for empty password, got %d", w.Code) } } // TestRegister_WithValidReferralCode verifies that registration succeeds when // a valid existing referral code is provided, and the referral relationship // is recorded in the user_referrals table. func TestRegister_WithValidReferralCode(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Create a referrer user with a known referral code referrerID, err := fixtures.CreateTestUserWithEmail(tx, "referrer@test.com", "verified_email") if err != nil { t.Fatalf("failed to create referrer user: %v", err) } defer fixtures.DeleteUser(tx, referrerID) // Set a known referral code for the referrer knownCode := "abc123def456" _, err = tx.Exec(ctx, "UPDATE users SET referral_code = $1 WHERE id = $2", knownCode, referrerID) if err != nil { t.Fatalf("failed to set referral code: %v", err) } body := RegisterRequest{ FirstName: "Referred", LastName: "User", Email: "referred@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, ReferralCode: knownCode, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusCreated { t.Errorf("expected status 201, got %d. body: %s", w.Code, w.Body.String()) } // Verify referral relationship was created var referredID string err = tx.QueryRow(ctx, "SELECT id FROM users WHERE email = $1", "referred@test.com").Scan(&referredID) if err != nil { t.Fatalf("failed to find referred user: %v", err) } defer fixtures.DeleteUser(tx, referredID) var count int err = tx.QueryRow(ctx, "SELECT COUNT(*) FROM user_referrals WHERE referrer_id = $1 AND referred_id = $2", referrerID, referredID).Scan(&count) if err != nil { t.Fatalf("failed to query user_referrals: %v", err) } if count != 1 { t.Errorf("expected 1 referral record, got %d", count) } } // TestRegister_WithInvalidReferralCode verifies that registration fails with // 400 when a non-existent referral code is provided. func TestRegister_WithInvalidReferralCode(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) body := RegisterRequest{ FirstName: "Test", LastName: "User", Email: "invalid-referral@test.com", Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, ReferralCode: "nonexistent1234", // 12 chars but doesn't exist } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400, got %d. body: %s", w.Code, w.Body.String()) } } // TestRegister_WithInvalidReferralCodeFormat verifies that registration fails // when the referral code is not exactly 12 characters. func TestRegister_WithInvalidReferralCodeFormat(t *testing.T) { t.Parallel() ctx, _ := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) tests := []struct { name string code string desc string }{ {"too_short", "abc123", "less than 12 chars"}, {"too_long", "abc123def456ghi", "more than 12 chars"}, {"special_chars", "abc123def4!!", "contains special chars"}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { body := RegisterRequest{ FirstName: "Test", LastName: "User", Email: fmt.Sprintf("format-test-%s@test.com", tt.name), Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, ReferralCode: tt.code, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != http.StatusBadRequest { t.Errorf("expected status 400 for %s (%s), got %d. body: %s", tt.name, tt.desc, w.Code, w.Body.String()) } }) } } // TestRegister_ReferralCodeCaseInsensitive verifies that referral codes with // uppercase letters are accepted and correctly matched against lowercase stored codes. func TestRegister_ReferralCodeCaseInsensitive(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) handler := http.HandlerFunc(RegisterHandler) // Create a referrer user with a known referral code (lowercase hex) referrerID, err := fixtures.CreateTestUserWithEmail(tx, "referrer-case@test.com", "verified_email") if err != nil { t.Fatalf("failed to create referrer user: %v", err) } defer fixtures.DeleteUser(tx, referrerID) knownCode := "abc123def456" _, err = tx.Exec(ctx, "UPDATE users SET referral_code = $1 WHERE id = $2", knownCode, referrerID) if err != nil { t.Fatalf("failed to set referral code: %v", err) } tests := []struct { name string inputCode string wantStatus int }{ {"lowercase", "abc123def456", http.StatusCreated}, {"uppercase", "ABC123DEF456", http.StatusCreated}, {"mixed_case", "AbC123DeF456", http.StatusCreated}, {"all_caps", "ABC123DEF456", http.StatusCreated}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { body := RegisterRequest{ FirstName: "Case", LastName: "Test", Email: fmt.Sprintf("case-test-%s@test.com", tt.name), Password: "password123", Phone: "07123456789", DateOfBirth: "1990-01-15", AgreedToPolicy: true, ReferralCode: tt.inputCode, } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/register", body, ctx) if w.Code != tt.wantStatus { t.Errorf("%s: expected status %d, got %d. body: %s", tt.name, tt.wantStatus, w.Code, w.Body.String()) } if tt.wantStatus == http.StatusCreated { // Verify referral relationship was created var referredID string err = tx.QueryRow(ctx, "SELECT id FROM users WHERE email = $1", fmt.Sprintf("case-test-%s@test.com", tt.name)).Scan(&referredID) if err != nil { t.Fatalf("%s: failed to find referred user: %v", tt.name, err) } defer fixtures.DeleteUser(tx, referredID) var count int err = tx.QueryRow(ctx, "SELECT COUNT(*) FROM user_referrals WHERE referrer_id = $1 AND referred_id = $2", referrerID, referredID).Scan(&count) if err != nil { t.Fatalf("%s: failed to query user_referrals: %v", tt.name, err) } if count != 1 { t.Errorf("%s: expected 1 referral record, got %d", tt.name, count) } } }) } } // ============================================================================= // Logout Handler Tests // ============================================================================= // TestLogoutHandler_Success verifies that a valid logout request returns // 200 OK with {"success": true} and revokes the JTI. func TestLogoutHandler_Success(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Generate a token and get its JTI token, jti, err := auth.GenerateToken(userID, "verified_email") if err != nil { t.Fatalf("failed to generate token: %v", err) } // Create request with JTI in context (simulating RequireAuth middleware) req := httptest.NewRequest("POST", "/api/logout", nil) req.Header.Set("Authorization", "Bearer "+token) reqCtx := context.WithValue(ctx, mw.JTIKey, jti) req = req.WithContext(reqCtx) w := httptest.NewRecorder() LogoutHandler(w, req) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp struct { Success bool `json:"success"` } if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if !resp.Success { t.Error("expected success=true in response") } // Verify JTI was revoked if !auth.IsJTIRevoked(ctx, jti) { t.Error("expected JTI to be revoked after logout") } } // TestLogoutHandler_RevokesJTI verifies that after logout, the token's JTI is // revoked and the token can no longer be used with authenticated endpoints. func TestLogoutHandler_RevokesJTI(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Generate a token and get its JTI token, jti, err := auth.GenerateToken(userID, "verified_email") if err != nil { t.Fatalf("failed to generate token: %v", err) } // Call logout with JTI in context req := httptest.NewRequest("POST", "/api/logout", nil) req.Header.Set("Authorization", "Bearer "+token) reqCtx := context.WithValue(ctx, mw.JTIKey, jti) req = req.WithContext(reqCtx) w := httptest.NewRecorder() LogoutHandler(w, req) if w.Code != http.StatusOK { t.Fatalf("logout failed: %d. body: %s", w.Code, w.Body.String()) } // Try to use the same token through RequireAuth middleware router := chi.NewRouter() router.With(mw.RequireAuth).Get("/api/protected", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) }) req2 := httptest.NewRequest("GET", "/api/protected", nil) req2 = req2.WithContext(ctx) req2.Header.Set("Authorization", "Bearer "+token) w2 := httptest.NewRecorder() router.ServeHTTP(w2, req2) if w2.Code != http.StatusUnauthorized { t.Errorf("expected 401 for revoked token, got %d", w2.Code) } } // TestLogoutHandler_NoToken verifies that calling logout without an // Authorization header returns 401. func TestLogoutHandler_NoToken(t *testing.T) { t.Parallel() _, _ = resetTestData(t) req := httptest.NewRequest("POST", "/api/logout", nil) w := httptest.NewRecorder() // Without JTI in context, handler returns 401 LogoutHandler(w, req) if w.Code != http.StatusUnauthorized { t.Errorf("expected status 401, got %d. body: %s", w.Code, w.Body.String()) } } // TestLogoutHandler_InvalidToken verifies that calling logout with an empty // JTI returns 401. func TestLogoutHandler_InvalidToken(t *testing.T) { t.Parallel() _, _ = resetTestData(t) req := httptest.NewRequest("POST", "/api/logout", nil) reqCtx := context.WithValue(req.Context(), mw.JTIKey, "") req = req.WithContext(reqCtx) w := httptest.NewRecorder() LogoutHandler(w, req) if w.Code != http.StatusUnauthorized { t.Errorf("expected status 401, got %d. body: %s", w.Code, w.Body.String()) } } // ============================================================================= // Refresh Token JTI Tests // ============================================================================= // TestRefreshToken_RevokesOldJTI verifies that refreshing a token revokes the // old JTI and issues a new one. The old token becomes invalid after refresh. func TestRefreshToken_RevokesOldJTI(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) // Create a test user userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Generate initial token and JTI oldToken, oldJTI, err := auth.GenerateToken(userID, "verified_email") if err != nil { t.Fatalf("failed to generate old token: %v", err) } // Verify old JTI is not yet revoked if auth.IsJTIRevoked(ctx, oldJTI) { t.Fatal("old JTI should not be revoked before refresh") } // Call refresh handler with old JTI in context req := httptest.NewRequest("POST", "/api/refresh-token", nil) req.Header.Set("Authorization", "Bearer "+oldToken) reqCtx := ctx reqCtx = context.WithValue(reqCtx, mw.UserIDKey, userID) reqCtx = context.WithValue(reqCtx, mw.UserRoleKey, "verified_email") reqCtx = context.WithValue(reqCtx, mw.JTIKey, oldJTI) req = req.WithContext(reqCtx) w := httptest.NewRecorder() RefreshTokenHandler(w, req) if w.Code != http.StatusOK { t.Fatalf("refresh failed: %d. body: %s", w.Code, w.Body.String()) } // Verify old JTI was revoked if !auth.IsJTIRevoked(ctx, oldJTI) { t.Error("expected old JTI to be revoked after refresh") } // Verify old token is rejected by middleware router := chi.NewRouter() router.With(mw.RequireAuth).Get("/api/protected", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusOK) }) req2 := httptest.NewRequest("GET", "/api/protected", nil) req2 = req2.WithContext(ctx) req2.Header.Set("Authorization", "Bearer "+oldToken) w2 := httptest.NewRecorder() router.ServeHTTP(w2, req2) if w2.Code != http.StatusUnauthorized { t.Errorf("expected 401 for revoked token after refresh, got %d", w2.Code) } } // ============================================================================= // Login Response JTI Tests // ============================================================================= // TestLoginResponse_IncludesJTI verifies that the login response includes both // "token" and "jti" fields, both non-empty. func TestLoginResponse_IncludesJTI(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) // Create a test user with known email userID, err := fixtures.CreateTestUserWithEmail(tx, "jti-test@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) body := LoginRequest{ Email: "jti-test@test.com", Password: "testpassword123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusOK { t.Errorf("expected status 200, got %d. body: %s", w.Code, w.Body.String()) } var resp struct { Token string `json:"token"` JTI string `json:"jti"` } if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Errorf("failed to parse response: %v", err) } if resp.Token == "" { t.Error("expected non-empty token in login response") } if resp.JTI == "" { t.Error("expected non-empty jti in login response") } } // ============================================================================= // LoginInProgress Rate Limiting Tests // ============================================================================= // TestLoginInProgress_Cap verifies that when the loginInProgress map is full // (20 concurrent logins), the 21st attempt returns HTTP 429 Too Many Requests. func TestLoginInProgress_Cap(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) // Create a test user userID, err := fixtures.CreateTestUserWithEmail(tx, "ratelimit@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) // Fill the loginInProgress map with 20 entries loginStateMu.Lock() for i := 0; i < maxLoginInProgress; i++ { loginInProgress[fmt.Sprintf("stale-user-%d", i)] = time.Now() } loginStateMu.Unlock() defer func() { // Clean up loginStateMu.Lock() for i := 0; i < maxLoginInProgress; i++ { delete(loginInProgress, fmt.Sprintf("stale-user-%d", i)) } loginStateMu.Unlock() }() // Attempt login - should get 429 body := LoginRequest{ Email: "ratelimit@test.com", Password: "testpassword123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusTooManyRequests { t.Errorf("expected status 429, got %d. body: %s", w.Code, w.Body.String()) } } // ValidateUKPhoneNumber Security Tests // // These tests verify that ValidateUKPhoneNumber rejects or sanitises // injection payloads (SQLi, XSS, command injection, control characters). func TestValidateUKPhoneNumber_RejectsPureInjectionPayloads(t *testing.T) { t.Parallel() payloads := []string{ // SQL injection "' OR '1'='1", "admin'--", `" OR 1=1 --`, "'; DROP TABLE users;--", // XSS "", "", "\">", "javascript:alert(1)", // Command injection "; rm -rf /", "| cat /etc/passwd", "`id`", "$(cat /etc/passwd)", // Control characters "\n", "\r\n", "\x00", } for _, p := range payloads { result, err := ValidateUKPhoneNumber(p) if err == nil { t.Errorf("expected injection payload %q to be rejected, got result %q", p, result) } } } func TestValidateUKPhoneNumber_RejectsMixedInjectionPayloads(t *testing.T) { t.Parallel() // When injection characters are interleaved with a valid UK phone number, // libphonenumber rejects the entire input — it does NOT try to extract // digits from non-numeric characters. This is MORE secure than naive // digit-stripping approaches. payloads := []string{ "' OR '1'='1 OR '+447700900000", ">", "'; rm -rf /; +447700900000", "\x00\n+447700900000", } for _, p := range payloads { result, err := ValidateUKPhoneNumber(p) if err == nil { t.Errorf("expected mixed payload %q to be rejected, got result %q", p, result) } } } // ============================================================================= // Account Lockout Tests (new from security pass) // ============================================================================= // TestLogin_AccountLockout_After5Failures verifies that after 5 failed login // attempts, the account is locked and the next login attempt returns HTTP 429. func TestLogin_AccountLockout_After5Failures(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) userID, err := fixtures.CreateTestUserWithEmail(tx, "user@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) defer tx.Exec(ctx, "UPDATE users SET failed_attempts = 0, locked_until = NULL WHERE id = $1", userID) for i := 0; i < 5; i++ { body := LoginRequest{ Email: "user@test.com", Password: "wrongpassword", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusUnauthorized { t.Fatalf("attempt %d: expected 401, got %d", i+1, w.Code) } } body := LoginRequest{ Email: "user@test.com", Password: "wrongpassword", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusTooManyRequests { t.Errorf("expected 429 after 5 failures, got %d. body: %s", w.Code, w.Body.String()) } var failedAttempts int var lockedUntil *time.Time err = tx.QueryRow(ctx, "SELECT failed_attempts, locked_until FROM users WHERE id = $1", userID).Scan(&failedAttempts, &lockedUntil) if err != nil { t.Fatalf("failed to query lockout state: %v", err) } if failedAttempts < 5 { t.Errorf("expected >=5 failed attempts, got %d", failedAttempts) } if lockedUntil == nil { t.Error("expected locked_until to be set") } } // TestLogin_AccountLockout_ResetsOnSuccess verifies that a successful login // resets the failed_attempts counter and clears the locked_until. func TestLogin_AccountLockout_ResetsOnSuccess(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) userID, err := fixtures.CreateTestUserWithEmail(tx, "lockout-reset@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) _, err = tx.Exec(ctx, "UPDATE users SET failed_attempts = 3 WHERE id = $1", userID) if err != nil { t.Fatalf("failed to set failed_attempts: %v", err) } body := LoginRequest{ Email: "lockout-reset@test.com", Password: "testpassword123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusOK { t.Fatalf("expected 200, got %d. body: %s", w.Code, w.Body.String()) } var failedAttempts int var lockedUntil *time.Time err = tx.QueryRow(ctx, "SELECT failed_attempts, locked_until FROM users WHERE id = $1", userID).Scan(&failedAttempts, &lockedUntil) if err != nil { t.Fatalf("failed to query lockout state: %v", err) } if failedAttempts != 0 { t.Errorf("expected 0 failed_attempts after success, got %d", failedAttempts) } if lockedUntil != nil { t.Error("expected locked_until to be cleared after success") } } // ============================================================================= // JWT Auth Unit Tests (new from security pass) // ============================================================================= // TestJWT_ExpiryIsOneHour verifies that generated JWTs have a 1-hour expiry // (changed from 30 days during security pass). func TestJWT_ExpiryIsOneHour(t *testing.T) { t.Parallel() userID := "test-user-id" role := "verified_email" token, jti, err := auth.GenerateToken(userID, role) if err != nil { t.Fatalf("failed to generate token: %v", err) } if token == "" { t.Fatal("expected non-empty token") } if jti == "" { t.Fatal("expected non-empty jti") } retrievedUserID, retrievedRole, retrievedJTI, err := auth.VerifyToken(token, context.Background()) if err != nil { t.Fatalf("failed to verify token: %v", err) } if retrievedUserID != userID { t.Errorf("expected userID %q, got %q", userID, retrievedUserID) } if retrievedRole != role { t.Errorf("expected role %q, got %q", role, retrievedRole) } if retrievedJTI != jti { t.Errorf("expected jti %q, got %q", jti, retrievedJTI) } } // TestRefreshToken_Generation verifies that a refresh token can be generated // and stored in the database. This requires DB access. func TestRefreshToken_Generation(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) refreshToken, err := auth.GenerateRefreshToken(ctx, userID, "verified_email") if err != nil { t.Fatalf("failed to generate refresh token: %v", err) } if refreshToken == "" { t.Fatal("expected non-empty refresh token") } var count int err = tx.QueryRow(ctx, "SELECT COUNT(*) FROM refresh_tokens WHERE user_id = $1", userID).Scan(&count) if err != nil { t.Fatalf("failed to query refresh_tokens: %v", err) } if count != 1 { t.Errorf("expected 1 refresh_token, got %d", count) } retrievedUserID, retrievedRole, err := auth.VerifyRefreshToken(ctx, refreshToken) if err != nil { t.Fatalf("failed to verify refresh token: %v", err) } if retrievedUserID != userID { t.Errorf("expected userID %q, got %q", userID, retrievedUserID) } if retrievedRole != "verified_email" { t.Errorf("expected role 'verified_email', got %q", retrievedRole) } _, _, err = auth.VerifyRefreshToken(ctx, refreshToken) if err == nil { t.Error("expected error on second refresh token verification (rotated)") } } // TestJTI_Revocation_PostgreSQL verifies that JTI revocation uses the // PostgreSQL revoked_jtis table and persists across operations. func TestJTI_Revocation_PostgreSQL(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) token, jti, err := auth.GenerateToken(userID, "verified_email") if err != nil { t.Fatalf("failed to generate token: %v", err) } if auth.IsJTIRevoked(ctx, jti) { t.Fatal("JTI should not be revoked before we revoke it") } _, _, _, err = auth.VerifyToken(token, ctx) if err != nil { t.Fatalf("token should be valid before revocation: %v", err) } auth.RevokeJTI(ctx, jti, time.Now().Add(1*time.Hour)) if !auth.IsJTIRevoked(ctx, jti) { t.Error("JTI should be revoked after RevokeJTI call") } _, _, _, err = auth.VerifyToken(token, ctx) if err == nil { t.Error("VerifyToken should fail for revoked JTI") } } // ============================================================================= // Login Response Field Tests (new from security pass) // ============================================================================= // TestLogin_ResponseIncludesRefreshToken verifies the login response // includes a refreshToken field alongside the JWT. func TestLogin_ResponseIncludesRefreshToken(t *testing.T) { ctx, tx := resetTestData(t) handler := http.HandlerFunc(LoginHandler) userID, err := fixtures.CreateTestUserWithEmail(tx, "refresh-check@test.com", "verified_email") if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) body := LoginRequest{ Email: "refresh-check@test.com", Password: "testpassword123", } w := testutils.MakeRequestNoAuth(handler, "POST", "/api/login", body, ctx) if w.Code != http.StatusOK { t.Fatalf("expected 200, got %d. body: %s", w.Code, w.Body.String()) } var resp struct { Token string `json:"token"` JTI string `json:"jti"` RefreshToken string `json:"refreshToken"` } if err := testutils.ParseResponseBody(w, &resp); err != nil { t.Fatalf("failed to parse response: %v", err) } if resp.Token == "" { t.Error("expected non-empty token") } if resp.JTI == "" { t.Error("expected non-empty jti") } if resp.RefreshToken == "" { t.Error("expected non-empty refreshToken in login response") } } // TestRefreshToken_RevokesOldJTI_DBBacked verifies refresh still revokes old // JTI and the revocation is persisted in the revoked_jtis table. func TestRefreshToken_RevokesOldJTI_DBBacked(t *testing.T) { t.Parallel() ctx, tx := resetTestData(t) userID, err := fixtures.CreateTestUser(tx) if err != nil { t.Fatalf("failed to create test user: %v", err) } defer fixtures.DeleteUser(tx, userID) oldToken, oldJTI, err := auth.GenerateToken(userID, "verified_email") if err != nil { t.Fatalf("failed to generate old token: %v", err) } if auth.IsJTIRevoked(ctx, oldJTI) { t.Fatal("old JTI should not be revoked before refresh") } req := httptest.NewRequest("POST", "/api/refresh-token", nil) req.Header.Set("Authorization", "Bearer "+oldToken) reqCtx := ctx reqCtx = context.WithValue(reqCtx, mw.UserIDKey, userID) reqCtx = context.WithValue(reqCtx, mw.UserRoleKey, "verified_email") reqCtx = context.WithValue(reqCtx, mw.JTIKey, oldJTI) req = req.WithContext(reqCtx) w := httptest.NewRecorder() RefreshTokenHandler(w, req) if w.Code != http.StatusOK { t.Fatalf("refresh failed: %d. body: %s", w.Code, w.Body.String()) } if !auth.IsJTIRevoked(ctx, oldJTI) { t.Error("expected old JTI to be revoked after refresh (DB-backed)") } var dbCount int err = tx.QueryRow(ctx, "SELECT COUNT(*) FROM revoked_jtis WHERE jti = $1 AND expires_at > NOW()", oldJTI).Scan(&dbCount) if err != nil { t.Fatalf("failed to query revoked_jtis: %v", err) } if dbCount != 1 { t.Errorf("expected 1 revoked_jtis row, got %d", dbCount) } } // Ensure test compilation - import pgxpool to avoid unused import var _ = func() *pgxpool.Pool { return nil }