Kotlin Multiplatform network inspection and mocking SDK. Intercept HTTP and WebSocket traffic, mock API responses, and throttle requests — no proxy server needed.

wiretap-urlsession is a dedicated Swift wrapper exported as an XCFramework via KMMBridge/SPM.

• API Mocking — Return fake responses without hitting the network. Match on method, URL, headers, and body.
• Request Throttling — Add artificial delay with fixed or random ranges.
• HTTP Logging — Capture URL, method, headers, bodies, status codes, duration, TLS details (OkHttp).
• WebSocket Logging — Full lifecycle tracking with message capture for Ktor and OkHttp.
• Header Masking — Keep, mask, or skip headers from logs.
• Log Retention — Forever, per app session, or time-based auto-pruning.
• Built-in Inspector UI — Compose Multiplatform UI for browsing logs, WebSocket streams, and managing rules.
• No-op Variants — Drop-in release replacements with zero overhead.

WiretapKMP is published to Maven Central.

In your settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        mavenCentral()
        google()
    }
}

dependencies {
    // Debug
    debugImplementation("dev.skymansandy:wiretap-ktor:1.0.0-RC3")
    // Release (no-op)
    releaseImplementation("dev.skymansandy:wiretap-ktor-noop:1.0.0-RC3")
}

dependencies {
    // Debug
    debugImplementation("dev.skymansandy:wiretap-okhttp:1.0.0-RC3")
    // Release (no-op)
    releaseImplementation("dev.skymansandy:wiretap-okhttp-noop:1.0.0-RC3")
}

Add the WiretapURLSession SPM package, then use #if DEBUG to disable in release:

#if DEBUG
let interceptor = WiretapURLSessionInterceptor(session: .shared) { config in
    config.enabled = true
}
#else
let interceptor = WiretapURLSessionInterceptor(session: .shared) { config in
    config.enabled = false
}
#endif

val client = HttpClient {
    install(WiretapKtorPlugin) {
        enabled = true
        logRetention = LogRetention.Days(7)
    }
    install(WiretapKtorWebSocketPlugin)
}

val client = OkHttpClient.Builder()
    .addInterceptor(
        WiretapOkHttpInterceptor {
            enabled = true
            logRetention = LogRetention.Days(7)
        }
    )
    .build()

let interceptor = WiretapURLSessionInterceptor(session: .shared) { config in
    config.enabled = true
    config.logRetention = LogRetention.Days(days: 7)
}

interceptor.intercept(request: request) { data, response, error in
    // handle response
}

Swap dependencies for release builds — no conditional code needed.

For URLSession, use config.enabled = false with #if DEBUG (see installation above).

Full documentation

Copyright 2025 skymansandy

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.