@vrplatform/email 1.0.2-5 → 1.0.2-556

package/src/utils/send-email.ts

@@ -1,8 +1,25 @@
+import { day } from '@vrplatform/utils';
+
+type EmailDeliveryFailureDetails = {
+  httpStatus: number;
+  postmarkErrorCode?: number;
+  provider: 'postmark';
+  providerCategory: 'inactiveRecipient' | 'rejected';
+};
+
+type EmailDeliveryErrorDetails =
+  | EmailDeliveryFailureDetails
+  | {
+      failureCount: number;
+      failures: EmailDeliveryFailureDetails[];
+    };
+
 export class EmailDeliveryError extends Error {
   constructor(
     message: string,
-    public readonly details?: Record<string, unknown>,
-    public readonly expected = false
+    public readonly details?: EmailDeliveryErrorDetails,
+    public readonly expected = false,
+    public readonly retryable = true
   ) {
     super(message);
     this.name = 'EmailDeliveryError';
@@ -16,6 +33,8 @@ export async function sendEmail(
     text: string;
     html: string;
     replyTo?: string;
+    tag?: string;
+    metadata?: Record<string, string>;
   },
   options: {
     fetch?: (
@@ -26,7 +45,12 @@ export async function sendEmail(
   }
 ) {
   if (!options.postmarkToken) {
-    throw new EmailDeliveryError('Postmark is not configured');
+    throw new EmailDeliveryError(
+      'Postmark is not configured',
+      undefined,
+      false,
+      false
+    );
   }
 
   const response = await (options.fetch ?? fetch)(
@@ -46,41 +70,159 @@ export async function sendEmail(
         TextBody: data.text,
         HtmlBody: data.html,
         MessageStream: 'outbound',
+        Tag: data.tag,
+        Metadata: data.metadata,
       }),
     }
   );
 
   const providerResponse: unknown = await response.json().catch(() => ({}));
-  const providerMessage =
+  const responseErrorCode =
     providerResponse !== null &&
     typeof providerResponse === 'object' &&
-    'Message' in providerResponse &&
-    typeof providerResponse.Message === 'string'
-      ? providerResponse.Message
+    'ErrorCode' in providerResponse &&
+    typeof providerResponse.ErrorCode === 'number'
+      ? providerResponse.ErrorCode
+      : undefined;
+  const headerErrorCode = response.headers.get('X-PM-ApiErrorCode');
+  const errorCode =
+    responseErrorCode ??
+    (headerErrorCode && /^\d+$/.test(headerErrorCode)
+      ? Number(headerErrorCode)
+      : undefined);
+  const postmarkErrorCode =
+    typeof errorCode === 'number' &&
+    Number.isSafeInteger(errorCode) &&
+    errorCode >= 0
+      ? errorCode
       : undefined;
 
-  if (!response.ok) {
-    if (
-      response.status === 422 &&
-      providerMessage?.includes('marked as inactive')
-    ) {
+  if (
+    !response.ok ||
+    (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)
+  ) {
+    const inactiveRecipient =
+      response.status === 422 && postmarkErrorCode === 406;
+    const details: EmailDeliveryFailureDetails = {
+      provider: 'postmark',
+      providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',
+      httpStatus: response.status,
+      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+    };
+
+    if (inactiveRecipient) {
       throw new EmailDeliveryError(
         'Postmark recipient is inactive',
-        {
-          providerMessage,
-          status: response.status,
-          statusText: response.statusText,
-        },
-        true
+        details,
+        true,
+        false
       );
     }
 
-    throw new EmailDeliveryError('Postmark rejected the email', {
-      providerResponse,
-      status: response.status,
-      statusText: response.statusText,
+    throw new EmailDeliveryError(
+      'Postmark rejected the email',
+      details,
+      false,
+      response.status === 429 || response.status >= 500
+    );
+  }
+
+  const messageId =
+    providerResponse !== null &&
+    typeof providerResponse === 'object' &&
+    'MessageID' in providerResponse &&
+    typeof providerResponse.MessageID === 'string' &&
+    providerResponse.MessageID
+      ? providerResponse.MessageID
+      : undefined;
+  const submittedAt =
+    providerResponse !== null &&
+    typeof providerResponse === 'object' &&
+    'SubmittedAt' in providerResponse &&
+    typeof providerResponse.SubmittedAt === 'string' &&
+    day(providerResponse.SubmittedAt).isValid()
+      ? providerResponse.SubmittedAt
+      : undefined;
+  if (!messageId || !submittedAt || postmarkErrorCode !== 0) {
+    throw new EmailDeliveryError('Postmark returned an invalid response', {
+      provider: 'postmark',
+      providerCategory: 'rejected',
+      httpStatus: response.status,
+      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
     });
   }
 
-  return { status: response.status };
+  return {
+    httpStatus: response.status,
+    messageId,
+    submittedAt,
+  };
+}
+
+export async function settleEmailDeliveries(deliveries: Promise<unknown>[]) {
+  const failures = (await Promise.allSettled(deliveries)).filter(
+    (result) => result.status === 'rejected'
+  );
+  if (failures.length === 0) return;
+
+  const unexpectedDeliveryError = failures.find(
+    (failure) =>
+      failure.reason instanceof EmailDeliveryError && !failure.reason.expected
+  )?.reason;
+  const allExpected = failures.every(
+    (failure) =>
+      failure.reason instanceof EmailDeliveryError && failure.reason.expected
+  );
+  const firstDeliveryError = failures.find(
+    (failure) => failure.reason instanceof EmailDeliveryError
+  )?.reason;
+  const failureDetails = failures.flatMap((failure) => {
+    if (
+      !(failure.reason instanceof EmailDeliveryError) ||
+      !failure.reason.details ||
+      !('provider' in failure.reason.details)
+    ) {
+      return [];
+    }
+    const { httpStatus, postmarkErrorCode, provider, providerCategory } =
+      failure.reason.details;
+    return [
+      {
+        httpStatus,
+        provider,
+        providerCategory,
+        ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+      },
+    ];
+  });
+
+  const details: EmailDeliveryErrorDetails = {
+    failureCount: failures.length,
+    failures: failureDetails,
+  };
+  if (unexpectedDeliveryError instanceof EmailDeliveryError) {
+    if (unexpectedDeliveryError.message === 'Postmark is not configured') {
+      throw new EmailDeliveryError(
+        'Postmark is not configured',
+        details,
+        false,
+        false
+      );
+    }
+    throw new EmailDeliveryError(
+      'Postmark rejected the email',
+      details,
+      false,
+      unexpectedDeliveryError.retryable
+    );
+  }
+  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {
+    throw new EmailDeliveryError(
+      'Postmark recipient is inactive',
+      details,
+      true,
+      false
+    );
+  }
+  throw new EmailDeliveryError('Email delivery failed', details);
 }