@vrplatform/email 1.0.2-stage.557 → 1.0.2-stage.560

package/build/main/utils/find-postmark-email.d.ts

@@ -3,6 +3,6 @@ export declare function findPostmarkEmail(deliveryId: string, options: {
     postmarkToken?: string;
 }): Promise<{
     httpStatus: number;
-    messageId: any;
-    submittedAt: any;
+    messageId: string;
+    submittedAt: string;
 } | undefined>;

package/build/main/utils/find-postmark-email.js

@@ -2,7 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findPostmarkEmail = findPostmarkEmail;
 const utils_1 = require("@vrplatform/utils");
+const zod_1 = require("zod");
 const send_email_1 = require("./send-email");
+const postmarkMessagesResponseSchema = zod_1.z.object({
+    TotalCount: zod_1.z.number().int().nonnegative(),
+    Messages: zod_1.z.array(zod_1.z.object({
+        MessageID: zod_1.z.string().min(1),
+        ReceivedAt: zod_1.z.string().refine((value) => (0, utils_1.day)(value).isValid()),
+        Metadata: zod_1.z.object({ deliveryId: zod_1.z.string() }).passthrough(),
+    })),
+});
 async function findPostmarkEmail(deliveryId, options) {
     if (!options.postmarkToken) {
         throw new send_email_1.EmailDeliveryError('Postmark is not configured', undefined, false, false);
@@ -27,40 +36,20 @@ async function findPostmarkEmail(deliveryId, options) {
             httpStatus: response.status,
         }, false, response.status === 429 || response.status >= 500);
     }
-    if (!providerResponse ||
-        typeof providerResponse !== 'object' ||
-        !('TotalCount' in providerResponse) ||
-        typeof providerResponse.TotalCount !== 'number' ||
-        !('Messages' in providerResponse) ||
-        !Array.isArray(providerResponse.Messages)) {
+    const result = postmarkMessagesResponseSchema.safeParse(providerResponse);
+    if (!result.success) {
         throw new send_email_1.EmailDeliveryError('Postmark returned an invalid response');
     }
-    if (providerResponse.TotalCount === 0)
+    if (result.data.TotalCount === 0)
         return undefined;
-    const message = providerResponse.Messages.find((value) => value &&
-        typeof value === 'object' &&
-        'Metadata' in value &&
-        value.Metadata &&
-        typeof value.Metadata === 'object' &&
-        'deliveryId' in value.Metadata &&
-        value.Metadata.deliveryId === deliveryId);
-    const messageId = message &&
-        typeof message === 'object' &&
-        'MessageID' in message &&
-        typeof message.MessageID === 'string' &&
-        message.MessageID
-        ? message.MessageID
-        : undefined;
-    const submittedAt = message &&
-        typeof message === 'object' &&
-        'ReceivedAt' in message &&
-        typeof message.ReceivedAt === 'string' &&
-        (0, utils_1.day)(message.ReceivedAt).isValid()
-        ? message.ReceivedAt
-        : undefined;
-    if (!messageId || !submittedAt) {
+    const message = result.data.Messages.find(({ Metadata }) => Metadata.deliveryId === deliveryId);
+    if (!message) {
         throw new send_email_1.EmailDeliveryError('Postmark returned an invalid response');
     }
-    return { httpStatus: response.status, messageId, submittedAt };
+    return {
+        httpStatus: response.status,
+        messageId: message.MessageID,
+        submittedAt: message.ReceivedAt,
+    };
 }
 //# sourceMappingURL=find-postmark-email.js.map

package/build/main/utils/find-postmark-email.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-postmark-email.js","sourceRoot":"src/","sources":["utils/find-postmark-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { EmailDeliveryError } from './send-email';\n\nexport async function findPostmarkEmail(\n  deliveryId: string,\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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\n  }\n\n  const url = new URL('https://api.postmarkapp.com/messages/outbound');\n  url.searchParams.set('count', '1');\n  url.searchParams.set('offset', '0');\n  url.searchParams.set('messagestream', 'outbound');\n  url.searchParams.set('metadata_deliveryId', deliveryId);\n  const response = await (options.fetch ?? fetch)(url, {\n    method: 'GET',\n    headers: {\n      Accept: 'application/json',\n      'X-Postmark-Server-Token': options.postmarkToken,\n    },\n  });\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n\n  if (!response.ok) {\n    throw new EmailDeliveryError(\n      'Postmark message lookup failed',\n      {\n        provider: 'postmark',\n        providerCategory: 'rejected',\n        httpStatus: response.status,\n      },\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  if (\n    !providerResponse ||\n    typeof providerResponse !== 'object' ||\n    !('TotalCount' in providerResponse) ||\n    typeof providerResponse.TotalCount !== 'number' ||\n    !('Messages' in providerResponse) ||\n    !Array.isArray(providerResponse.Messages)\n  ) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n  if (providerResponse.TotalCount === 0) return undefined;\n\n  const message = providerResponse.Messages.find(\n    (value) =>\n      value &&\n      typeof value === 'object' &&\n      'Metadata' in value &&\n      value.Metadata &&\n      typeof value.Metadata === 'object' &&\n      'deliveryId' in value.Metadata &&\n      value.Metadata.deliveryId === deliveryId\n  );\n  const messageId =\n    message &&\n    typeof message === 'object' &&\n    'MessageID' in message &&\n    typeof message.MessageID === 'string' &&\n    message.MessageID\n      ? message.MessageID\n      : undefined;\n  const submittedAt =\n    message &&\n    typeof message === 'object' &&\n    'ReceivedAt' in message &&\n    typeof message.ReceivedAt === 'string' &&\n    day(message.ReceivedAt).isValid()\n      ? message.ReceivedAt\n      : undefined;\n  if (!messageId || !submittedAt) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n\n  return { httpStatus: response.status, messageId, submittedAt };\n}\n"]}
+{"version":3,"file":"find-postmark-email.js","sourceRoot":"src/","sources":["utils/find-postmark-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { z } from 'zod';\nimport { EmailDeliveryError } from './send-email';\n\nconst postmarkMessagesResponseSchema = z.object({\n  TotalCount: z.number().int().nonnegative(),\n  Messages: z.array(\n    z.object({\n      MessageID: z.string().min(1),\n      ReceivedAt: z.string().refine((value) => day(value).isValid()),\n      Metadata: z.object({ deliveryId: z.string() }).passthrough(),\n    })\n  ),\n});\n\nexport async function findPostmarkEmail(\n  deliveryId: string,\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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\n  }\n\n  const url = new URL('https://api.postmarkapp.com/messages/outbound');\n  url.searchParams.set('count', '1');\n  url.searchParams.set('offset', '0');\n  url.searchParams.set('messagestream', 'outbound');\n  url.searchParams.set('metadata_deliveryId', deliveryId);\n  const response = await (options.fetch ?? fetch)(url, {\n    method: 'GET',\n    headers: {\n      Accept: 'application/json',\n      'X-Postmark-Server-Token': options.postmarkToken,\n    },\n  });\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n\n  if (!response.ok) {\n    throw new EmailDeliveryError(\n      'Postmark message lookup failed',\n      {\n        provider: 'postmark',\n        providerCategory: 'rejected',\n        httpStatus: response.status,\n      },\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const result = postmarkMessagesResponseSchema.safeParse(providerResponse);\n  if (!result.success) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n  if (result.data.TotalCount === 0) return undefined;\n\n  const message = result.data.Messages.find(\n    ({ Metadata }) => Metadata.deliveryId === deliveryId\n  );\n  if (!message) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId: message.MessageID,\n    submittedAt: message.ReceivedAt,\n  };\n}\n"]}

package/build/main/utils/index.d.ts

@@ -1,3 +1,2 @@
 export * from './find-postmark-email';
-export * from './find-postmark-email';
 export * from './send-email';

package/build/main/utils/index.js

@@ -15,6 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./find-postmark-email"), exports);
-__exportStar(require("./find-postmark-email"), exports);
 __exportStar(require("./send-email"), exports);
 //# sourceMappingURL=index.js.map

package/build/main/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"src/","sources":["utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,wDAAsC;AACtC,+CAA6B","sourcesContent":["export * from './find-postmark-email';\nexport * from './find-postmark-email';\nexport * from './send-email';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,+CAA6B","sourcesContent":["export * from './find-postmark-email';\nexport * from './send-email';\n"]}

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

@@ -4,6 +4,26 @@ exports.EmailDeliveryError = void 0;
 exports.sendEmail = sendEmail;
 exports.settleEmailDeliveries = settleEmailDeliveries;
 const utils_1 = require("@vrplatform/utils");
+const zod_1 = require("zod");
+const postmarkErrorCodeSchema = zod_1.z.number().int().nonnegative();
+const postmarkResponseErrorCodeSchema = zod_1.z
+    .object({ ErrorCode: postmarkErrorCodeSchema })
+    .transform(({ ErrorCode }) => ErrorCode);
+const postmarkHeaderErrorCodeSchema = zod_1.z
+    .string()
+    .regex(/^\d+$/)
+    .transform(Number)
+    .pipe(postmarkErrorCodeSchema);
+const postmarkSuccessResponseSchema = zod_1.z.object({
+    ErrorCode: zod_1.z.literal(0),
+    MessageID: zod_1.z.string().min(1),
+    SubmittedAt: zod_1.z.string().refine((value) => (0, utils_1.day)(value).isValid()),
+});
+function parseOptional(schema, value) {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return result.data;
+}
 class EmailDeliveryError extends Error {
     constructor(message, details, expected = false, retryable = true) {
         super(message);
@@ -38,22 +58,8 @@ async function sendEmail(data, options) {
         }),
     });
     const providerResponse = await response.json().catch(() => ({}));
-    const responseErrorCode = providerResponse !== null &&
-        typeof providerResponse === 'object' &&
-        '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;
+    const postmarkErrorCode = parseOptional(postmarkResponseErrorCodeSchema, providerResponse) ??
+        parseOptional(postmarkHeaderErrorCodeSchema, response.headers.get('X-PM-ApiErrorCode'));
     if (!response.ok ||
         (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)) {
         const inactiveRecipient = response.status === 422 && postmarkErrorCode === 406;
@@ -68,21 +74,8 @@ async function sendEmail(data, options) {
         }
         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' &&
-        (0, utils_1.day)(providerResponse.SubmittedAt).isValid()
-        ? providerResponse.SubmittedAt
-        : undefined;
-    if (!messageId || !submittedAt || postmarkErrorCode !== 0) {
+    const result = postmarkSuccessResponseSchema.safeParse(providerResponse);
+    if (!result.success) {
         throw new EmailDeliveryError('Postmark returned an invalid response', {
             provider: 'postmark',
             providerCategory: 'rejected',
@@ -92,8 +85,8 @@ async function sendEmail(data, options) {
     }
     return {
         httpStatus: response.status,
-        messageId,
-        submittedAt,
+        messageId: result.data.MessageID,
+        submittedAt: result.data.SubmittedAt,
     };
 }
 async function settleEmailDeliveries(deliveries) {

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":"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","sourcesContent":["import { day } from '@vrplatform/utils';\n\ntype 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    public readonly retryable = true\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    tag?: string;\n    metadata?: Record<string, 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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\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        Tag: data.tag,\n        Metadata: data.metadata,\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 (\n    !response.ok ||\n    (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)\n  ) {\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        false\n      );\n    }\n\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const messageId =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'MessageID' in providerResponse &&\n    typeof providerResponse.MessageID === 'string' &&\n    providerResponse.MessageID\n      ? providerResponse.MessageID\n      : undefined;\n  const submittedAt =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'SubmittedAt' in providerResponse &&\n    typeof providerResponse.SubmittedAt === 'string' &&\n    day(providerResponse.SubmittedAt).isValid()\n      ? providerResponse.SubmittedAt\n      : undefined;\n  if (!messageId || !submittedAt || postmarkErrorCode !== 0) {\n    throw new EmailDeliveryError('Postmark returned an invalid response', {\n      provider: 'postmark',\n      providerCategory: 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    });\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId,\n    submittedAt,\n  };\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(\n        'Postmark is not configured',\n        details,\n        false,\n        false\n      );\n    }\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      unexpectedDeliveryError.retryable\n    );\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true,\n      false\n    );\n  }\n  throw new EmailDeliveryError('Email delivery failed', details);\n}\n"]}
+{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { z } from 'zod';\n\nconst postmarkErrorCodeSchema = z.number().int().nonnegative();\nconst postmarkResponseErrorCodeSchema = z\n  .object({ ErrorCode: postmarkErrorCodeSchema })\n  .transform(({ ErrorCode }) => ErrorCode);\nconst postmarkHeaderErrorCodeSchema = z\n  .string()\n  .regex(/^\\d+$/)\n  .transform(Number)\n  .pipe(postmarkErrorCodeSchema);\nconst postmarkSuccessResponseSchema = z.object({\n  ErrorCode: z.literal(0),\n  MessageID: z.string().min(1),\n  SubmittedAt: z.string().refine((value) => day(value).isValid()),\n});\n\nfunction parseOptional<T>(schema: z.ZodType<T>, value: unknown) {\n  const result = schema.safeParse(value);\n  if (result.success) return result.data;\n}\n\ntype 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    public readonly retryable = true\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    tag?: string;\n    metadata?: Record<string, 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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\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        Tag: data.tag,\n        Metadata: data.metadata,\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const postmarkErrorCode =\n    parseOptional(postmarkResponseErrorCodeSchema, providerResponse) ??\n    parseOptional(\n      postmarkHeaderErrorCodeSchema,\n      response.headers.get('X-PM-ApiErrorCode')\n    );\n\n  if (\n    !response.ok ||\n    (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)\n  ) {\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        false\n      );\n    }\n\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const result = postmarkSuccessResponseSchema.safeParse(providerResponse);\n  if (!result.success) {\n    throw new EmailDeliveryError('Postmark returned an invalid response', {\n      provider: 'postmark',\n      providerCategory: 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    });\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId: result.data.MessageID,\n    submittedAt: result.data.SubmittedAt,\n  };\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(\n        'Postmark is not configured',\n        details,\n        false,\n        false\n      );\n    }\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      unexpectedDeliveryError.retryable\n    );\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true,\n      false\n    );\n  }\n  throw new EmailDeliveryError('Email delivery failed', details);\n}\n"]}

package/build/module/utils/find-postmark-email.d.ts

@@ -3,6 +3,6 @@ export declare function findPostmarkEmail(deliveryId: string, options: {
     postmarkToken?: string;
 }): Promise<{
     httpStatus: number;
-    messageId: any;
-    submittedAt: any;
+    messageId: string;
+    submittedAt: string;
 } | undefined>;

package/build/module/utils/find-postmark-email.js

@@ -1,5 +1,14 @@
 import { day } from '@vrplatform/utils';
+import { z } from 'zod';
 import { EmailDeliveryError } from './send-email';
+const postmarkMessagesResponseSchema = z.object({
+    TotalCount: z.number().int().nonnegative(),
+    Messages: z.array(z.object({
+        MessageID: z.string().min(1),
+        ReceivedAt: z.string().refine((value) => day(value).isValid()),
+        Metadata: z.object({ deliveryId: z.string() }).passthrough(),
+    })),
+});
 export async function findPostmarkEmail(deliveryId, options) {
     if (!options.postmarkToken) {
         throw new EmailDeliveryError('Postmark is not configured', undefined, false, false);
@@ -24,40 +33,20 @@ export async function findPostmarkEmail(deliveryId, options) {
             httpStatus: response.status,
         }, false, response.status === 429 || response.status >= 500);
     }
-    if (!providerResponse ||
-        typeof providerResponse !== 'object' ||
-        !('TotalCount' in providerResponse) ||
-        typeof providerResponse.TotalCount !== 'number' ||
-        !('Messages' in providerResponse) ||
-        !Array.isArray(providerResponse.Messages)) {
+    const result = postmarkMessagesResponseSchema.safeParse(providerResponse);
+    if (!result.success) {
         throw new EmailDeliveryError('Postmark returned an invalid response');
     }
-    if (providerResponse.TotalCount === 0)
+    if (result.data.TotalCount === 0)
         return undefined;
-    const message = providerResponse.Messages.find((value) => value &&
-        typeof value === 'object' &&
-        'Metadata' in value &&
-        value.Metadata &&
-        typeof value.Metadata === 'object' &&
-        'deliveryId' in value.Metadata &&
-        value.Metadata.deliveryId === deliveryId);
-    const messageId = message &&
-        typeof message === 'object' &&
-        'MessageID' in message &&
-        typeof message.MessageID === 'string' &&
-        message.MessageID
-        ? message.MessageID
-        : undefined;
-    const submittedAt = message &&
-        typeof message === 'object' &&
-        'ReceivedAt' in message &&
-        typeof message.ReceivedAt === 'string' &&
-        day(message.ReceivedAt).isValid()
-        ? message.ReceivedAt
-        : undefined;
-    if (!messageId || !submittedAt) {
+    const message = result.data.Messages.find(({ Metadata }) => Metadata.deliveryId === deliveryId);
+    if (!message) {
         throw new EmailDeliveryError('Postmark returned an invalid response');
     }
-    return { httpStatus: response.status, messageId, submittedAt };
+    return {
+        httpStatus: response.status,
+        messageId: message.MessageID,
+        submittedAt: message.ReceivedAt,
+    };
 }
 //# sourceMappingURL=find-postmark-email.js.map

package/build/module/utils/find-postmark-email.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-postmark-email.js","sourceRoot":"src/","sources":["utils/find-postmark-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { EmailDeliveryError } from './send-email';\n\nexport async function findPostmarkEmail(\n  deliveryId: string,\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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\n  }\n\n  const url = new URL('https://api.postmarkapp.com/messages/outbound');\n  url.searchParams.set('count', '1');\n  url.searchParams.set('offset', '0');\n  url.searchParams.set('messagestream', 'outbound');\n  url.searchParams.set('metadata_deliveryId', deliveryId);\n  const response = await (options.fetch ?? fetch)(url, {\n    method: 'GET',\n    headers: {\n      Accept: 'application/json',\n      'X-Postmark-Server-Token': options.postmarkToken,\n    },\n  });\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n\n  if (!response.ok) {\n    throw new EmailDeliveryError(\n      'Postmark message lookup failed',\n      {\n        provider: 'postmark',\n        providerCategory: 'rejected',\n        httpStatus: response.status,\n      },\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  if (\n    !providerResponse ||\n    typeof providerResponse !== 'object' ||\n    !('TotalCount' in providerResponse) ||\n    typeof providerResponse.TotalCount !== 'number' ||\n    !('Messages' in providerResponse) ||\n    !Array.isArray(providerResponse.Messages)\n  ) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n  if (providerResponse.TotalCount === 0) return undefined;\n\n  const message = providerResponse.Messages.find(\n    (value) =>\n      value &&\n      typeof value === 'object' &&\n      'Metadata' in value &&\n      value.Metadata &&\n      typeof value.Metadata === 'object' &&\n      'deliveryId' in value.Metadata &&\n      value.Metadata.deliveryId === deliveryId\n  );\n  const messageId =\n    message &&\n    typeof message === 'object' &&\n    'MessageID' in message &&\n    typeof message.MessageID === 'string' &&\n    message.MessageID\n      ? message.MessageID\n      : undefined;\n  const submittedAt =\n    message &&\n    typeof message === 'object' &&\n    'ReceivedAt' in message &&\n    typeof message.ReceivedAt === 'string' &&\n    day(message.ReceivedAt).isValid()\n      ? message.ReceivedAt\n      : undefined;\n  if (!messageId || !submittedAt) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n\n  return { httpStatus: response.status, messageId, submittedAt };\n}\n"]}
+{"version":3,"file":"find-postmark-email.js","sourceRoot":"src/","sources":["utils/find-postmark-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { z } from 'zod';\nimport { EmailDeliveryError } from './send-email';\n\nconst postmarkMessagesResponseSchema = z.object({\n  TotalCount: z.number().int().nonnegative(),\n  Messages: z.array(\n    z.object({\n      MessageID: z.string().min(1),\n      ReceivedAt: z.string().refine((value) => day(value).isValid()),\n      Metadata: z.object({ deliveryId: z.string() }).passthrough(),\n    })\n  ),\n});\n\nexport async function findPostmarkEmail(\n  deliveryId: string,\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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\n  }\n\n  const url = new URL('https://api.postmarkapp.com/messages/outbound');\n  url.searchParams.set('count', '1');\n  url.searchParams.set('offset', '0');\n  url.searchParams.set('messagestream', 'outbound');\n  url.searchParams.set('metadata_deliveryId', deliveryId);\n  const response = await (options.fetch ?? fetch)(url, {\n    method: 'GET',\n    headers: {\n      Accept: 'application/json',\n      'X-Postmark-Server-Token': options.postmarkToken,\n    },\n  });\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n\n  if (!response.ok) {\n    throw new EmailDeliveryError(\n      'Postmark message lookup failed',\n      {\n        provider: 'postmark',\n        providerCategory: 'rejected',\n        httpStatus: response.status,\n      },\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const result = postmarkMessagesResponseSchema.safeParse(providerResponse);\n  if (!result.success) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n  if (result.data.TotalCount === 0) return undefined;\n\n  const message = result.data.Messages.find(\n    ({ Metadata }) => Metadata.deliveryId === deliveryId\n  );\n  if (!message) {\n    throw new EmailDeliveryError('Postmark returned an invalid response');\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId: message.MessageID,\n    submittedAt: message.ReceivedAt,\n  };\n}\n"]}

package/build/module/utils/index.d.ts

@@ -1,3 +1,2 @@
 export * from './find-postmark-email';
-export * from './find-postmark-email';
 export * from './send-email';

package/build/module/utils/index.js

@@ -1,4 +1,3 @@
 export * from './find-postmark-email';
-export * from './find-postmark-email';
 export * from './send-email';
 //# sourceMappingURL=index.js.map

package/build/module/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"src/","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC","sourcesContent":["export * from './find-postmark-email';\nexport * from './find-postmark-email';\nexport * from './send-email';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC","sourcesContent":["export * from './find-postmark-email';\nexport * from './send-email';\n"]}

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

@@ -1,4 +1,24 @@
 import { day } from '@vrplatform/utils';
+import { z } from 'zod';
+const postmarkErrorCodeSchema = z.number().int().nonnegative();
+const postmarkResponseErrorCodeSchema = z
+    .object({ ErrorCode: postmarkErrorCodeSchema })
+    .transform(({ ErrorCode }) => ErrorCode);
+const postmarkHeaderErrorCodeSchema = z
+    .string()
+    .regex(/^\d+$/)
+    .transform(Number)
+    .pipe(postmarkErrorCodeSchema);
+const postmarkSuccessResponseSchema = z.object({
+    ErrorCode: z.literal(0),
+    MessageID: z.string().min(1),
+    SubmittedAt: z.string().refine((value) => day(value).isValid()),
+});
+function parseOptional(schema, value) {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return result.data;
+}
 export class EmailDeliveryError extends Error {
     details;
     expected;
@@ -35,22 +55,8 @@ export async function sendEmail(data, options) {
         }),
     });
     const providerResponse = await response.json().catch(() => ({}));
-    const responseErrorCode = providerResponse !== null &&
-        typeof providerResponse === 'object' &&
-        '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;
+    const postmarkErrorCode = parseOptional(postmarkResponseErrorCodeSchema, providerResponse) ??
+        parseOptional(postmarkHeaderErrorCodeSchema, response.headers.get('X-PM-ApiErrorCode'));
     if (!response.ok ||
         (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)) {
         const inactiveRecipient = response.status === 422 && postmarkErrorCode === 406;
@@ -65,21 +71,8 @@ export async function sendEmail(data, options) {
         }
         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) {
+    const result = postmarkSuccessResponseSchema.safeParse(providerResponse);
+    if (!result.success) {
         throw new EmailDeliveryError('Postmark returned an invalid response', {
             provider: 'postmark',
             providerCategory: 'rejected',
@@ -89,8 +82,8 @@ export async function sendEmail(data, options) {
     }
     return {
         httpStatus: response.status,
-        messageId,
-        submittedAt,
+        messageId: result.data.MessageID,
+        submittedAt: result.data.SubmittedAt,
     };
 }
 export async function settleEmailDeliveries(deliveries) {

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":"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","sourcesContent":["import { day } from '@vrplatform/utils';\n\ntype 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    public readonly retryable = true\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    tag?: string;\n    metadata?: Record<string, 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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\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        Tag: data.tag,\n        Metadata: data.metadata,\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 (\n    !response.ok ||\n    (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)\n  ) {\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        false\n      );\n    }\n\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const messageId =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'MessageID' in providerResponse &&\n    typeof providerResponse.MessageID === 'string' &&\n    providerResponse.MessageID\n      ? providerResponse.MessageID\n      : undefined;\n  const submittedAt =\n    providerResponse !== null &&\n    typeof providerResponse === 'object' &&\n    'SubmittedAt' in providerResponse &&\n    typeof providerResponse.SubmittedAt === 'string' &&\n    day(providerResponse.SubmittedAt).isValid()\n      ? providerResponse.SubmittedAt\n      : undefined;\n  if (!messageId || !submittedAt || postmarkErrorCode !== 0) {\n    throw new EmailDeliveryError('Postmark returned an invalid response', {\n      provider: 'postmark',\n      providerCategory: 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    });\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId,\n    submittedAt,\n  };\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(\n        'Postmark is not configured',\n        details,\n        false,\n        false\n      );\n    }\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      unexpectedDeliveryError.retryable\n    );\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true,\n      false\n    );\n  }\n  throw new EmailDeliveryError('Email delivery failed', details);\n}\n"]}
+{"version":3,"file":"send-email.js","sourceRoot":"src/","sources":["utils/send-email.ts"],"names":[],"mappings":"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","sourcesContent":["import { day } from '@vrplatform/utils';\nimport { z } from 'zod';\n\nconst postmarkErrorCodeSchema = z.number().int().nonnegative();\nconst postmarkResponseErrorCodeSchema = z\n  .object({ ErrorCode: postmarkErrorCodeSchema })\n  .transform(({ ErrorCode }) => ErrorCode);\nconst postmarkHeaderErrorCodeSchema = z\n  .string()\n  .regex(/^\\d+$/)\n  .transform(Number)\n  .pipe(postmarkErrorCodeSchema);\nconst postmarkSuccessResponseSchema = z.object({\n  ErrorCode: z.literal(0),\n  MessageID: z.string().min(1),\n  SubmittedAt: z.string().refine((value) => day(value).isValid()),\n});\n\nfunction parseOptional<T>(schema: z.ZodType<T>, value: unknown) {\n  const result = schema.safeParse(value);\n  if (result.success) return result.data;\n}\n\ntype 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    public readonly retryable = true\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    tag?: string;\n    metadata?: Record<string, 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(\n      'Postmark is not configured',\n      undefined,\n      false,\n      false\n    );\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        Tag: data.tag,\n        Metadata: data.metadata,\n      }),\n    }\n  );\n\n  const providerResponse: unknown = await response.json().catch(() => ({}));\n  const postmarkErrorCode =\n    parseOptional(postmarkResponseErrorCodeSchema, providerResponse) ??\n    parseOptional(\n      postmarkHeaderErrorCodeSchema,\n      response.headers.get('X-PM-ApiErrorCode')\n    );\n\n  if (\n    !response.ok ||\n    (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)\n  ) {\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        false\n      );\n    }\n\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      response.status === 429 || response.status >= 500\n    );\n  }\n\n  const result = postmarkSuccessResponseSchema.safeParse(providerResponse);\n  if (!result.success) {\n    throw new EmailDeliveryError('Postmark returned an invalid response', {\n      provider: 'postmark',\n      providerCategory: 'rejected',\n      httpStatus: response.status,\n      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),\n    });\n  }\n\n  return {\n    httpStatus: response.status,\n    messageId: result.data.MessageID,\n    submittedAt: result.data.SubmittedAt,\n  };\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(\n        'Postmark is not configured',\n        details,\n        false,\n        false\n      );\n    }\n    throw new EmailDeliveryError(\n      'Postmark rejected the email',\n      details,\n      false,\n      unexpectedDeliveryError.retryable\n    );\n  }\n  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {\n    throw new EmailDeliveryError(\n      'Postmark recipient is inactive',\n      details,\n      true,\n      false\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.557",
+  "version": "1.0.2-stage.560",
   "description": "VRTrust transactional email templates and Postmark transport",
   "license": "ISC",
   "main": "build/main/index.js",
@@ -30,7 +30,8 @@
     "@react-email/img": "0.0.9",
     "@react-email/preview": "0.0.10",
     "@react-email/render": "0.0.17",
-    "@react-email/text": "0.0.9"
+    "@react-email/text": "0.0.9",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@vrplatform/utils": "*",

package/src/utils/find-postmark-email.ts

@@ -1,6 +1,18 @@
 import { day } from '@vrplatform/utils';
+import { z } from 'zod';
 import { EmailDeliveryError } from './send-email';
 
+const postmarkMessagesResponseSchema = z.object({
+  TotalCount: z.number().int().nonnegative(),
+  Messages: z.array(
+    z.object({
+      MessageID: z.string().min(1),
+      ReceivedAt: z.string().refine((value) => day(value).isValid()),
+      Metadata: z.object({ deliveryId: z.string() }).passthrough(),
+    })
+  ),
+});
+
 export async function findPostmarkEmail(
   deliveryId: string,
   options: {
@@ -47,47 +59,22 @@ export async function findPostmarkEmail(
     );
   }
 
-  if (
-    !providerResponse ||
-    typeof providerResponse !== 'object' ||
-    !('TotalCount' in providerResponse) ||
-    typeof providerResponse.TotalCount !== 'number' ||
-    !('Messages' in providerResponse) ||
-    !Array.isArray(providerResponse.Messages)
-  ) {
+  const result = postmarkMessagesResponseSchema.safeParse(providerResponse);
+  if (!result.success) {
     throw new EmailDeliveryError('Postmark returned an invalid response');
   }
-  if (providerResponse.TotalCount === 0) return undefined;
+  if (result.data.TotalCount === 0) return undefined;
 
-  const message = providerResponse.Messages.find(
-    (value) =>
-      value &&
-      typeof value === 'object' &&
-      'Metadata' in value &&
-      value.Metadata &&
-      typeof value.Metadata === 'object' &&
-      'deliveryId' in value.Metadata &&
-      value.Metadata.deliveryId === deliveryId
+  const message = result.data.Messages.find(
+    ({ Metadata }) => Metadata.deliveryId === deliveryId
   );
-  const messageId =
-    message &&
-    typeof message === 'object' &&
-    'MessageID' in message &&
-    typeof message.MessageID === 'string' &&
-    message.MessageID
-      ? message.MessageID
-      : undefined;
-  const submittedAt =
-    message &&
-    typeof message === 'object' &&
-    'ReceivedAt' in message &&
-    typeof message.ReceivedAt === 'string' &&
-    day(message.ReceivedAt).isValid()
-      ? message.ReceivedAt
-      : undefined;
-  if (!messageId || !submittedAt) {
+  if (!message) {
     throw new EmailDeliveryError('Postmark returned an invalid response');
   }
 
-  return { httpStatus: response.status, messageId, submittedAt };
+  return {
+    httpStatus: response.status,
+    messageId: message.MessageID,
+    submittedAt: message.ReceivedAt,
+  };
 }

package/src/utils/index.ts

@@ -1,3 +1,2 @@
 export * from './find-postmark-email';
-export * from './find-postmark-email';
 export * from './send-email';

package/src/utils/send-email.ts

@@ -1,4 +1,25 @@
 import { day } from '@vrplatform/utils';
+import { z } from 'zod';
+
+const postmarkErrorCodeSchema = z.number().int().nonnegative();
+const postmarkResponseErrorCodeSchema = z
+  .object({ ErrorCode: postmarkErrorCodeSchema })
+  .transform(({ ErrorCode }) => ErrorCode);
+const postmarkHeaderErrorCodeSchema = z
+  .string()
+  .regex(/^\d+$/)
+  .transform(Number)
+  .pipe(postmarkErrorCodeSchema);
+const postmarkSuccessResponseSchema = z.object({
+  ErrorCode: z.literal(0),
+  MessageID: z.string().min(1),
+  SubmittedAt: z.string().refine((value) => day(value).isValid()),
+});
+
+function parseOptional<T>(schema: z.ZodType<T>, value: unknown) {
+  const result = schema.safeParse(value);
+  if (result.success) return result.data;
+}
 
 type EmailDeliveryFailureDetails = {
   httpStatus: number;
@@ -77,25 +98,12 @@ export async function sendEmail(
   );
 
   const providerResponse: unknown = await response.json().catch(() => ({}));
-  const responseErrorCode =
-    providerResponse !== null &&
-    typeof providerResponse === 'object' &&
-    '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;
+    parseOptional(postmarkResponseErrorCodeSchema, providerResponse) ??
+    parseOptional(
+      postmarkHeaderErrorCodeSchema,
+      response.headers.get('X-PM-ApiErrorCode')
+    );
 
   if (
     !response.ok ||
@@ -127,23 +135,8 @@ export async function sendEmail(
     );
   }
 
-  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) {
+  const result = postmarkSuccessResponseSchema.safeParse(providerResponse);
+  if (!result.success) {
     throw new EmailDeliveryError('Postmark returned an invalid response', {
       provider: 'postmark',
       providerCategory: 'rejected',
@@ -154,8 +147,8 @@ export async function sendEmail(
 
   return {
     httpStatus: response.status,
-    messageId,
-    submittedAt,
+    messageId: result.data.MessageID,
+    submittedAt: result.data.SubmittedAt,
   };
 }