@vrplatform/email 1.0.2-5 → 1.0.2-556

package/build/module/templates/InvitePmEmailTemplate.js

@@ -6,17 +6,21 @@ export const getDefaultInvitePropertyManagerEmailData = (mode, args) => {
         ? EMAIL_ACTION_LINK_COMPONENT
         : `<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}`,
     };
 };
 export const InvitePmEmailTemplate = (props) => {
-    return (_jsx(ActionEmailTemplate, { ...props, tenant: {
+    return (_jsx(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/build/module/templates/InvitePmEmailTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"InvitePmEmailTemplate.js","sourceRoot":"src/","sources":["templates/InvitePmEmailTemplate.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAEL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,IAAoB,EACpB,IAGC,EACgB,EAAE;IACnB,MAAM,UAAU,GACd,IAAI,KAAK,KAAK;QACZ,CAAC,CAAC,2BAA2B;QAC7B,CAAC,CAAC,YAAY,IAAI,CAAC,UAAU,qBAAqB,IAAI,CAAC,UAAU,MAAM,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,oCAAoC,IAAI,CAAC,OAAO,0BAA0B,IAAI,CAAC,OAAO,4DAA4D;QAC3J,OAAO,EAAE,qFAAqF,UAAU,MAAM;QAC9G,UAAU,EAAE,mBAAmB;QAC/B,MAAM,EAAE,sBAAsB;QAC9B,gBAAgB,EACd,6GAA6G;QAC/G,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,OAAO,EAAE,wCAAwC,IAAI,CAAC,OAAO,EAAE;KAChE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAA+B,EAAE,EAAE;IACvE,OAAO,CACL,KAAC,mBAAmB,OACd,KAAK,EACT,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;SACxB,GACD,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { EMAIL_ACTION_LINK_COMPONENT } from '../extensions';\nimport {\n  type ActionEmailData,\n  ActionEmailTemplate,\n  type ActionEmailTemplateProps,\n} from '../components';\n\nexport const getDefaultInvitePropertyManagerEmailData = (\n  mode: 'tag' | 'text',\n  args: {\n    appName: string;\n    signInLink: string;\n  }\n): ActionEmailData => {\n  const signInLink =\n    mode === 'tag'\n      ? EMAIL_ACTION_LINK_COMPONENT\n      : `<a href='${args.signInLink}' target='_blank'>${args.signInLink}</a>`;\n\n  return {\n    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>`,\n    bodyTwo: `<p>If you have any trouble with the button, you can use the following link below: ${signInLink}</p>`,\n    buttonText: 'Accept Invitation',\n    header: 'Welcome to the team!',\n    shortDescription:\n      'You have been invited to join the team. To start using VRPlatform, verify your email address at link below.',\n    href: args.signInLink,\n    subject: `You are invited to join your team on ${args.appName}`,\n  };\n};\n\nexport const InvitePmEmailTemplate = (props: ActionEmailTemplateProps) => {\n  return (\n    <ActionEmailTemplate\n      {...props}\n      tenant={{\n        logo: undefined,\n        name: props.tenant.name,\n      }}\n    />\n  );\n};\n"]}
+{"version":3,"file":"InvitePmEmailTemplate.js","sourceRoot":"src/","sources":["templates/InvitePmEmailTemplate.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAEL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,IAAoB,EACpB,IAGC,EACgB,EAAE;IACnB,MAAM,UAAU,GACd,IAAI,KAAK,KAAK;QACZ,CAAC,CAAC,2BAA2B;QAC7B,CAAC,CAAC,YAAY,IAAI,CAAC,UAAU,qBAAqB,IAAI,CAAC,UAAU,MAAM,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,oCAAoC,IAAI,CAAC,OAAO,qEAAqE;QAC9H,OAAO,EAAE,qFAAqF,UAAU,MAAM;QAC9G,UAAU,EAAE,mBAAmB;QAC/B,MAAM,EAAE,sBAAsB;QAC9B,gBAAgB,EAAE,+CAA+C,IAAI,CAAC,OAAO,GAAG;QAChF,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,OAAO,EAAE,wCAAwC,IAAI,CAAC,OAAO,EAAE;KAChE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAA+B,EAAE,EAAE;IACvE,OAAO,CACL,KAAC,mBAAmB,OACd,KAAK,EACT,IAAI,EAAE;YACJ,GAAG,KAAK,CAAC,IAAI;YACb,wEAAwE;YACxE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,6aAA6a;SAC5c,EACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;SACxB,GACD,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { EMAIL_ACTION_LINK_COMPONENT } from '../extensions';\nimport {\n  type ActionEmailData,\n  ActionEmailTemplate,\n  type ActionEmailTemplateProps,\n} from '../components';\n\nexport const getDefaultInvitePropertyManagerEmailData = (\n  mode: 'tag' | 'text',\n  args: {\n    appName: string;\n    signInLink: string;\n  }\n): ActionEmailData => {\n  const signInLink =\n    mode === 'tag'\n      ? EMAIL_ACTION_LINK_COMPONENT\n      : `<a href='${args.signInLink}' target='_blank'>${args.signInLink}</a>`;\n\n  return {\n    bodyOne: `<p>You are invited to join us on ${args.appName}.</p><p>Accept the invitation below to set up your team access.</p>`,\n    bodyTwo: `<p>If you have any trouble with the button, you can use the following link below: ${signInLink}</p>`,\n    buttonText: 'Accept Invitation',\n    header: 'Welcome to the team!',\n    shortDescription: `Accept your invitation to join your team on ${args.appName}.`,\n    href: args.signInLink,\n    subject: `You are invited to join your team on ${args.appName}`,\n  };\n};\n\nexport const InvitePmEmailTemplate = (props: ActionEmailTemplateProps) => {\n  return (\n    <ActionEmailTemplate\n      {...props}\n      data={{\n        ...props.data,\n        // Add guidance at render time so saved custom templates receive it too.\n        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>`,\n      }}\n      tenant={{\n        logo: undefined,\n        name: props.tenant.name,\n      }}\n    />\n  );\n};\n"]}

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

@@ -0,0 +1,8 @@
+export declare function findPostmarkEmail(deliveryId: string, options: {
+    fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    postmarkToken?: string;
+}): Promise<{
+    httpStatus: number;
+    messageId: any;
+    submittedAt: any;
+} | undefined>;

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

@@ -0,0 +1,63 @@
+import { day } from '@vrplatform/utils';
+import { EmailDeliveryError } from './send-email';
+export async function findPostmarkEmail(deliveryId, options) {
+    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 = 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);
+    }
+    if (!providerResponse ||
+        typeof providerResponse !== 'object' ||
+        !('TotalCount' in providerResponse) ||
+        typeof providerResponse.TotalCount !== 'number' ||
+        !('Messages' in providerResponse) ||
+        !Array.isArray(providerResponse.Messages)) {
+        throw new EmailDeliveryError('Postmark returned an invalid response');
+    }
+    if (providerResponse.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) {
+        throw new EmailDeliveryError('Postmark returned an invalid response');
+    }
+    return { httpStatus: response.status, messageId, submittedAt };
+}
+//# sourceMappingURL=find-postmark-email.js.map

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

@@ -0,0 +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"]}

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

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

package/build/module/utils/index.js

@@ -1,2 +1,4 @@
+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,cAAc,CAAC","sourcesContent":["export * from './send-email';\n"]}
+{"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"]}

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

@@ -1,7 +1,18 @@
+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);
+    readonly retryable: boolean;
+    constructor(message: string, details?: EmailDeliveryErrorDetails | undefined, expected?: boolean, retryable?: boolean);
 }
 export declare function sendEmail(data: {
     to: string;
@@ -9,9 +20,15 @@ export declare function sendEmail(data: {
     text: string;
     html: string;
     replyTo?: string;
+    tag?: string;
+    metadata?: Record<string, string>;
 }, options: {
     fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
     postmarkToken?: string;
 }): Promise<{
-    status: number;
+    httpStatus: number;
+    messageId: string;
+    submittedAt: string;
 }>;
+export declare function settleEmailDeliveries(deliveries: Promise<unknown>[]): Promise<void>;
+export {};

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

@@ -1,16 +1,19 @@
+import { day } from '@vrplatform/utils';
 export class EmailDeliveryError extends Error {
     details;
     expected;
-    constructor(message, details, expected = false) {
+    retryable;
+    constructor(message, details, expected = false, retryable = true) {
         super(message);
         this.details = details;
         this.expected = expected;
+        this.retryable = retryable;
         this.name = 'EmailDeliveryError';
     }
 }
 export async function sendEmail(data, options) {
     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)('https://api.postmarkapp.com/email', {
         method: 'POST',
@@ -27,30 +30,105 @@ export async function sendEmail(data, options) {
             TextBody: data.text,
             HtmlBody: data.html,
             MessageStream: 'outbound',
+            Tag: data.tag,
+            Metadata: data.metadata,
         }),
     });
     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;
-    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 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 ||
+        (postmarkErrorCode !== undefined && postmarkErrorCode !== 0)) {
+        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, false);
         }
-        throw new EmailDeliveryError('Postmark rejected the email', {
-            providerResponse,
-            status: response.status,
-            statusText: response.statusText,
+        throw new EmailDeliveryError('Postmark rejected the email', details, false, response.status === 429 || response.status >= 500);
+    }
+    const messageId = providerResponse !== null &&
+        typeof providerResponse === 'object' &&
+        'MessageID' in providerResponse &&
+        typeof providerResponse.MessageID === 'string' &&
+        providerResponse.MessageID
+        ? providerResponse.MessageID
+        : undefined;
+    const submittedAt = providerResponse !== null &&
+        typeof providerResponse === 'object' &&
+        'SubmittedAt' in providerResponse &&
+        typeof providerResponse.SubmittedAt === 'string' &&
+        day(providerResponse.SubmittedAt).isValid()
+        ? providerResponse.SubmittedAt
+        : undefined;
+    if (!messageId || !submittedAt || postmarkErrorCode !== 0) {
+        throw new EmailDeliveryError('Postmark returned an invalid response', {
+            provider: 'postmark',
+            providerCategory: 'rejected',
+            httpStatus: response.status,
+            ...(postmarkErrorCode !== undefined ? { postmarkErrorCode } : {}),
         });
     }
-    return { status: response.status };
+    return {
+        httpStatus: response.status,
+        messageId,
+        submittedAt,
+    };
+}
+export async function settleEmailDeliveries(deliveries) {
+    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, 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);
 }
 //# 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":["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"]}

package/package.json

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

package/src/components/EmailContainer.tsx

@@ -124,7 +124,7 @@ const Footer = () => (
         color: '#737373',
       }}
     >
-      © {day().year()} VRPlatform Ventures Ltd. All rights reserved.
+      © {day().year()} VR Technologies. All rights reserved.
     </Text>
     <Text
       style={{

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/utils/find-postmark-email.ts

@@ -0,0 +1,93 @@
+import { day } from '@vrplatform/utils';
+import { EmailDeliveryError } from './send-email';
+
+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
+    );
+  }
+
+  if (
+    !providerResponse ||
+    typeof providerResponse !== 'object' ||
+    !('TotalCount' in providerResponse) ||
+    typeof providerResponse.TotalCount !== 'number' ||
+    !('Messages' in providerResponse) ||
+    !Array.isArray(providerResponse.Messages)
+  ) {
+    throw new EmailDeliveryError('Postmark returned an invalid response');
+  }
+  if (providerResponse.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) {
+    throw new EmailDeliveryError('Postmark returned an invalid response');
+  }
+
+  return { httpStatus: response.status, messageId, submittedAt };
+}

package/src/utils/index.ts

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