@spec check_response(map()) :: {:ok, map()} | {:error, term()}

Check an API response for error codes and return a normalized result.

Examples

{:ok, data} = response |> Geofox.Utils.ErrorHandler.check_response()
{:error, reason} = response |> Geofox.Utils.ErrorHandler.check_response()

@spec extract_data!(map()) :: map()

Extract data from a successful API response, raising on errors.

Useful for pipeline operations where you want to fail fast on API errors.

@spec handle_response({:ok, map()} | {:error, term()}) ::
  {:ok, map()} | {:error, term()}

Handle Tesla/HTTP client responses (used internally by Client module).