@shopware-ag/acceptance-test-suite 2.3.11 → 2.4.0

package/dist/index.d.mts

@@ -70,9 +70,61 @@ declare class StoreApiContext {
     head<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
 }
 
+interface Email {
+    fromName: string;
+    fromAddress: string;
+    toName: string;
+    toAddress: string;
+    subject: string;
+    emailId: string;
+}
+declare class MailpitApiContext {
+    context: APIRequestContext;
+    constructor(context: APIRequestContext);
+    /**
+     * Fetches email headers based on the recipient's email address.
+     * @param email - The email address of the recipient.
+     * @returns An Email object containing the email headers.
+     */
+    getEmailHeaders(email: string): Promise<Email>;
+    /**
+     * Retrieves the body content of the latest email as an HTML string.
+     * @returns The HTML content of the latest email.
+     */
+    getEmailBody(): Promise<string>;
+    /**
+     * Generates the full email content, combining headers and body.
+     * @param email - The email address to fetch headers for.
+     * @returns The full email content as a string.
+     */
+    generateEmailContent(email: string): Promise<string>;
+    /**
+     * Retrieves the plain text content of the latest email.
+     * @returns The plain text content of the latest email.
+     */
+    getRenderMessageTxt(): Promise<string>;
+    /**
+     * Extracts the first URL found in the plain text content of the latest email.
+     * @returns The first URL found in the email content.
+     * @throws An error if no URL is found in the email content.
+     */
+    getLinkFromMail(): Promise<string>;
+    /**
+     * Deletes a specific email by ID if provided, or deletes all emails if no ID is provided.
+     * @param emailId - The ID of the email to delete (optional).
+     */
+    deleteMail(emailId?: string): Promise<void>;
+    /**
+     * Creates a new EmailApiContext instance with the appropriate configuration.
+     * @returns A promise that resolves to an EmailApiContext instance.
+     */
+    static create(baseURL: string): Promise<MailpitApiContext>;
+}
+
 interface ApiContextTypes {
     AdminApiContext: AdminApiContext;
     StoreApiContext: StoreApiContext;
+    MailpitApiContext: MailpitApiContext;
 }
 
 interface PageContextTypes {

package/dist/index.d.ts

@@ -70,9 +70,61 @@ declare class StoreApiContext {
     head<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
 }
 
+interface Email {
+    fromName: string;
+    fromAddress: string;
+    toName: string;
+    toAddress: string;
+    subject: string;
+    emailId: string;
+}
+declare class MailpitApiContext {
+    context: APIRequestContext;
+    constructor(context: APIRequestContext);
+    /**
+     * Fetches email headers based on the recipient's email address.
+     * @param email - The email address of the recipient.
+     * @returns An Email object containing the email headers.
+     */
+    getEmailHeaders(email: string): Promise<Email>;
+    /**
+     * Retrieves the body content of the latest email as an HTML string.
+     * @returns The HTML content of the latest email.
+     */
+    getEmailBody(): Promise<string>;
+    /**
+     * Generates the full email content, combining headers and body.
+     * @param email - The email address to fetch headers for.
+     * @returns The full email content as a string.
+     */
+    generateEmailContent(email: string): Promise<string>;
+    /**
+     * Retrieves the plain text content of the latest email.
+     * @returns The plain text content of the latest email.
+     */
+    getRenderMessageTxt(): Promise<string>;
+    /**
+     * Extracts the first URL found in the plain text content of the latest email.
+     * @returns The first URL found in the email content.
+     * @throws An error if no URL is found in the email content.
+     */
+    getLinkFromMail(): Promise<string>;
+    /**
+     * Deletes a specific email by ID if provided, or deletes all emails if no ID is provided.
+     * @param emailId - The ID of the email to delete (optional).
+     */
+    deleteMail(emailId?: string): Promise<void>;
+    /**
+     * Creates a new EmailApiContext instance with the appropriate configuration.
+     * @returns A promise that resolves to an EmailApiContext instance.
+     */
+    static create(baseURL: string): Promise<MailpitApiContext>;
+}
+
 interface ApiContextTypes {
     AdminApiContext: AdminApiContext;
     StoreApiContext: StoreApiContext;
+    MailpitApiContext: MailpitApiContext;
 }
 
 interface PageContextTypes {

package/dist/index.mjs

@@ -393,16 +393,16 @@ const test$b = test$d.extend({
   ]
 });
 
-var __defProp$s = Object.defineProperty;
-var __defNormalProp$s = (obj, key, value) => key in obj ? __defProp$s(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$s = (obj, key, value) => {
-  __defNormalProp$s(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$t = Object.defineProperty;
+var __defNormalProp$t = (obj, key, value) => key in obj ? __defProp$t(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$t = (obj, key, value) => {
+  __defNormalProp$t(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const _AdminApiContext = class _AdminApiContext {
   constructor(context, options) {
-    __publicField$s(this, "context");
-    __publicField$s(this, "options");
+    __publicField$t(this, "context");
+    __publicField$t(this, "options");
     this.context = context;
     this.options = options;
   }
@@ -494,7 +494,7 @@ const _AdminApiContext = class _AdminApiContext {
     return this.context.head(url, options);
   }
 };
-__publicField$s(_AdminApiContext, "defaultOptions", {
+__publicField$t(_AdminApiContext, "defaultOptions", {
   app_url: process.env["APP_URL"],
   client_id: process.env["SHOPWARE_ACCESS_KEY_ID"],
   client_secret: process.env["SHOPWARE_SECRET_ACCESS_KEY"],
@@ -504,16 +504,16 @@ __publicField$s(_AdminApiContext, "defaultOptions", {
 });
 let AdminApiContext = _AdminApiContext;
 
-var __defProp$r = Object.defineProperty;
-var __defNormalProp$r = (obj, key, value) => key in obj ? __defProp$r(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$r = (obj, key, value) => {
-  __defNormalProp$r(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$s = Object.defineProperty;
+var __defNormalProp$s = (obj, key, value) => key in obj ? __defProp$s(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$s = (obj, key, value) => {
+  __defNormalProp$s(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const _StoreApiContext = class _StoreApiContext {
   constructor(context, options) {
-    __publicField$r(this, "context");
-    __publicField$r(this, "options");
+    __publicField$s(this, "context");
+    __publicField$s(this, "options");
     this.context = context;
     this.options = options;
   }
@@ -572,12 +572,122 @@ const _StoreApiContext = class _StoreApiContext {
     return this.context.head(url, options);
   }
 };
-__publicField$r(_StoreApiContext, "defaultOptions", {
+__publicField$s(_StoreApiContext, "defaultOptions", {
   app_url: process.env["APP_URL"],
   ignoreHTTPSErrors: true
 });
 let StoreApiContext = _StoreApiContext;
 
+var __defProp$r = Object.defineProperty;
+var __defNormalProp$r = (obj, key, value) => key in obj ? __defProp$r(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$r = (obj, key, value) => {
+  __defNormalProp$r(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class MailpitApiContext {
+  constructor(context) {
+    __publicField$r(this, "context");
+    this.context = context;
+  }
+  /**
+   * Fetches email headers based on the recipient's email address.
+   * @param email - The email address of the recipient.
+   * @returns An Email object containing the email headers.
+   */
+  async getEmailHeaders(email) {
+    const response = await this.context.get("/api/v1/search", {
+      params: {
+        kind: "To.Address",
+        query: email
+      }
+    });
+    const responseJson = await response.json();
+    return {
+      fromName: responseJson.messages[0].From.Name,
+      fromAddress: responseJson.messages[0].From.Address,
+      toName: responseJson.messages[0].To[0].Name,
+      toAddress: responseJson.messages[0].To[0].Address,
+      subject: responseJson.messages[0].Subject,
+      emailId: responseJson.messages[0].ID
+    };
+  }
+  /**
+   * Retrieves the body content of the latest email as an HTML string.
+   * @returns The HTML content of the latest email.
+   */
+  async getEmailBody() {
+    const response = await this.context.get("view/latest.html");
+    const buffer = await response.body();
+    const htmlString = buffer.toString("utf-8");
+    return htmlString;
+  }
+  /**
+   * Generates the full email content, combining headers and body.
+   * @param email - The email address to fetch headers for.
+   * @returns The full email content as a string.
+   */
+  async generateEmailContent(email) {
+    const headers = await this.getEmailHeaders(email);
+    const htmlTemplate = await this.getEmailBody();
+    const headerSection = `
+       <div style="font-family:arial; font-size:16px;" id="email-container">
+        <p id="from"><strong>From:</strong> ${headers.fromName} &lt;${headers.fromAddress}&gt;</p>
+        <p id="to"><strong>To:</strong> ${headers.toName} &lt;${headers.toAddress}&gt;</p>
+        <p id="subject"><strong>Subject:</strong> ${headers.subject}</p>
+      </div> 
+    `;
+    const emailContent = headerSection + htmlTemplate;
+    return emailContent;
+  }
+  /**
+   * Retrieves the plain text content of the latest email.
+   * @returns The plain text content of the latest email.
+   */
+  async getRenderMessageTxt() {
+    const response = await this.context.get("view/latest.txt");
+    const buffer = await response.body();
+    const text = buffer.toString("utf-8");
+    return text;
+  }
+  /**
+   * Extracts the first URL found in the plain text content of the latest email.
+   * @returns The first URL found in the email content.
+   * @throws An error if no URL is found in the email content.
+   */
+  async getLinkFromMail() {
+    const textContent = await this.getRenderMessageTxt();
+    const urlMatch = textContent.match(/https?:\/\/[^\s]+/);
+    if (urlMatch && urlMatch.length > 0) {
+      return urlMatch[0];
+    }
+    throw new Error("No URL found in the email content");
+  }
+  /**
+   * Deletes a specific email by ID if provided, or deletes all emails if no ID is provided.
+   * @param emailId - The ID of the email to delete (optional).
+   */
+  async deleteMail(emailId) {
+    const data = emailId ? { IDs: [emailId] } : {};
+    await this.context.delete(`api/v1/messages`, { data });
+  }
+  /**
+   * Creates a new EmailApiContext instance with the appropriate configuration.
+   * @returns A promise that resolves to an EmailApiContext instance.
+   */
+  static async create(baseURL) {
+    const extraHTTPHeaders = {
+      "Accept": "application/json",
+      "Content-Type": "application/json"
+    };
+    const context = await request.newContext({
+      baseURL,
+      ignoreHTTPSErrors: true,
+      extraHTTPHeaders
+    });
+    return new MailpitApiContext(context);
+  }
+}
+
 const test$a = test$d.extend({
   AdminApiContext: [
     async ({}, use) => {
@@ -597,6 +707,13 @@ const test$a = test$d.extend({
       await use(storeApiContext);
     },
     { scope: "worker" }
+  ],
+  MailpitApiContext: [
+    async ({}, use) => {
+      const mailpitApiContext = await MailpitApiContext.create(process.env["MAILPIT_BASE_URL"]);
+      await use(mailpitApiContext);
+    },
+    { scope: "worker" }
   ]
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopware-ag/acceptance-test-suite",
-  "version": "2.3.11",
+  "version": "2.4.0",
   "description": "Shopware Acceptance Test Suite",
   "author": "shopware AG",
   "license": "MIT",