kenwork

A Kotlin-first networking library for Android and Kotlin Multiplatform — typed endpoints, a coroutine HTTP client with automatic OAuth refresh, layered caching, and a repository abstraction. kenwork is the Kotlin counterpart of SwiftyNetwork: the two libraries expose the same concepts with idiomatic APIs on each platform.

Built on Ktor + OkHttp and kotlinx.serialization, 100% coroutines, dependency-injection free (plain constructors + a Configuration object).

dependencies {
    implementation("io.github.maniramezan.kenwork:network-core:0.5.0") // KMP
    implementation("io.github.maniramezan.kenwork:network:0.3.0")
    implementation("io.github.maniramezan.kenwork:cache:0.3.0")        // optional
    implementation("io.github.maniramezan.kenwork:repository:0.3.0")   // optional
    implementation("io.github.maniramezan.kenwork:mutations:0.3.0")    // optional
    testImplementation("io.github.maniramezan.kenwork:testing:0.3.0")  // optional
}

network-core targets Android (minimum SDK 26), JVM/Desktop (JDK 17 bytecode), and iOS device and Apple Silicon simulator. The established network, cache, repository, mutations, and testing artifacts remain Android/JVM libraries.

import io.github.maniramezan.kenwork.network.HttpMethod
import io.github.maniramezan.kenwork.network.NetworkClient
import io.github.maniramezan.kenwork.network.NetworkClientConfiguration
import io.github.maniramezan.kenwork.network.NetworkEndpoint
import io.github.maniramezan.kenwork.network.OAuthAuthorizationProvider
import kotlinx.serialization.Serializable

// 1. Describe an endpoint.
data class GetVideo(val id: Int) : NetworkEndpoint {
    override val baseUrl = "https://api.example.com"
    override val path = "v1/videos/$id"
    override val method = HttpMethod.GET
}

@Serializable
data class Video(val id: Int, val title: String)

// 2. Build a client (optionally with an auth provider).
val client = NetworkClient(
    NetworkClientConfiguration(
        authorizationProvider = OAuthAuthorizationProvider(
            initialAccessToken = currentToken,
            refreshTokenHandler = { refreshAccessToken() },
        ),
    ),
)

// 3. Make type-safe requests from a coroutine.
suspend fun loadVideo(): Video = client.request(GetVideo(id = 42))

A 401 automatically triggers a single coalesced token refresh and one retry.

• Type-safe NetworkEndpoint with sensible defaults.
• Coroutine NetworkClient with reified request<T>() / request<B, T>(body).
• Pluggable AuthorizationProvider; OAuthAuthorizationProvider does coalesced 401 refresh-and-retry.
• Pluggable RetryPolicy — DefaultRetryPolicy retries timeouts, lost connectivity, 429, and 5xx with jittered exponential backoff, honors Retry-After, and retries idempotent methods only by default. Use RetryPolicy.None to disable, or supply your own.
• Reachability-aware retry — give the client a ReachabilityGate (e.g. networkMonitor.asReachabilityGate()) and retries park while offline, resuming when the network returns instead of burning attempts.
• Closed NetworkError set (Unauthorized, Forbidden, NotFound, ServerError, Timeout, NoInternetConnection, DecodingFailed, …).
• Caching: InMemoryCache (LRU + expiry), FileSystemCache (durable PersistentCache), LayeredCache (memory + persistent with timestamp promotion), CachePolicy.
• GenericRepository coordinating network + cache with write-through, single-flight load coalescing, and a reactive stream() that re-emits on cache changes (offline-first).
• NetworkMonitor connectivity (StateFlow), OkHttp SslPinningConfiguration, KenworkLogger, and a NetworkEventListener telemetry hook (with per-attempt retry events).

• ARCHITECTURE.md — layering & concurrency model.
• docs/cookbook.md — task-oriented recipes.
• docs/parity.md — SwiftyNetwork ↔ kenwork mapping.
• MIGRATION.md — moving an existing Ktor/auth layer onto kenwork.
• docs/release.md — how releases reach Maven Central.
• API reference (Dokka): published to GitHub Pages on pushes to main.

MIT — see LICENSE.