CountryDetector

Resolves the user's likely country.

A fun interface so a host can supply one inline — commonly to add a backend/IP lookup ahead of the device signals:

val detector = CountryDetector {
    api.geoCountry()?.let { CountryDetectionResult.detected(it, CountryDetectionSource.Network) }
        ?: DefaultCountryDetector(context).detectCountry()
}

Rules the library relies on

• No location permission. Country-level detection never justifies a runtime permission prompt; SIM, network and locale are enough. Implementations must not request one.

• Never called from composition. detectCountry is suspend and is invoked from a LaunchedEffect, so a network-backed implementation is free to block for as long as it needs.

• Detection is a suggestion, not a command. An explicit user selection always outranks a detection result; see com.ezzy.ccp.countrypicker.state.CountryPickerState.

Inheritors