feat: Implement flight search functionality

This commit introduces the ability to search for flights based on user-defined criteria.

Key changes:
- Added `GetFlightsSearchContentUseCase` interface in the domain layer and its implementation `GetFlightsSearchContentUseCaseImpl` in the repository layer to handle flight search logic.
- Implemented `FlightDomainMapper` to map `FlightResponse` from the API to the domain `Flight` model.
- Updated `NetworkModule`:
    - Introduced `ServicesAPI` and `NativeAppsAPI` qualifiers to differentiate between Retrofit instances for different Ryanair APIs.
    - Configured a new Retrofit instance for the `nativeapps.ryanair.com` base URL.
    - Modified `FlightService` to use the `nativeapps.ryanair.com` base URL.
- Updated `FlightService` endpoint to `api/v4/en-gb/Availability`.
- Integrated `GetFlightsSearchContentUseCase` into `HomeScreenViewModel` to trigger flight searches.
- Created `SearchOptions` data class in the domain layer to encapsulate search parameters.
- Added `GetFlightsSearchContentUseCaseModule` to provide the use case implementation via Hilt.

model/data/api/src/main/kotlin/dev/adriankuta/model/data/api/FlightService.kt

@@ -12,7 +12,7 @@ interface FlightService {
         "client: android",
         "client-version: 3.300.0",
     )
-    @GET("v4/en-gb/Availability")
+    @GET("api/v4/en-gb/Availability")
     @Suppress("LongParameterList")
     suspend fun getFlights(
         @Query("dateout") date: String,

model/data/api/src/main/kotlin/dev/adriankuta/model/data/api/di/NetworkModule.kt

@@ -12,6 +12,7 @@ import okhttp3.OkHttpClient
 import okhttp3.logging.HttpLoggingInterceptor
 import retrofit2.Retrofit
 import retrofit2.converter.moshi.MoshiConverterFactory
+import javax.inject.Qualifier
 import javax.inject.Singleton
 
 @Module
@@ -37,7 +38,8 @@ class NetworkModule {
 
     @Singleton
     @Provides
-    fun provideRetrofit(client: OkHttpClient, moshi: Moshi): Retrofit = Retrofit.Builder()
+    @ServicesAPI
+    fun provideServicesRetrofit(client: OkHttpClient, moshi: Moshi): Retrofit = Retrofit.Builder()
         // TODO("add URL provided in the task instructions")
         .baseUrl("https://services-api.ryanair.com")
         .addConverterFactory(MoshiConverterFactory.create(moshi))
@@ -46,16 +48,34 @@ class NetworkModule {
 
     @Singleton
     @Provides
-    fun provideAirportService(retrofit: Retrofit): AirportService =
+    @NativeAppsAPI
+    fun provideNativeAppsRetrofit(client: OkHttpClient, moshi: Moshi): Retrofit = Retrofit.Builder()
+        // TODO("add URL provided in the task instructions")
+        .baseUrl("https://nativeapps.ryanair.com")
+        .addConverterFactory(MoshiConverterFactory.create(moshi))
+        .client(client)
+        .build()
+
+    @Singleton
+    @Provides
+    fun provideAirportService(@ServicesAPI retrofit: Retrofit): AirportService =
         retrofit.create(AirportService::class.java)
 
     @Singleton
     @Provides
-    fun provideRoutesService(retrofit: Retrofit): RoutesService =
+    fun provideRoutesService(@ServicesAPI retrofit: Retrofit): RoutesService =
         retrofit.create(RoutesService::class.java)
 
     @Singleton
     @Provides
-    fun provideFlightService(retrofit: Retrofit): FlightService =
+    fun provideFlightService(@NativeAppsAPI retrofit: Retrofit): FlightService =
         retrofit.create(FlightService::class.java)
 }
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class ServicesAPI
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class NativeAppsAPI

model/repository/src/main/kotlin/dev/adriankuta/flights/model/repository/di/GetFlightsSearchContentUseCaseModule.kt

@@ -0,0 +1,19 @@
+package dev.adriankuta.flights.model.repository.di
+
+import dagger.Binds
+import dagger.Module
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import dev.adriankuta.flights.domain.search.GetFlightsSearchContentUseCase
+import dev.adriankuta.flights.model.repository.usecases.GetFlightsSearchContentUseCaseImpl
+
+@Module
+@InstallIn(SingletonComponent::class)
+@Suppress("UnnecessaryAbstractClass")
+internal abstract class GetFlightsSearchContentUseCaseModule {
+
+    @Binds
+    abstract fun bind(
+        getFlightsSearchContentUseCaseImpl: GetFlightsSearchContentUseCaseImpl,
+    ): GetFlightsSearchContentUseCase
+}

model/repository/src/main/kotlin/dev/adriankuta/flights/model/repository/mappers/FlightDomainMapper.kt

@@ -0,0 +1,75 @@
+package dev.adriankuta.flights.model.repository.mappers
+
+import dev.adriankuta.flights.domain.types.Flight
+import dev.adriankuta.flights.domain.types.RegularFare
+import dev.adriankuta.flights.domain.types.Segment
+import dev.adriankuta.flights.domain.types.Trip
+import dev.adriankuta.flights.domain.types.TripDate
+import dev.adriankuta.flights.domain.types.TripFare
+import dev.adriankuta.flights.domain.types.TripFlight
+import dev.adriankuta.model.data.api.entities.FlightResponse
+import dev.adriankuta.model.data.api.entities.RegularFare as ApiRegularFare
+import dev.adriankuta.model.data.api.entities.Segment as ApiSegment
+import dev.adriankuta.model.data.api.entities.Trip as ApiTrip
+import dev.adriankuta.model.data.api.entities.TripDate as ApiTripDate
+import dev.adriankuta.model.data.api.entities.TripFare as ApiTripFare
+import dev.adriankuta.model.data.api.entities.TripFlight as ApiTripFlight
+
+internal fun FlightResponse.toDomain(): Flight {
+    return Flight(
+        currency = currency ?: "",
+        currPrecision = currPrecision ?: 0,
+        trips = trips.orEmpty().map { it.toDomain() },
+    )
+}
+
+internal fun ApiTrip.toDomain(): Trip {
+    return Trip(
+        dates = dates.orEmpty().map { it.toDomain() },
+        origin = origin ?: "",
+        destination = destination ?: "",
+    )
+}
+
+internal fun ApiTripDate.toDomain(): TripDate {
+    return TripDate(
+        dateOut = dateOut ?: "",
+        flights = flights.orEmpty().map { it.toDomain() },
+    )
+}
+
+internal fun ApiTripFlight.toDomain(): TripFlight {
+    return TripFlight(
+        faresLeft = faresLeft ?: 0,
+        regularFare = regularFare?.toDomain() ?: RegularFare(emptyList()),
+        flightNumber = flightNumber ?: "",
+        dateTimes = dateTimes.orEmpty(),
+        duration = duration ?: "",
+        segments = segments.orEmpty().map { it.toDomain() },
+        operatedBy = operatedBy ?: "",
+    )
+}
+
+internal fun ApiRegularFare.toDomain(): RegularFare {
+    return RegularFare(
+        fares = fares.orEmpty().map { it.toDomain() },
+    )
+}
+
+internal fun ApiTripFare.toDomain(): TripFare {
+    return TripFare(
+        type = type ?: "",
+        amount = amount ?: 0.0,
+        count = count ?: 0,
+    )
+}
+
+internal fun ApiSegment.toDomain(): Segment {
+    return Segment(
+        origin = origin ?: "",
+        destination = destination ?: "",
+        flightNumber = flightNumber ?: "",
+        dateTimes = dateTimes.orEmpty(),
+        duration = duration ?: "",
+    )
+}

model/repository/src/main/kotlin/dev/adriankuta/flights/model/repository/usecases/GetFlightsSearchContentUseCaseImpl.kt

@@ -0,0 +1,27 @@
+package dev.adriankuta.flights.model.repository.usecases
+
+import dev.adriankuta.flights.domain.search.GetFlightsSearchContentUseCase
+import dev.adriankuta.flights.domain.search.entities.SearchOptions
+import dev.adriankuta.flights.domain.types.Flight
+import dev.adriankuta.flights.model.repository.mappers.toDomain
+import dev.adriankuta.model.data.api.FlightService
+import java.time.format.DateTimeFormatter
+import javax.inject.Inject
+
+internal class GetFlightsSearchContentUseCaseImpl @Inject constructor(
+    private val flightService: FlightService,
+) : GetFlightsSearchContentUseCase {
+
+    override suspend fun invoke(searchOptions: SearchOptions): Flight {
+        val result = flightService.getFlights(
+            origin = searchOptions.origin.code,
+            destination = searchOptions.destination.code,
+            date = searchOptions.date.format(DateTimeFormatter.ISO_DATE),
+            adult = searchOptions.adults,
+            teen = searchOptions.teens,
+            child = searchOptions.children,
+        )
+
+        return result.toDomain()
+    }
+}