@usejunior/email-core 0.1.11 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/dist/actions/compose-helpers.d.ts +14 -0
  2. package/dist/actions/compose-helpers.d.ts.map +1 -1
  3. package/dist/actions/compose-helpers.js +27 -5
  4. package/dist/actions/compose-helpers.js.map +1 -1
  5. package/dist/actions/draft.d.ts +4 -2
  6. package/dist/actions/draft.d.ts.map +1 -1
  7. package/dist/actions/draft.js +25 -8
  8. package/dist/actions/draft.js.map +1 -1
  9. package/dist/actions/read.d.ts +1 -1
  10. package/dist/actions/registry.d.ts +1 -3
  11. package/dist/actions/registry.d.ts.map +1 -1
  12. package/dist/actions/registry.js +52 -10
  13. package/dist/actions/registry.js.map +1 -1
  14. package/dist/actions/reply.d.ts +2 -1
  15. package/dist/actions/reply.d.ts.map +1 -1
  16. package/dist/actions/reply.js +14 -5
  17. package/dist/actions/reply.js.map +1 -1
  18. package/dist/actions/send.d.ts +2 -1
  19. package/dist/actions/send.d.ts.map +1 -1
  20. package/dist/actions/send.js +16 -5
  21. package/dist/actions/send.js.map +1 -1
  22. package/dist/index.d.ts +3 -0
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +2 -0
  25. package/dist/index.js.map +1 -1
  26. package/dist/metrics.d.ts +8 -0
  27. package/dist/metrics.d.ts.map +1 -0
  28. package/dist/metrics.js +26 -0
  29. package/dist/metrics.js.map +1 -0
  30. package/dist/providers/provider.d.ts +104 -0
  31. package/dist/providers/provider.d.ts.map +1 -1
  32. package/dist/providers/provider.js +197 -7
  33. package/dist/providers/provider.js.map +1 -1
  34. package/dist/scope-profile.d.ts.map +1 -1
  35. package/dist/scope-profile.js +21 -3
  36. package/dist/scope-profile.js.map +1 -1
  37. package/package.json +1 -1
  38. package/dist/actions/configure.d.ts +0 -36
  39. package/dist/actions/configure.d.ts.map +0 -1
  40. package/dist/actions/configure.js +0 -112
  41. package/dist/actions/configure.js.map +0 -1
  42. package/dist/actions/status.d.ts +0 -27
  43. package/dist/actions/status.d.ts.map +0 -1
  44. package/dist/actions/status.js +0 -90
  45. package/dist/actions/status.js.map +0 -1
@@ -9,8 +9,8 @@ declare const SendEmailInput: z.ZodObject<{
9
9
  mailbox: z.ZodOptional<z.ZodString>;
10
10
  draft: z.ZodOptional<z.ZodBoolean>;
11
11
  format: z.ZodOptional<z.ZodEnum<{
12
- text: "text";
13
12
  html: "html";
13
+ text: "text";
14
14
  markdown: "markdown";
15
15
  }>>;
16
16
  force_black: z.ZodOptional<z.ZodBoolean>;
@@ -57,6 +57,7 @@ declare const SendEmailOutput: z.ZodObject<{
57
57
  recoverable: z.ZodBoolean;
58
58
  availableMailboxes: z.ZodOptional<z.ZodArray<z.ZodString>>;
59
59
  defaultMailbox: z.ZodOptional<z.ZodString>;
60
+ retryAfter: z.ZodOptional<z.ZodNumber>;
60
61
  }, z.core.$strip>>;
61
62
  }, z.core.$strip>;
62
63
  export declare const sendEmailAction: EmailAction<z.infer<typeof SendEmailInput>, z.infer<typeof SendEmailOutput>>;
@@ -1 +1 @@
1
- {"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/actions/send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAyBjD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAelB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcnB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAAW,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,EAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CA8LhC,CAAC"}
1
+ {"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/actions/send.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwBjD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAelB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAenB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAAW,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,EAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAsMhC,CAAC"}
@@ -2,7 +2,6 @@
2
2
  import { z } from 'zod';
3
3
  import { checkSendAllowlist } from '../security/send-allowlist.js';
4
4
  import { checkReplyThreading } from '../security/reply-validation.js';
5
- import { withRetry } from '../providers/provider.js';
6
5
  import { truncateBody, BODY_SIZE_LIMIT } from '../content/body-loader.js';
7
6
  import { renderEmailBody } from '../content/body-renderer.js';
8
7
  import { ScheduledSendAtSchema, scheduledSendNotSupportedError, validateScheduledSendAt, } from './scheduling.js';
@@ -36,11 +35,12 @@ const SendEmailOutput = z.object({
36
35
  recoverable: z.boolean(),
37
36
  availableMailboxes: z.array(z.string()).optional(),
38
37
  defaultMailbox: z.string().optional(),
38
+ retryAfter: z.number().optional(),
39
39
  }).optional(),
40
40
  });
41
41
  export const sendEmailAction = {
42
42
  name: 'send_email',
43
- description: 'Compose and send a new email. Gated by send allowlist. Draft mode bypasses allowlist.',
43
+ description: 'Compose and send a new email. Gated by send allowlist. Draft mode bypasses allowlist. If a send fails with SEND_STATUS_UNKNOWN, the message may already have been delivered; do not resend without checking Sent Items.',
44
44
  input: SendEmailInput,
45
45
  output: SendEmailOutput,
46
46
  annotations: { readOnlyHint: false, destructiveHint: false },
@@ -181,6 +181,7 @@ export const sendEmailAction = {
181
181
  code: result.error.code,
182
182
  message: result.error.message,
183
183
  recoverable: result.error.recoverable,
184
+ ...(typeof result.error.retryAfter === 'number' ? { retryAfter: result.error.retryAfter } : {}),
184
185
  } : undefined,
185
186
  };
186
187
  }
@@ -188,9 +189,14 @@ export const sendEmailAction = {
188
189
  return handleProviderError(err, 'SCHEDULE_SEND_FAILED');
189
190
  }
190
191
  }
191
- // Immediate send with retry on transient errors
192
+ // Immediate send — exactly one provider attempt. Graph /sendMail (and
193
+ // Gmail messages.send) are non-idempotent POSTs with no idempotency key:
194
+ // a timeout or 5xx after the provider accepted the message is
195
+ // indistinguishable from a pre-acceptance failure, so an automatic retry
196
+ // can silently deliver duplicates. Fail fast and surface the structured
197
+ // error instead (mirrors the scheduled-send branch above).
192
198
  try {
193
- const result = await withRetry(() => ctx.provider.sendMessage(composeMessage), { maxRetries: 3, baseDelay: 1000 });
199
+ const result = await ctx.provider.sendMessage(composeMessage);
194
200
  if (ctx.rateLimiter) {
195
201
  ctx.rateLimiter.recordUsage('send_email');
196
202
  }
@@ -201,11 +207,16 @@ export const sendEmailAction = {
201
207
  code: result.error.code,
202
208
  message: result.error.message,
203
209
  recoverable: result.error.recoverable,
210
+ ...(typeof result.error.retryAfter === 'number' ? { retryAfter: result.error.retryAfter } : {}),
204
211
  } : undefined,
205
212
  };
206
213
  }
207
214
  catch (err) {
208
- return handleProviderError(err, 'SEND_FAILED');
215
+ const handled = handleProviderError(err, 'SEND_STATUS_UNKNOWN');
216
+ if (ctx.rateLimiter && handled.error.code === 'SEND_STATUS_UNKNOWN') {
217
+ ctx.rateLimiter.recordUsage('send_email');
218
+ }
219
+ return handled;
209
220
  }
210
221
  },
211
222
  };
@@ -1 +1 @@
1
- {"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/actions/send.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SACpD,QAAQ,CAAC,oIAAoI,CAAC;IACjJ,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAChC,QAAQ,CAAC,mIAAmI,CAAC;IAChJ,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;SACnD,QAAQ,CAAC,0EAA0E,CAAC;IACvF,iBAAiB,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACtC,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;QACxB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAClD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAGxB;IACF,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,uFAAuF;IACpG,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,eAAe;IACvB,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;IAC5D,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACxB,8CAA8C;QAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;QAED,IAAI,eAAmC,CAAC;QACxC,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACnE,IAAI,OAAO,IAAI,SAAS;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5E,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,6BAA6B;wBACnC,OAAO,EAAE,0DAA0D;wBACnE,WAAW,EAAE,KAAK;qBACnB;iBACF,CAAC;YACJ,CAAC;YACD,eAAe,GAAG,SAAS,CAAC,KAAK,CAAC;QACpC,CAAC;QAED,uCAAuC;QACvC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9D,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAEtB,0DAA0D;QAC1D,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3E,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QACD,MAAM,WAAW,GAAG,SAAS,CAAC,KAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9E,uCAAuC;QACvC,MAAM,aAAa,GAAG,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAClD,CAAC;QAED,qBAAqB;QACrB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,CAAC,CAAC;QAElD,wEAAwE;QACxE,2EAA2E;QAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,0BAA0B;QAC1B,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAQ,CAAC,CAAC;QACrD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACnD,CAAC;QAED,yDAAyD;QACzD,uEAAuE;QACvE,uDAAuD;QACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,IAAI,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC5B,IAAI,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAEpC,uEAAuE;QACvE,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,CAAC;YAC1D,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,CAAC;YAC3F,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,GAAG,OAAO,CAAC;QAEf,uDAAuD;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjD,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,OAAQ;gBACjB,IAAI;gBACJ,QAAQ,EAAE,WAAW;gBACrB,WAAW;aACZ,CAAC,CAAC;YACH,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO;gBAC9D,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;gBAC5D,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,GAAG,aAAa;gBAChB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;oBACzB,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI;oBAC5B,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO;oBAClC,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW;iBAC3C,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,kBAAkB,GAAG;YACzB,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YAC1C,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACpD,CAAC;QACF,MAAM,cAAc,GAAG,kBAAkB,CAAC,kBAAkB,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;QACjF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE;aAClF,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACrE,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,MAAM,cAAc,GAAG;YACrB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,OAAQ;YACjB,IAAI;YACJ,QAAQ,EAAE,WAAW;YACrB,WAAW;SACZ,CAAC;QAEF,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe;gBAAE,OAAO,8BAA8B,EAAE,CAAC;YAC3E,IAAI,CAAC;gBACH,oEAAoE;gBACpE,mEAAmE;gBACnE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;gBACnF,IACE,GAAG,CAAC,WAAW;uBACZ,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,8BAA8B,CAAC,EAC5E,CAAC;oBACD,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;gBAC5C,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;wBACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;wBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;wBAC7B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;qBACtC,CAAC,CAAC,CAAC,SAAS;iBACd,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,mBAAmB,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,EAC9C,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CACnC,CAAC;YAEF,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;oBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;oBAC7B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;iBACtC,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF,CAAC"}
1
+ {"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/actions/send.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -5,10 +5,13 @@ export type { EmailScopeProfile } from './scope-profile.js';
5
5
  export type { EmailAddress, EmailMessage, EmailThread, EmailAttachment, ComposeMessage, OutboundAttachment, SendResult, ScheduledSend, ScheduledSendResult, DraftResult, EmailError, ListOptions, ReplyOptions, } from './types.js';
6
6
  export type { EmailReader, EmailSender, EmailScheduledSender, EmailSubscriber, EmailCategorizer, EmailAttachmentHandler, EmailFolder, EmailFolderManager, InboxRule, CreateInboxRule, EmailRuleManager, DownloadedAttachment, EmailProvider, AuthManager, DraftReplyStatus, } from './providers/provider.js';
7
7
  export { ProviderError, AttachmentNotSupportedError, AttachmentNotFoundError } from './providers/provider.js';
8
+ export { isProviderError, normalizeProviderError, classifyHttpStatus, classifyTransportError, parseRetryAfter, isRetryable, withRetry, SEND_STATUS_UNKNOWN, } from './providers/provider.js';
9
+ export type { OperationKind, DispatchStage, ClassifiedFailure } from './providers/provider.js';
8
10
  export { isAllowedSender, loadReceiveAllowlist, getReceiveAllowlistPath, checkDeletePolicy, getDeletePolicyFromEnv, } from './security/receive-allowlist.js';
9
11
  export type { DeletePolicy } from './security/receive-allowlist.js';
10
12
  export { isAllowedRecipient, loadSendAllowlist, getSendAllowlistPath, checkSendAllowlist, SendRateLimiter, } from './security/send-allowlist.js';
11
13
  export { WatchedAllowlist } from './security/watched-allowlist.js';
14
+ export { recordActionMetric, getMetrics, resetMetrics } from './metrics.js';
12
15
  export { htmlToMarkdown, transformEmailContent } from './content/sanitize.js';
13
16
  export { readEmailAction, READ_HTML_BODY_LIMIT } from './actions/read.js';
14
17
  export { sendEmailAction } from './actions/send.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -2,9 +2,11 @@
2
2
  export { EMAIL_ACTIONS } from './actions/registry.js';
3
3
  export { EMAIL_SCOPE_PROFILES, EMAIL_SCOPE_PROFILE_ENV, filterActionsForProfile, getEmailScopeProfile, isActionAllowedForProfile, profileBlockedActionError, } from './scope-profile.js';
4
4
  export { ProviderError, AttachmentNotSupportedError, AttachmentNotFoundError } from './providers/provider.js';
5
+ export { isProviderError, normalizeProviderError, classifyHttpStatus, classifyTransportError, parseRetryAfter, isRetryable, withRetry, SEND_STATUS_UNKNOWN, } from './providers/provider.js';
5
6
  export { isAllowedSender, loadReceiveAllowlist, getReceiveAllowlistPath, checkDeletePolicy, getDeletePolicyFromEnv, } from './security/receive-allowlist.js';
6
7
  export { isAllowedRecipient, loadSendAllowlist, getSendAllowlistPath, checkSendAllowlist, SendRateLimiter, } from './security/send-allowlist.js';
7
8
  export { WatchedAllowlist } from './security/watched-allowlist.js';
9
+ export { recordActionMetric, getMetrics, resetMetrics } from './metrics.js';
8
10
  export { htmlToMarkdown, transformEmailContent } from './content/sanitize.js';
9
11
  export { readEmailAction, READ_HTML_BODY_LIMIT } from './actions/read.js';
10
12
  export { sendEmailAction } from './actions/send.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAkC5B,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,iBAAiB,EAAE,eAAe;AAClC,kBAAkB,EAAE,gBAAgB;AACpC,kBAAkB,EAAE,gBAAgB;EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EAAE,mBAAmB;AACzC,qBAAqB,EAAE,oBAAoB;AAC3C,qBAAqB,EAAE,oBAAoB;EAC5C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAkC5B,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,SAAS,EACT,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,iBAAiB,EAAE,eAAe;AAClC,kBAAkB,EAAE,gBAAgB;AACpC,kBAAkB,EAAE,gBAAgB;EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EAAE,mBAAmB;AACzC,qBAAqB,EAAE,oBAAoB;AAC3C,qBAAqB,EAAE,oBAAoB;EAC5C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}
@@ -0,0 +1,8 @@
1
+ export declare function recordActionMetric(durationMs: number, isError: boolean): void;
2
+ export declare function getMetrics(): {
3
+ actions_total: number;
4
+ errors_total: number;
5
+ avg_latency_ms: number;
6
+ };
7
+ export declare function resetMetrics(): void;
8
+ //# sourceMappingURL=metrics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAI7E;AAED,wBAAgB,UAAU;;;;EAQzB;AAED,wBAAgB,YAAY,IAAI,IAAI,CAInC"}
@@ -0,0 +1,26 @@
1
+ const metricsStore = {
2
+ actionCount: 0,
3
+ errorCount: 0,
4
+ totalLatencyMs: 0,
5
+ };
6
+ export function recordActionMetric(durationMs, isError) {
7
+ metricsStore.actionCount++;
8
+ metricsStore.totalLatencyMs += durationMs;
9
+ if (isError)
10
+ metricsStore.errorCount++;
11
+ }
12
+ export function getMetrics() {
13
+ return {
14
+ actions_total: metricsStore.actionCount,
15
+ errors_total: metricsStore.errorCount,
16
+ avg_latency_ms: metricsStore.actionCount > 0
17
+ ? Math.round(metricsStore.totalLatencyMs / metricsStore.actionCount)
18
+ : 0,
19
+ };
20
+ }
21
+ export function resetMetrics() {
22
+ metricsStore.actionCount = 0;
23
+ metricsStore.errorCount = 0;
24
+ metricsStore.totalLatencyMs = 0;
25
+ }
26
+ //# sourceMappingURL=metrics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,OAAgB;IACrE,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3B,YAAY,CAAC,cAAc,IAAI,UAAU,CAAC;IAC1C,IAAI,OAAO;QAAE,YAAY,CAAC,UAAU,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,aAAa,EAAE,YAAY,CAAC,WAAW;QACvC,YAAY,EAAE,YAAY,CAAC,UAAU;QACrC,cAAc,EAAE,YAAY,CAAC,WAAW,GAAG,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,GAAG,YAAY,CAAC,WAAW,CAAC;YACpE,CAAC,CAAC,CAAC;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,YAAY,CAAC,WAAW,GAAG,CAAC,CAAC;IAC7B,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC;IAC5B,YAAY,CAAC,cAAc,GAAG,CAAC,CAAC;AAClC,CAAC"}
@@ -99,6 +99,96 @@ export declare class ProviderError extends Error {
99
99
  retryAfter?: number | undefined;
100
100
  constructor(code: string, message: string, provider: string, recoverable: boolean, retryAfter?: number | undefined);
101
101
  }
102
+ /**
103
+ * Structural guard for ProviderError.
104
+ *
105
+ * `instanceof` is NOT sufficient here. ProviderError is defined in email-core
106
+ * but constructed in the provider packages, which depend on email-core by
107
+ * semver range. A duplicate install (two copies of email-core in the tree)
108
+ * makes `err instanceof ProviderError` silently false, which would collapse
109
+ * every normalized provider error back into the caller's fallback code —
110
+ * reintroducing exactly the defect this normalization exists to fix, and doing
111
+ * it invisibly. `auth.ts` already carries the same structural fallback for
112
+ * GraphApiError for the same reason.
113
+ */
114
+ export declare function isProviderError(err: unknown): err is ProviderError;
115
+ /**
116
+ * What kind of operation produced an error. Delivery is called out separately
117
+ * because it is the only kind where re-issuing a request can duplicate a
118
+ * user-visible side effect (a sent email).
119
+ */
120
+ export type OperationKind = 'idempotent-read' | 'idempotent-write' | 'delivery';
121
+ /**
122
+ * Where a transport failure occurred relative to the request being written.
123
+ *
124
+ * `connect-failed` means we can PROVE no request bytes reached the origin, so
125
+ * the operation definitely did not happen. `dispatched-or-unknown` means the
126
+ * request may have been written and acted upon — for delivery that is the
127
+ * difference between "not sent" and "may have been sent".
128
+ *
129
+ * A third category — a purely local failure before any dispatch was attempted
130
+ * (payload construction, recipient parsing, attachment encoding) — is not
131
+ * represented here because it is enforced structurally: providers wrap ONLY
132
+ * the dispatch call, so construction errors never reach this function.
133
+ */
134
+ export type DispatchStage = 'connect-failed' | 'dispatched-or-unknown';
135
+ /**
136
+ * Classify a thrown transport error by walking the `cause` chain.
137
+ *
138
+ * Node's global fetch (undici) rejects with a generic `TypeError: fetch failed`
139
+ * whose real cause hangs off `.cause`; googleapis/Gaxios wraps again. So the
140
+ * code we need is rarely on the top-level error.
141
+ *
142
+ * Returns `connect-failed` ONLY when a recognized pre-dispatch code is present
143
+ * and no ambiguous code appears anywhere in the chain. Everything else —
144
+ * including an unrecognized code, no code at all, or a non-Error throw —
145
+ * returns `dispatched-or-unknown`. Ambiguity is the safe default: mistaking
146
+ * "may have been sent" for "not sent" is the failure mode that duplicates
147
+ * email, so it must never happen by accident.
148
+ */
149
+ export declare function classifyTransportError(err: unknown): DispatchStage;
150
+ /**
151
+ * Parse a Retry-After header value into seconds.
152
+ *
153
+ * Accepts both forms defined by RFC 9110: delta-seconds and an HTTP-date.
154
+ * Returns undefined for anything unparseable or in the past, so a caller can
155
+ * fall back to its own backoff rather than waiting on a bad value.
156
+ */
157
+ export declare function parseRetryAfter(value: string | null | undefined): number | undefined;
158
+ /** Code emitted when a delivery may or may not have been accepted. */
159
+ export declare const SEND_STATUS_UNKNOWN = "SEND_STATUS_UNKNOWN";
160
+ export interface ClassifiedFailure {
161
+ code: string;
162
+ /** True only when re-issuing the request is SAFE, not merely when it might succeed. */
163
+ recoverable: boolean;
164
+ retryAfter?: number;
165
+ }
166
+ /**
167
+ * Map an HTTP status to a normalized failure.
168
+ *
169
+ * The dividing line: a 4xx proves the service received AND rejected the
170
+ * request, so the operation definitely did not happen — terminal. A 5xx proves
171
+ * receipt but nothing about whether the service acted, so for delivery it is
172
+ * ambiguous. This is the same line `scheduledDraftSendFailure` already draws
173
+ * for scheduled sends.
174
+ *
175
+ * Note 429 on a delivery operation: `retryAfter` is populated as advice to the
176
+ * human, but `recoverable` stays false so that no machine layer re-issues the
177
+ * send. The status proves the request was rejected, so resending is safe — but
178
+ * that decision belongs to the user, not to an automatic retry.
179
+ */
180
+ export declare function classifyHttpStatus(status: number, operation: OperationKind, opts?: {
181
+ retryAfter?: number;
182
+ }): ClassifiedFailure;
183
+ /**
184
+ * Whether an error may be retried for a given operation kind.
185
+ *
186
+ * Delivery is never retryable, unconditionally — not because every delivery
187
+ * failure is ambiguous, but because this is the last line of defence against
188
+ * a future caller wrapping a send in withRetry again. Belt as well as braces:
189
+ * providers also refuse to mark delivery failures recoverable.
190
+ */
191
+ export declare function isRetryable(err: unknown, operation: OperationKind): boolean;
102
192
  export declare class AttachmentNotSupportedError extends Error {
103
193
  constructor(message: string);
104
194
  }
@@ -109,10 +199,24 @@ export declare function registerProvider(name: string, factory: () => Promise<Em
109
199
  export declare function getRegisteredProviders(): string[];
110
200
  export declare function createProvider(name: string): Promise<EmailProvider>;
111
201
  export declare function discoverProviders(): Promise<string[]>;
202
+ /**
203
+ * Retry with exponential backoff, for operations that are safe to re-issue.
204
+ *
205
+ * The gate is allowlist, not denylist: an error is retried only when it is a
206
+ * ProviderError explicitly marked recoverable. It previously read
207
+ * `err instanceof ProviderError && !err.recoverable → throw`, which retried
208
+ * EVERYTHING else — plain Errors, programming bugs, and unclassified provider
209
+ * errors alike. That inversion is what let a deterministic Graph 400 be
210
+ * re-issued four times, and it contradicted the function's own comment.
211
+ *
212
+ * `operation` defaults to 'idempotent-read'. Passing 'delivery' makes this a
213
+ * single attempt by construction — see isRetryable.
214
+ */
112
215
  export declare function withRetry<T>(fn: () => Promise<T>, opts?: {
113
216
  maxRetries?: number;
114
217
  baseDelay?: number;
115
218
  maxDelay?: number;
219
+ operation?: OperationKind;
116
220
  }): Promise<T>;
117
221
  export interface AuthManager {
118
222
  connect(credentials: Record<string, string>): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  // Error normalization
2
2
  export function normalizeProviderError(err, provider) {
3
- if (err instanceof ProviderError) {
3
+ if (isProviderError(err)) {
4
4
  return {
5
5
  code: err.code,
6
6
  message: err.message,
@@ -31,6 +31,179 @@ export class ProviderError extends Error {
31
31
  this.name = 'ProviderError';
32
32
  }
33
33
  }
34
+ /**
35
+ * Structural guard for ProviderError.
36
+ *
37
+ * `instanceof` is NOT sufficient here. ProviderError is defined in email-core
38
+ * but constructed in the provider packages, which depend on email-core by
39
+ * semver range. A duplicate install (two copies of email-core in the tree)
40
+ * makes `err instanceof ProviderError` silently false, which would collapse
41
+ * every normalized provider error back into the caller's fallback code —
42
+ * reintroducing exactly the defect this normalization exists to fix, and doing
43
+ * it invisibly. `auth.ts` already carries the same structural fallback for
44
+ * GraphApiError for the same reason.
45
+ */
46
+ export function isProviderError(err) {
47
+ if (err instanceof ProviderError)
48
+ return true;
49
+ if (!err || typeof err !== 'object')
50
+ return false;
51
+ const obj = err;
52
+ return (obj.name === 'ProviderError' &&
53
+ typeof obj.code === 'string' &&
54
+ typeof obj.recoverable === 'boolean');
55
+ }
56
+ /**
57
+ * Error codes that can only arise before any request bytes are written.
58
+ *
59
+ * DNS resolution and TCP connect strictly precede the HTTP request; a TLS
60
+ * handshake failure likewise aborts before the request is sent. Every entry
61
+ * here is an exact code — never match on message text, which is unstable
62
+ * across Node and undici versions.
63
+ */
64
+ const PRE_DISPATCH_ERROR_CODES = new Set([
65
+ // DNS
66
+ 'ENOTFOUND', 'EAI_AGAIN',
67
+ // TCP connect
68
+ 'ECONNREFUSED', 'UND_ERR_CONNECT_TIMEOUT',
69
+ // TLS handshake — aborts before the HTTP request is written
70
+ 'CERT_HAS_EXPIRED', 'CERT_NOT_YET_VALID',
71
+ 'DEPTH_ZERO_SELF_SIGNED_CERT', 'SELF_SIGNED_CERT_IN_CHAIN',
72
+ 'UNABLE_TO_VERIFY_LEAF_SIGNATURE', 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY',
73
+ 'ERR_TLS_CERT_ALTNAME_INVALID', 'ERR_SSL_WRONG_VERSION_NUMBER',
74
+ ]);
75
+ /**
76
+ * Error codes that are known to be ambiguous — the request may already have
77
+ * been written and acted upon. Listed explicitly so that a chain containing
78
+ * one of these is never downgraded to `connect-failed` by an accompanying
79
+ * pre-dispatch code.
80
+ *
81
+ * ETIMEDOUT is here deliberately: Node defines it as a connect OR send
82
+ * timeout, so the code alone cannot prove which. ECONNRESET means an
83
+ * ESTABLISHED connection was closed, which is genuinely undecidable.
84
+ */
85
+ const AMBIGUOUS_ERROR_CODES = new Set([
86
+ 'ETIMEDOUT', 'ECONNRESET', 'EPIPE', 'EHOSTUNREACH', 'ENETUNREACH',
87
+ 'UND_ERR_HEADERS_TIMEOUT', 'UND_ERR_BODY_TIMEOUT', 'UND_ERR_SOCKET',
88
+ 'UND_ERR_RESPONSE_STATUS_CODE', 'UND_ERR_ABORTED',
89
+ 'ABORT_ERR', 'ERR_STREAM_PREMATURE_CLOSE',
90
+ ]);
91
+ const MAX_CAUSE_DEPTH = 5;
92
+ /**
93
+ * Classify a thrown transport error by walking the `cause` chain.
94
+ *
95
+ * Node's global fetch (undici) rejects with a generic `TypeError: fetch failed`
96
+ * whose real cause hangs off `.cause`; googleapis/Gaxios wraps again. So the
97
+ * code we need is rarely on the top-level error.
98
+ *
99
+ * Returns `connect-failed` ONLY when a recognized pre-dispatch code is present
100
+ * and no ambiguous code appears anywhere in the chain. Everything else —
101
+ * including an unrecognized code, no code at all, or a non-Error throw —
102
+ * returns `dispatched-or-unknown`. Ambiguity is the safe default: mistaking
103
+ * "may have been sent" for "not sent" is the failure mode that duplicates
104
+ * email, so it must never happen by accident.
105
+ */
106
+ export function classifyTransportError(err) {
107
+ const codes = [];
108
+ let current = err;
109
+ for (let depth = 0; depth < MAX_CAUSE_DEPTH && current; depth++) {
110
+ if (typeof current !== 'object')
111
+ break;
112
+ const obj = current;
113
+ for (const key of ['code', 'errno']) {
114
+ const value = obj[key];
115
+ if (typeof value === 'string')
116
+ codes.push(value);
117
+ }
118
+ current = obj.cause;
119
+ }
120
+ if (codes.some(code => AMBIGUOUS_ERROR_CODES.has(code)))
121
+ return 'dispatched-or-unknown';
122
+ if (codes.some(code => PRE_DISPATCH_ERROR_CODES.has(code)))
123
+ return 'connect-failed';
124
+ return 'dispatched-or-unknown';
125
+ }
126
+ /**
127
+ * Parse a Retry-After header value into seconds.
128
+ *
129
+ * Accepts both forms defined by RFC 9110: delta-seconds and an HTTP-date.
130
+ * Returns undefined for anything unparseable or in the past, so a caller can
131
+ * fall back to its own backoff rather than waiting on a bad value.
132
+ */
133
+ export function parseRetryAfter(value) {
134
+ if (!value)
135
+ return undefined;
136
+ const trimmed = value.trim();
137
+ if (/^\d+$/.test(trimmed)) {
138
+ const seconds = Number(trimmed);
139
+ return Number.isFinite(seconds) ? seconds : undefined;
140
+ }
141
+ const parsed = Date.parse(trimmed);
142
+ if (Number.isNaN(parsed))
143
+ return undefined;
144
+ const seconds = Math.ceil((parsed - Date.now()) / 1000);
145
+ return seconds > 0 ? seconds : undefined;
146
+ }
147
+ /** Code emitted when a delivery may or may not have been accepted. */
148
+ export const SEND_STATUS_UNKNOWN = 'SEND_STATUS_UNKNOWN';
149
+ /**
150
+ * Map an HTTP status to a normalized failure.
151
+ *
152
+ * The dividing line: a 4xx proves the service received AND rejected the
153
+ * request, so the operation definitely did not happen — terminal. A 5xx proves
154
+ * receipt but nothing about whether the service acted, so for delivery it is
155
+ * ambiguous. This is the same line `scheduledDraftSendFailure` already draws
156
+ * for scheduled sends.
157
+ *
158
+ * Note 429 on a delivery operation: `retryAfter` is populated as advice to the
159
+ * human, but `recoverable` stays false so that no machine layer re-issues the
160
+ * send. The status proves the request was rejected, so resending is safe — but
161
+ * that decision belongs to the user, not to an automatic retry.
162
+ */
163
+ export function classifyHttpStatus(status, operation, opts = {}) {
164
+ const isDelivery = operation === 'delivery';
165
+ const { retryAfter } = opts;
166
+ if (status === 429) {
167
+ return { code: 'RATE_LIMITED', recoverable: !isDelivery, retryAfter };
168
+ }
169
+ if (status >= 400 && status < 500) {
170
+ switch (status) {
171
+ case 400:
172
+ case 422:
173
+ return { code: 'INVALID_REQUEST', recoverable: false };
174
+ case 401:
175
+ return { code: 'AUTH_REQUIRED', recoverable: false };
176
+ case 403:
177
+ return { code: 'PERMISSION_DENIED', recoverable: false };
178
+ case 404:
179
+ return { code: 'NOT_FOUND', recoverable: false };
180
+ case 409:
181
+ return { code: 'CONFLICT', recoverable: false };
182
+ case 413:
183
+ return { code: 'PAYLOAD_TOO_LARGE', recoverable: false };
184
+ default:
185
+ return { code: 'PROVIDER_REJECTED', recoverable: false };
186
+ }
187
+ }
188
+ // 5xx and anything else: the origin received the request but its outcome is
189
+ // unknown. Safe to retry a read; never safe to re-issue a delivery.
190
+ return isDelivery
191
+ ? { code: SEND_STATUS_UNKNOWN, recoverable: false, retryAfter }
192
+ : { code: 'PROVIDER_ERROR', recoverable: true, retryAfter };
193
+ }
194
+ /**
195
+ * Whether an error may be retried for a given operation kind.
196
+ *
197
+ * Delivery is never retryable, unconditionally — not because every delivery
198
+ * failure is ambiguous, but because this is the last line of defence against
199
+ * a future caller wrapping a send in withRetry again. Belt as well as braces:
200
+ * providers also refuse to mark delivery failures recoverable.
201
+ */
202
+ export function isRetryable(err, operation) {
203
+ if (operation === 'delivery')
204
+ return false;
205
+ return isProviderError(err) && err.recoverable;
206
+ }
34
207
  // Thrown by providers when an attachment cannot be downloaded by this
35
208
  // implementation — e.g. Microsoft Graph item/reference attachments, which
36
209
  // require the /$value raw-bytes path. The download_attachment action remaps
@@ -82,11 +255,24 @@ export async function discoverProviders() {
82
255
  }
83
256
  return discovered;
84
257
  }
85
- // Retry with exponential backoff
258
+ /**
259
+ * Retry with exponential backoff, for operations that are safe to re-issue.
260
+ *
261
+ * The gate is allowlist, not denylist: an error is retried only when it is a
262
+ * ProviderError explicitly marked recoverable. It previously read
263
+ * `err instanceof ProviderError && !err.recoverable → throw`, which retried
264
+ * EVERYTHING else — plain Errors, programming bugs, and unclassified provider
265
+ * errors alike. That inversion is what let a deterministic Graph 400 be
266
+ * re-issued four times, and it contradicted the function's own comment.
267
+ *
268
+ * `operation` defaults to 'idempotent-read'. Passing 'delivery' makes this a
269
+ * single attempt by construction — see isRetryable.
270
+ */
86
271
  export async function withRetry(fn, opts = {}) {
87
272
  const maxRetries = opts.maxRetries ?? 3;
88
273
  const baseDelay = opts.baseDelay ?? 1000;
89
274
  const maxDelay = opts.maxDelay ?? 16000;
275
+ const operation = opts.operation ?? 'idempotent-read';
90
276
  let lastError;
91
277
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
92
278
  try {
@@ -96,12 +282,16 @@ export async function withRetry(fn, opts = {}) {
96
282
  lastError = err;
97
283
  if (attempt === maxRetries)
98
284
  break;
99
- // Only retry on recoverable errors
100
- if (err instanceof ProviderError && !err.recoverable) {
285
+ if (!isRetryable(err, operation))
101
286
  throw err;
102
- }
103
- const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
104
- const jitter = delay * (0.5 + Math.random() * 0.5);
287
+ // A provider-supplied Retry-After is a floor, not a ceiling: honour it
288
+ // when it exceeds our own backoff, so we do not hammer a throttled API.
289
+ const backoff = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
290
+ const retryAfterMs = isProviderError(err) && typeof err.retryAfter === 'number'
291
+ ? err.retryAfter * 1000
292
+ : 0;
293
+ const delay = Math.max(backoff, retryAfterMs);
294
+ const jitter = retryAfterMs > backoff ? delay : delay * (0.5 + Math.random() * 0.5);
105
295
  await new Promise(resolve => setTimeout(resolve, jitter));
106
296
  }
107
297
  }