@vrplatform/email 1.0.2-373 → 1.0.2-37339970689

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":["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\n/**\n * Formats a verified sender address with a display name for the From header.\n * Registrations store bare addresses; recipients should still see the company\n * name the way they see `VRPlatform <notifications@vrplatform.app>`.\n */\nexport function formatSenderIdentity(\n  name: string | null | undefined,\n  address: string\n) {\n  const display = (name ?? '').replace(/[\\r\\n\"<>]/g, '').trim();\n  return display ? `\"${display}\" <${address}>` : address;\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    from?: 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: data.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-373",
+  "version": "1.0.2-37339970689",
   "description": "VRTrust transactional email templates and Postmark transport",
   "license": "ISC",
   "main": "build/main/index.js",
@@ -30,16 +30,17 @@
     "@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": "*",
+    "@vrplatform/utils": "1.0.21",
     "react": "^19.0.0"
   },
   "devDependencies": {
     "@types/react": "19.2.17",
     "@vrplatform/bin": "*",
-    "@vrplatform/utils": "*",
+    "@vrplatform/utils": "1.0.21",
     "react": "19.2.7"
   },
   "files": [

package/src/components/ActionEmailTemplate.tsx

@@ -33,9 +33,7 @@ export const ActionEmailTemplate = ({
     <EmailContainer
       title={data.subject}
       shortDescription={data.shortDescription}
-      tenant={{
-        logo: tenant.logo,
-      }}
+      tenant={tenant}
       mode={mode}
     >
       <Heading

package/src/components/EmailContainer.tsx

@@ -12,7 +12,7 @@ import type { EmailBaseProps } from '../types';
 type Props = {
   children: React.ReactNode;
   title: string;
-  tenant: Omit<EmailBaseProps['tenant'], 'name'>;
+  tenant: Omit<EmailBaseProps['tenant'], 'name'> & { name?: string };
   mode: EmailBaseProps['mode'];
   shortDescription?: string;
 };
@@ -68,7 +68,11 @@ export const EmailContainer = (props: Props) => {
   );
 };
 
-const Content = ({ children, tenant: { logo: tenantLogo }, mode }: Props) => {
+const Content = ({
+  children,
+  tenant: { logo: tenantLogo, name, showPlatformBranding = true },
+  mode,
+}: Props) => {
   return (
     <>
       {tenantLogo ? (
@@ -86,6 +90,8 @@ const Content = ({ children, tenant: { logo: tenantLogo }, mode }: Props) => {
         >
           <Img src={tenantLogo} alt={'Logo'} width={70} />
         </div>
+      ) : !showPlatformBranding ? (
+        <Text>{name}</Text>
       ) : mode === 'send' ? (
         <Img
           src={'https://staging.portal.vrplatform.app/logo.png'}
@@ -105,7 +111,7 @@ const Content = ({ children, tenant: { logo: tenantLogo }, mode }: Props) => {
 
       {children}
 
-      <Footer />
+      {showPlatformBranding ? <Footer /> : <Text>{name}</Text>}
     </>
   );
 };

package/src/components/utils/parse-email-html.ts

@@ -1,3 +1,11 @@
+const escapeHtml = (value: string) =>
+  value
+    .replaceAll('&', '&')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&#39;');
+
 export const parseEmailHtml = (
   html: string,
   args: {
@@ -10,16 +18,22 @@ export const parseEmailHtml = (
   // parse out any html scripts of type : <team-name-component></team-name-component> or <user-name-component></user-name-component>
   // and replace them with the appropriate component
   // return the parsed html
+  // Values are escaped because names come from users and integrations. Function
+  // replacers keep `$` sequences in a value from being read as patterns.
+  const href = escapeHtml(args.href);
 
   return html
     .replaceAll(
       /<action-link-component><\/action-link-component>/g,
-      `<a href="${args.href}" target="_blank">${args.href}</a>`
+      () => `<a href="${href}" target="_blank">${href}</a>`
     )
-    .replaceAll(/<user-name-component><\/user-name-component>/g, args.userName)
-    .replaceAll(
-      /<listing-name-component><\/listing-name-component>/g,
-      args.listingName
+    .replaceAll(/<user-name-component><\/user-name-component>/g, () =>
+      escapeHtml(args.userName)
+    )
+    .replaceAll(/<listing-name-component><\/listing-name-component>/g, () =>
+      escapeHtml(args.listingName)
     )
-    .replaceAll(/<date-component><\/date-component>/g, args.date);
+    .replaceAll(/<date-component><\/date-component>/g, () =>
+      escapeHtml(args.date)
+    );
 };

package/src/templates/InviteOwnerEmailTemplate.tsx

@@ -16,17 +16,30 @@ export const getDefaultInviteOwnerEmailData = (
     mode === 'tag' ? EMAIL_ACTION_LINK_COMPONENT : args.signInLink;
 
   return {
-    bodyOne: `<p>You are invited to join us on ${args.appName}.</p><p>To start using ${args.appName}, accept the invitation and verify your email address.</p>`,
+    bodyOne: `<p>You are invited to access your Owner Portal on ${args.appName}.</p><p>Accept the invitation below to set up your access.</p>`,
     bodyTwo: `<p>If you have any trouble with the button, you can copy and paste the link below into your browser: ${signInLink}</p>`,
     buttonText: 'Accept Invitation',
-    header: 'Welcome to the team!',
-    shortDescription:
-      'You have been invited to join the team. To start using VRPlatform, verify your email address at link below.',
+    header: 'Welcome to your Owner Portal!',
+    shortDescription: 'Set up your Owner Portal access using your invitation.',
     href: args.signInLink,
-    subject: `You are invited to join your team on ${args.appName}`,
+    subject: `Your invitation to the ${args.appName} Owner Portal`,
   };
 };
 
-export const InviteOwnerEmailTemplate = (props: ActionEmailTemplateProps) => {
-  return <ActionEmailTemplate {...props} />;
+export const InviteOwnerEmailTemplate = ({
+  ownerAccessRole = 'admin',
+  ...props
+}: ActionEmailTemplateProps & {
+  ownerAccessRole?: 'admin' | 'viewer';
+}) => {
+  return (
+    <ActionEmailTemplate
+      {...props}
+      data={{
+        ...props.data,
+        // Add guidance at render time so saved custom templates receive it too.
+        bodyTwo: `${props.data.bodyTwo}<hr style="width:100%;border:none;border-top:1px solid #eaeaea;margin:24px 0" /><p>This invitation link is for one-time setup of your Owner Portal access and expires after 7 days. Sign up using the exact email address this invitation was sent to.</p><p>If your invitation expires before setup is complete, contact your property manager for a new invitation.</p><p>For questions about ${ownerAccessRole === 'viewer' ? 'portal access' : 'your statements or portal access'}, contact your property manager.</p>`,
+      }}
+    />
+  );
 };

package/src/templates/InvitePmEmailTemplate.tsx

@@ -18,12 +18,11 @@ export const getDefaultInvitePropertyManagerEmailData = (
       : `<a href='${args.signInLink}' target='_blank'>${args.signInLink}</a>`;
 
   return {
-    bodyOne: `<p>You are invited to join us on ${args.appName}.</p><p>To start using ${args.appName}, accept the invitation and verify your email address.</p>`,
+    bodyOne: `<p>You are invited to join us on ${args.appName}.</p><p>Accept the invitation below to set up your team access.</p>`,
     bodyTwo: `<p>If you have any trouble with the button, you can use the following link below: ${signInLink}</p>`,
     buttonText: 'Accept Invitation',
     header: 'Welcome to the team!',
-    shortDescription:
-      'You have been invited to join the team. To start using VRPlatform, verify your email address at link below.',
+    shortDescription: `Accept your invitation to join your team on ${args.appName}.`,
     href: args.signInLink,
     subject: `You are invited to join your team on ${args.appName}`,
   };
@@ -33,6 +32,11 @@ export const InvitePmEmailTemplate = (props: ActionEmailTemplateProps) => {
   return (
     <ActionEmailTemplate
       {...props}
+      data={{
+        ...props.data,
+        // Add guidance at render time so saved custom templates receive it too.
+        bodyTwo: `${props.data.bodyTwo}<hr style="width:100%;border:none;border-top:1px solid #eaeaea;margin:24px 0" /><p>This invitation link is for one-time setup of your team access and expires after 7 days. Sign up using the exact email address this invitation was sent to.</p><p>If your invitation expires before setup is complete, contact your team administrator for a new invitation.</p><p>For questions about team access, contact your team administrator.</p>`,
+      }}
       tenant={{
         logo: undefined,
         name: props.tenant.name,

package/src/types.ts

@@ -2,6 +2,7 @@ export type EmailBaseProps = {
   mode: 'edit' | 'preview' | 'send';
   tenant: {
     name: string;
+    showPlatformBranding?: boolean;
     logo: string | undefined | null;
   };
   listing: string | undefined;

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

@@ -0,0 +1,80 @@
+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: {
+    fetch?: (
+      input: string | URL | Request,
+      init?: RequestInit
+    ) => Promise<Response>;
+    postmarkToken?: string;
+  }
+) {
+  if (!options.postmarkToken) {
+    throw new EmailDeliveryError(
+      'Postmark is not configured',
+      undefined,
+      false,
+      false
+    );
+  }
+
+  const url = new URL('https://api.postmarkapp.com/messages/outbound');
+  url.searchParams.set('count', '1');
+  url.searchParams.set('offset', '0');
+  url.searchParams.set('messagestream', 'outbound');
+  url.searchParams.set('metadata_deliveryId', deliveryId);
+  const response = await (options.fetch ?? fetch)(url, {
+    method: 'GET',
+    headers: {
+      Accept: 'application/json',
+      'X-Postmark-Server-Token': options.postmarkToken,
+    },
+  });
+  const providerResponse: unknown = await response.json().catch(() => ({}));
+
+  if (!response.ok) {
+    throw new EmailDeliveryError(
+      'Postmark message lookup failed',
+      {
+        provider: 'postmark',
+        providerCategory: 'rejected',
+        httpStatus: response.status,
+      },
+      false,
+      response.status === 429 || response.status >= 500
+    );
+  }
+
+  const result = postmarkMessagesResponseSchema.safeParse(providerResponse);
+  if (!result.success) {
+    throw new EmailDeliveryError('Postmark returned an invalid response');
+  }
+  if (result.data.TotalCount === 0) return undefined;
+
+  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: message.MessageID,
+    submittedAt: message.ReceivedAt,
+  };
+}

package/src/utils/index.ts

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

package/src/utils/send-email.ts

@@ -1,14 +1,65 @@
+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;
+  postmarkErrorCode?: number;
+  provider: 'postmark';
+  providerCategory: 'inactiveRecipient' | 'rejected';
+};
+
+type EmailDeliveryErrorDetails =
+  | EmailDeliveryFailureDetails
+  | {
+      failureCount: number;
+      failures: EmailDeliveryFailureDetails[];
+    };
+
 export class EmailDeliveryError extends Error {
   constructor(
     message: string,
-    public readonly details?: Record<string, unknown>,
-    public readonly expected = false
+    public readonly details?: EmailDeliveryErrorDetails,
+    public readonly expected = false,
+    public readonly retryable = true
   ) {
     super(message);
     this.name = 'EmailDeliveryError';
   }
 }
 
+/**
+ * Formats a verified sender address with a display name for the From header.
+ * Registrations store bare addresses; recipients should still see the company
+ * name the way they see `VRPlatform <notifications@vrplatform.app>`.
+ */
+export function formatSenderIdentity(
+  name: string | null | undefined,
+  address: string
+) {
+  const display = (name ?? '').replace(/[\r\n"<>]/g, '').trim();
+  return display ? `"${display}" <${address}>` : address;
+}
+
 export async function sendEmail(
   data: {
     to: string;
@@ -16,6 +67,9 @@ export async function sendEmail(
     text: string;
     html: string;
     replyTo?: string;
+    tag?: string;
+    metadata?: Record<string, string>;
+    from?: string;
   },
   options: {
     fetch?: (
@@ -26,7 +80,12 @@ export async function sendEmail(
   }
 ) {
   if (!options.postmarkToken) {
-    throw new EmailDeliveryError('Postmark is not configured');
+    throw new EmailDeliveryError(
+      'Postmark is not configured',
+      undefined,
+      false,
+      false
+    );
   }
 
   const response = await (options.fetch ?? fetch)(
@@ -39,48 +98,138 @@ export async function sendEmail(
         'X-Postmark-Server-Token': options.postmarkToken,
       },
       body: JSON.stringify({
-        From: 'VRPlatform <notifications@vrplatform.app>',
+        From: data.from ?? 'VRPlatform <notifications@vrplatform.app>',
         To: data.to,
         Subject: data.subject,
         ReplyTo: data.replyTo,
         TextBody: data.text,
         HtmlBody: data.html,
         MessageStream: 'outbound',
+        Tag: data.tag,
+        Metadata: data.metadata,
       }),
     }
   );
 
   const providerResponse: unknown = await response.json().catch(() => ({}));
-  const providerMessage =
-    providerResponse !== null &&
-    typeof providerResponse === 'object' &&
-    'Message' in providerResponse &&
-    typeof providerResponse.Message === 'string'
-      ? providerResponse.Message
-      : undefined;
-
-  if (!response.ok) {
-    if (
-      response.status === 422 &&
-      providerMessage?.includes('marked as inactive')
-    ) {
+  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;
+    const details: EmailDeliveryFailureDetails = {
+      provider: 'postmark',
+      providerCategory: inactiveRecipient ? 'inactiveRecipient' : 'rejected',
+      httpStatus: response.status,
+      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+    };
+
+    if (inactiveRecipient) {
       throw new EmailDeliveryError(
         'Postmark recipient is inactive',
-        {
-          providerMessage,
-          status: response.status,
-          statusText: response.statusText,
-        },
-        true
+        details,
+        true,
+        false
       );
     }
 
-    throw new EmailDeliveryError('Postmark rejected the email', {
-      providerResponse,
-      status: response.status,
-      statusText: response.statusText,
+    throw new EmailDeliveryError(
+      'Postmark rejected the email',
+      details,
+      false,
+      response.status === 429 || response.status >= 500
+    );
+  }
+
+  const result = postmarkSuccessResponseSchema.safeParse(providerResponse);
+  if (!result.success) {
+    throw new EmailDeliveryError('Postmark returned an invalid response', {
+      provider: 'postmark',
+      providerCategory: 'rejected',
+      httpStatus: response.status,
+      ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
     });
   }
 
-  return { status: response.status };
+  return {
+    httpStatus: response.status,
+    messageId: result.data.MessageID,
+    submittedAt: result.data.SubmittedAt,
+  };
+}
+
+export async function settleEmailDeliveries(deliveries: Promise<unknown>[]) {
+  const failures = (await Promise.allSettled(deliveries)).filter(
+    (result) => result.status === 'rejected'
+  );
+  if (failures.length === 0) return;
+
+  const unexpectedDeliveryError = failures.find(
+    (failure) =>
+      failure.reason instanceof EmailDeliveryError && !failure.reason.expected
+  )?.reason;
+  const allExpected = failures.every(
+    (failure) =>
+      failure.reason instanceof EmailDeliveryError && failure.reason.expected
+  );
+  const firstDeliveryError = failures.find(
+    (failure) => failure.reason instanceof EmailDeliveryError
+  )?.reason;
+  const failureDetails = failures.flatMap((failure) => {
+    if (
+      !(failure.reason instanceof EmailDeliveryError) ||
+      !failure.reason.details ||
+      !('provider' in failure.reason.details)
+    ) {
+      return [];
+    }
+    const { httpStatus, postmarkErrorCode, provider, providerCategory } =
+      failure.reason.details;
+    return [
+      {
+        httpStatus,
+        provider,
+        providerCategory,
+        ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
+      },
+    ];
+  });
+
+  const details: EmailDeliveryErrorDetails = {
+    failureCount: failures.length,
+    failures: failureDetails,
+  };
+  if (unexpectedDeliveryError instanceof EmailDeliveryError) {
+    if (unexpectedDeliveryError.message === 'Postmark is not configured') {
+      throw new EmailDeliveryError(
+        'Postmark is not configured',
+        details,
+        false,
+        false
+      );
+    }
+    throw new EmailDeliveryError(
+      'Postmark rejected the email',
+      details,
+      false,
+      unexpectedDeliveryError.retryable
+    );
+  }
+  if (allExpected && firstDeliveryError instanceof EmailDeliveryError) {
+    throw new EmailDeliveryError(
+      'Postmark recipient is inactive',
+      details,
+      true,
+      false
+    );
+  }
+  throw new EmailDeliveryError('Email delivery failed', details);
 }