@ultimat3/mail 11.1.0 → 11.3.0

package/CLAUDE.md

@@ -51,8 +51,13 @@
   while its own `cause` said retrying cannot help. `errors.test.ts` asserts it through the QUEUE's
   `nextRetryForError`, never against the table.
   `stage` is the `SendStage` union in `errors.ts`; a new step goes there first.
-  The transient set is 4xx over SMTP, and 408/409/425/429 + 5xx over HTTP — that HTTP set
-  lives in `RETRYABLE_STATUSES` (`driver-resend.ts`) and is edited there, never restated.
+  The transient set is 4xx over SMTP, and 408/409/425/429 + 5xx over HTTP — the HTTP half is
+  `isRetryableStatus` in **`@ultimat3/core`** (`retryable-status.ts`), `As of 2026-08-23`, and is
+  edited there. It was a private `RETRYABLE_STATUSES` in `driver-resend.ts` that was byte-identical
+  to `packages/cache/src/purge-http.ts`'s, in two packages that cannot import each other — so one
+  of the two was always going to be edited alone. Never restate it here.
+  `driver-resend.test.ts`'s "every status maps to the same retryable verdict" pins the whole table
+  through the driver, so the answer cannot move under this package without a failing test.
 - A transport is selected from the environment by `selectMailDriver`, never from an `app.config.ts`
   field — nothing loads that file's contents at runtime, so a `mail:` config block would be a
   setting no boot could read. Two credentials at once is refused, not resolved: mail leaving by

package/README.md

@@ -93,7 +93,7 @@ with STARTTLS. Credentials are percent-decoded, so a password with `@` or `/` wo
 
 `RESEND_API_KEY` and a verified sending domain. Every request carries `Idempotency-Key:
 mailIdempotencyKey(message)` — a job retry after a timeout hands Resend the identical message, and
-that header is what makes it one email. 408/409/425/429 and 5xx are retryable; every other non-2xx
+that header is what makes it one email. 408/409/425/429 and 5xx are retryable (`isRetryableStatus`, `@ultimat3/core`); every other non-2xx
 is a configuration problem that retrying cannot fix.
 
 ## Framework mails

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/mail",
-  "version": "11.1.0",
+  "version": "11.3.0",
   "description": "Transactional email as data: one template renders HTML and text, sent through a job.",
   "license": "MIT",
   "type": "module",
@@ -31,10 +31,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "11.1.0",
-    "@ultimat3/i18n": "11.1.0",
-    "@ultimat3/jobs": "11.1.0",
-    "@ultimat3/schema": "11.1.0",
-    "@ultimat3/time": "11.1.0"
+    "@ultimat3/core": "11.3.0",
+    "@ultimat3/i18n": "11.3.0",
+    "@ultimat3/jobs": "11.3.0",
+    "@ultimat3/schema": "11.3.0",
+    "@ultimat3/time": "11.3.0"
   }
 }

package/src/driver-resend.ts

@@ -5,6 +5,11 @@
 import {
   ConfigInvalidError,
   EnvMissingError,
+  // The status table is core's: this package's copy and `packages/cache/src/purge-http.ts`'s were
+  // byte-identical in two packages that cannot import each other, so one was always going to be
+  // edited alone. A throttle or a transient conflict can land unchanged; every other 4xx here is a
+  // config problem no retry fixes.
+  isRetryableStatus,
   logger,
   nanoid,
   renderThrowable,
@@ -22,10 +27,6 @@ export type MailFetch = (input: string, init: RequestInit) => Promise<Response>;
 const DEFAULT_TIMEOUT_MS = 15_000;
 const MAX_DETAIL_LENGTH = 200;
 
-// A 4xx here means the same request, unchanged, might land: a throttle or a momentary
-// conflict. Every other 4xx is a config problem retrying cannot fix.
-const RETRYABLE_STATUSES = new Set([408, 409, 425, 429]);
-
 export interface ResendDriverOptions {
   /** Read from `RESEND_API_KEY`. A literal key in app.config.ts is a key in git. */
   readonly apiKey: string;
@@ -55,11 +56,6 @@ function requireFrom(from: string): string {
   });
 }
 
-/** `retryable` for a throttle or a transient conflict; everything else is a config problem. */
-function isRetryableStatus(status: number): boolean {
-  return status >= 500 || RETRYABLE_STATUSES.has(status);
-}
-
 function fixFor(status: number): string {
   if (status === 401 || status === 403) {
     return 'set RESEND_API_KEY to a current key from https://resend.com/api-keys, then retry';