@vrplatform/email 1.0.2-stage.446 → 1.0.2-stage.458

package/build/main/utils/send-email.d.ts

@@ -1,7 +1,17 @@
+type EmailDeliveryFailureDetails = {
+    httpStatus: number;
+    postmarkErrorCode?: number;
+    provider: 'postmark';
+    providerCategory: 'inactiveRecipient' | 'rejected';
+};
+type EmailDeliveryErrorDetails = EmailDeliveryFailureDetails | {
+    failureCount: number;
+    failures: EmailDeliveryFailureDetails[];
+};
 export declare class EmailDeliveryError extends Error {
-    readonly details?: Record<string, unknown> | undefined;
+    readonly details?: EmailDeliveryErrorDetails | undefined;
     readonly expected: boolean;
-    constructor(message: string, details?: Record<string, unknown> | undefined, expected?: boolean);
+    constructor(message: string, details?: EmailDeliveryErrorDetails | undefined, expected?: boolean);
 }
 export declare function sendEmail(data: {
     to: string;
@@ -15,3 +25,5 @@ export declare function sendEmail(data: {
 }): Promise<{
     status: number;
 }>;
+export declare function settleEmailDeliveries(deliveries: Promise<unknown>[]): Promise<void>;
+export {};

package/build/main/utils/send-email.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailDeliveryError = void 0;
 exports.sendEmail = sendEmail;
+exports.settleEmailDeliveries = settleEmailDeliveries;
 class EmailDeliveryError extends Error {
     constructor(message, details, expected = false) {
         super(message);
@@ -33,27 +34,73 @@ async function sendEmail(data, options) {
         }),
     });
     const providerResponse = await response.json().catch(() => ({}));
-    const providerMessage = providerResponse !== null &&
+    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')) {
-            throw new EmailDeliveryError('Postmark recipient is inactive', {
-                providerMessage,
-                status: response.status,
-                statusText: response.statusText,
-            }, true);
+        const inactiveRecipient = response.status === 422 && postmarkErrorCode === 406;
+        const details = {
+            provider: 'postmark',
+            providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',
+            httpStatus: response.status,
+            ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+        };
+        if (inactiveRecipient) {
+            throw new EmailDeliveryError('Postmark recipient is inactive', details, true);
         }
-        throw new EmailDeliveryError('Postmark rejected the email', {
-            providerResponse,
-            status: response.status,
-            statusText: response.statusText,
-        });
+        throw new EmailDeliveryError('Postmark rejected the email', details);
     }
     return { status: response.status };
 }
+async function settleEmailDeliveries(deliveries) {
+    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 = {
+        failureCount: failures.length,
+        failures: failureDetails,
+    };
+    if (unexpectedDeliveryError instanceof EmailDeliveryError) {
+        if (unexpectedDeliveryError.message === 'Postmark is not configured') {
+            throw new EmailDeliveryError('Postmark is not configured', details);
+        }
+        throw new EmailDeliveryError('Postmark rejected the email', details);
+    }
+    if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {
+        throw new EmailDeliveryError('Postmark recipient is inactive', details, true);
+    }
+    throw new EmailDeliveryError('Email delivery failed', details);
+}
 //# sourceMappingURL=send-email.js.map

package/build/main/utils/send-email.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":";;;AAWA,8BA0EC;AArFD,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YACE,OAAe,EACC,OAAiC,EACjC,WAAW,KAAK;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,YAAO,GAAP,OAAO,CAA0B;QACjC,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AATD,gDASC;AAEM,KAAK,UAAU,SAAS,CAC7B,IAMC,EACD,OAMC;IAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAC7C,mCAAmC,EACnC;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;YAClC,yBAAyB,EAAE,OAAO,CAAC,aAAa;SACjD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,2CAA2C;YACjD,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,aAAa,EAAE,UAAU;SAC1B,CAAC;KACH,CACF,CAAC;IAEF,MAAM,gBAAgB,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,eAAe,GACnB,gBAAgB,KAAK,IAAI;QACzB,OAAO,gBAAgB,KAAK,QAAQ;QACpC,SAAS,IAAI,gBAAgB;QAC7B,OAAO,gBAAgB,CAAC,OAAO,KAAK,QAAQ;QAC1C,CAAC,CAAC,gBAAgB,CAAC,OAAO;QAC1B,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IACE,QAAQ,CAAC,MAAM,KAAK,GAAG;YACvB,eAAe,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAC/C,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,gCAAgC,EAChC;gBACE,eAAe;gBACf,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE;YAC1D,gBAAgB;YAChB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AACrC,CAAC","sourcesContent":["export class EmailDeliveryError extends Error {\n  constructor(\n    message: string,\n    public readonly details?: Record<string, unknown>,\n    public readonly expected = false\n  ) {\n    super(message);\n    this.name = 'EmailDeliveryError';\n  }\n}\n\nexport async function sendEmail(\n  data: {\n    to: string;\n    subject: string;\n    text: string;\n    html: string;\n    replyTo?: string;\n  },\n  options: {\n    fetch?: (\n      input: string | URL | Request,\n      init?: RequestInit\n    ) => Promise<Response>;\n    postmarkToken?: string;\n  }\n) {\n  if (!options.postmarkToken) {\n    throw new EmailDeliveryError('Postmark is not configured');\n  }\n\n  const response = await (options.fetch ?? fetch)(\n    'https://api.postmarkapp.com/email',\n    {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        'X-Postmark-Server-Token': options.postmarkToken,\n      },\n      body: JSON.stringify({\n        From: 'VRPlatform <notifications@vrplatform.app>',\n        To: data.to,\n        Subject: data.subject,\n        ReplyTo: data.replyTo,\n        TextBody: data.text,\n        HtmlBody: data.html,\n        MessageStream: 'outbound',\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const providerMessage =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'Message' in providerResponse &&\n    typeof providerResponse.Message === 'string'\n      ? providerResponse.Message\n      : undefined;\n\n  if (!response.ok) {\n    if (\n      response.status === 422 &&\n      providerMessage?.includes('marked as inactive')\n    ) {\n      throw new EmailDeliveryError(\n        'Postmark recipient is inactive',\n        {\n          providerMessage,\n          status: response.status,\n          statusText: response.statusText,\n        },\n        true\n      );\n    }\n\n    throw new EmailDeliveryError('Postmark rejected the email', {\n      providerResponse,\n      status: response.status,\n      statusText: response.statusText,\n    });\n  }\n\n  return { status: response.status };\n}\n"]}
+{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":"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","sourcesContent":["type EmailDeliveryFailureDetails = {\n  httpStatus: number;\n  postmarkErrorCode?: number;\n  provider: 'postmark';\n  providerCategory: 'inactiveRecipient' | 'rejected';\n};\n\ntype EmailDeliveryErrorDetails =\n  | EmailDeliveryFailureDetails\n  | {\n      failureCount: number;\n      failures: EmailDeliveryFailureDetails[];\n    };\n\nexport class EmailDeliveryError extends Error {\n  constructor(\n    message: string,\n    public readonly details?: EmailDeliveryErrorDetails,\n    public readonly expected = false\n  ) {\n    super(message);\n    this.name = 'EmailDeliveryError';\n  }\n}\n\nexport async function sendEmail(\n  data: {\n    to: string;\n    subject: string;\n    text: string;\n    html: string;\n    replyTo?: string;\n  },\n  options: {\n    fetch?: (\n      input: string | URL | Request,\n      init?: RequestInit\n    ) => Promise<Response>;\n    postmarkToken?: string;\n  }\n) {\n  if (!options.postmarkToken) {\n    throw new EmailDeliveryError('Postmark is not configured');\n  }\n\n  const response = await (options.fetch ?? fetch)(\n    'https://api.postmarkapp.com/email',\n    {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        'X-Postmark-Server-Token': options.postmarkToken,\n      },\n      body: JSON.stringify({\n        From: 'VRPlatform <notifications@vrplatform.app>',\n        To: data.to,\n        Subject: data.subject,\n        ReplyTo: data.replyTo,\n        TextBody: data.text,\n        HtmlBody: data.html,\n        MessageStream: 'outbound',\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const responseErrorCode =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'ErrorCode' in providerResponse &&\n    typeof providerResponse.ErrorCode === 'number'\n      ? providerResponse.ErrorCode\n      : undefined;\n  const headerErrorCode = response.headers.get('X-PM-ApiErrorCode');\n  const errorCode =\n    responseErrorCode ??\n    (headerErrorCode && /^\\d+$/.test(headerErrorCode)\n      ? Number(headerErrorCode)\n      : undefined);\n  const postmarkErrorCode =\n    typeof errorCode === 'number' &&\n    Number.isSafeInteger(errorCode) &&\n    errorCode >= 0\n      ? errorCode\n      : undefined;\n\n  if (!response.ok) {\n    const inactiveRecipient =\n      response.status === 422 && postmarkErrorCode === 406;\n    const details: EmailDeliveryFailureDetails = {\n      provider: 'postmark',\n      providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    };\n\n    if (inactiveRecipient) {\n      throw new EmailDeliveryError(\n        'Postmark recipient is inactive',\n        details,\n        true\n      );\n    }\n\n    throw new EmailDeliveryError('Postmark rejected the email', details);\n  }\n\n  return { status: response.status };\n}\n\nexport async function settleEmailDeliveries(deliveries: Promise<unknown>[]) {\n  const failures = (await Promise.allSettled(deliveries)).filter(\n    (result) => result.status === 'rejected'\n  );\n  if (failures.length === 0) return;\n\n  const unexpectedDeliveryError = failures.find(\n    (failure) =>\n      failure.reason instanceof EmailDeliveryError && !failure.reason.expected\n  )?.reason;\n  const allExpected = failures.every(\n    (failure) =>\n      failure.reason instanceof EmailDeliveryError && failure.reason.expected\n  );\n  const firstDeliveryError = failures.find(\n    (failure) => failure.reason instanceof EmailDeliveryError\n  )?.reason;\n  const failureDetails = failures.flatMap((failure) => {\n    if (\n      !(failure.reason instanceof EmailDeliveryError) ||\n      !failure.reason.details ||\n      !('provider' in failure.reason.details)\n    ) {\n      return [];\n    }\n    const { httpStatus, postmarkErrorCode, provider, providerCategory } =\n      failure.reason.details;\n    return [\n      {\n        httpStatus,\n        provider,\n        providerCategory,\n        ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n      },\n    ];\n  });\n\n  const details: EmailDeliveryErrorDetails = {\n    failureCount: failures.length,\n    failures: failureDetails,\n  };\n  if (unexpectedDeliveryError instanceof EmailDeliveryError) {\n    if (unexpectedDeliveryError.message === 'Postmark is not configured') {\n      throw new EmailDeliveryError('Postmark is not configured', details);\n    }\n    throw new EmailDeliveryError('Postmark rejected the email', details);\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true\n    );\n  }\n  throw new EmailDeliveryError('Email delivery failed', details);\n}\n"]}

package/build/module/utils/send-email.d.ts

@@ -1,7 +1,17 @@
+type EmailDeliveryFailureDetails = {
+    httpStatus: number;
+    postmarkErrorCode?: number;
+    provider: 'postmark';
+    providerCategory: 'inactiveRecipient' | 'rejected';
+};
+type EmailDeliveryErrorDetails = EmailDeliveryFailureDetails | {
+    failureCount: number;
+    failures: EmailDeliveryFailureDetails[];
+};
 export declare class EmailDeliveryError extends Error {
-    readonly details?: Record<string, unknown> | undefined;
+    readonly details?: EmailDeliveryErrorDetails | undefined;
     readonly expected: boolean;
-    constructor(message: string, details?: Record<string, unknown> | undefined, expected?: boolean);
+    constructor(message: string, details?: EmailDeliveryErrorDetails | undefined, expected?: boolean);
 }
 export declare function sendEmail(data: {
     to: string;
@@ -15,3 +25,5 @@ export declare function sendEmail(data: {
 }): Promise<{
     status: number;
 }>;
+export declare function settleEmailDeliveries(deliveries: Promise<unknown>[]): Promise<void>;
+export {};

package/build/module/utils/send-email.js

@@ -30,27 +30,73 @@ export async function sendEmail(data, options) {
         }),
     });
     const providerResponse = await response.json().catch(() => ({}));
-    const providerMessage = providerResponse !== null &&
+    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')) {
-            throw new EmailDeliveryError('Postmark recipient is inactive', {
-                providerMessage,
-                status: response.status,
-                statusText: response.statusText,
-            }, true);
+        const inactiveRecipient = response.status === 422 && postmarkErrorCode === 406;
+        const details = {
+            provider: 'postmark',
+            providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',
+            httpStatus: response.status,
+            ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+        };
+        if (inactiveRecipient) {
+            throw new EmailDeliveryError('Postmark recipient is inactive', details, true);
         }
-        throw new EmailDeliveryError('Postmark rejected the email', {
-            providerResponse,
-            status: response.status,
-            statusText: response.statusText,
-        });
+        throw new EmailDeliveryError('Postmark rejected the email', details);
     }
     return { status: response.status };
 }
+export async function settleEmailDeliveries(deliveries) {
+    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 = {
+        failureCount: failures.length,
+        failures: failureDetails,
+    };
+    if (unexpectedDeliveryError instanceof EmailDeliveryError) {
+        if (unexpectedDeliveryError.message === 'Postmark is not configured') {
+            throw new EmailDeliveryError('Postmark is not configured', details);
+        }
+        throw new EmailDeliveryError('Postmark rejected the email', details);
+    }
+    if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {
+        throw new EmailDeliveryError('Postmark recipient is inactive', details, true);
+    }
+    throw new EmailDeliveryError('Email delivery failed', details);
+}
 //# sourceMappingURL=send-email.js.map

package/build/module/utils/send-email.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IACA;IAHlB,YACE,OAAe,EACC,OAAiC,EACjC,WAAW,KAAK;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,YAAO,GAAP,OAAO,CAA0B;QACjC,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAMC,EACD,OAMC;IAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAC7C,mCAAmC,EACnC;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;YAClC,yBAAyB,EAAE,OAAO,CAAC,aAAa;SACjD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,2CAA2C;YACjD,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,aAAa,EAAE,UAAU;SAC1B,CAAC;KACH,CACF,CAAC;IAEF,MAAM,gBAAgB,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,eAAe,GACnB,gBAAgB,KAAK,IAAI;QACzB,OAAO,gBAAgB,KAAK,QAAQ;QACpC,SAAS,IAAI,gBAAgB;QAC7B,OAAO,gBAAgB,CAAC,OAAO,KAAK,QAAQ;QAC1C,CAAC,CAAC,gBAAgB,CAAC,OAAO;QAC1B,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IACE,QAAQ,CAAC,MAAM,KAAK,GAAG;YACvB,eAAe,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAC/C,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,gCAAgC,EAChC;gBACE,eAAe;gBACf,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE;YAC1D,gBAAgB;YAChB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AACrC,CAAC","sourcesContent":["export class EmailDeliveryError extends Error {\n  constructor(\n    message: string,\n    public readonly details?: Record<string, unknown>,\n    public readonly expected = false\n  ) {\n    super(message);\n    this.name = 'EmailDeliveryError';\n  }\n}\n\nexport async function sendEmail(\n  data: {\n    to: string;\n    subject: string;\n    text: string;\n    html: string;\n    replyTo?: string;\n  },\n  options: {\n    fetch?: (\n      input: string | URL | Request,\n      init?: RequestInit\n    ) => Promise<Response>;\n    postmarkToken?: string;\n  }\n) {\n  if (!options.postmarkToken) {\n    throw new EmailDeliveryError('Postmark is not configured');\n  }\n\n  const response = await (options.fetch ?? fetch)(\n    'https://api.postmarkapp.com/email',\n    {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        'X-Postmark-Server-Token': options.postmarkToken,\n      },\n      body: JSON.stringify({\n        From: 'VRPlatform <notifications@vrplatform.app>',\n        To: data.to,\n        Subject: data.subject,\n        ReplyTo: data.replyTo,\n        TextBody: data.text,\n        HtmlBody: data.html,\n        MessageStream: 'outbound',\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const providerMessage =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'Message' in providerResponse &&\n    typeof providerResponse.Message === 'string'\n      ? providerResponse.Message\n      : undefined;\n\n  if (!response.ok) {\n    if (\n      response.status === 422 &&\n      providerMessage?.includes('marked as inactive')\n    ) {\n      throw new EmailDeliveryError(\n        'Postmark recipient is inactive',\n        {\n          providerMessage,\n          status: response.status,\n          statusText: response.statusText,\n        },\n        true\n      );\n    }\n\n    throw new EmailDeliveryError('Postmark rejected the email', {\n      providerResponse,\n      status: response.status,\n      statusText: response.statusText,\n    });\n  }\n\n  return { status: response.status };\n}\n"]}
+{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":"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","sourcesContent":["type EmailDeliveryFailureDetails = {\n  httpStatus: number;\n  postmarkErrorCode?: number;\n  provider: 'postmark';\n  providerCategory: 'inactiveRecipient' | 'rejected';\n};\n\ntype EmailDeliveryErrorDetails =\n  | EmailDeliveryFailureDetails\n  | {\n      failureCount: number;\n      failures: EmailDeliveryFailureDetails[];\n    };\n\nexport class EmailDeliveryError extends Error {\n  constructor(\n    message: string,\n    public readonly details?: EmailDeliveryErrorDetails,\n    public readonly expected = false\n  ) {\n    super(message);\n    this.name = 'EmailDeliveryError';\n  }\n}\n\nexport async function sendEmail(\n  data: {\n    to: string;\n    subject: string;\n    text: string;\n    html: string;\n    replyTo?: string;\n  },\n  options: {\n    fetch?: (\n      input: string | URL | Request,\n      init?: RequestInit\n    ) => Promise<Response>;\n    postmarkToken?: string;\n  }\n) {\n  if (!options.postmarkToken) {\n    throw new EmailDeliveryError('Postmark is not configured');\n  }\n\n  const response = await (options.fetch ?? fetch)(\n    'https://api.postmarkapp.com/email',\n    {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        'X-Postmark-Server-Token': options.postmarkToken,\n      },\n      body: JSON.stringify({\n        From: 'VRPlatform <notifications@vrplatform.app>',\n        To: data.to,\n        Subject: data.subject,\n        ReplyTo: data.replyTo,\n        TextBody: data.text,\n        HtmlBody: data.html,\n        MessageStream: 'outbound',\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const responseErrorCode =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'ErrorCode' in providerResponse &&\n    typeof providerResponse.ErrorCode === 'number'\n      ? providerResponse.ErrorCode\n      : undefined;\n  const headerErrorCode = response.headers.get('X-PM-ApiErrorCode');\n  const errorCode =\n    responseErrorCode ??\n    (headerErrorCode && /^\\d+$/.test(headerErrorCode)\n      ? Number(headerErrorCode)\n      : undefined);\n  const postmarkErrorCode =\n    typeof errorCode === 'number' &&\n    Number.isSafeInteger(errorCode) &&\n    errorCode >= 0\n      ? errorCode\n      : undefined;\n\n  if (!response.ok) {\n    const inactiveRecipient =\n      response.status === 422 && postmarkErrorCode === 406;\n    const details: EmailDeliveryFailureDetails = {\n      provider: 'postmark',\n      providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    };\n\n    if (inactiveRecipient) {\n      throw new EmailDeliveryError(\n        'Postmark recipient is inactive',\n        details,\n        true\n      );\n    }\n\n    throw new EmailDeliveryError('Postmark rejected the email', details);\n  }\n\n  return { status: response.status };\n}\n\nexport async function settleEmailDeliveries(deliveries: Promise<unknown>[]) {\n  const failures = (await Promise.allSettled(deliveries)).filter(\n    (result) => result.status === 'rejected'\n  );\n  if (failures.length === 0) return;\n\n  const unexpectedDeliveryError = failures.find(\n    (failure) =>\n      failure.reason instanceof EmailDeliveryError && !failure.reason.expected\n  )?.reason;\n  const allExpected = failures.every(\n    (failure) =>\n      failure.reason instanceof EmailDeliveryError && failure.reason.expected\n  );\n  const firstDeliveryError = failures.find(\n    (failure) => failure.reason instanceof EmailDeliveryError\n  )?.reason;\n  const failureDetails = failures.flatMap((failure) => {\n    if (\n      !(failure.reason instanceof EmailDeliveryError) ||\n      !failure.reason.details ||\n      !('provider' in failure.reason.details)\n    ) {\n      return [];\n    }\n    const { httpStatus, postmarkErrorCode, provider, providerCategory } =\n      failure.reason.details;\n    return [\n      {\n        httpStatus,\n        provider,\n        providerCategory,\n        ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n      },\n    ];\n  });\n\n  const details: EmailDeliveryErrorDetails = {\n    failureCount: failures.length,\n    failures: failureDetails,\n  };\n  if (unexpectedDeliveryError instanceof EmailDeliveryError) {\n    if (unexpectedDeliveryError.message === 'Postmark is not configured') {\n      throw new EmailDeliveryError('Postmark is not configured', details);\n    }\n    throw new EmailDeliveryError('Postmark rejected the email', details);\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true\n    );\n  }\n  throw new EmailDeliveryError('Email delivery failed', details);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vrplatform/email",
-  "version": "1.0.2-stage.446",
+  "version": "1.0.2-stage.458",
   "description": "VRTrust transactional email templates and Postmark transport",
   "license": "ISC",
   "main": "build/main/index.js",

package/src/utils/send-email.ts

@@ -1,7 +1,21 @@
+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 details?: EmailDeliveryErrorDetails,
     public readonly expected = false
   ) {
     super(message);
@@ -51,36 +65,103 @@ export async function sendEmail(
   );
 
   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')
-    ) {
+    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,
-        },
+        details,
         true
       );
     }
 
-    throw new EmailDeliveryError('Postmark rejected the email', {
-      providerResponse,
-      status: response.status,
-      statusText: response.statusText,
-    });
+    throw new EmailDeliveryError('Postmark rejected the email', details);
   }
 
   return { status: response.status };
 }
+
+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);
+    }
+    throw new EmailDeliveryError('Postmark rejected the email', details);
+  }
+  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {
+    throw new EmailDeliveryError(
+      'Postmark recipient is inactive',
+      details,
+      true
+    );
+  }
+  throw new EmailDeliveryError('Email delivery failed', details);
+}