@bigbinary/neeto-playwright-commons 4.2.3 → 4.3.0

package/index.d.ts

@@ -870,6 +870,81 @@ declare class IpRestrictionsApi {
   }: AllowedIpRange) => Promise<playwright_core.APIResponse | undefined>;
   disable: () => Promise<playwright_core.APIResponse | undefined>;
 }
+interface MailpitAddress {
+  Name: string;
+  Address: string;
+}
+interface MailpitPart {
+  PartID: string;
+  FileName: string;
+  ContentType: string;
+  ContentID: string;
+  Size: number;
+}
+interface MailpitMessageSummary {
+  ID: string;
+  MessageID: string;
+  From: MailpitAddress | null;
+  To: MailpitAddress[] | null;
+  Cc: MailpitAddress[] | null;
+  Bcc: MailpitAddress[] | null;
+  ReplyTo: MailpitAddress[] | null;
+  Subject: string;
+  Created: string;
+  Size: number;
+  Attachments: number;
+  Snippet: string;
+}
+interface MailpitMessage {
+  ID: string;
+  MessageID: string;
+  From: MailpitAddress | null;
+  To: MailpitAddress[] | null;
+  Cc: MailpitAddress[] | null;
+  Bcc: MailpitAddress[] | null;
+  ReplyTo: MailpitAddress[] | null;
+  Subject: string;
+  Date: string;
+  Text: string;
+  HTML: string;
+  Size: number;
+  Attachments: MailpitPart[] | null;
+  Inline: MailpitPart[] | null;
+}
+interface MailpitSearchParams {
+  query?: string;
+  start?: number;
+  limit?: number;
+  tz?: string;
+}
+interface MailpitSearchResult {
+  messages: MailpitMessageSummary[];
+  messagesCount: number;
+}
+declare class MailpitApi {
+  private neetoPlaywrightUtilities;
+  readonly baseUrl: string;
+  private readonly headers;
+  constructor(neetoPlaywrightUtilities: CustomCommands);
+  /**
+   *
+   * Used to authorize the Fastmail API and get the account details. There is usually no need to call this method since this is invoked when the fixture is setup and will save the credentials for all the future callback of mailerUtils methods.
+   *
+   * This method doesn't accept any arguments and doesn't return anything.
+   *
+  */
+  authorizeAndSetAccountId: () => Promise<void>;
+  private warnOnUnexpectedResponse;
+  search: ({
+    query,
+    start,
+    limit,
+    tz
+  }: MailpitSearchParams) => Promise<MailpitSearchResult>;
+  getMessage: (id: string) => Promise<MailpitMessage | null>;
+  fetchRawMessage: (id: string) => Promise<Buffer<ArrayBufferLike> | null>;
+  deleteMessages: (ids: string[]) => Promise<void>;
+}
 declare class MemberApis {
   private neetoPlaywrightUtilities;
   private readonly teamMembersBaseUrl;
@@ -898,6 +973,7 @@ interface RailsEmail {
   htmlBody?: string;
   textBody?: string;
   receivedAt: string;
+  messageId?: string;
   attachments?: RailsEmailAttachment[];
 }
 interface BaseRailsEmailSearchParams {
@@ -1249,6 +1325,7 @@ interface FormattedList$1 {
   subject: string;
   attachments: Attachment$1[];
   blobId: string;
+  messageId?: string;
 }
 interface AttachmentDetails$1 {
   filename: string | null;
@@ -1263,7 +1340,7 @@ declare class RailsEmailUtils {
   private convertRailsEmailToFormattedList;
   clearEmails: () => Promise<unknown>;
   clearStaleEmails: () => Promise<unknown>;
-  getLatestEmail: (searchParams: RailsEmailSearchParams) => Promise<void>;
+  getLatestEmail: (searchParams: RailsEmailSearchParams) => Promise<RailsEmail | null>;
   listEmails: (searchParams?: RailsEmailSearchParams) => Promise<RailsEmail[]>;
   /**
    *
@@ -1403,6 +1480,10 @@ declare class RailsEmailUtils {
     receivedAfter,
     expectedEmailCount
   }?: Partial<FindMessageFilterOptions$1> | undefined, shouldThrowErrorOnTimeout?: boolean) => Promise<FormattedList$1 | Record<string, never>>;
+  getLatestMessageId: (subject: string, {
+    timeout,
+    receivedAfter
+  }?: Partial<FindMessageFilterOptions$1> | undefined) => Promise<string | undefined>;
   /**
    *
    * A helper method that is used to find the first code value from the matching email body. This method has been built to match the Neeto OTP emails.
@@ -1524,6 +1605,7 @@ declare class FastmailApi {
   headers: FastmailHeaders;
   accountId: string | undefined;
   constructor(neetoPlaywrightUtilities: CustomCommands);
+  private assertApiKey;
   /**
    *
    * Used to authorize the Fastmail API and get the account details. There is usually no need to call this method since this is invoked when the fixture is setup and will save the credentials for all the future callback of mailerUtils methods.
@@ -1615,14 +1697,17 @@ interface FormattedList {
   subject: string;
   attachments: Attachment[];
   blobId: string;
+  messageId?: string;
 }
 declare class MailerUtils {
   private neetoPlaywrightUtilities;
   accountId: string | undefined;
   fastmailApi: FastmailApi;
+  mailpitApi: MailpitApi;
   railsEmailUtils: RailsEmailUtils;
   constructor(neetoPlaywrightUtilities: CustomCommands);
   private queryEmail;
+  private buildMessageBodies;
   private getEmails;
   /**
    *
@@ -1800,6 +1885,10 @@ declare class MailerUtils {
    *
   */
   generateRandomEmail: () => string;
+  getLatestMessageId: (subject: string, {
+    timeout,
+    receivedAfter
+  }?: Partial<FindMessageFilterOptions> | undefined) => Promise<string | undefined>;
   /**
    *
    * This method is used to return an attachment from the first email matching the search criteria. It supports filtering attachments by name, by MIME content-type, or both. If no matching attachment is found, an error is thrown.
@@ -1883,6 +1972,45 @@ declare class MailerUtils {
     receivedAfter,
     expectedEmailCount
   }?: Partial<FindMessageFilterOptions> | undefined, shouldThrowErrorOnTimeout?: boolean) => Promise<AttachmentDetails | undefined>;
+  private toIdentifiers;
+  private toMailpitAttachments;
+  private toFormattedList;
+  private matchesSummaryCriteria;
+  private warnOnNonMailpitRecipient;
+  private queryMailpitEmails;
+  private getEmailsV2;
+  private pollForMailpitSummaries;
+  listMessagesV2: (messageSearchCriteria?: Partial<MessageSearchCriteria> | undefined, listMessagesFilterCriteria?: Partial<ListMessagesFilterCriteria> | undefined) => Promise<FormattedList[]>;
+  getEmailIdsV2: (messageSearchCriteria?: Partial<MessageSearchCriteria>, {
+    timeout,
+    receivedAfter,
+    expectedEmailCount
+  }?: Partial<FindMessageFilterOptions> | undefined, shouldThrowErrorOnTimeout?: boolean) => Promise<string[]>;
+  findMessageV2: (messageSearchCriteria?: Partial<MessageSearchCriteria>, {
+    timeout,
+    receivedAfter,
+    expectedEmailCount
+  }?: Partial<FindMessageFilterOptions> | undefined, shouldThrowErrorOnTimeout?: boolean) => Promise<FormattedList | Record<string, never>>;
+  findOtpFromEmailV2: ({
+    email,
+    subjectSubstring,
+    timeout,
+    receivedAfter,
+    expectedEmailCount
+  }: FindOtpFromEmailParams) => Promise<string | undefined>;
+  generateRandomEmailV2: () => string;
+  getLatestMessageIdV2: (subject: string, {
+    timeout,
+    receivedAfter
+  }?: Partial<FindMessageFilterOptions> | undefined) => Promise<string | undefined>;
+  getEmailAttachmentV2: ({
+    name,
+    type
+  }: AttachmentFilter, messageSearchCriteria?: Partial<MessageSearchCriteria>, {
+    timeout,
+    receivedAfter,
+    expectedEmailCount
+  }?: Partial<FindMessageFilterOptions> | undefined, shouldThrowErrorOnTimeout?: boolean) => Promise<AttachmentDetails | undefined>;
 }
 /**
  *
@@ -4067,6 +4195,11 @@ declare const CUSTOM_DOMAIN_SUFFIX = "aceinvoice.com";
  * @endexample
 */
 declare const ZAPIER_TEST_EMAIL: (product: string) => string;
+declare const MAILPIT_BASE_URL = "https://mailpit.neetodeployapp.com";
+declare const MAILPIT_DOMAIN_NAME = "mail.aceinvoice.com";
+declare const IS_MAILPIT_ENABLED: boolean;
+declare const mailpitDomainName: () => string;
+declare const ZAPIER_TEST_EMAIL_V2: (product: string) => string;
 declare const SINGULAR: {
   count: number;
 };
@@ -9344,5 +9477,5 @@ interface Overrides {
  * @endexample
 */
 declare const definePlaywrightConfig: (overrides: Overrides) => PlaywrightTestConfig<{}, {}>;
-export { ACTIONS, ADMIN_PANEL_SELECTORS, ALL_RESOURCES, ANALYTICS_RESOURCES, API_KEYS_SELECTORS, API_ROUTES, APP_RESOURCES, AUDIT_LOGS_SELECTORS, ApiKeysApi, ApiKeysPage, AuditLogsPage, BASE_URL, CALENDAR_LABELS, CERTIFICATE_LIMIT_EXCEEDED_MESSAGE, CERTIFICATE_LIMIT_EXCEEDED_REGEXP, CHANGELOG_WIDGET_SELECTORS, CHAT_WIDGET_SELECTORS, CHAT_WIDGET_TEXTS, COLOR, COMMON_SELECTORS, COMMON_TEXTS, COMMUNITY_TEXTS, CREDENTIALS, CURRENT_TIME_RANGES, CUSTOM_DOMAIN_SELECTORS, CUSTOM_DOMAIN_SUFFIX, ColorPickerUtils, CustomCommands, CustomDomainApi, CustomDomainPage, DATE_FORMATS, DATE_PICKER_SELECTORS, DATE_RANGES, DATE_TEXTS, DEFAULT_WEBHOOKS_RESPONSE_TEXT, DESCRIPTION_EDITOR_TEXTS, EDITOR_VERIFY_TEXT_COLOR, EMBED_SELECTORS, EMOJI_LABEL, EMPTY_STORAGE_STATE, ENGAGE_TEXTS, ENVIRONMENT, EXAMPLE_URL, EXPANDED_FONT_SIZE, EXPORT_FILE_TYPES, EditorPage, EmailDeliveryUtils, EmbedBase, FILE_FORMATS, FONTS_RESOURCES, FONT_SIZE_SELECTORS, FROM_EMAIL_ENV_KEYS, GLOBAL_TRANSLATIONS_PATTERN, GOOGLE_ANALYTICS_SELECTORS, GOOGLE_CALENDAR_DATE_FORMAT, GOOGLE_LOGIN_SELECTORS, GOOGLE_LOGIN_TEXTS, GOOGLE_SHEETS_SELECTORS, GooglePage, HELP_CENTER_ROUTES, HELP_CENTER_SELECTORS, HelpAndProfilePage, INTEGRATIONS_TEXTS, INTEGRATION_SELECTORS, IPRestrictionsPage, IP_RESTRICTIONS_SELECTORS, IS_CI, IS_DEV_ENV, IS_STAGING_ENV, ImageUploader, IntegrationBase, IpRestrictionsApi, KEYBOARD_SHORTCUTS_SELECTORS, KEYBOARD_SHORTCUT_TEST_CASES, LIST_MODIFIER_SELECTORS, LIST_MODIFIER_TAGS, LOGIN_SELECTORS, MEMBER_FORM_SELECTORS, MEMBER_SELECTORS, MEMBER_TEXTS, MERGE_TAGS_SELECTORS, MICROSOFT_LOGIN_SELECTORS, MICROSOFT_LOGIN_TEXTS, MailerUtils, Member, MemberApis, MicrosoftPage, NEETO_AUTH_BASE_URL, NEETO_EDITOR_SELECTORS, NEETO_FILTERS_SELECTORS, NEETO_IMAGE_UPLOADER_SELECTORS, NEETO_ROUTES, NEETO_SEO_SELECTORS, NEETO_TEXT_MODIFIER_SELECTORS, NeetoAuthServer, NeetoChatWidget, NeetoEmailDeliveryApi, NeetoTowerApi, ONBOARDING_SELECTORS, ORGANIZATION_TEXTS, OTP_EMAIL_PATTERN, OrganizationPage, PAST_TIME_RANGES, PHONE_NUMBER_FORMATS, PLURAL, PRODUCT_ROLES_ROUTE_MAP, PROFILE_LINKS, PROFILE_SECTION_SELECTORS, PROJECT_NAMES, PROJECT_TRANSLATIONS_PATH, ROLES_SELECTORS, ROUTES, RailsEmailApiClient, RailsEmailUtils, RoleApis, RolesPage, SIGNUP_SELECTORS, SINGULAR, SLACK_DATA_QA_SELECTORS, SLACK_DEFAULT_CHANNEL, SLACK_SELECTORS, SLACK_WEB_TEXTS, STATUS_TEXTS, STORAGE_STATE, SecurityApi, SidebarSection, SlackApi, SlackPage, TABLE_SELECTORS, TAB_SELECTORS, TAGS_SELECTORS, TEAM_MEMBER_TEXTS, TEXT_MODIFIER_ROLES, TEXT_MODIFIER_SELECTORS, TEXT_MODIFIER_TAGS, THANK_YOU_SELECTORS, THEMES_SELECTORS, THEMES_TEXTS, THIRD_PARTY_RESOURCES, THIRD_PARTY_ROUTES, TIME_RANGES, TOASTR_MESSAGES, TWILIO_SELECTORS, TagsApi, TagsPage, TeamMembers, ThankYouApi, ThankYouPage, TwilioApi, USER_AGENTS, WEBHOOK_SELECTORS, WebhookSiteApi, WebhooksPage, ZAPIER_LIMIT_EXHAUSTED_MESSAGE, ZAPIER_SELECTORS, ZAPIER_TEST_EMAIL, ZAPIER_WEB_TEXTS, ZapierPage, authenticateUser, baseURLGenerator, basicHTMLContent, clearCredentials, commands, cpuThrottlingUsingCDP, createOrganizationViaRake, currencyUtils, dataQa, decodeQRCodeFromFile, definePlaywrightConfig, executeWithThrottledResources, extractSubdomainFromError, filterUtils, fixedMenuSelector, generatePhoneNumber, generatePhoneNumberDetails, generateRandomBypassEmail, generateRandomFile, generateStagingData, getByDataQA, getClipboardContent, getDirname, getFormattedPhoneNumber, getFullUrl, getGlobalUserProps, getGlobalUserState, getImagePathAndName, getIsoCodeFromPhoneCode, getListCount, globalShortcuts, grantClipboardPermissions, hexToRGB, hexToRGBA, i18nFixture, imageRegex, initializeCredentials, initializeTestData, initializeTotp, isGithubIssueOpen, isStagingOrganizationExpired, joinHyphenCase, joinString, login, networkConditions, networkThrottlingUsingCDP, optionSelector, readFileSyncIfExists, removeCredentialFile, serializeFileForBrowser, shouldSkipCustomDomainSetup, shouldSkipSetupAndTeardown, simulateClickWithDelay, simulateTypingWithDelay, skipTest, squish, _default as stealthTest, tableUtils, toCamelCase, updateCredentials, warmup, withCookieCache, writeDataToFile };
+export { ACTIONS, ADMIN_PANEL_SELECTORS, ALL_RESOURCES, ANALYTICS_RESOURCES, API_KEYS_SELECTORS, API_ROUTES, APP_RESOURCES, AUDIT_LOGS_SELECTORS, ApiKeysApi, ApiKeysPage, AuditLogsPage, BASE_URL, CALENDAR_LABELS, CERTIFICATE_LIMIT_EXCEEDED_MESSAGE, CERTIFICATE_LIMIT_EXCEEDED_REGEXP, CHANGELOG_WIDGET_SELECTORS, CHAT_WIDGET_SELECTORS, CHAT_WIDGET_TEXTS, COLOR, COMMON_SELECTORS, COMMON_TEXTS, COMMUNITY_TEXTS, CREDENTIALS, CURRENT_TIME_RANGES, CUSTOM_DOMAIN_SELECTORS, CUSTOM_DOMAIN_SUFFIX, ColorPickerUtils, CustomCommands, CustomDomainApi, CustomDomainPage, DATE_FORMATS, DATE_PICKER_SELECTORS, DATE_RANGES, DATE_TEXTS, DEFAULT_WEBHOOKS_RESPONSE_TEXT, DESCRIPTION_EDITOR_TEXTS, EDITOR_VERIFY_TEXT_COLOR, EMBED_SELECTORS, EMOJI_LABEL, EMPTY_STORAGE_STATE, ENGAGE_TEXTS, ENVIRONMENT, EXAMPLE_URL, EXPANDED_FONT_SIZE, EXPORT_FILE_TYPES, EditorPage, EmailDeliveryUtils, EmbedBase, FILE_FORMATS, FONTS_RESOURCES, FONT_SIZE_SELECTORS, FROM_EMAIL_ENV_KEYS, GLOBAL_TRANSLATIONS_PATTERN, GOOGLE_ANALYTICS_SELECTORS, GOOGLE_CALENDAR_DATE_FORMAT, GOOGLE_LOGIN_SELECTORS, GOOGLE_LOGIN_TEXTS, GOOGLE_SHEETS_SELECTORS, GooglePage, HELP_CENTER_ROUTES, HELP_CENTER_SELECTORS, HelpAndProfilePage, INTEGRATIONS_TEXTS, INTEGRATION_SELECTORS, IPRestrictionsPage, IP_RESTRICTIONS_SELECTORS, IS_CI, IS_DEV_ENV, IS_MAILPIT_ENABLED, IS_STAGING_ENV, ImageUploader, IntegrationBase, IpRestrictionsApi, KEYBOARD_SHORTCUTS_SELECTORS, KEYBOARD_SHORTCUT_TEST_CASES, LIST_MODIFIER_SELECTORS, LIST_MODIFIER_TAGS, LOGIN_SELECTORS, MAILPIT_BASE_URL, MAILPIT_DOMAIN_NAME, MEMBER_FORM_SELECTORS, MEMBER_SELECTORS, MEMBER_TEXTS, MERGE_TAGS_SELECTORS, MICROSOFT_LOGIN_SELECTORS, MICROSOFT_LOGIN_TEXTS, MailerUtils, MailpitApi, Member, MemberApis, MicrosoftPage, NEETO_AUTH_BASE_URL, NEETO_EDITOR_SELECTORS, NEETO_FILTERS_SELECTORS, NEETO_IMAGE_UPLOADER_SELECTORS, NEETO_ROUTES, NEETO_SEO_SELECTORS, NEETO_TEXT_MODIFIER_SELECTORS, NeetoAuthServer, NeetoChatWidget, NeetoEmailDeliveryApi, NeetoTowerApi, ONBOARDING_SELECTORS, ORGANIZATION_TEXTS, OTP_EMAIL_PATTERN, OrganizationPage, PAST_TIME_RANGES, PHONE_NUMBER_FORMATS, PLURAL, PRODUCT_ROLES_ROUTE_MAP, PROFILE_LINKS, PROFILE_SECTION_SELECTORS, PROJECT_NAMES, PROJECT_TRANSLATIONS_PATH, ROLES_SELECTORS, ROUTES, RailsEmailApiClient, RailsEmailUtils, RoleApis, RolesPage, SIGNUP_SELECTORS, SINGULAR, SLACK_DATA_QA_SELECTORS, SLACK_DEFAULT_CHANNEL, SLACK_SELECTORS, SLACK_WEB_TEXTS, STATUS_TEXTS, STORAGE_STATE, SecurityApi, SidebarSection, SlackApi, SlackPage, TABLE_SELECTORS, TAB_SELECTORS, TAGS_SELECTORS, TEAM_MEMBER_TEXTS, TEXT_MODIFIER_ROLES, TEXT_MODIFIER_SELECTORS, TEXT_MODIFIER_TAGS, THANK_YOU_SELECTORS, THEMES_SELECTORS, THEMES_TEXTS, THIRD_PARTY_RESOURCES, THIRD_PARTY_ROUTES, TIME_RANGES, TOASTR_MESSAGES, TWILIO_SELECTORS, TagsApi, TagsPage, TeamMembers, ThankYouApi, ThankYouPage, TwilioApi, USER_AGENTS, WEBHOOK_SELECTORS, WebhookSiteApi, WebhooksPage, ZAPIER_LIMIT_EXHAUSTED_MESSAGE, ZAPIER_SELECTORS, ZAPIER_TEST_EMAIL, ZAPIER_TEST_EMAIL_V2, ZAPIER_WEB_TEXTS, ZapierPage, authenticateUser, baseURLGenerator, basicHTMLContent, clearCredentials, commands, cpuThrottlingUsingCDP, createOrganizationViaRake, currencyUtils, dataQa, decodeQRCodeFromFile, definePlaywrightConfig, executeWithThrottledResources, extractSubdomainFromError, filterUtils, fixedMenuSelector, generatePhoneNumber, generatePhoneNumberDetails, generateRandomBypassEmail, generateRandomFile, generateStagingData, getByDataQA, getClipboardContent, getDirname, getFormattedPhoneNumber, getFullUrl, getGlobalUserProps, getGlobalUserState, getImagePathAndName, getIsoCodeFromPhoneCode, getListCount, globalShortcuts, grantClipboardPermissions, hexToRGB, hexToRGBA, i18nFixture, imageRegex, initializeCredentials, initializeTestData, initializeTotp, isGithubIssueOpen, isStagingOrganizationExpired, joinHyphenCase, joinString, login, mailpitDomainName, networkConditions, networkThrottlingUsingCDP, optionSelector, readFileSyncIfExists, removeCredentialFile, serializeFileForBrowser, shouldSkipCustomDomainSetup, shouldSkipSetupAndTeardown, simulateClickWithDelay, simulateTypingWithDelay, skipTest, squish, _default as stealthTest, tableUtils, toCamelCase, updateCredentials, warmup, withCookieCache, writeDataToFile };
 export type { BaseThemeStyle, BaseThemeStyleType, ColumnMenuAction, CountryProps, CustomFixture, EmailDeliveryConnectParams, EmailDeliveryProvider, EmailDeliveryVerifiedEmail, EmailDeliveryVerifyEmailParams, EmailDeliveryVerifyEmailResponse, EmailMatchCriteria, IntroPageThemeStyle, IntroPageThemeStyleType, OAuthEmailDeliveryProvider, ProjectName, ThemeCategory, ValueOf };

package/index.js

@@ -1,4 +1,4 @@
-import { keysToSnakeCase, isPresent, hyphenate, isNotPresent, noop as noop$2, humanize, findBy, dynamicArray, truncate, isNotEmpty, isNotEqualDeep, randomPick } from '@bigbinary/neeto-cist';
+import { isPresent, keysToSnakeCase, hyphenate, isNotPresent, noop as noop$2, humanize, findBy, dynamicArray, truncate, isNotEmpty, isNotEqualDeep, randomPick } from '@bigbinary/neeto-cist';
 import { faker } from '@faker-js/faker';
 import * as fs from 'fs';
 import fs__default, { readFileSync, promises, existsSync, writeFileSync, unlinkSync, mkdirSync, rmSync, createWriteStream } from 'fs';
@@ -299,6 +299,162 @@ class IpRestrictionsApi {
     });
 }
 
+const ENVIRONMENT = {
+    development: "development",
+    staging: "staging",
+    review: "review",
+};
+const EXAMPLE_URL = "https://example.com";
+const IS_STAGING_ENV = process.env.TEST_ENV === ENVIRONMENT.staging;
+const IS_DEV_ENV = process.env.TEST_ENV === ENVIRONMENT.development;
+const IS_CI = isPresent(process.env.NEETO_CI_JOB_ID);
+const DEFAULT_WEBHOOKS_RESPONSE_TEXT = JSON.stringify({ success: true });
+const STORAGE_STATE = "./e2e/auth/user.json";
+const GLOBAL_TRANSLATIONS_PATTERN = "../node_modules/@bigbinary/**/translations/en.json";
+const PROJECT_TRANSLATIONS_PATH = "../app/javascript/src/translations/en.json";
+const CREDENTIALS = {
+    firstName: "Oliver",
+    lastName: "Smith",
+    name: "Oliver Smith",
+    email: "oliver@example.com",
+    password: "welcome",
+    subdomainName: "spinkart",
+};
+const OTP_EMAIL_PATTERN = "Your login code is";
+const SLACK_DEFAULT_CHANNEL = "general";
+const CUSTOM_DOMAIN_SUFFIX = "aceinvoice.com";
+const ZAPIER_TEST_EMAIL = (product) => `neeto-${product}-zapier-test@${process.env.FASTMAIL_DOMAIN_NAME}`;
+const MAILPIT_BASE_URL = "https://mailpit.neetodeployapp.com";
+const MAILPIT_DOMAIN_NAME = "mail.aceinvoice.com";
+const IS_MAILPIT_ENABLED = isPresent(process.env.MAILPIT_DOMAIN_NAME);
+const mailpitDomainName = () => process.env.MAILPIT_DOMAIN_NAME || MAILPIT_DOMAIN_NAME;
+const ZAPIER_TEST_EMAIL_V2 = (product) => `neeto-${product}-zapier-test@${mailpitDomainName()}`;
+// constants for translation
+const SINGULAR = { count: 1 };
+const PLURAL = { count: 2 };
+const COLOR = {
+    transparent: "rgba(0, 0, 0, 0)",
+    softBlue: "rgb(230, 244, 255)",
+};
+const DATE_TEXTS = { now: "Now", nextYear: "next-year" };
+const EMPTY_STORAGE_STATE = {
+    storageState: { cookies: [], origins: [] },
+};
+const CURRENT_TIME_RANGES = {
+    last24Hours: "Last 24 hours",
+    thisWeek: "This week",
+    thisMonth: "This month",
+    thisYear: "This year",
+    thisQuarter: "This quarter",
+    last30Days: "Last 30 days",
+    last7Days: "Last 7 days",
+};
+const PAST_TIME_RANGES = {
+    lastWeek: "Last week",
+    lastMonth: "Last month",
+    lastYear: "Last year",
+    lastQuarter: "Last quarter",
+};
+const TIME_RANGES = {
+    ...PAST_TIME_RANGES,
+    ...CURRENT_TIME_RANGES,
+    customDuration: "Custom duration",
+};
+const DATE_RANGES = {
+    ...PAST_TIME_RANGES,
+    ...CURRENT_TIME_RANGES,
+    after: "After",
+    before: "Before",
+    customDateRange: "Custom date range",
+};
+const CERTIFICATE_LIMIT_EXCEEDED_REGEXP = `too many certificates \\(\\d+\\) already issued for "${CUSTOM_DOMAIN_SUFFIX}"`;
+const CERTIFICATE_LIMIT_EXCEEDED_MESSAGE = "Certificate limit exceeded for custom domain";
+const EXPORT_FILE_TYPES = {
+    pdf: "pdf",
+    excel: "excel",
+    csv: "csv",
+};
+const CALENDAR_LABELS = {
+    month: "month panel",
+    year: "year panel",
+};
+const DATE_FORMATS = {
+    month: "MMM",
+    year: "YYYY",
+    date: "DD/MM/YYYY",
+    calendarDate: "YYYY-MM-DD",
+};
+
+const EMPTY_SEARCH_RESULT = {
+    messages: [],
+    messagesCount: 0,
+};
+class MailpitApi {
+    neetoPlaywrightUtilities;
+    baseUrl;
+    headers;
+    constructor(neetoPlaywrightUtilities) {
+        this.neetoPlaywrightUtilities = neetoPlaywrightUtilities;
+        this.baseUrl = (process.env.MAILPIT_BASE_URL || MAILPIT_BASE_URL).replace(/\/+$/, "");
+        const { MAILPIT_USERNAME, MAILPIT_PASSWORD } = process.env;
+        this.headers =
+            MAILPIT_USERNAME && MAILPIT_PASSWORD
+                ? {
+                    Authorization: `Basic ${Buffer.from(`${MAILPIT_USERNAME}:${MAILPIT_PASSWORD}`).toString("base64")}`,
+                }
+                : {};
+    }
+    authorizeAndSetAccountId = async () => { };
+    warnOnUnexpectedResponse = (endpoint, response) => {
+        if (response.ok() || response.status() === 404)
+            return;
+        if (response.status() === 401) {
+            console.warn(`Mailpit rejected the credentials for ${endpoint}. Set MAILPIT_USERNAME and MAILPIT_PASSWORD to the basic auth credentials of ${this.baseUrl}, otherwise every email lookup will time out.`);
+            return;
+        }
+        console.warn(`Mailpit responded with ${response.status()} for ${endpoint}. Treating it as no result, so an email lookup may time out even though the email exists.`);
+    };
+    search = async ({ query, start = 0, limit = 50, tz = "UTC", }) => {
+        const isSearch = Boolean(query);
+        const endpoint = `/api/v1/${isSearch ? "search" : "messages"}`;
+        const response = await this.neetoPlaywrightUtilities.request.get(`${this.baseUrl}${endpoint}`, {
+            params: isSearch
+                ? { query: query, start, limit, tz }
+                : { start, limit },
+            headers: this.headers,
+            failOnStatusCode: false,
+            timeout: 15_000,
+        });
+        this.warnOnUnexpectedResponse(endpoint, response);
+        if (!response.ok())
+            return EMPTY_SEARCH_RESULT;
+        const { messages, messages_count: messagesCount } = await response.json();
+        return { messages: messages ?? [], messagesCount: messagesCount ?? 0 };
+    };
+    getMessage = async (id) => {
+        const endpoint = `/api/v1/message/${id}`;
+        const response = await this.neetoPlaywrightUtilities.request.get(`${this.baseUrl}${endpoint}`, { headers: this.headers, failOnStatusCode: false, timeout: 15_000 });
+        this.warnOnUnexpectedResponse(endpoint, response);
+        return response.ok() ? await response.json() : null;
+    };
+    fetchRawMessage = async (id) => {
+        const endpoint = `/api/v1/message/${id}/raw`;
+        const response = await this.neetoPlaywrightUtilities.request.get(`${this.baseUrl}${endpoint}`, { headers: this.headers, failOnStatusCode: false, timeout: 15_000 });
+        this.warnOnUnexpectedResponse(endpoint, response);
+        return response.ok() ? await response.body() : null;
+    };
+    deleteMessages = async (ids) => {
+        if (!ids?.length)
+            throw new Error("MailpitApi.deleteMessages requires a non-empty list of message IDs. Mailpit deletes every stored message when the list is empty, and the inbox is shared across neeto products.");
+        await this.neetoPlaywrightUtilities.request.delete(`${this.baseUrl}/api/v1/messages`, {
+            data: { IDs: ids },
+            headers: this.headers,
+            failOnStatusCode: false,
+            timeout: 15_000,
+        });
+    };
+}
+
 class MemberApis {
     neetoPlaywrightUtilities;
     teamMembersBaseUrl;
@@ -351,6 +507,7 @@ class RailsEmailApiClient {
         htmlBody: raw.html_body,
         textBody: raw.text_body,
         receivedAt: raw.received_at,
+        ...(raw.message_id && { messageId: raw.message_id }),
         attachments: raw.attachments?.map(({ filename, mime_type, data }) => ({
             name: filename,
             type: mime_type,
@@ -477,87 +634,6 @@ class TagsApi {
     });
 }
 
-const ENVIRONMENT = {
-    development: "development",
-    staging: "staging",
-    review: "review",
-};
-const EXAMPLE_URL = "https://example.com";
-const IS_STAGING_ENV = process.env.TEST_ENV === ENVIRONMENT.staging;
-const IS_DEV_ENV = process.env.TEST_ENV === ENVIRONMENT.development;
-const IS_CI = isPresent(process.env.NEETO_CI_JOB_ID);
-const DEFAULT_WEBHOOKS_RESPONSE_TEXT = JSON.stringify({ success: true });
-const STORAGE_STATE = "./e2e/auth/user.json";
-const GLOBAL_TRANSLATIONS_PATTERN = "../node_modules/@bigbinary/**/translations/en.json";
-const PROJECT_TRANSLATIONS_PATH = "../app/javascript/src/translations/en.json";
-const CREDENTIALS = {
-    firstName: "Oliver",
-    lastName: "Smith",
-    name: "Oliver Smith",
-    email: "oliver@example.com",
-    password: "welcome",
-    subdomainName: "spinkart",
-};
-const OTP_EMAIL_PATTERN = "Your login code is";
-const SLACK_DEFAULT_CHANNEL = "general";
-const CUSTOM_DOMAIN_SUFFIX = "aceinvoice.com";
-const ZAPIER_TEST_EMAIL = (product) => `neeto-${product}-zapier-test@${process.env.FASTMAIL_DOMAIN_NAME}`;
-// constants for translation
-const SINGULAR = { count: 1 };
-const PLURAL = { count: 2 };
-const COLOR = {
-    transparent: "rgba(0, 0, 0, 0)",
-    softBlue: "rgb(230, 244, 255)",
-};
-const DATE_TEXTS = { now: "Now", nextYear: "next-year" };
-const EMPTY_STORAGE_STATE = {
-    storageState: { cookies: [], origins: [] },
-};
-const CURRENT_TIME_RANGES = {
-    last24Hours: "Last 24 hours",
-    thisWeek: "This week",
-    thisMonth: "This month",
-    thisYear: "This year",
-    thisQuarter: "This quarter",
-    last30Days: "Last 30 days",
-    last7Days: "Last 7 days",
-};
-const PAST_TIME_RANGES = {
-    lastWeek: "Last week",
-    lastMonth: "Last month",
-    lastYear: "Last year",
-    lastQuarter: "Last quarter",
-};
-const TIME_RANGES = {
-    ...PAST_TIME_RANGES,
-    ...CURRENT_TIME_RANGES,
-    customDuration: "Custom duration",
-};
-const DATE_RANGES = {
-    ...PAST_TIME_RANGES,
-    ...CURRENT_TIME_RANGES,
-    after: "After",
-    before: "Before",
-    customDateRange: "Custom date range",
-};
-const CERTIFICATE_LIMIT_EXCEEDED_REGEXP = `too many certificates \\(\\d+\\) already issued for "${CUSTOM_DOMAIN_SUFFIX}"`;
-const CERTIFICATE_LIMIT_EXCEEDED_MESSAGE = "Certificate limit exceeded for custom domain";
-const EXPORT_FILE_TYPES = {
-    pdf: "pdf",
-    excel: "excel",
-    csv: "csv",
-};
-const CALENDAR_LABELS = {
-    month: "month panel",
-    year: "year panel",
-};
-const DATE_FORMATS = {
-    month: "MMM",
-    year: "YYYY",
-    date: "DD/MM/YYYY",
-    calendarDate: "YYYY-MM-DD",
-};
-
 const THANK_YOU_URL = "/neeto_thank_you/thank_you_configurations";
 class ThankYouApi {
     neetoPlaywrightUtilities;
@@ -69536,16 +69612,19 @@ class FastmailApi {
     accountId;
     constructor(neetoPlaywrightUtilities) {
         this.neetoPlaywrightUtilities = neetoPlaywrightUtilities;
-        if (!IS_DEV_ENV && !process.env.NEETO_AUTOMATION_FASTMAIL_API_KEY)
-            throw new Error("Please set the environment variable NEETO_AUTOMATION_FASTMAIL_API_KEYS. Credentials can be found in the Automation Credentials vault in the BigBinary 1Password account.");
         this.headers = {
             "Content-Type": "application/json",
             Authorization: `Bearer ${process.env.NEETO_AUTOMATION_FASTMAIL_API_KEY}`,
         };
     }
+    assertApiKey = () => {
+        if (!process.env.NEETO_AUTOMATION_FASTMAIL_API_KEY)
+            throw new Error("Please set the environment variable NEETO_AUTOMATION_FASTMAIL_API_KEY. Credentials can be found in the Automation Credentials vault in the BigBinary 1Password account.");
+    };
     authorizeAndSetAccountId = async () => {
         if (IS_DEV_ENV)
             return;
+        this.assertApiKey();
         const response = await this.neetoPlaywrightUtilities.apiRequest({
             method: "get",
             url: "https://api.fastmail.com/.well-known/jmap",
@@ -69555,6 +69634,7 @@ class FastmailApi {
         this.accountId = accountId;
     };
     apiRequest = async (method, body) => {
+        this.assertApiKey();
         const response = await this.neetoPlaywrightUtilities.apiRequest({
             method: "post",
             url: "https://api.fastmail.com/jmap/api/",
@@ -69653,6 +69733,7 @@ class RailsEmailUtils {
                 type: att.type,
             })) || [],
             blobId: "",
+            ...(railsEmail.messageId && { messageId: railsEmail.messageId }),
         };
     };
     clearEmails = () => this.railsEmailClient.clearEmails();
@@ -69662,7 +69743,7 @@ class RailsEmailUtils {
     };
     getLatestEmail = async (searchParams) => {
         await this.clearStaleEmails();
-        await this.railsEmailClient.getLatestEmail(searchParams);
+        return this.railsEmailClient.getLatestEmail(searchParams);
     };
     listEmails = (searchParams) => this.railsEmailClient.listEmails(searchParams);
     listMessages = async (messageSearchCriteria = {}, { receivedAfter = new Date(new Date().valueOf() - 60 * 60 * 1000), } = {}) => {
@@ -69702,6 +69783,12 @@ class RailsEmailUtils {
         }
         return email;
     };
+    getLatestMessageId = async (subject, { timeout = 10_000, receivedAfter = new Date(new Date().valueOf() - 60 * 1000), } = {}) => {
+        const email = await this.findMessage({ subject }, { timeout, receivedAfter }, false);
+        if (!("messageId" in email) || !email.messageId)
+            return undefined;
+        return email.messageId.replace(/^<|>$/g, "");
+    };
     findOtpFromEmail = async ({ email, subjectSubstring = OTP_EMAIL_PATTERN, timeout = 10_000, receivedAfter = new Date(), expectedEmailCount = 1, }) => {
         const otp = await this.neetoPlaywrightUtilities.executeRecursively({
             callback: async () => {
@@ -69772,14 +69859,23 @@ class RailsEmailUtils {
 }
 
 const dateTimeOneHourAgo = () => new Date(new Date().valueOf() - 60 * 60 * 1000);
+const MAILPIT_SEARCH_DATE_MARGIN = 24 * 60 * 60 * 1000;
+const toMailpitSearchDate = (date) => new Date(date.valueOf() - MAILPIT_SEARCH_DATE_MARGIN)
+    .toISOString()
+    .slice(0, 10)
+    .replace(/-/g, "/");
+const toMailpitSearchTerm = (value) => `"${value.replace(/"/g, "")}"`;
+const mailpitTimeoutError = (messageSearchCriteria, receivedAfter, expectedEmailCount) => new Error(`Timed out waiting for matching message. Searched Mailpit for ${JSON.stringify(messageSearchCriteria)} received after ${receivedAfter.toISOString()}, expecting at least ${expectedEmailCount}.`);
 class MailerUtils {
     neetoPlaywrightUtilities;
     accountId;
     fastmailApi;
+    mailpitApi;
     railsEmailUtils;
     constructor(neetoPlaywrightUtilities) {
         this.neetoPlaywrightUtilities = neetoPlaywrightUtilities;
         this.fastmailApi = new FastmailApi(neetoPlaywrightUtilities);
+        this.mailpitApi = new MailpitApi(neetoPlaywrightUtilities);
         this.railsEmailUtils = new RailsEmailUtils(neetoPlaywrightUtilities);
     }
     queryEmail = async (messageSearchCriteria, { receivedAfter = dateTimeOneHourAgo(), page = 1, itemsPerPage = 50, }) => {
@@ -69805,9 +69901,29 @@ class MailerUtils {
         }
         return { ids, total };
     };
-    getEmails = async (ids) => {
+    buildMessageBodies = (emailBody, { stripInjectedLinks = false } = {}) => {
         const LINK_REGEX = /(http|ftp|https):\/\/([\w_-]+(?:(?:\.[\w_-]+)+))([\w.,@?^=%&:/~+#-]*[\w@?^=%&/~+#-])/g;
         const CODE_REGEX = /(?<![#/])\b\d{4,}\b/g;
+        const emailBodyWithStrippedHead = emailBody.split("</head>").at(-1);
+        const links = emailBodyWithStrippedHead.match(LINK_REGEX);
+        const codes = emailBodyWithStrippedHead.match(CODE_REGEX);
+        const filteredLinks = stripInjectedLinks && links && links.length > 2
+            ? links.slice(1, -1)
+            : links;
+        const contentRecognitions = {
+            links: filteredLinks,
+            codes: codes && [...codes],
+        };
+        const html = { body: emailBody, ...contentRecognitions };
+        const wrappedHtml = /<html[\s>]/i.test(emailBody)
+            ? emailBody.replace(/\sxmlns="[^"]+"/g, "")
+            : basicHTMLContent(emailBody);
+        const root = distExports.parse(wrappedHtml, { comment: false });
+        const textBody = root.querySelector("body")?.text.trim() || "";
+        const text = { body: textBody, ...contentRecognitions };
+        return { html, text };
+    };
+    getEmails = async (ids) => {
         const messageDetailsBody = {
             ids,
             bodyProperties: ["type", "name"],
@@ -69815,24 +69931,11 @@ class MailerUtils {
         };
         const { methodResponses: [[, { list }]], } = await this.fastmailApi.apiRequest("Email/get", messageDetailsBody);
         const formattedList = list.map((listItem) => {
-            const { id, from, to, bodyValues, cc, bcc, replyTo, receivedAt, subject, attachments, blobId, } = listItem;
+            const { id, from, to, bodyValues, cc, bcc, replyTo, receivedAt, subject, messageId, attachments, blobId, } = listItem;
             const emailBody = Object.values(pluck("value", bodyValues)).join(" ");
-            const emailBodyWithStrippedHead = emailBody.split("</head>").at(-1);
-            const links = emailBodyWithStrippedHead.match(LINK_REGEX);
-            const codes = emailBodyWithStrippedHead.match(CODE_REGEX);
-            // Remove first and last links as Fastmail adds dot image links
-            const filteredLinks = links && links.length > 2 ? links.slice(1, -1) : links;
-            const contentRecognitions = {
-                links: filteredLinks,
-                codes: codes && [...codes],
-            };
-            const html = { body: emailBody, ...contentRecognitions };
-            const wrappedHtml = /<html[\s>]/i.test(emailBody)
-                ? emailBody.replace(/\sxmlns="[^"]+"/g, "")
-                : basicHTMLContent(emailBody);
-            const root = distExports.parse(wrappedHtml, { comment: false });
-            const textBody = root.querySelector("body")?.text.trim() || "";
-            const text = { body: textBody, ...contentRecognitions };
+            const { html, text } = this.buildMessageBodies(emailBody, {
+                stripInjectedLinks: true,
+            });
             return {
                 html,
                 text,
@@ -69846,6 +69949,7 @@ class MailerUtils {
                 subject,
                 attachments,
                 blobId,
+                ...(messageId?.[0] && { messageId: messageId[0] }),
             };
         });
         return formattedList;
@@ -69866,10 +69970,10 @@ class MailerUtils {
                 return ids;
             },
             condition: async () => {
-                const { total } = await this.queryEmail(messageSearchCriteria, {
+                const { ids } = await this.queryEmail(messageSearchCriteria, {
                     receivedAfter,
                 });
-                return total >= expectedEmailCount;
+                return ids.length >= expectedEmailCount;
             },
             timeout,
         }));
@@ -69926,6 +70030,46 @@ class MailerUtils {
         return codes?.[0];
     };
     generateRandomEmail = () => faker.internet.email({ provider: process.env.FASTMAIL_DOMAIN_NAME });
+    getLatestMessageId = async (subject, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), } = {}) => {
+        if (IS_DEV_ENV) {
+            return this.railsEmailUtils.getLatestMessageId(subject, {
+                timeout: timeout / 3,
+                receivedAfter,
+            });
+        }
+        if (!this.accountId) {
+            await this.fastmailApi.authorizeAndSetAccountId();
+        }
+        const messageId = (await this.neetoPlaywrightUtilities.executeRecursively({
+            callback: async () => {
+                const { methodResponses: [[, { ids }]], } = await this.fastmailApi.apiRequest("Email/query", {
+                    filter: { subject, after: receivedAfter.toISOString() },
+                    sort: [{ property: "receivedAt", isAscending: false }],
+                    limit: 1,
+                });
+                const emailId = ids?.[0];
+                if (!emailId)
+                    return null;
+                const { methodResponses: [[, { list }]], } = await this.fastmailApi.apiRequest("Email/get", {
+                    ids: [emailId],
+                    properties: ["messageId"],
+                });
+                const rawMessageId = list?.[0]?.messageId?.[0];
+                if (!rawMessageId)
+                    return null;
+                return rawMessageId.replace(/^<|>$/g, "");
+            },
+            condition: async () => {
+                const { methodResponses: [[, { ids }]], } = await this.fastmailApi.apiRequest("Email/query", {
+                    filter: { subject, after: receivedAfter.toISOString() },
+                    limit: 1,
+                });
+                return ids.length >= 1;
+            },
+            timeout,
+        }));
+        return messageId || undefined;
+    };
     getEmailAttachment = async ({ name, type }, messageSearchCriteria = {}, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), expectedEmailCount = 1, } = {}, shouldThrowErrorOnTimeout = true) => {
         if (IS_DEV_ENV)
             return this.railsEmailUtils.getEmailAttachment({ name, type }, messageSearchCriteria, { receivedAfter, expectedEmailCount, timeout: timeout / 3 }, shouldThrowErrorOnTimeout);
@@ -69947,6 +70091,189 @@ class MailerUtils {
             return matchesName && matchesType;
         });
     };
+    toIdentifiers = (addresses) => {
+        if (!addresses)
+            return [];
+        return (Array.isArray(addresses) ? addresses : [addresses]).map(({ Name, Address }) => ({ name: Name || "", email: Address || "" }));
+    };
+    toMailpitAttachments = (message) => [
+        ...(message?.Attachments || []),
+        ...(message?.Inline || []).filter(({ ContentID }) => !ContentID),
+    ];
+    toFormattedList = (summary, message) => {
+        const { html, text } = this.buildMessageBodies(message.HTML || "", {
+            stripInjectedLinks: true,
+        });
+        const attachments = this.toMailpitAttachments(message).map(({ FileName, ContentType }) => ({
+            name: FileName || null,
+            type: ContentType,
+        }));
+        const messageId = (message.MessageID || summary.MessageID || "").replace(/^<|>$/g, "");
+        return {
+            html,
+            text,
+            id: summary.ID,
+            from: this.toIdentifiers(message.From || summary.From),
+            to: this.toIdentifiers(message.To || summary.To),
+            cc: this.toIdentifiers(message.Cc || summary.Cc),
+            bcc: this.toIdentifiers(message.Bcc || summary.Bcc),
+            replyTo: this.toIdentifiers(message.ReplyTo || summary.ReplyTo),
+            received: new Date(summary.Created),
+            subject: message.Subject ?? summary.Subject,
+            attachments,
+            blobId: "",
+            ...(messageId && { messageId }),
+        };
+    };
+    matchesSummaryCriteria = (summary, { to, from, subject }) => {
+        if (to &&
+            !this.toIdentifiers(summary.To).some(recipient => recipient.email.toLowerCase() === to.toLowerCase()))
+            return false;
+        if (from &&
+            !this.toIdentifiers(summary.From).some(sender => sender.email.toLowerCase() === from.toLowerCase()))
+            return false;
+        if (subject &&
+            !(summary.Subject || "").toLowerCase().includes(subject.toLowerCase()))
+            return false;
+        return true;
+    };
+    warnOnNonMailpitRecipient = ({ to, }) => {
+        const domain = mailpitDomainName().toLowerCase();
+        if (to && !to.toLowerCase().endsWith(`@${domain}`))
+            console.warn(`MailerUtils V2 reads from Mailpit, but "${to}" is not on the Mailpit domain "${domain}". Unless mail for that address is relayed to Mailpit, this lookup will poll until it times out. Generate recipients with generateRandomEmailV2().`);
+    };
+    queryMailpitEmails = async (messageSearchCriteria, { receivedAfter = dateTimeOneHourAgo(), page = 1, itemsPerPage = 50, }) => {
+        if (itemsPerPage > 100 || itemsPerPage < 1)
+            throw new Error("itemsPerPage should be in the range of 1-100");
+        const { to, from } = messageSearchCriteria;
+        const query = [
+            ...(to ? [`to:${toMailpitSearchTerm(to)}`] : []),
+            ...(from ? [`from:${toMailpitSearchTerm(from)}`] : []),
+            `after:${toMailpitSearchDate(receivedAfter)}`,
+        ].join(" ");
+        const { messages } = await this.mailpitApi.search({
+            query,
+            start: (page - 1) * itemsPerPage,
+            limit: itemsPerPage,
+        });
+        return messages.filter(summary => new Date(summary.Created).valueOf() >= receivedAfter.valueOf() &&
+            this.matchesSummaryCriteria(summary, messageSearchCriteria));
+    };
+    getEmailsV2 = async (summaries) => {
+        const emails = await Promise.all(summaries.map(async (summary) => {
+            const message = await this.mailpitApi.getMessage(summary.ID);
+            return message && this.toFormattedList(summary, message);
+        }));
+        return emails.filter(Boolean);
+    };
+    pollForMailpitSummaries = async (messageSearchCriteria, { timeout, receivedAfter, expectedEmailCount, }) => {
+        const requiresBodyMatch = Boolean(messageSearchCriteria.body);
+        let matchingSummaries = [];
+        const summaries = await this.neetoPlaywrightUtilities.executeRecursively({
+            callback: async () => matchingSummaries,
+            condition: async () => {
+                const candidates = await this.queryMailpitEmails(messageSearchCriteria, { receivedAfter });
+                if (requiresBodyMatch) {
+                    const emails = await this.getEmailsV2(candidates);
+                    const matchedIds = new Set(emails
+                        .filter(email => this.matchesCriteria(email, messageSearchCriteria))
+                        .map(({ id }) => id));
+                    matchingSummaries = candidates.filter(({ ID }) => matchedIds.has(ID));
+                }
+                else {
+                    matchingSummaries = candidates;
+                }
+                return matchingSummaries.length >= expectedEmailCount;
+            },
+            timeout,
+        });
+        return summaries === false ? null : summaries;
+    };
+    listMessagesV2 = async (messageSearchCriteria = {}, listMessagesFilterCriteria = {}) => {
+        if (IS_DEV_ENV) {
+            return this.railsEmailUtils.listMessages(messageSearchCriteria, listMessagesFilterCriteria);
+        }
+        this.warnOnNonMailpitRecipient(messageSearchCriteria);
+        const summaries = await this.queryMailpitEmails(messageSearchCriteria, listMessagesFilterCriteria);
+        const emails = await this.getEmailsV2(summaries);
+        return emails.filter(email => this.matchesCriteria(email, messageSearchCriteria));
+    };
+    getEmailIdsV2 = async (messageSearchCriteria = {}, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), expectedEmailCount = 1, } = {}, shouldThrowErrorOnTimeout = true) => {
+        if (IS_DEV_ENV) {
+            const emails = await this.railsEmailUtils.listMessages(messageSearchCriteria, { receivedAfter });
+            return emails.map(({ id }) => id);
+        }
+        this.warnOnNonMailpitRecipient(messageSearchCriteria);
+        const summaries = await this.pollForMailpitSummaries(messageSearchCriteria, { timeout, receivedAfter, expectedEmailCount });
+        if (!summaries) {
+            if (shouldThrowErrorOnTimeout)
+                throw mailpitTimeoutError(messageSearchCriteria, receivedAfter, expectedEmailCount);
+            return [];
+        }
+        return summaries.map(({ ID }) => ID);
+    };
+    findMessageV2 = async (messageSearchCriteria = {}, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), expectedEmailCount = 1, } = {}, shouldThrowErrorOnTimeout = true) => {
+        if (IS_DEV_ENV) {
+            return this.railsEmailUtils.findMessage(messageSearchCriteria, { receivedAfter, expectedEmailCount, timeout: timeout / 3 }, shouldThrowErrorOnTimeout);
+        }
+        this.warnOnNonMailpitRecipient(messageSearchCriteria);
+        const summaries = await this.pollForMailpitSummaries(messageSearchCriteria, { timeout, receivedAfter, expectedEmailCount });
+        if (!summaries) {
+            if (shouldThrowErrorOnTimeout)
+                throw mailpitTimeoutError(messageSearchCriteria, receivedAfter, expectedEmailCount);
+            return {};
+        }
+        const emails = await this.getEmailsV2(summaries);
+        const filteredEmails = emails.filter(email => this.matchesCriteria(email, messageSearchCriteria));
+        return filteredEmails[0] || {};
+    };
+    findOtpFromEmailV2 = async ({ email, subjectSubstring = OTP_EMAIL_PATTERN, timeout = 2 * 60 * 1000, receivedAfter = new Date(Date.now() - 3000), expectedEmailCount = 1, }) => {
+        if (IS_DEV_ENV) {
+            return this.railsEmailUtils.findOtpFromEmail({
+                email,
+                subjectSubstring,
+                receivedAfter,
+                expectedEmailCount,
+                timeout: timeout / 3,
+            });
+        }
+        const message = await this.findMessageV2({ to: email, subject: subjectSubstring }, { timeout, receivedAfter, expectedEmailCount });
+        return message.html?.codes?.[0];
+    };
+    generateRandomEmailV2 = () => {
+        const domain = mailpitDomainName();
+        const [localPart] = faker.internet.email({ provider: domain }).split("@");
+        return `${localPart}.${faker.string.alphanumeric(8).toLowerCase()}@${domain}`;
+    };
+    getLatestMessageIdV2 = async (subject, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), } = {}) => {
+        if (IS_DEV_ENV) {
+            return this.railsEmailUtils.getLatestMessageId(subject, {
+                timeout: timeout / 3,
+                receivedAfter,
+            });
+        }
+        const summaries = await this.pollForMailpitSummaries({ subject }, { timeout, receivedAfter, expectedEmailCount: 1 });
+        const messageId = summaries?.[0]?.MessageID;
+        return messageId ? messageId.replace(/^<|>$/g, "") : undefined;
+    };
+    getEmailAttachmentV2 = async ({ name, type }, messageSearchCriteria = {}, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), expectedEmailCount = 1, } = {}, shouldThrowErrorOnTimeout = true) => {
+        if (IS_DEV_ENV)
+            return this.railsEmailUtils.getEmailAttachment({ name, type }, messageSearchCriteria, { receivedAfter, expectedEmailCount, timeout: timeout / 3 }, shouldThrowErrorOnTimeout);
+        const { id } = await this.findMessageV2(messageSearchCriteria, { expectedEmailCount, receivedAfter, timeout }, shouldThrowErrorOnTimeout);
+        const rawMessage = id ? await this.mailpitApi.fetchRawMessage(id) : null;
+        if (!rawMessage)
+            throw new Error("No such attachment exists");
+        const parsedEmail = await mailparserExports.simpleParser(rawMessage);
+        const attachments = parsedEmail.attachments;
+        const attachment = attachments.find(att => {
+            const matchesName = name ? att.filename?.includes(name) : true;
+            const matchesType = type ? att.contentType?.startsWith(type) : true;
+            return matchesName && matchesType;
+        });
+        if (!attachment)
+            throw new Error("No such attachment exists");
+        return attachment;
+    };
 }
 
 var HeaderTypes;
@@ -116619,7 +116946,8 @@ const commands = {
     },
     mailerUtils: async ({ neetoPlaywrightUtilities }, use) => {
         const mailerUtils = new MailerUtils(neetoPlaywrightUtilities);
-        await mailerUtils.fastmailApi.authorizeAndSetAccountId();
+        if (!IS_MAILPIT_ENABLED)
+            await mailerUtils.fastmailApi.authorizeAndSetAccountId();
         await use(mailerUtils);
         IS_DEV_ENV && (await mailerUtils.railsEmailUtils.clearStaleEmails());
     },
@@ -126177,4 +126505,4 @@ const definePlaywrightConfig = (overrides) => {
     });
 };
 
-export { ACTIONS, ADMIN_PANEL_SELECTORS, ALL_RESOURCES, ANALYTICS_RESOURCES, API_KEYS_SELECTORS, API_ROUTES, APP_RESOURCES, AUDIT_LOGS_SELECTORS, ApiKeysApi, ApiKeysPage, AuditLogsPage, BASE_URL, CALENDAR_LABELS, CERTIFICATE_LIMIT_EXCEEDED_MESSAGE, CERTIFICATE_LIMIT_EXCEEDED_REGEXP, CHANGELOG_WIDGET_SELECTORS, CHAT_WIDGET_SELECTORS, CHAT_WIDGET_TEXTS, COLOR, COMMON_SELECTORS, COMMON_TEXTS, COMMUNITY_TEXTS, CREDENTIALS, CURRENT_TIME_RANGES, CUSTOM_DOMAIN_SELECTORS, CUSTOM_DOMAIN_SUFFIX, ColorPickerUtils, CustomCommands, CustomDomainApi, CustomDomainPage, DATE_FORMATS, DATE_PICKER_SELECTORS, DATE_RANGES, DATE_TEXTS, DEFAULT_WEBHOOKS_RESPONSE_TEXT, DESCRIPTION_EDITOR_TEXTS, EDITOR_VERIFY_TEXT_COLOR, EMBED_SELECTORS, EMOJI_LABEL, EMPTY_STORAGE_STATE, ENGAGE_TEXTS, ENVIRONMENT, EXAMPLE_URL, EXPANDED_FONT_SIZE, EXPORT_FILE_TYPES, EditorPage, EmailDeliveryUtils, EmbedBase, FILE_FORMATS, FONTS_RESOURCES, FONT_SIZE_SELECTORS, FROM_EMAIL_ENV_KEYS, GLOBAL_TRANSLATIONS_PATTERN, GOOGLE_ANALYTICS_SELECTORS, GOOGLE_CALENDAR_DATE_FORMAT, GOOGLE_LOGIN_SELECTORS, GOOGLE_LOGIN_TEXTS, GOOGLE_SHEETS_SELECTORS, GooglePage, HELP_CENTER_ROUTES, HELP_CENTER_SELECTORS, HelpAndProfilePage, INTEGRATIONS_TEXTS, INTEGRATION_SELECTORS, IPRestrictionsPage, IP_RESTRICTIONS_SELECTORS, IS_CI, IS_DEV_ENV, IS_STAGING_ENV, ImageUploader, IntegrationBase, IpRestrictionsApi, KEYBOARD_SHORTCUTS_SELECTORS, KEYBOARD_SHORTCUT_TEST_CASES, LIST_MODIFIER_SELECTORS, LIST_MODIFIER_TAGS, LOGIN_SELECTORS, MEMBER_FORM_SELECTORS, MEMBER_SELECTORS, MEMBER_TEXTS, MERGE_TAGS_SELECTORS, MICROSOFT_LOGIN_SELECTORS, MICROSOFT_LOGIN_TEXTS, MailerUtils, Member, MemberApis, MicrosoftPage, NEETO_AUTH_BASE_URL, NEETO_EDITOR_SELECTORS, NEETO_FILTERS_SELECTORS, NEETO_IMAGE_UPLOADER_SELECTORS, NEETO_ROUTES, NEETO_SEO_SELECTORS, NEETO_TEXT_MODIFIER_SELECTORS, NeetoAuthServer, NeetoChatWidget, NeetoEmailDeliveryApi, NeetoTowerApi, ONBOARDING_SELECTORS, ORGANIZATION_TEXTS, OTP_EMAIL_PATTERN, OrganizationPage, PAST_TIME_RANGES, PHONE_NUMBER_FORMATS, PLURAL, PRODUCT_ROLES_ROUTE_MAP, PROFILE_LINKS, PROFILE_SECTION_SELECTORS, PROJECT_NAMES, PROJECT_TRANSLATIONS_PATH, ROLES_SELECTORS, ROUTES, RailsEmailApiClient, RailsEmailUtils, RoleApis, RolesPage, SIGNUP_SELECTORS, SINGULAR, SLACK_DATA_QA_SELECTORS, SLACK_DEFAULT_CHANNEL, SLACK_SELECTORS, SLACK_WEB_TEXTS, STATUS_TEXTS, STORAGE_STATE, SecurityApi, SidebarSection, SlackApi, SlackPage, TABLE_SELECTORS, TAB_SELECTORS, TAGS_SELECTORS, TEAM_MEMBER_TEXTS, TEXT_MODIFIER_ROLES, TEXT_MODIFIER_SELECTORS, TEXT_MODIFIER_TAGS, THANK_YOU_SELECTORS, THEMES_SELECTORS, THEMES_TEXTS, THIRD_PARTY_RESOURCES, THIRD_PARTY_ROUTES, TIME_RANGES, TOASTR_MESSAGES, TWILIO_SELECTORS, TagsApi, TagsPage, TeamMembers, ThankYouApi, ThankYouPage, TwilioApi, USER_AGENTS, WEBHOOK_SELECTORS, WebhookSiteApi, WebhooksPage, ZAPIER_LIMIT_EXHAUSTED_MESSAGE, ZAPIER_SELECTORS, ZAPIER_TEST_EMAIL, ZAPIER_WEB_TEXTS, ZapierPage, authenticateUser, baseURLGenerator, basicHTMLContent, clearCredentials, commands, cpuThrottlingUsingCDP, createOrganizationViaRake, currencyUtils, dataQa, decodeQRCodeFromFile, definePlaywrightConfig, executeWithThrottledResources, extractSubdomainFromError, filterUtils, fixedMenuSelector, generatePhoneNumber, generatePhoneNumberDetails, generateRandomBypassEmail, generateRandomFile, generateStagingData, getByDataQA, getClipboardContent, getDirname, getFormattedPhoneNumber, getFullUrl, getGlobalUserProps, getGlobalUserState, getImagePathAndName, getIsoCodeFromPhoneCode, getListCount, globalShortcuts, grantClipboardPermissions, hexToRGB, hexToRGBA, i18nFixture, imageRegex, initializeCredentials, initializeTestData, initializeTotp, isGithubIssueOpen, isStagingOrganizationExpired, joinHyphenCase, joinString, login, networkConditions, networkThrottlingUsingCDP, optionSelector, readFileSyncIfExists, removeCredentialFile, serializeFileForBrowser, shouldSkipCustomDomainSetup, shouldSkipSetupAndTeardown, simulateClickWithDelay, simulateTypingWithDelay, skipTest, squish, stealth as stealthTest, tableUtils, toCamelCase, updateCredentials, warmup, withCookieCache, writeDataToFile };
+export { ACTIONS, ADMIN_PANEL_SELECTORS, ALL_RESOURCES, ANALYTICS_RESOURCES, API_KEYS_SELECTORS, API_ROUTES, APP_RESOURCES, AUDIT_LOGS_SELECTORS, ApiKeysApi, ApiKeysPage, AuditLogsPage, BASE_URL, CALENDAR_LABELS, CERTIFICATE_LIMIT_EXCEEDED_MESSAGE, CERTIFICATE_LIMIT_EXCEEDED_REGEXP, CHANGELOG_WIDGET_SELECTORS, CHAT_WIDGET_SELECTORS, CHAT_WIDGET_TEXTS, COLOR, COMMON_SELECTORS, COMMON_TEXTS, COMMUNITY_TEXTS, CREDENTIALS, CURRENT_TIME_RANGES, CUSTOM_DOMAIN_SELECTORS, CUSTOM_DOMAIN_SUFFIX, ColorPickerUtils, CustomCommands, CustomDomainApi, CustomDomainPage, DATE_FORMATS, DATE_PICKER_SELECTORS, DATE_RANGES, DATE_TEXTS, DEFAULT_WEBHOOKS_RESPONSE_TEXT, DESCRIPTION_EDITOR_TEXTS, EDITOR_VERIFY_TEXT_COLOR, EMBED_SELECTORS, EMOJI_LABEL, EMPTY_STORAGE_STATE, ENGAGE_TEXTS, ENVIRONMENT, EXAMPLE_URL, EXPANDED_FONT_SIZE, EXPORT_FILE_TYPES, EditorPage, EmailDeliveryUtils, EmbedBase, FILE_FORMATS, FONTS_RESOURCES, FONT_SIZE_SELECTORS, FROM_EMAIL_ENV_KEYS, GLOBAL_TRANSLATIONS_PATTERN, GOOGLE_ANALYTICS_SELECTORS, GOOGLE_CALENDAR_DATE_FORMAT, GOOGLE_LOGIN_SELECTORS, GOOGLE_LOGIN_TEXTS, GOOGLE_SHEETS_SELECTORS, GooglePage, HELP_CENTER_ROUTES, HELP_CENTER_SELECTORS, HelpAndProfilePage, INTEGRATIONS_TEXTS, INTEGRATION_SELECTORS, IPRestrictionsPage, IP_RESTRICTIONS_SELECTORS, IS_CI, IS_DEV_ENV, IS_MAILPIT_ENABLED, IS_STAGING_ENV, ImageUploader, IntegrationBase, IpRestrictionsApi, KEYBOARD_SHORTCUTS_SELECTORS, KEYBOARD_SHORTCUT_TEST_CASES, LIST_MODIFIER_SELECTORS, LIST_MODIFIER_TAGS, LOGIN_SELECTORS, MAILPIT_BASE_URL, MAILPIT_DOMAIN_NAME, MEMBER_FORM_SELECTORS, MEMBER_SELECTORS, MEMBER_TEXTS, MERGE_TAGS_SELECTORS, MICROSOFT_LOGIN_SELECTORS, MICROSOFT_LOGIN_TEXTS, MailerUtils, MailpitApi, Member, MemberApis, MicrosoftPage, NEETO_AUTH_BASE_URL, NEETO_EDITOR_SELECTORS, NEETO_FILTERS_SELECTORS, NEETO_IMAGE_UPLOADER_SELECTORS, NEETO_ROUTES, NEETO_SEO_SELECTORS, NEETO_TEXT_MODIFIER_SELECTORS, NeetoAuthServer, NeetoChatWidget, NeetoEmailDeliveryApi, NeetoTowerApi, ONBOARDING_SELECTORS, ORGANIZATION_TEXTS, OTP_EMAIL_PATTERN, OrganizationPage, PAST_TIME_RANGES, PHONE_NUMBER_FORMATS, PLURAL, PRODUCT_ROLES_ROUTE_MAP, PROFILE_LINKS, PROFILE_SECTION_SELECTORS, PROJECT_NAMES, PROJECT_TRANSLATIONS_PATH, ROLES_SELECTORS, ROUTES, RailsEmailApiClient, RailsEmailUtils, RoleApis, RolesPage, SIGNUP_SELECTORS, SINGULAR, SLACK_DATA_QA_SELECTORS, SLACK_DEFAULT_CHANNEL, SLACK_SELECTORS, SLACK_WEB_TEXTS, STATUS_TEXTS, STORAGE_STATE, SecurityApi, SidebarSection, SlackApi, SlackPage, TABLE_SELECTORS, TAB_SELECTORS, TAGS_SELECTORS, TEAM_MEMBER_TEXTS, TEXT_MODIFIER_ROLES, TEXT_MODIFIER_SELECTORS, TEXT_MODIFIER_TAGS, THANK_YOU_SELECTORS, THEMES_SELECTORS, THEMES_TEXTS, THIRD_PARTY_RESOURCES, THIRD_PARTY_ROUTES, TIME_RANGES, TOASTR_MESSAGES, TWILIO_SELECTORS, TagsApi, TagsPage, TeamMembers, ThankYouApi, ThankYouPage, TwilioApi, USER_AGENTS, WEBHOOK_SELECTORS, WebhookSiteApi, WebhooksPage, ZAPIER_LIMIT_EXHAUSTED_MESSAGE, ZAPIER_SELECTORS, ZAPIER_TEST_EMAIL, ZAPIER_TEST_EMAIL_V2, ZAPIER_WEB_TEXTS, ZapierPage, authenticateUser, baseURLGenerator, basicHTMLContent, clearCredentials, commands, cpuThrottlingUsingCDP, createOrganizationViaRake, currencyUtils, dataQa, decodeQRCodeFromFile, definePlaywrightConfig, executeWithThrottledResources, extractSubdomainFromError, filterUtils, fixedMenuSelector, generatePhoneNumber, generatePhoneNumberDetails, generateRandomBypassEmail, generateRandomFile, generateStagingData, getByDataQA, getClipboardContent, getDirname, getFormattedPhoneNumber, getFullUrl, getGlobalUserProps, getGlobalUserState, getImagePathAndName, getIsoCodeFromPhoneCode, getListCount, globalShortcuts, grantClipboardPermissions, hexToRGB, hexToRGBA, i18nFixture, imageRegex, initializeCredentials, initializeTestData, initializeTotp, isGithubIssueOpen, isStagingOrganizationExpired, joinHyphenCase, joinString, login, mailpitDomainName, networkConditions, networkThrottlingUsingCDP, optionSelector, readFileSyncIfExists, removeCredentialFile, serializeFileForBrowser, shouldSkipCustomDomainSetup, shouldSkipSetupAndTeardown, simulateClickWithDelay, simulateTypingWithDelay, skipTest, squish, stealth as stealthTest, tableUtils, toCamelCase, updateCredentials, warmup, withCookieCache, writeDataToFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigbinary/neeto-playwright-commons",
-  "version": "4.2.3",
+  "version": "4.3.0",
   "description": "A package encapsulating common playwright code across neeto projects.",
   "repository": "git@github.com:bigbinary/neeto-playwright-commons.git",
   "license": "apache-2.0",