proxymail-qa 0.3.0 → 0.4.0

package/README.md

@@ -100,6 +100,11 @@ const { delivered, invalid } = await qa.variants(address);
 
 // After the app changes the test account's password, keep the saved one in step.
 await qa.setPassword(address, { password: 'the-new-test-password' });
+
+// Check the email that arrived: SPF, DKIM, DMARC, local or http links, where
+// its link goes, a stated expiry and more. Verdicts only, never its content.
+const result = await qa.checkEmail(address, { type: 'link', expectHost: 'staging.example.com' });
+expect(result.failed).toEqual([]);
 ```
 
 When a wait comes back empty, the error says why as far as Proxy Mail QA can

package/dist/index.d.ts

@@ -132,6 +132,31 @@ export interface CountOptions {
     subtype?: CountSubtype | CountSubtype[];
 }
 export type CountSubtype = 'otp' | 'coupon' | 'verify' | 'magic_signin' | 'invite' | 'reset' | 'other' | 'any';
+export type CheckId = 'spf' | 'dkim' | 'dmarc' | 'local_links' | 'plain_http' | 'expected_host' | 'expiry' | 'plain_text' | 'size' | 'images_only';
+export interface EmailCheck {
+    check: CheckId;
+    status: 'pass' | 'fail' | 'warn' | 'skip';
+    detail: string;
+}
+export interface EmailChecks {
+    address: string;
+    email: {
+        id: string;
+        received_at: string;
+        service: string | null;
+        service_domain: string | null;
+        type: 'code' | 'link' | null;
+        subtype: string | null;
+    };
+    passed: boolean;
+    failed: CheckId[];
+    warnings: CheckId[];
+    checks: EmailCheck[];
+}
+export interface CheckOptions extends CountOptions {
+    emailId?: string;
+    expectHost?: string;
+}
 export interface NoEmail {
     address: string;
     since: string;
@@ -171,6 +196,7 @@ export declare class ProxyMailQA {
         limit?: number;
     }): Promise<Record<string, unknown>[]>;
     countEmails(address: string, options?: CountOptions): Promise<EmailCount>;
+    checkEmail(address: string, options?: CheckOptions): Promise<EmailChecks>;
     expectNoEmail(address: string, options?: CountOptions & {
         timeout?: number;
     }): Promise<NoEmail>;

package/dist/index.js

@@ -141,6 +141,18 @@ export class ProxyMailQA {
     countEmails(address, options = {}) {
         return this.request('GET', `/addresses/${encodeURIComponent(address)}/count${countQuery(options)}`);
     }
+    // Checks one email the address received: SPF, DKIM and DMARC, links to
+    // localhost or plain http, where its link goes (expectHost), a stated
+    // expiry, a plain-text part, size and image-only emails. Doesn't wait: wait
+    // for the email first. Throws ProxyMailQAError (404) when none matches.
+    checkEmail(address, options = {}) {
+        const extra = {};
+        if (options.emailId)
+            extra.email_id = options.emailId;
+        if (options.expectHost)
+            extra.expect_host = options.expectHost;
+        return this.request('GET', `/addresses/${encodeURIComponent(address)}/checks${countQuery(options, extra)}`);
+    }
     // Resolves when no matching email arrives within timeout seconds (default
     // 30; longer repeats the request), for checks such as "an unsubscribed user
     // gets nothing". Throws ProxyMailQAError (status 409, code email_arrived)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proxymail-qa",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Disposable test inboxes for Playwright, Cypress and scripts: create an address, then wait for its verification code or link.",
   "license": "MIT",
   "author": "Proxy Mail QA <hello@proxymail.qa> (https://proxymail.qa)",