bridge-swift

Bridge Swift

Kotlin interface in iosMain → Swift implements it in iosApp → Inject via Koin DI.

Architecture Reference: @../_shared/patterns.md

When you arrive here

This skill is the iOS-Swift leg of the Rule 14 platform path (@../create-feature/architecture/platform.md). Reach it when a feature's iOS actual can't be written cleanly in Kotlin/Native and needs a Swift class. /create-feature and /modify-feature finish the Kotlin side (the commonMain interface + Android/desktop actuals + expect/actual val platformModule) and then route the user here — they never call this skill directly. Android almost never needs a bridge (Kotlin calls the Android SDK directly), so this is iOS-specific. The Provider-wraps-bridge-in-Either<T> pattern below is the same DataSource contract platform.md describes.

Critical: Swift Inheritance

Swift class inherits from <ModulePrefix><InterfaceName>:

Module	Kotlin	Swift Inherits
core:data	RecaptchaBridge	DataRecaptchaBridge
feature:auth	AuthBridge	AuthAuthBridge

Use Xcode autocomplete (Ctrl+Space) to find exact protocol name.

Implementation Steps

1. Bridge Interface (iosMain)

// <module>/src/iosMain/kotlin/{PKG_PREFIX}/<feature>/<Feature>Bridge.kt
interface <Feature>Bridge {
    suspend fun execute(param: String): String
}

2. Provider (iosMain)

// <module>/src/iosMain/kotlin/{PKG_PREFIX}/<feature>/IOS<Feature>Provider.kt
class IOS<Feature>Provider(private val bridge: <Feature>Bridge) : <Feature>Provider {
    override suspend fun execute(): Either<String> =
        try { Either.Success(bridge.execute("param")) }
        catch (e: Exception) { Either.Failure(ErrorModel.Exception(e)) }
}

3. Swift Implementation (iosApp)

// iosApp/iosApp/<Feature>/<Feature>BridgeImpl.swift
import ComposeApp

class <Feature>BridgeImpl: <ModulePrefix><Feature>Bridge {
    func execute(param: String, completionHandler: @escaping (String?, Error?) -> Void) {
        Task {
            do { completionHandler(try await nativeOperation(param), nil) }
            catch { completionHandler(nil, error) }
        }
    }
}