@qawolf/emails 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QA Wolf Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @qawolf/emails
+
+`@qawolf/emails` is a TypeScript toolkit designed to help you use QA
+Wolf-managed inboxes in email-driven tests.
+
+The QA Wolf runner configures the emails client for each flow, so flow code can
+call `mail.inbox()` directly. Use it to create inbox addresses, wait for
+inbound messages, parse links from email content, and send outbound messages.
+
+To learn more about how to use `@qawolf/emails`, check out the
+[API Reference](https://docs.qawolf.com/qawolf/libraries/emails/api-reference/mail)
+and [Documentation](https://docs.qawolf.com/qawolf/libraries/emails).
+
+## Install
+
+```sh
+npm install @qawolf/emails
+```
+
+## Usage
+
+Create a fresh inbox for the current run, trigger an email in your app, and
+continue with the message QA Wolf receives.
+
+```ts
+import { mail } from "@qawolf/emails";
+
+const inbox = await mail.inbox({ new: true });
+
+await page.getByLabel("Email").fill(inbox.emailAddress);
+
+const after = new Date();
+await page.getByRole("button", { name: "Send magic link" }).click();
+
+const message = await inbox.waitForMessage({ after });
+const signInUrl = message.urls[0];
+```
+
+Pass `new: true` for most tests. It creates a unique derived address so emails
+from earlier runs do not affect the current flow. If your app does not support
+plus addresses, pass a custom `delimiter`.
+
+```ts
+const inbox = await mail.inbox({ new: true, delimiter: "-" });
+```
+
+Capture `after` immediately before the app action that should send email. This
+keeps `waitForMessage(...)` pinned to the message caused by that action.
+
+Send email from the same inbox when your workflow needs an inbound message or
+reply.
+
+```ts
+await inbox.sendMessage({
+  to: ["support@example.com"],
+  subject: "Test message",
+  text: "Hello from a QA Wolf flow",
+});
+```
+
+For runners and local harnesses, create and configure a client before invoking
+flow code.
+
+```ts
+import { configureEmailsClient, createEmailsClient } from "@qawolf/emails";
+
+const emails = await createEmailsClient({
+  emailerUrl: process.env["EMAILER_URL"]!,
+  pollForEmailsDefaultTimeoutMs: 300_000,
+  teamId: process.env["QAWOLF_TEAM_ID"],
+  waitForMessagesDefaultDelayMs: 15_000,
+});
+
+configureEmailsClient(emails);
+```

package/dist/buildGetInboxFn.d.ts

@@ -0,0 +1,46 @@
+import type { QueryEmailsOutput, SendEmailInput } from "@qawolf/emailer-types";
+import { type GetInboxOptions, type ParsedEmail, type SendMessage, type SendMessageResult, type WaitForMessage } from "./types.js";
+export type GetInboxFn = {
+    (args?: GetInboxOptions): Promise<GetInboxResult>;
+};
+export type GetInboxResult = {
+    emailAddress: string;
+    sendMessage: (options: SendMessage) => Promise<SendMessageResult>;
+    waitForMessage: (options: WaitForMessage) => Promise<ParsedEmail>;
+    waitForMessages: (options: WaitForMessage) => Promise<ParsedEmail[]>;
+};
+/** Configuration for the emails client and inbox helpers. */
+export type EmailsClientOptions = {
+    /** The URL of the emailer service. */
+    emailerUrl: string;
+    /** A function that can be used to log messages. */
+    logger?: (severity: string, message: string) => void;
+    /** The default timeout when polling for emails. */
+    pollForEmailsDefaultTimeoutMs: number;
+    /** The ID of the workspace to send and receive emails for. */
+    teamId?: string;
+    /** The default delay when waiting for messages. */
+    waitForMessagesDefaultDelayMs: number;
+};
+/**
+ * Build a `getInbox` function directly.
+ *
+ * Prefer `createEmailsClient()` for new code and use this helper only when a
+ * runtime still needs to inject `getInbox` for backward compatibility.
+ */
+export declare function buildGetInboxFn({ emailerUrl, logger, pollForEmailsDefaultTimeoutMs, teamId, waitForMessagesDefaultDelayMs, }: EmailsClientOptions): Promise<GetInboxFn>;
+/**
+ * Build a list of ParsedEmail from a QueryEmailsOutput.
+ * @param email The output from the emailer.
+ */
+export declare const buildParsedEmails: (email: QueryEmailsOutput) => ParsedEmail[];
+/**
+ * Build a SendEmailInput to be sent over to the emailer.
+ * @param opts The options to build the input from.
+ */
+export declare const buildSendEmailInput: (opts: {
+    email: SendMessage;
+    from: string;
+    teamId: string;
+}) => SendEmailInput;
+//# sourceMappingURL=buildGetInboxFn.d.ts.map

package/dist/buildGetInboxFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGetInboxFn.d.ts","sourceRoot":"","sources":["../src/buildGetInboxFn.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAIV,iBAAiB,EACjB,cAAc,EAIf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAIpB,MAAM,YAAY,CAAC;AAmCpB,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAClE,eAAe,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACtE,CAAC;AASF,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG;IAChC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,mDAAmD;IACnD,6BAA6B,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,6BAA6B,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,EACpC,UAAU,EACV,MAAM,EACN,6BAA6B,EAC7B,MAAM,EACN,6BAA6B,GAC9B,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkQ3C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,iBAAiB,KAAG,WAAW,EAyBvE,CAAC;AAsFF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,cAwBH,CAAC"}

package/dist/buildGetInboxFn.js

@@ -0,0 +1,322 @@
+/* eslint-disable @qawolf/max-lines -- Old technical debt */
+import { init } from "@paralleldrive/cuid2";
+import retry, { AbortError } from "p-retry";
+import superJson, {} from "superjson";
+import { getNamedAddress, getNamedAddressAsString, } from "@qawolf/emailer-types";
+import { extractUrlsFromHtml } from "./extractUrlsFromHtml.js";
+import { getInboxOptionsSchema, sendMessageSchema, waitForMessageSchema, } from "./types.js";
+const createEmailSuffix = init({ length: 7 });
+/**
+ * Build a `getInbox` function directly.
+ *
+ * Prefer `createEmailsClient()` for new code and use this helper only when a
+ * runtime still needs to inject `getInbox` for backward compatibility.
+ */
+export async function buildGetInboxFn({ emailerUrl, logger, pollForEmailsDefaultTimeoutMs, teamId, waitForMessagesDefaultDelayMs, }) {
+    const trimmed = emailerUrl[emailerUrl.length - 1] === "/"
+        ? emailerUrl.slice(0, -1)
+        : emailerUrl;
+    // Use the emailer service's documented HTTP tRPC endpoints directly so this
+    // public package does not depend on our private shared tRPC client package.
+    // WIZ-10243 tracks replacing this with public emailer tRPC API types.
+    const callEmailerQuery = async (procedure, input) => {
+        const url = new URL(`/v1/trpc/${procedure}`, trimmed);
+        const encodedInput = JSON.stringify(input);
+        if (!encodedInput)
+            throw Error("Emailer query input must be JSON");
+        url.searchParams.set("input", encodedInput);
+        return callEmailer(url, { method: "GET" });
+    };
+    const callEmailerMutation = async (procedure, input) => {
+        return callEmailer(new URL(`/v1/trpc/${procedure}`, trimmed), {
+            body: JSON.stringify(input),
+            headers: {
+                "content-type": "application/json",
+            },
+            method: "POST",
+        });
+    };
+    /**
+     * Poll the emailer for all emails that match the given criteria.
+     * @param options Polling options
+     * @returns An array of emails. An empty array is returned only if the timeout is reached.
+     *   Otherwise it will keep polling until there is at least one (or minCount) email.
+     */
+    async function pollForEmails({ createdAfter, minCount = 1, target, timeoutMs = pollForEmailsDefaultTimeoutMs, }) {
+        if (minCount < 1)
+            throw Error("minCount must be at least 1");
+        if (timeoutMs < 0)
+            throw Error("timeoutMs must be at least 0");
+        let timeout = false;
+        const requestPromise = retry(async (attempt) => {
+            if (timeout)
+                return [];
+            try {
+                if (logger) {
+                    logger("verbose", `wait for email in mailbox of ${target}, attempt ${attempt}`);
+                }
+                const result = await callEmailerQuery("emails.query", {
+                    createdAt: {
+                        after: createdAfter.toISOString(),
+                    },
+                    isInbound: true,
+                    ownerId: teamId,
+                    target: getNamedAddress(target).address,
+                });
+                if (result.type === "targetOwnerDoesNotMatch")
+                    throw new AbortError(`${target} is not allowed for this workspace`);
+                const { data } = result;
+                if (!data || data.length < minCount) {
+                    throw Error(`${target} has not yet received ${minCount} email${minCount === 1 ? "" : "s"} after ${createdAfter.toISOString()}`);
+                }
+                if (logger)
+                    logger("info", `found  ${data.length} emails for ${target}`);
+                return buildParsedEmails(data);
+            }
+            catch (e) {
+                if (logger)
+                    logger("verbose", `pollForEmail failed ${e}`);
+                throw e;
+            }
+        }, {
+            factor: 1,
+            maxTimeout: 3000,
+            minTimeout: 3000,
+            retries: Math.round(timeoutMs / 3000),
+        });
+        const timeoutPromise = (async () => {
+            await sleep(timeoutMs);
+            timeout = true;
+            throw Error(`No email for ${target} is found`);
+        })();
+        return Promise.race([requestPromise, timeoutPromise]);
+    }
+    return async (args = {}) => {
+        if (!teamId)
+            throw Error("teamId is required");
+        getInboxOptionsSchema.parse(args);
+        // The rest of the function cannot run if emailAddress ends up being undefined,
+        // so we make sure it's always string.
+        let emailAddress = args.address ??
+            (await (async () => {
+                const defaultAddresses = getEmailerData(await callEmailerQuery("addresses.query", {
+                    constraints: {
+                        limit: 1,
+                    },
+                    isDefault: true,
+                    ownerId: teamId,
+                }));
+                if (defaultAddresses.length < 1) {
+                    throw Error(`no default address has been found for workspace ${teamId}`);
+                }
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- Old technical debt
+                return defaultAddresses[0].emailAddress;
+            })());
+        if (args.new) {
+            const [inbox, domain] = emailAddress.split("@");
+            // Emailer service handles plus addresses automatically but for
+            // any other delimiter we need to save the address temporarily
+            // for the inbound parse webhook to match to.
+            emailAddress = `${inbox}${args.delimiter ?? "+"}${createEmailSuffix()}@${domain}`;
+            if (args.delimiter && args.delimiter !== "+") {
+                await callEmailerMutation("addresses.upsert", {
+                    emailAddress,
+                    isTemporary: true,
+                    ownerId: teamId,
+                });
+            }
+        }
+        const calledAt = new Date();
+        /**
+         * Send an email from the address you've chosen.
+         * @returns The stripped-down version of the email that was sent
+         * @param email The email to send.
+         */
+        const sendMessage = async (email) => {
+            sendMessageSchema.parse(email);
+            if (logger)
+                logger("verbose", `will send email to ${email.to.join(", ")}`);
+            const sentEmail = await retry(async () => getEmailerData(await callEmailerMutation("emails.send", buildSendEmailInput({
+                email,
+                from: emailAddress,
+                teamId,
+            }))), {
+                retries: 4,
+            });
+            if (!sentEmail)
+                throw Error("Error sending email");
+            if (logger)
+                logger("info", `sent email to ${email.to.join(", ")}`);
+            return {
+                id: sentEmail.id,
+            };
+        };
+        /**
+         * Wait for your workspace's test inbox to receive an email and return its details
+         * @param options Optional wait configuration
+         * @returns The first email received, or throws an error if none received
+         */
+        const waitForMessage = async ({ after, timeout, } = {}) => {
+            waitForMessageSchema.parse({ after, timeout });
+            const messages = await pollForEmails({
+                createdAfter: after || calledAt,
+                target: emailAddress,
+                timeoutMs: timeout,
+            });
+            const [message] = messages;
+            if (!message)
+                throw Error("no message received");
+            return message;
+        };
+        /**
+         * Wait for timeout and then return all emails received at your workspace's test
+         * inbox since this function was called. Returns an array with the last received
+         * email being the first item in the array.
+         * @param options Optional wait configuration
+         * @returns All messages received between `after` and `after+timeout`
+         */
+        const waitForMessages = async ({ after, delay = waitForMessagesDefaultDelayMs, minCount, timeout, } = {}) => {
+            waitForMessageSchema.parse({ after, timeout });
+            if (logger) {
+                logger("verbose", `delaying ${delay}ms before checking for received emails`);
+            }
+            await sleep(delay);
+            const parsedEmails = await pollForEmails({
+                createdAfter: after || calledAt,
+                minCount,
+                target: emailAddress,
+                timeoutMs: timeout,
+            });
+            if (logger) {
+                logger("verbose", "waitForMessages result: " +
+                    JSON.stringify({
+                        messageCount: parsedEmails.length,
+                        target: emailAddress,
+                    }));
+            }
+            return parsedEmails;
+        };
+        return {
+            emailAddress,
+            sendMessage,
+            waitForMessage,
+            waitForMessages,
+        };
+    };
+}
+/**
+ * Build a list of ParsedEmail from a QueryEmailsOutput.
+ * @param email The output from the emailer.
+ */
+export const buildParsedEmails = (email) => {
+    return email
+        .map((message) => ({
+        attachments: message.attachments?.map((attachment) => {
+            return {
+                content: Buffer.from(attachment.contentBase64, "base64"),
+                fileName: attachment.fileName,
+                type: attachment.type,
+            };
+        }),
+        bcc: message.bcc?.map(getNamedAddressAsString),
+        cc: message.cc?.map(getNamedAddressAsString),
+        from: getNamedAddressAsString(message.from),
+        html: message.html ?? "",
+        id: message.id,
+        replyTo: message.replyTo?.map(getNamedAddressAsString),
+        subject: message.subject ?? "",
+        teamId: message.ownerId,
+        text: message.text ?? "",
+        to: message.to.map(getNamedAddressAsString),
+    }))
+        .map((message) => {
+        const urls = extractUrlsFromHtml(message.html);
+        return { ...message, urls };
+    });
+};
+async function callEmailer(url, init) {
+    const response = await fetch(url, init);
+    const body = await response.text();
+    if (!body) {
+        if (!response.ok)
+            throw Error(`Emailer request failed with status ${response.status}`);
+        throw Error(`Emailer response was empty with status ${response.status}`);
+    }
+    let json;
+    try {
+        json = JSON.parse(body);
+    }
+    catch {
+        if (!response.ok) {
+            throw Error(`Emailer request failed with status ${response.status}: ${body}`);
+        }
+        throw Error(`Emailer response was not valid JSON with status ${response.status}`);
+    }
+    if (json.error)
+        return parseEmailerError(json.error, response.status);
+    if (!response.ok) {
+        throw Error(`Emailer request failed with status ${response.status}: ${body}`);
+    }
+    if (!json.result)
+        throw Error("Emailer response did not include result data");
+    return {
+        data: deserializeTrpcData(json.result.data),
+        type: "success",
+    };
+}
+function deserializeTrpcData(data) {
+    if (isSuperJsonResult(data))
+        return superJson.deserialize(data);
+    return data;
+}
+function getEmailerData(result) {
+    if (result.type === "targetOwnerDoesNotMatch")
+        throw Error("Emailer target is not allowed for this workspace");
+    return result.data;
+}
+function isSuperJsonResult(data) {
+    return typeof data === "object" && data !== null && "json" in data;
+}
+function parseEmailerError(error, status) {
+    if (error.json?.data?.code === "FORBIDDEN" &&
+        error.json.message === "targetOwnerDoesNotMatch")
+        return { type: "targetOwnerDoesNotMatch" };
+    const message = error.json?.message ?? error.message ?? "Emailer request failed";
+    const httpStatus = error.json?.data?.httpStatus ?? status;
+    throw Error(`Emailer request failed with status ${httpStatus}: ${message}`);
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Build a SendEmailInput to be sent over to the emailer.
+ * @param opts The options to build the input from.
+ */
+export const buildSendEmailInput = (opts) => {
+    const { email, from, teamId } = opts;
+    return {
+        attachments: email.attachments?.map((attachment) => {
+            return {
+                contentBase64: attachment.content.toString("base64"),
+                contentId: attachment.contentId,
+                disposition: attachment.disposition,
+                fileName: attachment.fileName,
+                type: attachment.type,
+            };
+        }),
+        bcc: email.bcc?.map(getNamedAddress),
+        cc: email.cc?.map(getNamedAddress),
+        from: getNamedAddress(from),
+        html: email.html,
+        ownerId: teamId,
+        ownerType: "TEAM",
+        replyTo: email.replyTo?.map(getNamedAddress),
+        replyToMessageId: email.replyToMessageId,
+        subject: email.subject,
+        text: email.text,
+        to: email.to.map(getNamedAddress),
+    };
+};
+//# sourceMappingURL=buildGetInboxFn.js.map

package/dist/buildGetInboxFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGetInboxFn.js","sourceRoot":"","sources":["../src/buildGetInboxFn.ts"],"names":[],"mappings":"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"}

package/dist/clientScope.d.ts

@@ -0,0 +1,5 @@
+import type { EmailsClient } from "./createEmailsClient.js";
+export declare function configureEmailsClient(client: EmailsClient): void;
+export declare function resetEmailsClient(): void;
+export declare function getCurrentEmailsClient(): EmailsClient | undefined;
+//# sourceMappingURL=clientScope.d.ts.map

package/dist/clientScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientScope.d.ts","sourceRoot":"","sources":["../src/clientScope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEhE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,sBAAsB,IAAI,YAAY,GAAG,SAAS,CAEjE"}

package/dist/clientScope.js

@@ -0,0 +1,11 @@
+let currentClient;
+export function configureEmailsClient(client) {
+    currentClient = client;
+}
+export function resetEmailsClient() {
+    currentClient = undefined;
+}
+export function getCurrentEmailsClient() {
+    return currentClient;
+}
+//# sourceMappingURL=clientScope.js.map

package/dist/clientScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientScope.js","sourceRoot":"","sources":["../src/clientScope.ts"],"names":[],"mappings":"AAEA,IAAI,aAAuC,CAAC;AAE5C,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,SAAS,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/createEmailsClient.d.ts

@@ -0,0 +1,11 @@
+import { type EmailsClientOptions, type GetInboxFn } from "./buildGetInboxFn.js";
+export type { EmailsClientOptions } from "./buildGetInboxFn.js";
+export type EmailsClient = {
+    getInbox: GetInboxFn;
+};
+/**
+ * Create an emails client that can be used directly in runners, local tooling,
+ * or any other environment with access to the QA Wolf emailer service.
+ */
+export declare function createEmailsClient(options: EmailsClientOptions): Promise<EmailsClient>;
+//# sourceMappingURL=createEmailsClient.d.ts.map

package/dist/createEmailsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEmailsClient.d.ts","sourceRoot":"","sources":["../src/createEmailsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAIvB"}

package/dist/createEmailsClient.js

@@ -0,0 +1,11 @@
+import { buildGetInboxFn, } from "./buildGetInboxFn.js";
+/**
+ * Create an emails client that can be used directly in runners, local tooling,
+ * or any other environment with access to the QA Wolf emailer service.
+ */
+export async function createEmailsClient(options) {
+    return {
+        getInbox: await buildGetInboxFn(options),
+    };
+}
+//# sourceMappingURL=createEmailsClient.js.map

package/dist/createEmailsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEmailsClient.js","sourceRoot":"","sources":["../src/createEmailsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAO9B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA4B;IAE5B,OAAO;QACL,QAAQ,EAAE,MAAM,eAAe,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/extractUrlsFromHtml.d.ts

@@ -0,0 +1,2 @@
+export declare const extractUrlsFromHtml: (html: string) => string[];
+//# sourceMappingURL=extractUrlsFromHtml.d.ts.map

package/dist/extractUrlsFromHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractUrlsFromHtml.d.ts","sourceRoot":"","sources":["../src/extractUrlsFromHtml.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,aAO/C,CAAC"}

package/dist/extractUrlsFromHtml.js

@@ -0,0 +1,14 @@
+import { parse } from "node-html-parser";
+const extractElementAttributes = (doc, ele, attr) => {
+    return doc
+        .querySelectorAll(ele)
+        .map((e) => e.getAttribute(attr))
+        .filter((v) => !!v && !v.includes("w3.org"));
+};
+export const extractUrlsFromHtml = (html) => {
+    const doc = parse(html);
+    const hrefUrls = extractElementAttributes(doc, "a", "href");
+    const srcUrls = extractElementAttributes(doc, "img", "src");
+    return [...hrefUrls, ...srcUrls].sort();
+};
+//# sourceMappingURL=extractUrlsFromHtml.js.map

package/dist/extractUrlsFromHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractUrlsFromHtml.js","sourceRoot":"","sources":["../src/extractUrlsFromHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,wBAAwB,GAAG,CAC/B,GAAgB,EAChB,GAAW,EACX,IAAY,EACZ,EAAE;IACF,OAAO,GAAG;SACP,gBAAgB,CAAC,GAAG,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,EAAE;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAExB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,wBAAwB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { GetInboxResult } from "./buildGetInboxFn.js";
+import type { GetInboxOptions } from "./types.js";
+export { type GetInboxFn, type GetInboxResult } from "./buildGetInboxFn.js";
+export { configureEmailsClient, getCurrentEmailsClient, resetEmailsClient, } from "./clientScope.js";
+export { type EmailsClient, type EmailsClientOptions, createEmailsClient, } from "./createEmailsClient.js";
+export type { Email, GetInboxOptions, ParsedEmail, SendMessage, SendMessageResult, WaitForMessage, } from "./types.js";
+export declare const mail: {
+    inbox(options?: GetInboxOptions): Promise<GetInboxResult>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,KAAK,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,IAAI;oBACO,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAWhE,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import { getCurrentEmailsClient } from "./clientScope.js";
+export {} from "./buildGetInboxFn.js";
+export { configureEmailsClient, getCurrentEmailsClient, resetEmailsClient, } from "./clientScope.js";
+export { createEmailsClient, } from "./createEmailsClient.js";
+export const mail = {
+    async inbox(options) {
+        const client = getCurrentEmailsClient();
+        if (!client) {
+            throw Error("@qawolf/emails mail.inbox() requires a client. Call " +
+                "configureEmailsClient(...) once at startup before reading " +
+                "mail.inbox().");
+        }
+        return client.getInbox(options);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAwC,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGL,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAWjC,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,CACT,sDAAsD;gBACpD,4DAA4D;gBAC5D,eAAe,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export type Email = {
+    attachments?: {
+        content: Buffer;
+        fileName: string;
+        type?: string;
+    }[];
+    bcc?: string[];
+    cc?: string[];
+    from: string;
+    html: string;
+    id: string;
+    replyTo?: string[];
+    subject: string;
+    teamId: string;
+    text: string;
+    to: string[];
+};
+export type ParsedEmail = Email & {
+    urls: string[];
+};
+export declare const getInboxOptionsSchema: z.ZodObject<{
+    address: z.ZodOptional<z.ZodEmail>;
+    delimiter: z.ZodOptional<z.ZodString>;
+    new: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GetInboxOptions = z.infer<typeof getInboxOptionsSchema>;
+export declare const sendMessageSchema: z.ZodObject<{
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        content: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
+        contentId: z.ZodOptional<z.ZodString>;
+        disposition: z.ZodOptional<z.ZodEnum<{
+            attachment: "attachment";
+            inline: "inline";
+        }>>;
+        fileName: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    bcc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    html: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    replyToMessageId: z.ZodOptional<z.ZodString>;
+    subject: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    to: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type SendMessage = z.infer<typeof sendMessageSchema>;
+export declare const sendMessageResultSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type SendMessageResult = z.infer<typeof sendMessageResultSchema>;
+export declare const waitForMessageSchema: z.ZodObject<{
+    after: z.ZodOptional<z.ZodDate>;
+    delay: z.ZodOptional<z.ZodNumber>;
+    minCount: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type WaitForMessage = z.infer<typeof waitForMessageSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,KAAK,GAAG;IAClB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;iBAyB1B,CAAC;AACL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export const getInboxOptionsSchema = z.object({
+    address: z.email().optional(),
+    delimiter: z.string().optional(),
+    new: z.boolean().optional(),
+});
+export const sendMessageSchema = z
+    // The first section is the original SendMessage type.
+    .object({
+    attachments: z
+        .array(z.object({
+        content: z.instanceof(Buffer),
+        contentId: z.string().optional(),
+        disposition: z.enum(["attachment", "inline"]).optional(),
+        fileName: z.string(),
+        type: z.string().optional(),
+    }))
+        .optional(),
+    bcc: z.array(z.string()).optional(),
+    cc: z.array(z.string()).optional(),
+    html: z.string().optional(),
+    replyTo: z.array(z.string()).optional(),
+    replyToMessageId: z.string().optional(),
+    subject: z.string(),
+    text: z.string().optional(),
+    to: z.array(z.string()),
+})
+    .refine((data) => data.html || data.text, {
+    message: "Either html or text must be provided.",
+});
+export const sendMessageResultSchema = z.object({
+    id: z.string(),
+});
+export const waitForMessageSchema = z.object({
+    after: z.date().optional(),
+    delay: z.number().min(0).optional(),
+    minCount: z.number().min(1).optional(),
+    timeout: z.number().optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;IAChC,sDAAsD;KACrD,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;QACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CACH;SACA,QAAQ,EAAE;IACb,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACxB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,uCAAuC;CACjD,CAAC,CAAC;AAGL,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@qawolf/emails",
+  "version": "1.0.0",
+  "private": false,
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "/dist",
+    "/LICENSE",
+    "/README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf ./dist && tsc -p tsconfig.build.json",
+    "lint:ci": "npm run lint:non-fixable; NON_FIXABLE_EXIT=$?; npm run lint:fixable && exit $NON_FIXABLE_EXIT",
+    "lint:dev": "npm run lint:fixable",
+    "lint:fixable": "eslint . --ext cjs,cts,js,jsx,mjs,ts,tsx --fix --quiet && prettier --log-level=warn --write .",
+    "lint:non-fixable": "dpdm --exit-code circular:1 --no-tree --no-warning --transform --include='.*' --exclude='/(dist|node_modules)/' '**/*'",
+    "prepublishOnly": "nx run emails:build",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" NODE_NO_WARNINGS=1 jest",
+    "test:watch": "npm run test -- --watch",
+    "tsc:check": "tsc"
+  },
+  "dependencies": {
+    "@paralleldrive/cuid2": "^2.2.0",
+    "@qawolf/emailer-types": "^1.0.0",
+    "msw": "^2.12.14",
+    "node-html-parser": "^6.1.13",
+    "p-retry": "^6.2.1",
+    "superjson": "^2.2.6",
+    "tslib": "^2.5.3",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20.19.0 <25"
+  },
+  "nx": {
+    "targets": {
+      "npm:publish": {}
+    }
+  }
+}