add iOS test

Author: martinbonnin

libraries/apollo-runtime/src/appleMain/kotlin/com/apollographql/apollo/network/http/DefaultHttpEngine.apple.kt

@@ -11,6 +11,7 @@ import kotlinx.atomicfu.locks.withLock
 import kotlinx.cinterop.alloc
 import kotlinx.cinterop.nativeHeap
 import kotlinx.cinterop.ptr
+import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.suspendCancellableCoroutine
 import okio.Buffer
 import okio.BufferedSource

libraries/apollo-runtime/src/commonMain/kotlin/com/apollographql/apollo/network/http/HttpEngine.kt

@@ -9,6 +9,7 @@ import com.apollographql.apollo.api.http.HttpMethod
 import com.apollographql.apollo.api.http.HttpRequest
 import com.apollographql.apollo.api.http.HttpResponse
 import com.apollographql.apollo.exception.ApolloNetworkException
+import kotlinx.coroutines.CancellationException
 import okio.Closeable
 
 /**
@@ -23,6 +24,7 @@ interface HttpEngine : Closeable {
    *
    * @throws [ApolloNetworkException] if a network error happens
    */
+  @Throws(ApolloNetworkException::class, CancellationException::class)
   suspend fun execute(request: HttpRequest): HttpResponse
 
   @ApolloDeprecatedSince(v4_0_0)

libraries/apollo-runtime/src/commonMain/kotlin/com/apollographql/apollo/network/http/HttpInterceptor.kt

@@ -2,16 +2,26 @@ package com.apollographql.apollo.network.http
 
 import com.apollographql.apollo.api.http.HttpRequest
 import com.apollographql.apollo.api.http.HttpResponse
+import com.apollographql.apollo.exception.ApolloException
 import com.apollographql.apollo.exception.ApolloNetworkException
+import kotlinx.coroutines.CancellableContinuation
+import kotlinx.coroutines.CancellationException
 
 interface HttpInterceptorChain {
   /**
-   * @throws [ApolloNetworkException] if a network error happens
+   * Continues with the request and call all downstream interceptors.
    */
+  @Throws(ApolloException::class, CancellationException::class)
   suspend fun proceed(request: HttpRequest): HttpResponse
 }
 
 interface HttpInterceptor {
+  /**
+   * Intercepts the request and returns a response.
+   * Implementation may throw [ApolloException] in case of error. Those errors are typically
+   * caught by the network transport and subsequently exposed in `ApolloResponse.exception`
+   */
+  @Throws(ApolloException::class, CancellationException::class)
   suspend fun intercept(request: HttpRequest, chain: HttpInterceptorChain): HttpResponse
 
   // TODO: remove dispose