@beignet/provider-mail-smtp 0.0.32 → 0.0.33

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @beignet/provider-mail-smtp
 
+## 0.0.33
+
+### Patch Changes
+
+- 92af951: Document and test the provider resilience baseline: mail providers fail fast
+  without provider-owned retries, while S3 delegates bounded retries to the AWS
+  SDK or caller-owned injected clients.
+
 ## 0.0.32
 
 ### Patch Changes

package/README.md

@@ -121,9 +121,10 @@ When `ctx.ports.devtools` is installed, this provider records `mail.send`,
 
 ## Failure and retry semantics
 
-The provider fails fast and does not retry. Mail delivery is not idempotent: a
-timed-out send may still have been delivered, so a blind provider retry risks
-duplicate emails.
+The provider fails fast and does not retry. Each `send(...)` call makes one
+Nodemailer `sendMail(...)` call, even for transient network errors or
+provider-side failures. Mail delivery is not idempotent: a timed-out send may
+still have been delivered, so a blind provider retry risks duplicate emails.
 
 Delivery failures throw `MailDeliveryError` from `@beignet/core/mail` with the
 provider name, the recipient count, and the original SMTP error preserved as
@@ -135,8 +136,9 @@ failing the first send. Startup configuration problems also throw during
 provider setup.
 
 When mail needs retries, dispatch it from a job or an outbox-backed listener
-and own idempotency there, for example by recording one delivery per business
-event before sending.
+and own idempotency there. The job or outbox row should choose attempts and
+delay, and the application should record one delivery per business event before
+sending.
 
 ## Local and tests
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-mail-smtp",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "type": "module",
   "description": "SMTP mail provider for Beignet - adds mailer port using nodemailer",
   "main": "./dist/index.js",