[BOOK-79] feat: apis - 알라딘 도서검색, 도서상세검색 외부 API Helper (#15)

Author: minwoo1999

apis/src/main/kotlin/org/yapp/apis/book/helper/AladinApiHelper.kt

@@ -0,0 +1,45 @@
+package org.yapp.infra.external.aladin.helper
+
+import mu.KotlinLogging
+import org.yapp.globalutils.annotation.Helper
+import org.yapp.infra.external.aladin.AladinApi
+import org.yapp.infra.external.aladin.response.AladinBookDetailResponse
+import org.yapp.infra.external.aladin.response.AladinSearchResponse
+
+
+@Helper
+class AladinApiHelper(
+    private val aladinApi: AladinApi
+) {
+    private val log = KotlinLogging.logger {}
+
+    fun searchBooks(query: String, params: Map<String, Any>): AladinSearchResponse {
+        return aladinApi.searchBooks(query, params)
+            .onSuccess { response ->
+                log.info("Aladin search successful for query: '$query', total results: ${response.totalResults}")
+            }
+            .getOrElse { exception ->
+                log.error("Failed to call Aladin search API for query: '$query'", exception)
+                // TODO: 특정 비즈니스 예외로 맵핑하거나, 공통 예외 처리 계층에서 처리하도록 리팩토링
+                throw IllegalStateException(
+                    "Failed to retrieve search results from Aladin API: ${exception.message}",
+                    exception
+                )
+            }
+    }
+
+    fun lookupBook(itemId: String, itemIdType: String, optResult: List<String>?): AladinBookDetailResponse {
+        // AladinApi로 optResult를 직접 전달
+        return aladinApi.lookupBook(itemId, itemIdType, optResult)
+            .onSuccess { response ->
+                log.info("Aladin lookup successful for itemId: '$itemId', title: ${response.item?.firstOrNull()?.title}")
+            }
+            .getOrElse { exception ->
+                log.error("Failed to call Aladin lookup API for itemId: '$itemId'", exception)
+                throw IllegalStateException(
+                    "Failed to retrieve book details from Aladin API: ${exception.message}",
+                    exception
+                )
+            }
+    }
+}