external-services-automation 1.0.27 → 1.0.29

package/README.md

@@ -12,6 +12,17 @@ npm install external-services-automation
 
 ## Setup
 
+### Environment Variables
+
+For email testing with GetTestMailService, configure:
+
+```bash
+export TESTMAIL_API_KEY=your_api_key
+export TESTMAIL_NAMESPACE=your_namespace
+```
+
+Get your credentials from [testmail.app/console](https://testmail.app/console).
+
 ### Configure Your Test Framework
 
 The library can be used with any test framework. Here's an example for Playwright:
@@ -39,7 +50,8 @@ import {
   RegisterPage,
   KindeAuthService,
   StripeService,
-  GuerrillaMailClient
+  GuerrillaMailService,
+  GetTestMailService
 } from 'external-services-automation';
 ```
 
@@ -88,11 +100,23 @@ await loginPage.fillCredentials(email, password);
 - **ConfirmUpdatePage** - Confirmation dialogs
 - **LeftPanelPage** - Navigation and sidebar interactions
 
-### Utilities
-- **GuerrillaMailClient** - Temporary email handling for account verification
-  - `createTempEmail()` - Creates temporary email address
-  - `getVerificationCode()` - Retrieves verification emails
-  - `cleanup()` - Cleans up temporary email resources
+### Email Services
+
+#### GuerrillaMailService
+Temporary email service (free, but can be unstable):
+- `createMail(alias?)` - Creates temporary email address
+- `readMailBySubject(regex)` - Waits for email matching subject
+- `clearInbox()` - Cleans inbox
+
+#### GetTestMailService ⭐ **Recommended**
+Professional temporary email service with reliable API:
+- `createEmailAddress(tag)` - Generates email with custom tag
+- `getEmails(tag?, timestampFrom?, livequery?)` - Retrieves emails with filtering
+- `readMailBySubject(tag, regex)` - Waits for email matching subject
+- `extractCode(email, pattern?)` - Extracts verification codes
+- Requires API key from [testmail.app](https://testmail.app)
+
+See [GetTestMailService documentation](./docs/GetTestMailService.md) for detailed usage.
 
 ### World Extension
 - **ExternalServicesWorld** - Shared state management for test scenarios
@@ -102,29 +126,38 @@ await loginPage.fillCredentials(email, password);
 ```typescript
 // In your test files
 import { test, expect } from '@playwright/test';
-import { KindeAuthService, StripeService, GuerrillaMailClient } from 'external-services-automation';
+import { KindeAuthService, StripeService, GetTestMailService } from 'external-services-automation';
 
 test.describe('External Services Integration', () => {
   let authService: KindeAuthService;
   let stripeService: StripeService;
-  let tempEmail: GuerrillaMailClient;
+  let mailService: GetTestMailService;
 
   test.beforeEach(async () => {
     authService = new KindeAuthService();
     stripeService = new StripeService();
+    mailService = new GetTestMailService(
+      process.env.TESTMAIL_API_KEY!,
+      process.env.TESTMAIL_NAMESPACE!
+    );
   });
 
   test('should create account and upgrade subscription', async () => {
     // Create temporary email for account verification
-    tempEmail = new GuerrillaMailClient();
-    const email = await tempEmail.createTempEmail();
+    const tag = `signup-${Date.now()}`;
+    const email = mailService.createEmailAddress(tag);
     
     // Register new account
     await authService.register(email, 'John', 'Doe');
     
-    // Verify email
-    const verificationCode = await tempEmail.getVerificationCode();
-    await authService.verifyEmail(verificationCode);
+    // Wait for verification email and extract code
+    const verificationEmail = await mailService.readMailBySubject(
+      tag,
+      /verification code/i,
+      120000
+    );
+    const code = mailService.extractCode(verificationEmail);
+    await authService.verifyEmail(code);
     
     // Upgrade subscription
     await stripeService.upgradeSubscription('premium');
@@ -132,9 +165,6 @@ test.describe('External Services Integration', () => {
     // Verify subscription status
     const subscription = await stripeService.getCurrentSubscription();
     expect(subscription.status).toBe('active');
-    
-    // Cleanup
-    await tempEmail.cleanup();
   });
 
   test('should handle login with existing account', async () => {

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { KindeAuthService } from './services/KindeAuthService';
 export { StripeService } from './services/StripeService';
+export { GuerrillaMailService, GuerrillaEmail } from './services/GuerrillaMailService';
+export { GetTestMailService, TestMailEmail, TestMailResponse } from './services/GetTestMailService';
 export { LoginPage } from './pages/kinde/LoginPage';
 export { RegisterPage } from './pages/kinde/RegisterPage';
 export { PasswordSetupPage } from './pages/kinde/PasswordSetupPage';
@@ -9,5 +11,4 @@ export { UpdateSubscriptionPage, PlanType } from './pages/stripe/UpdateSubscript
 export { UpdatePaymentMethodPage } from './pages/stripe/UpdatePaymentMethodPage';
 export { ConfirmUpdatePage } from './pages/stripe/ConfirmUpdatePage';
 export { LeftPanelPage } from './pages/stripe/LeftPanelPage';
-export { GuerrillaMailClient } from './utils/temp-email-utils';
 export type { Page, BrowserContext, Locator } from 'playwright/test';

package/dist/index.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GuerrillaMailClient = exports.LeftPanelPage = exports.ConfirmUpdatePage = exports.UpdatePaymentMethodPage = exports.UpdateSubscriptionPage = exports.CurrentSubscriptionPage = exports.ConfirmCodePage = exports.PasswordSetupPage = exports.RegisterPage = exports.LoginPage = exports.StripeService = exports.KindeAuthService = void 0;
+exports.LeftPanelPage = exports.ConfirmUpdatePage = exports.UpdatePaymentMethodPage = exports.UpdateSubscriptionPage = exports.CurrentSubscriptionPage = exports.ConfirmCodePage = exports.PasswordSetupPage = exports.RegisterPage = exports.LoginPage = exports.GetTestMailService = exports.GuerrillaMailService = exports.StripeService = exports.KindeAuthService = void 0;
 // Export services
 var KindeAuthService_1 = require("./services/KindeAuthService");
 Object.defineProperty(exports, "KindeAuthService", { enumerable: true, get: function () { return KindeAuthService_1.KindeAuthService; } });
 var StripeService_1 = require("./services/StripeService");
 Object.defineProperty(exports, "StripeService", { enumerable: true, get: function () { return StripeService_1.StripeService; } });
+var GuerrillaMailService_1 = require("./services/GuerrillaMailService");
+Object.defineProperty(exports, "GuerrillaMailService", { enumerable: true, get: function () { return GuerrillaMailService_1.GuerrillaMailService; } });
+var GetTestMailService_1 = require("./services/GetTestMailService");
+Object.defineProperty(exports, "GetTestMailService", { enumerable: true, get: function () { return GetTestMailService_1.GetTestMailService; } });
 // Export all Kinde pages
 var LoginPage_1 = require("./pages/kinde/LoginPage");
 Object.defineProperty(exports, "LoginPage", { enumerable: true, get: function () { return LoginPage_1.LoginPage; } });
@@ -26,6 +30,3 @@ var ConfirmUpdatePage_1 = require("./pages/stripe/ConfirmUpdatePage");
 Object.defineProperty(exports, "ConfirmUpdatePage", { enumerable: true, get: function () { return ConfirmUpdatePage_1.ConfirmUpdatePage; } });
 var LeftPanelPage_1 = require("./pages/stripe/LeftPanelPage");
 Object.defineProperty(exports, "LeftPanelPage", { enumerable: true, get: function () { return LeftPanelPage_1.LeftPanelPage; } });
-// Export utilities
-var temp_email_utils_1 = require("./utils/temp-email-utils");
-Object.defineProperty(exports, "GuerrillaMailClient", { enumerable: true, get: function () { return temp_email_utils_1.GuerrillaMailClient; } });

package/dist/pages/kinde/ConfirmCodePage.d.ts

@@ -5,8 +5,5 @@ export declare class ConfirmCodePage {
     readonly codeInput: Locator;
     readonly continueButton: Locator;
     constructor(page: Page);
-    enterConfirmationCode(code: string): Promise<void>;
-    clickContinue(): Promise<void>;
     submitConfirmationCode(code: string): Promise<void>;
-    isOnConfirmCodePage(): Promise<void>;
 }

package/dist/pages/kinde/ConfirmCodePage.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfirmCodePage = void 0;
-const test_1 = require("@playwright/test");
 class ConfirmCodePage {
     constructor(page) {
         this.page = page;
@@ -9,20 +8,9 @@ class ConfirmCodePage {
         this.codeInput = page.locator('input[name="p_confirmation_code"]');
         this.continueButton = page.getByRole('button', { name: 'Continue' });
     }
-    async enterConfirmationCode(code) {
+    async submitConfirmationCode(code) {
         await this.codeInput.fill(code);
-    }
-    async clickContinue() {
         await this.continueButton.click();
     }
-    async submitConfirmationCode(code) {
-        await this.enterConfirmationCode(code);
-        await this.clickContinue();
-    }
-    async isOnConfirmCodePage() {
-        await (0, test_1.expect)(this.pageTitle).toBeVisible();
-        await (0, test_1.expect)(this.codeInput).toBeVisible();
-        await (0, test_1.expect)(this.continueButton).toBeVisible();
-    }
 }
 exports.ConfirmCodePage = ConfirmCodePage;

package/dist/pages/kinde/LoginPage.d.ts

@@ -4,12 +4,9 @@ export declare class LoginPage {
     readonly emailInput: Locator;
     readonly nextButton: Locator;
     readonly passwordInput: Locator;
-    readonly email_not_exists: Locator;
+    readonly emailErrorMessage: Locator;
     readonly createAccountLink: Locator;
     constructor(page: Page);
-    navigate(): Promise<void>;
-    enterEmail(email: string): Promise<void>;
-    enterPassword(password: string): Promise<void>;
     getEmailNotExistsMessage(): Promise<string | null>;
     login(email: string, password?: string): Promise<void>;
     goToRegisterPage(): Promise<void>;

package/dist/pages/kinde/LoginPage.js

@@ -7,32 +7,18 @@ class LoginPage {
         this.emailInput = page.locator('#sign_up_sign_in_credentials_p_email');
         this.nextButton = page.locator('.kinde-button.kinde-button-variant-primary');
         this.passwordInput = page.locator('#verify_password_p_password');
-        this.email_not_exists = page.locator('#sign_up_sign_in_credentials_p_email_error_msg');
+        this.emailErrorMessage = page.locator('#sign_up_sign_in_credentials_p_email_error_msg');
         this.createAccountLink = page.locator('//span[@class="signup-cta"]//a[text()="Sign up"]');
     }
-    async navigate() {
-        await this.page.goto('/login');
-    }
-    async enterEmail(email) {
-        await this.emailInput.fill(email);
-        await this.nextButton.click();
-        await this.page.waitForTimeout(2000);
-    }
-    async enterPassword(password) {
-        await this.passwordInput.fill(password);
-        await this.nextButton.click();
-        await this.page.waitForTimeout(3000);
-    }
     async getEmailNotExistsMessage() {
-        return await this.email_not_exists.textContent();
+        return await this.emailErrorMessage.textContent();
     }
     async login(email, password) {
-        if (!email) {
-            throw new Error(`${email} is not set`);
-        }
-        await this.enterEmail(email);
+        await this.emailInput.fill(email);
+        await this.nextButton.click();
         if (password) {
-            await this.enterPassword(password);
+            await this.passwordInput.fill(password);
+            await this.nextButton.click();
         }
     }
     async goToRegisterPage() {

package/dist/pages/kinde/PasswordSetupPage.d.ts

@@ -7,10 +7,6 @@ export declare class PasswordSetupPage {
     readonly continueButton: Locator;
     readonly dontUseMFAButton: Locator;
     constructor(page: Page);
-    enterPassword(password: string): Promise<void>;
-    enterConfirmPassword(password: string): Promise<void>;
-    clickContinue(): Promise<void>;
-    submitPasswordForm(password: string): Promise<void>;
-    isOnPasswordSetupPage(): Promise<void>;
+    fillPassword(password: string): Promise<void>;
     dontUseMFA(): Promise<void>;
 }

package/dist/pages/kinde/PasswordSetupPage.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PasswordSetupPage = void 0;
-const test_1 = require("@playwright/test");
 class PasswordSetupPage {
     constructor(page) {
         this.page = page;
@@ -11,26 +10,11 @@ class PasswordSetupPage {
         this.continueButton = page.getByRole('button', { name: 'Continue' });
         this.dontUseMFAButton = page.locator('//button[contains(text(), "multi-factor authentication")]');
     }
-    async enterPassword(password) {
+    async fillPassword(password) {
         await this.passwordInput.fill(password);
-    }
-    async enterConfirmPassword(password) {
         await this.confirmPasswordInput.fill(password);
-    }
-    async clickContinue() {
         await this.continueButton.click();
     }
-    async submitPasswordForm(password) {
-        await this.enterPassword(password);
-        await this.enterConfirmPassword(password);
-        await this.clickContinue();
-    }
-    async isOnPasswordSetupPage() {
-        await (0, test_1.expect)(this.pageTitle).toBeVisible();
-        await (0, test_1.expect)(this.passwordInput).toBeVisible();
-        await (0, test_1.expect)(this.confirmPasswordInput).toBeVisible();
-        await (0, test_1.expect)(this.continueButton).toBeVisible();
-    }
     async dontUseMFA() {
         await this.page.waitForTimeout(3000);
         if (await this.dontUseMFAButton.isVisible()) {

package/dist/pages/kinde/RegisterPage.d.ts

@@ -8,13 +8,5 @@ export declare class RegisterPage {
     readonly acceptPoliciesCheckbox: Locator;
     readonly createAccountButton: Locator;
     constructor(page: Page);
-    navigate(): Promise<void>;
-    enterFirstName(firstName: string): Promise<void>;
-    enterLastName(lastName: string): Promise<void>;
-    enterEmail(email: string): Promise<void>;
-    checkMarketingOptIn(): Promise<void>;
-    checkAcceptPolicies(): Promise<void>;
-    clickCreateAccount(): Promise<void>;
-    fillAndSubmitCreateAccountForm(firstName: string, lastName: string, email: string, acceptMarketing?: boolean): Promise<void>;
-    isOnRegisterPage(): Promise<void>;
+    register(firstName: string, lastName: string, email: string, acceptMarketing?: boolean): Promise<void>;
 }

package/dist/pages/kinde/RegisterPage.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RegisterPage = void 0;
-const test_1 = require("@playwright/test");
 class RegisterPage {
     constructor(page) {
         this.page = page;
@@ -12,53 +11,15 @@ class RegisterPage {
         this.acceptPoliciesCheckbox = page.locator('input[name="p_has_clickwrap_accepted"]');
         this.createAccountButton = page.locator('//span[contains(text(), "account")]/parent::button');
     }
-    async navigate() {
-        await this.page.goto('/auth/register');
-        await this.isOnRegisterPage();
-    }
-    async enterFirstName(firstName) {
+    async register(firstName, lastName, email, acceptMarketing = false) {
         await this.firstNameInput.fill(firstName);
-    }
-    async enterLastName(lastName) {
         await this.lastNameInput.fill(lastName);
-    }
-    async enterEmail(email) {
         await this.emailInput.fill(email);
-    }
-    async checkMarketingOptIn() {
-        await this.marketingOptInCheckbox.check();
-    }
-    async checkAcceptPolicies() {
         await this.acceptPoliciesCheckbox.check();
-    }
-    async clickCreateAccount() {
-        await this.createAccountButton.click();
-    }
-    async fillAndSubmitCreateAccountForm(firstName, lastName, email, acceptMarketing = false) {
-        await this.enterFirstName(firstName);
-        await this.enterLastName(lastName);
-        await this.enterEmail(email);
         if (acceptMarketing) {
-            await this.checkMarketingOptIn();
-        }
-        const checkboxCount = await this.acceptPoliciesCheckbox.count();
-        if (checkboxCount > 0) {
-            try {
-                await this.checkAcceptPolicies();
-            }
-            catch (error) {
-                // Ignore if checkbox is not interactable
-            }
+            await this.marketingOptInCheckbox.check();
         }
-        await this.clickCreateAccount();
-    }
-    async isOnRegisterPage() {
-        await (0, test_1.expect)(this.firstNameInput).toBeVisible();
-        await (0, test_1.expect)(this.lastNameInput).toBeVisible();
-        await (0, test_1.expect)(this.emailInput).toBeVisible();
-        await (0, test_1.expect)(this.marketingOptInCheckbox).toBeVisible();
-        // await expect(this.acceptPoliciesCheckbox).toBeVisible();
-        await (0, test_1.expect)(this.createAccountButton).toBeVisible();
+        await this.createAccountButton.click();
     }
 }
 exports.RegisterPage = RegisterPage;

package/dist/services/GetTestMailService.d.ts

@@ -0,0 +1,61 @@
+export interface TestMailEmail {
+    _id: string;
+    from: string;
+    to: string;
+    subject: string;
+    text?: string;
+    html?: string;
+    timestamp: number;
+    attachments?: any[];
+}
+export interface TestMailResponse {
+    result: string;
+    message: string;
+    count: number;
+    emails: TestMailEmail[];
+}
+export declare class GetTestMailService {
+    private readonly API_URL;
+    private readonly apiKey;
+    private readonly namespace;
+    private client;
+    constructor(apiKey: string, namespace: string);
+    /**
+     * Generate an email address for testing
+     * @param tag - Unique identifier for this email address
+     * @returns Complete email address
+     */
+    createEmailAddress(tag: string): string;
+    /**
+     * Get emails from inbox
+     * @param tag - Filter by specific tag
+     * @param timestampFrom - Get emails from this timestamp onwards (in milliseconds)
+     * @param livequery - Wait for new emails if true
+     * @param timeoutMs - Timeout for the request
+     * @returns Array of emails
+     */
+    getEmails(tag?: string, timestampFrom?: number, livequery?: boolean, timeoutMs?: number): Promise<TestMailEmail[]>;
+    /**
+     * Wait for an email matching the subject regex
+     * @param tag - Tag to filter emails
+     * @param subjectRegex - Regex pattern to match email subject
+     * @param timeoutMs - Maximum time to wait
+     * @param pollMs - Polling interval (not used with livequery)
+     * @returns Matching email
+     */
+    readMailBySubject(tag: string, subjectRegex: RegExp, timeoutMs?: number, pollMs?: number): Promise<TestMailEmail>;
+    /**
+     * Extract verification code from email body
+     * @param email - Email object
+     * @param pattern - Regex pattern to extract code (default: 6 digits)
+     * @returns Extracted code
+     */
+    extractCode(email: TestMailEmail, pattern?: RegExp): string;
+    /**
+     * Create an isolated instance with different configuration
+     * @param apiKey - API key
+     * @param namespace - Namespace
+     * @returns New GetTestMailService instance
+     */
+    static createIsolatedClient(apiKey: string, namespace: string): GetTestMailService;
+}

package/dist/services/GetTestMailService.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTestMailService = void 0;
+const axios_1 = __importDefault(require("axios"));
+class GetTestMailService {
+    constructor(apiKey, namespace) {
+        this.API_URL = 'https://api.testmail.app/api/json';
+        if (!apiKey || !namespace) {
+            throw new Error('API key and namespace are required for GetTestMailService');
+        }
+        this.apiKey = apiKey;
+        this.namespace = namespace;
+        this.client = axios_1.default.create({
+            timeout: 120000, // 2 minutes for livequery
+            headers: {
+                'Accept': 'application/json',
+            },
+        });
+    }
+    /**
+     * Generate an email address for testing
+     * @param tag - Unique identifier for this email address
+     * @returns Complete email address
+     */
+    createEmailAddress(tag) {
+        if (!tag) {
+            tag = `test-${Date.now()}-${Math.random().toString(36).substring(7)}`;
+        }
+        return `${this.namespace}.${tag}@inbox.testmail.app`;
+    }
+    /**
+     * Get emails from inbox
+     * @param tag - Filter by specific tag
+     * @param timestampFrom - Get emails from this timestamp onwards (in milliseconds)
+     * @param livequery - Wait for new emails if true
+     * @param timeoutMs - Timeout for the request
+     * @returns Array of emails
+     */
+    async getEmails(tag, timestampFrom, livequery = false, timeoutMs = 120000) {
+        const params = {
+            apikey: this.apiKey,
+            namespace: this.namespace,
+        };
+        if (tag) {
+            params.tag = tag;
+        }
+        if (timestampFrom) {
+            params.timestamp_from = timestampFrom;
+        }
+        if (livequery) {
+            params.livequery = 'true';
+        }
+        const { data } = await this.client.get(this.API_URL, {
+            params,
+            timeout: timeoutMs,
+        });
+        if (data.result !== 'success') {
+            throw new Error(`API returned error: ${data.message}`);
+        }
+        return data.emails || [];
+    }
+    /**
+     * Wait for an email matching the subject regex
+     * @param tag - Tag to filter emails
+     * @param subjectRegex - Regex pattern to match email subject
+     * @param timeoutMs - Maximum time to wait
+     * @param pollMs - Polling interval (not used with livequery)
+     * @returns Matching email
+     */
+    async readMailBySubject(tag, subjectRegex, timeoutMs = 60000, pollMs = 5000) {
+        const startTime = Date.now();
+        const timestampFrom = startTime;
+        while (Date.now() - startTime < timeoutMs) {
+            const remainingTime = timeoutMs - (Date.now() - startTime);
+            try {
+                const emails = await this.getEmails(tag, timestampFrom, true, Math.min(remainingTime, 60000) // Max 60s per request
+                );
+                const matches = emails.filter(email => subjectRegex.test(email.subject));
+                if (matches.length > 0) {
+                    // Sort by timestamp descending (most recent first)
+                    matches.sort((a, b) => b.timestamp - a.timestamp);
+                    return matches[0];
+                }
+            }
+            catch (error) {
+                // If timeout on request, continue polling
+                if (error.code === 'ECONNABORTED' || error.message?.includes('timeout')) {
+                    if (Date.now() - startTime >= timeoutMs) {
+                        break;
+                    }
+                    await new Promise(r => setTimeout(r, pollMs));
+                    continue;
+                }
+                throw error;
+            }
+            await new Promise(r => setTimeout(r, pollMs));
+        }
+        throw new Error(`Timeout (${timeoutMs} ms) waiting for an email with subject matching ${subjectRegex}`);
+    }
+    /**
+     * Extract verification code from email body
+     * @param email - Email object
+     * @param pattern - Regex pattern to extract code (default: 6 digits)
+     * @returns Extracted code
+     */
+    extractCode(email, pattern = /\b\d{6}\b/) {
+        const text = email.text || email.html || '';
+        const match = text.match(pattern);
+        if (!match) {
+            throw new Error('Could not extract code from email');
+        }
+        return match[0];
+    }
+    /**
+     * Create an isolated instance with different configuration
+     * @param apiKey - API key
+     * @param namespace - Namespace
+     * @returns New GetTestMailService instance
+     */
+    static createIsolatedClient(apiKey, namespace) {
+        return new GetTestMailService(apiKey, namespace);
+    }
+}
+exports.GetTestMailService = GetTestMailService;

package/dist/{utils/temp-email-utils.d.ts → services/GuerrillaMailService.d.ts}

@@ -6,7 +6,7 @@ export interface GuerrillaEmail {
     mail_body?: string;
     mail_timestamp: number;
 }
-declare class GuerrillaMailClient {
+declare class GuerrillaMailService {
     private readonly API_URL;
     private readonly ip;
     private readonly agent;
@@ -18,8 +18,8 @@ declare class GuerrillaMailClient {
     readMailBySubject(subjectRegex: RegExp, timeoutMs?: number, pollMs?: number): Promise<GuerrillaEmail>;
     deleteMail(mailId: string): Promise<void>;
     private fetchEmail;
-    static createIsolatedClient(): GuerrillaMailClient;
+    static createIsolatedClient(): GuerrillaMailService;
     clearInbox(): Promise<void>;
 }
-export declare const email: GuerrillaMailClient;
-export { GuerrillaMailClient };
+export declare const email: GuerrillaMailService;
+export { GuerrillaMailService };

package/dist/{utils/temp-email-utils.js → services/GuerrillaMailService.js}

@@ -3,11 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GuerrillaMailClient = exports.email = void 0;
+exports.GuerrillaMailService = exports.email = void 0;
 const axios_1 = __importDefault(require("axios"));
 const axios_cookiejar_support_1 = require("axios-cookiejar-support");
 const tough_cookie_1 = require("tough-cookie");
-class GuerrillaMailClient {
+class GuerrillaMailService {
     constructor() {
         this.API_URL = 'https://api.guerrillamail.com/ajax.php';
         this.ip = '127.0.0.1';
@@ -18,6 +18,7 @@ class GuerrillaMailClient {
         this.client = (0, axios_cookiejar_support_1.wrapper)(axios_1.default.create({
             jar,
             withCredentials: true,
+            timeout: 30000,
             headers: {
                 'User-Agent': 'qa-automation-utils/1.0',
             },
@@ -93,7 +94,7 @@ class GuerrillaMailClient {
         return data;
     }
     static createIsolatedClient() {
-        return new GuerrillaMailClient();
+        return new GuerrillaMailService();
     }
     async clearInbox() {
         const { data } = await this.client.get(this.API_URL, {
@@ -115,5 +116,5 @@ class GuerrillaMailClient {
         }
     }
 }
-exports.GuerrillaMailClient = GuerrillaMailClient;
-exports.email = new GuerrillaMailClient();
+exports.GuerrillaMailService = GuerrillaMailService;
+exports.email = new GuerrillaMailService();

package/dist/services/KindeAuthService.d.ts

@@ -1,14 +1,6 @@
-import { Page } from 'playwright/test';
-import { GuerrillaMailClient } from '../utils/temp-email-utils';
 export declare class KindeAuthService {
-    private tempEmail?;
-    private verificationCode?;
     private emailClient?;
-    private loginPage;
-    private registerPage;
-    private confirmCodePage;
-    private passwordSetupPage;
-    constructor(page: Page);
-    createAccountWithEmailVerification(referralCode?: string): Promise<GuerrillaMailClient>;
-    deleteTemporaryEmail(): Promise<void>;
+    constructor();
+    createGuerrillaMail(): Promise<string>;
+    getConfirmationCodeFromEmail(): Promise<string>;
 }

package/dist/services/KindeAuthService.js

@@ -1,57 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KindeAuthService = void 0;
-const ConfirmCodePage_1 = require("../pages/kinde/ConfirmCodePage");
-const LoginPage_1 = require("../pages/kinde/LoginPage");
-const PasswordSetupPage_1 = require("../pages/kinde/PasswordSetupPage");
-const RegisterPage_1 = require("../pages/kinde/RegisterPage");
-const temp_email_utils_1 = require("../utils/temp-email-utils");
+const GuerrillaMailService_1 = require("./GuerrillaMailService");
 class KindeAuthService {
-    constructor(page) {
-        this.loginPage = new LoginPage_1.LoginPage(page);
-        this.registerPage = new RegisterPage_1.RegisterPage(page);
-        this.confirmCodePage = new ConfirmCodePage_1.ConfirmCodePage(page);
-        this.passwordSetupPage = new PasswordSetupPage_1.PasswordSetupPage(page);
+    constructor() {
+        this.emailClient = GuerrillaMailService_1.GuerrillaMailService.createIsolatedClient();
     }
-    async createAccountWithEmailVerification(referralCode) {
-        await this.loginPage.page.goto(referralCode || '/');
-        await this.loginPage.goToRegisterPage();
-        await this.registerPage.isOnRegisterPage();
-        this.emailClient = temp_email_utils_1.GuerrillaMailClient.createIsolatedClient();
-        this.tempEmail = await this.emailClient.createMail();
-        const firstName = 'Test';
-        const lastName = 'User';
-        await this.registerPage.fillAndSubmitCreateAccountForm(firstName, lastName, this.tempEmail, false // Don't accept marketing emails
-        );
-        await this.confirmCodePage.isOnConfirmCodePage();
+    async createGuerrillaMail() {
+        return this.emailClient.createMail();
+    }
+    async getConfirmationCodeFromEmail() {
         const emailData = await this.emailClient.readMailBySubject(/Email verification code/i, 120000, // 2 minutes timeout
-        5000 // Check every 5 seconds
-        );
+        5000);
         const codeMatch = emailData.mail_body?.match(/\b\d{6}\b/);
-        if (codeMatch) {
-            this.verificationCode = codeMatch[0];
-            await this.confirmCodePage.submitConfirmationCode(this.verificationCode);
-        }
-        else {
-            throw new Error('Could not extract verification code from email');
-        }
-        await this.passwordSetupPage.isOnPasswordSetupPage();
-        const password = 'TestPassword123!';
-        await this.passwordSetupPage.submitPasswordForm(password);
-        await this.passwordSetupPage.dontUseMFA();
-        return this.emailClient;
-    }
-    async deleteTemporaryEmail() {
-        if (this.tempEmail) {
-            try {
-                this.tempEmail = undefined;
-                this.verificationCode = undefined;
-                this.emailClient = undefined;
-            }
-            catch (error) {
-                console.warn("Could not clean up temporary email:", error);
-            }
-        }
+        return codeMatch[0];
     }
 }
 exports.KindeAuthService = KindeAuthService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "external-services-automation",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "External services automation library for Playwright and Cucumber",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,16 +28,25 @@
     "build:watch": "tsc --watch",
     "clean": "rm -rf dist",
     "prebuild": "npm run clean",
-    "test": "echo \"No tests specified\" && exit 0",
+    "test": "jest",
+    "test:watch": "jest --watch",
     "prepublishOnly": "npm run build"
   },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
   "peerDependencies": {
     "@playwright/test": "^1.40.0",
     "axios-cookiejar-support": "^6.0.2",
     "tough-cookie": "^5.1.2"
   },
   "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.12",
     "@types/node": "^22.5.4",
+    "dotenv": "^17.3.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
     "typescript": "^5.5.4"
   }
 }