formcord

Updates

Changelog

Keep track of new features, bug fixes, and API changes.

v2.2.0

July 2026
  • NEW: Notification methods now return a success status so applications can handle an unsuccessful Discord delivery without enabling exceptions.
  • NEW: File validation messages now use readable byte, KB, MB, and GB units.
  • DOCS: Added delivery-status guidance and throwOnError debugging instructions.

v2.1.1

July 2026
  • NEW: Added automatic normalization for standard browser/runtime File and Blob objects directly inside validateFiles (no upfront manual mapping required).
  • NEW: Added "batch_rejected" to validation error reasons when using all-or-nothing validation (ignoreInvalid: false).
  • NEW: Added strict type checking for unrecognized file formats (triggers "invalid_file_type" reason).
  • FIX: Filtered out null/undefined elements from file arrays to prevent TypeError crashes.
  • FIX: Optimized batch validation performance by using push instead of unshift.

v2.1.0

July 2026
  • NEW: Added native file upload and media attachment support (PDFs, logs, images, and text content) using standard Web APIs.
  • NEW: Added a standalone validateFiles helper function to easily run file size/count checks or custom validation rules.
  • NEW: Supports human-readable size limits (e.g. "25mb", "2mb") in the validation helper.
  • FIX: Refined deprecation warnings to avoid false warnings on valid V2 text/attachment sends.

v2.0.1

May 2026
  • FIX: Added runtime deprecation warning for v1.x syntax (theme, content) to help users smoothly migrate to the V2 data API without silent failures.

v2.0.0

May 2026

BREAKING CHANGE: Standardized field naming across the board. To eliminate confusion between top-level text, embed styling, and form fields, we introduced a strict hierarchical API.

  • content is now text.
  • theme is now embed.
  • All arbitrary parameters like subject, email, and message must be placed inside the data object.
  • NEW: Introduced a unified formcord.send() method for fully custom notifications.
  • NEW: The data property automatically transforms arbitrary key-value pairs into beautifully formatted Discord embed fields (up to Discord's 25 field limit).

v1.0.0

Early 2026
  • Initial release.
  • Universal Discord notifications using standard Web APIs.
  • Included 5 core helpers: contact, error, deploy, feedback, and bug.