refactor(auth): Replace requireNotNull with field validation utility

- Use checkField for refresh token validation
- Remove IllegalArgumentException handler
- Add Kotlin contracts to validation utilities
- Bump version to 0.6.1

Author: gymynnym

build.gradle.kts

@@ -10,7 +10,7 @@ plugins {
 
 group = "me.loghub"
 
-version = "0.6.0-SNAPSHOT"
+version = "0.6.1-SNAPSHOT"
 
 java { toolchain { languageVersion = JavaLanguageVersion.of(21) } }
 

src/main/kotlin/me/loghub/api/controller/auth/RefreshController.kt

@@ -18,10 +18,7 @@ import org.springframework.web.bind.annotation.RestController
 class RefreshController(private val refreshService: RefreshService) {
     @PostMapping
     fun refreshToken(
-        @CookieValue(
-            RefreshTokenConfig.NAME,
-            required = false
-        ) refreshToken: String?
+        @CookieValue(RefreshTokenConfig.NAME, required = false) refreshToken: String?
     ): ResponseEntity<ResponseBody> {
         val token = refreshService.refreshToken(refreshToken)
         val responseBody = MessageResponseBody(

src/main/kotlin/me/loghub/api/handler/exception/ValidationExceptionHandler.kt

@@ -25,14 +25,6 @@ class ValidationExceptionHandler {
         ).toResponseEntity()
     }
 
-    @ExceptionHandler(IllegalArgumentException::class)
-    fun handleException(e: IllegalArgumentException): ResponseEntity<ResponseBody> {
-        return MessageResponseBody(
-            message = e.message ?: ResponseMessage.Default.INVALID_REQUEST,
-            status = HttpStatus.BAD_REQUEST
-        ).toResponseEntity()
-    }
-
     @ExceptionHandler(ConflictFieldException::class)
     fun handleException(e: ConflictFieldException): ResponseEntity<ResponseBody> {
         return FieldErrorsResponseBody(

src/main/kotlin/me/loghub/api/service/auth/RefreshService.kt

@@ -1,12 +1,14 @@
 package me.loghub.api.service.auth
 
 import jakarta.transaction.Transactional
+import me.loghub.api.config.RefreshTokenConfig
 import me.loghub.api.constant.message.ResponseMessage
 import me.loghub.api.dto.auth.token.TokenDTO
 import me.loghub.api.exception.auth.BadRefreshTokenException
 import me.loghub.api.lib.redis.key.RedisKeys
 import me.loghub.api.repository.user.UserRepository
 import me.loghub.api.service.auth.token.TokenService
+import me.loghub.api.util.checkField
 import org.springframework.data.redis.core.RedisTemplate
 import org.springframework.stereotype.Service
 import kotlin.time.Duration.Companion.seconds
@@ -20,7 +22,7 @@ class RefreshService(
 ) {
     @Transactional
     fun refreshToken(token: String?): TokenDTO {
-        requireNotNull(token) { ResponseMessage.Auth.INVALID_TOKEN }
+        checkField(RefreshTokenConfig.NAME, token != null) { ResponseMessage.Auth.INVALID_TOKEN }
 
         val redisKey = RedisKeys.REFRESH_TOKEN(token)
         val userId = redisTemplate.opsForValue().get(redisKey.key)

src/main/kotlin/me/loghub/api/util/ValidationUtil.kt

@@ -1,3 +1,5 @@
+@file:OptIn(ExperimentalContracts::class)
+
 package me.loghub.api.util
 
 import me.loghub.api.exception.auth.PermissionDeniedException
@@ -8,12 +10,18 @@ import me.loghub.api.exception.entity.EntityNotFoundFieldException
 import me.loghub.api.exception.validation.ConflictFieldException
 import me.loghub.api.exception.validation.CooldownNotElapsedException
 import me.loghub.api.exception.validation.IllegalFieldException
+import kotlin.contracts.ExperimentalContracts
+import kotlin.contracts.contract
 
 inline fun checkField(
     field: String,
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies condition
+    }
+
     if (!condition) {
         val message = lazyMessage()
         throw IllegalFieldException(field, message)
@@ -24,6 +32,10 @@ inline fun checkExists(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies condition
+    }
+
     if (!condition) {
         val message = lazyMessage()
         throw EntityNotFoundException(message)
@@ -35,6 +47,10 @@ inline fun checkExists(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies condition
+    }
+
     if (!condition) {
         val message = lazyMessage()
         throw EntityNotFoundFieldException(field, message)
@@ -45,6 +61,10 @@ inline fun checkPublished(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies condition
+    }
+
     if (!condition) {
         val message = lazyMessage()
         throw EntityNotFoundException(message)
@@ -55,6 +75,10 @@ inline fun checkConflict(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies !condition
+    }
+
     if (condition) {
         val message = lazyMessage()
         throw EntityConflictException(message)
@@ -66,6 +90,10 @@ inline fun checkConflict(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies !condition
+    }
+
     if (condition) {
         val message = lazyMessage()
         throw EntityExistsFieldException(field, message)
@@ -76,6 +104,10 @@ inline fun checkCooldown(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies !condition
+    }
+
     if (condition) {
         val message = lazyMessage()
         throw CooldownNotElapsedException(message)
@@ -86,6 +118,10 @@ inline fun checkPermission(
     condition: Boolean,
     lazyMessage: () -> String,
 ) {
+    contract {
+        returns() implies condition
+    }
+
     if (!condition) {
         val message = lazyMessage()
         throw PermissionDeniedException(message)