Why is StringValuesBuilder marked as @InternalAPI? It's used in Headers#build which is a public API

Because they don't want you to use the StringValuesBuilder directly externally, they want you to use the

HeadersBuilder

HeadersBuilder

also counts as @InternalAPI

yep, and with Kotlin 1.5.30-M1 I’m getting compilation errors when I use

append

in

HeadersBuilder

closure because of that.

@Nikolay Kasyanov I think it's intended behavior. You can add

@OptIn(InternalAPI::class)

annotation to make an error go away. Btw,

InternalAPI

annotation will be removed in version 2.0.0.

@Aleksei Tirman [JB] Isn't it a breaking change? Are you sure they can just release it like it's nothing?

@Aleksei Tirman [JB] to clarify, are clients not supposed to use

Headers.build

at all? 🤔

It will stay wihout

InternalAPI

annotation, e.g. StringValuesBuilder.