Module helpers 

Pure helpers: longpoll category derivation, callback parsing, return-URL builder. No HTTP or SDK state.

Functions

add_return_to_url

Append ?return=<metadata> (or merge as &return=) to a callback URL.

derive_longpoll_category

Compute the 9-char longpoll category locally from (api_token, radio_id).

handle_callback

Parse raw callback POST bytes into a typed CallbackEvent.

parse_callback

Parse an already-deserialized JSON callback body into a typed CallbackEvent.