evolution 0.1.1

Bug fixes

• Defined the null-coalescing operator %||% internally. It was used by .evo_post() and send_contact() but is only part of base R since 4.4.0, so the package failed to load on R 4.2–4.3 (the declared minimum is R 4.2.0).

• send_*() functions now normalise the recipient number, stripping formatting characters (spaces, dashes, parentheses and a leading +) before the request. Previously a number such as "+5581999990000" was sent verbatim and could be rejected by the API, even though it was shown as valid in the documentation. JIDs (values containing @, e.g. group ids ...@g.us) are passed through unchanged.

• .normalize_media() no longer silently treats a mistyped file path as base64. It now requires standard (padded) base64 and emits a path-aware error pointing at the resolved location when a file is not found.

• Corrected the copyright holder in LICENSE, which still referenced an unrelated package.

Documentation

• Unified the API reference URL across README and DESCRIPTION (https://evoapicloud.com).

• Removed a dead “apikey” redaction branch in the verbose logger (the API key is only ever sent as a header, never in the request body).

Internal

• Added a testthat suite covering the offline helpers (jid(), .normalize_media(), .compact(), .evo_path(), .assert_scalar_string()) and the argument-validation guard clauses of the exported send_*() functions and evo_client().

• Added .Rhistory and .DS_Store to .Rbuildignore.

evolution 0.1.0

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).

evolution 0.0.1

• 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.