@spec allow_auto_topic_creation?(Keyword.t()) :: boolean()

Checks if auto topic creation should be enabled.

@spec build_topics_list(Keyword.t()) :: [%{name: String.t()}] | nil

Extracts and normalizes topics list from options.

Wraps plain string topics as %{name: topic} maps, which is the format Kayrock's serializer expects for all Metadata API versions.

@spec build_v8_plus_request(map(), Keyword.t()) :: map()

Builds a V8+ Metadata request with authorized operations fields.

V8 adds include_cluster_authorized_operations and include_topic_authorized_operations. V9 uses the same fields with compact encoding (handled by Kayrock).

@spec default_api_version() :: 0 | 1 | 2

Returns the default API version for Metadata requests.