@asd20/ui-next 2.31.7 → 2.31.8

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.31.8](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.31.7...ui-next-v2.31.8) (2026-10-12)
+
+
+### Bug Fixes
+
+* refine 'send an email' functionality - help text, failure messaging, rate limits, spam detection ([a9c4a28](https://github.com/academydistrict20/asd20-ui-next/commit/a9c4a28f1fdab4c0c551aa2cfb6808fbc29742d2))
+
 ## [2.31.7](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.31.6...ui-next-v2.31.7) (2026-10-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asd20/ui-next",
-  "version": "2.31.7",
+  "version": "2.31.8",
   "private": false,
   "description": "ASD20 UI component library for Vue 3.",
   "license": "MIT",

package/src/components/organisms/Asd20ComposeEmailModal/index.vue

@@ -41,7 +41,7 @@
         :validator="validateMessageBody"
         label="Message"
         maxlength="8000"
-        help-text="Please enter at least 5 characters."
+        :help-text="messageHelpText"
         required
         @validated="validationErrors.messageBody = $event"
       />
@@ -124,6 +124,8 @@ import Asd20Button from '../../atoms/Asd20Button'
 import Recaptcha from '../../utils/Recaptcha'
 import sendEmail from '../../../helpers/sendEmail.js'
 
+const MIN_MESSAGE_LENGTH = 10
+
 export default {
   name: 'Asd20ComposeEmailModal',
   components: {
@@ -161,6 +163,11 @@ export default {
     },
   }),
   computed: {
+    messageHelpText() {
+      return String(this.emailMessage.messageBody || '').trim().length < MIN_MESSAGE_LENGTH
+        ? 'Please provide more detail.'
+        : ''
+    },
     modalTitle() {
       return 'Send an Email'
     },
@@ -228,8 +235,8 @@ export default {
     },
     validateMessageBody({ value, validationErrors }) {
       const message = String(value || '').trim()
-      if (message && message.length < 5)
-        validationErrors.push('The message must be at least 5 characters.')
+      if (message && message.length < MIN_MESSAGE_LENGTH)
+        validationErrors.push('Please provide more detail.')
       return validationErrors
     },
     getFormValidationMessages() {
@@ -247,8 +254,8 @@ export default {
         messages.push('Enter a valid email address.')
       if (!subject) messages.push('A subject is required.')
       if (!messageBody) messages.push('A message is required.')
-      else if (messageBody.length < 5)
-        messages.push('The message must be at least 5 characters.')
+      else if (messageBody.length < MIN_MESSAGE_LENGTH)
+        messages.push('Please provide more detail.')
 
       return messages
     },
@@ -304,11 +311,25 @@ export default {
       const statusMatch = String(error?.message || '').match(/\b(\d{3})\b/)
       return statusMatch ? Number(statusMatch[1]) : null
     },
+    isDeliveryUnconfirmed(error) {
+      return this.getSendEmailResponseData(error)?.code === 'delivery_unconfirmed' || this.getSendEmailErrorStatus(error) === null
+    },
     getSendEmailFailureMessage(error) {
+      if (this.isDeliveryUnconfirmed(error)) {
+        return "We couldn't confirm that your message was sent. Please check with the school before sending it again."
+      }
       if (this.getSendEmailErrorStatus(error) === 429) {
+        const response = this.getSendEmailResponseData(error)
+        if (response?.code === 'rate_limited' && typeof response.error === 'string' && response.error.trim()) {
+          return response.error
+        }
         return 'We could not send your message right now. Please wait and try again later.'
       }
 
+      const response = this.getSendEmailResponseData(error)
+      if (['captcha_failed', 'email_unavailable'].includes(response?.code) && typeof response.error === 'string' && response.error.trim()) {
+        return response.error
+      }
       return 'Something went wrong while sending your email. Please try again later.'
     },
     getSendEmailResponseData(error) {
@@ -341,7 +362,7 @@ export default {
           'Enter a valid email address.',
         'messageBody is required.': 'A message is required.',
         'messageBody is too short.':
-          'The message must be at least 5 characters.',
+          'Please provide more detail.',
         'messageBody is too long.':
           'The message must be 8,000 characters or fewer.',
         'Recipient was not found or does not have a public email address.':
@@ -374,15 +395,18 @@ export default {
           response?.code === 'moderation_unavailable'
             ? 'Email temporarily unavailable'
             : 'Message not sent',
-          response?.error ||
-            "We couldn't send your message through this form. For assistance contacting the appropriate staff member, please contact the Academy District 20 Help Desk at help@asd20.org or 719-234-1777.",
+          typeof response?.error === 'string' && response.error.trim()
+            ? response.error
+            : response?.code === 'moderation_unavailable'
+              ? "We couldn't send your message right now. Please try again later. If the problem persists, please contact the Academy District 20 Help Desk at help@asd20.org or 719-234-1777."
+              : 'Your message could not be sent through this form.',
           reference
         )
         return
       }
 
       this.showFeedback(
-        'Email not sent',
+        this.isDeliveryUnconfirmed(error) ? 'Delivery not confirmed' : 'Email not sent',
         this.getSendEmailFailureMessage(error),
         []
       )