Refactor: libcrmcommon: Best practices for decompress_file()

Be stricter about error-checking bz2 functions using the provided error
codes. Add doxygen. Reduce duplication. Limit scope of read_len
variable.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>