Skip to content

NEWS.md

Latest commit

 

History

History
146 lines (103 loc) · 5.47 KB

NEWS.md

File metadata and controls

146 lines (103 loc) · 5.47 KB

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.