Changes in version 0.1.0 (2026-02-27)                  

Breaking changes

  - The global timeout option was renamed from evoapi.timeout to
    evolution.timeout to match the package name. The previous option
    name was silently ignored due to a mismatch between zzz.R and the
    internal request function (#1).

New features

  - send_list(): sends interactive list messages with sections and
    selectable rows, mapping to the Evolution API v2 sendList endpoint.

  - check_is_whatsapp(): verifies whether phone numbers are registered
    on WhatsApp via the chat/whatsappNumbers endpoint.

  - print.evo_client(): new S3 print method that displays instance name
    and base URL when inspecting a client object.

Improved error handling

  - .evo_post() now extracts and surfaces the actual API error message
    from the JSON response body (fields response$message or message),
    instead of showing a generic "Evolution API error (status)" string.

  - Non-JSON error responses (e.g., HTML from a 502/503 gateway error)
    are now handled gracefully instead of crashing with a parse error.

  - All send_*() functions now validate required arguments up front with
    clear {cli} error messages (e.g., "'number' must be a single
    non-empty character string").

  - evo_client() uses descriptive cli::cli_abort() messages instead of
    stopifnot(), with hints like "Use Sys.getenv(\"EVO_APIKEY\")" for
    the API key argument.

Improved logging (verbose mode)

  - Verbose output now includes response timing (e.g., ✔ HTTP 201
    (0.34s)).

  - Verbose output now shows a preview of the response body (first 500
    characters) to help with debugging.

  - Large base64 media fields are truncated in verbose logs to keep
    output readable.

Bug fixes

  - jid() now strips all non-digit characters (including +) before
    appending @s.whatsapp.net. Previously, jid("+5581...") produced an
    invalid JID with the + preserved.

  - send_list(): footer parameter now defaults to "" instead of NULL,
    because the Evolution API requires footerText to be present in the
    request body (HTTP 400 otherwise).

  - send_sticker() and send_whatsapp_audio() now pass media through
    .normalize_media(), enabling local file paths (e.g.,
    "~/Downloads/sticker.webp") to be auto-encoded to base64. Previously
    only send_media() supported this.

  - .normalize_media() now calls path.expand() so that ~ in file paths
    is correctly resolved to the user's home directory.

  - send_whatsapp_audio() removed unused parameters (link_preview,
    mentions_everyone, mentioned) that are not part of the
    sendWhatsAppAudio API endpoint.

  - send_buttons() now emits a cli::cli_warn() at runtime alerting that
    interactive buttons are not supported on the Baileys (WhatsApp Web)
    connector and may be discontinued. The warning suggests send_poll()
    as an alternative.

  - send_list() now emits a cli::cli_warn() at runtime alerting that
    interactive list messages are not supported on the Baileys (WhatsApp
    Web) connector and may be discontinued. The warning suggests
    send_poll() as an alternative.

Documentation

  - Fixed author name typo in DESCRIPTION: "Vaconcelos" → "Vasconcelos".

  - README now accurately lists all exported functions including
    send_list() and check_is_whatsapp().

  - README includes new sections: verbose output example, configuration
    table, and send_list() / check_is_whatsapp() usage examples.

  - All roxygen documentation improved with @description, @examples,
    @seealso cross-references, and more specific @return descriptions.

  - Added jsonlite to Imports (used for response preview in verbose
    mode).

                 Changes in version 0.0.1 (2025-11-20)                  

  - Initial CRAN release.
  - Core messaging functions: send_text(), send_status(), send_media(),
    send_whatsapp_audio(), send_sticker(), send_location(),
    send_contact(), send_reaction(), send_buttons(), send_poll().
  - evo_client() factory with httr2 retry and apikey header.
  - jid() helper for building WhatsApp JIDs.