@empiricalrun/playwright-utils 0.30.1 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @empiricalrun/playwright-utils
 
+## 0.32.0
+
+### Minor Changes
+
+- 74b2cc6: feat: add KV store API and playwright fixture
+
+## 0.31.0
+
+### Minor Changes
+
+- 5639645: refactor: replace Mailosaur SDK with direct REST API calls
+
+### Patch Changes
+
+- Updated dependencies [25962dc]
+  - @empiricalrun/llm@0.25.1
+  - @empiricalrun/test-gen@0.78.2
+
 ## 0.30.1
 
 ### Patch Changes

package/dist/email.d.ts

@@ -1,15 +1,5 @@
-import MailosaurClient from "mailosaur";
-type Link = {
-    text?: string;
-    href?: string;
-};
-export type Email = {
-    subject?: string;
-    text?: string;
-    html?: string;
-    links: Link[];
-    codes: string[];
-};
+import { type MailosaurEmail } from "./mailosaur-client";
+export type Email = MailosaurEmail;
 type QueryFilter = {
     from?: string;
     subject?: string;
@@ -21,12 +11,12 @@ type EmailClientOptions = {
 };
 export declare class EmailClient {
     address: string;
-    client: MailosaurClient;
     timeout: number;
     serverId: string;
+    private client;
     constructor(opts?: EmailClientOptions);
     getAddress(): string;
-    waitForEmail(filter?: QueryFilter): Promise<Email | undefined>;
+    waitForEmail(filter?: QueryFilter): Promise<Email>;
 }
 export {};
 //# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,WAAW,CAAC;AAGxC,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,KAAK,kBAAkB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,SAAc;gBAEV,IAAI,GAAE,kBAAuB;IAmBzC,UAAU;IAIJ,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;CAiDrE"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,MAAM,KAAK,GAAG,cAAc,CAAC;AAEnC,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAKF,KAAK,kBAAkB,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,SAAa;IACrB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,IAAI,GAAE,kBAAuB;IA2BzC,UAAU,IAAI,MAAM;IAId,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;CAGzD"}

package/dist/email.js

@@ -1,26 +1,29 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailClient = void 0;
-const mailosaur_1 = __importDefault(require("mailosaur"));
+const mailosaur_client_1 = require("./mailosaur-client");
 const DEFAULT_TIMEOUT = 30_000;
+const SERVER_ID = "pnyrwq5o";
 class EmailClient {
     address;
-    client;
     timeout;
-    serverId = "pnyrwq5o";
+    serverId = SERVER_ID;
+    client;
     constructor(opts = {}) {
-        this.client = new mailosaur_1.default(process.env.MAILOSAUR_API_KEY);
+        const apiKey = process.env.MAILOSAUR_API_KEY;
+        if (!apiKey) {
+            throw new Error("'apiKey' must be set");
+        }
         const { timeout = DEFAULT_TIMEOUT, emailId: knownEmailId } = opts;
         this.timeout = timeout;
+        this.client = new mailosaur_client_1.MailosaurClient({
+            apiKey,
+            serverId: this.serverId,
+            timeout: this.timeout,
+        });
         const emailId = knownEmailId ||
             [...Array(7)].map(() => Math.random().toString(36)[2]).join("");
         if (emailId.includes("@")) {
-            // When EmailClient is used as a virtual SMTP server,
-            // we can read emails sent to any domain. These can be
-            // specified by setting the emailId to a full address.
             this.address = emailId;
         }
         else {
@@ -32,48 +35,7 @@ class EmailClient {
         return this.address;
     }
     async waitForEmail(filter) {
-        const now = new Date();
-        const bufferPeriod = 5_000;
-        const receivedAfter = new Date(now.getTime() - bufferPeriod);
-        try {
-            const email = await this.client.messages.get(this.serverId, {
-                sentTo: this.address,
-                sentFrom: filter?.from,
-                subject: filter?.subject,
-                body: filter?.body,
-            }, {
-                timeout: this.timeout,
-                receivedAfter,
-            });
-            const codesAsString = (email.html?.codes || []).map((code) => code.value);
-            const allLinks = [
-                ...(email.html?.links || []),
-                ...(email.text?.links || []),
-            ];
-            return {
-                subject: email.subject,
-                text: email.text?.body,
-                html: email.html?.body,
-                links: allLinks,
-                codes: codesAsString,
-            };
-        }
-        catch (error) {
-            if (error.errorType) {
-                const mailosaurError = error;
-                if (mailosaurError.errorType === "authentication_error") {
-                    throw new Error("Email provider error: Authentication error");
-                }
-                else if (mailosaurError.errorType === "search_timeout") {
-                    throw new Error(`Email not received at ${this.address} within ${this.timeout}ms`);
-                }
-                else {
-                    console.error(`Mailosaur error: ${mailosaurError.httpResponseBody}`);
-                    throw new Error(`Unknown error: ${mailosaurError.errorType}`);
-                }
-            }
-            throw error;
-        }
+        return this.client.waitForEmail(this.address, filter);
     }
 }
 exports.EmailClient = EmailClient;

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * from "./auth/google";
 export { solveRecaptcha } from "./captcha";
 export { baseConfig, chromeStablePath, devices } from "./config";
 export * from "./email";
+export * from "./kv";
 export * from "./playwright-extensions";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjE,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjE,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -24,4 +24,5 @@ Object.defineProperty(exports, "baseConfig", { enumerable: true, get: function (
 Object.defineProperty(exports, "chromeStablePath", { enumerable: true, get: function () { return config_1.chromeStablePath; } });
 Object.defineProperty(exports, "devices", { enumerable: true, get: function () { return config_1.devices; } });
 __exportStar(require("./email"), exports);
+__exportStar(require("./kv"), exports);
 __exportStar(require("./playwright-extensions"), exports);

package/dist/kv.d.ts

@@ -0,0 +1,7 @@
+export declare class KVClient {
+    private client;
+    constructor();
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttl: number): Promise<void>;
+}
+//# sourceMappingURL=kv.d.ts.map

package/dist/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAYA,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAqB;;IAW7B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAanE"}

package/dist/kv.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KVClient = void 0;
+const dashboard_1 = require("@empiricalrun/test-gen/dashboard");
+class KVClient {
+    client;
+    constructor() {
+        if (!process.env.EMPIRICALRUN_API_KEY) {
+            throw new Error("EMPIRICALRUN_API_KEY environment variable is required");
+        }
+        this.client = new dashboard_1.DashboardAPIClient({
+            authType: "project-api-key",
+        });
+    }
+    async get(key) {
+        const response = await this.client.request("/api/projects/kv", {
+            method: "GET",
+            params: { key },
+        });
+        if (response.error) {
+            throw new Error(`KV get failed: ${response.error.message}`);
+        }
+        return response.data?.value ?? null;
+    }
+    async set(key, value, ttl) {
+        const response = await this.client.request("/api/projects/kv", {
+            method: "POST",
+            body: { key, value, ttl },
+        });
+        if (response.error) {
+            throw new Error(`KV set failed: ${response.error.message}`);
+        }
+    }
+}
+exports.KVClient = KVClient;

package/dist/mailosaur-client.d.ts

@@ -0,0 +1,34 @@
+type Link = {
+    text?: string;
+    href?: string;
+};
+export type MailosaurEmail = {
+    subject?: string;
+    text?: string;
+    html?: string;
+    links: Link[];
+    codes: string[];
+};
+type MailosaurClientOptions = {
+    apiKey: string;
+    serverId: string;
+    timeout: number;
+};
+export declare class MailosaurClient {
+    private apiKey;
+    private serverId;
+    private timeout;
+    constructor(opts: MailosaurClientOptions);
+    waitForEmail(address: string, filter?: {
+        from?: string;
+        subject?: string;
+        body?: string;
+    }): Promise<MailosaurEmail>;
+    private searchWithPolling;
+    private getMessageById;
+    private handleMailosaurError;
+    private parseEmailResponse;
+    private sleep;
+}
+export {};
+//# sourceMappingURL=mailosaur-client.d.ts.map

package/dist/mailosaur-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailosaur-client.d.ts","sourceRoot":"","sources":["../src/mailosaur-client.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AA6BF,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,sBAAsB;IAMlC,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,cAAc,CAAC;YAqBZ,iBAAiB;YAyEjB,cAAc;YAuBd,oBAAoB;IAqBlC,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,KAAK;CAGd"}

package/dist/mailosaur-client.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailosaurClient = void 0;
+const MAILOSAUR_BASE_URL = "https://mailosaur.com/api";
+const DEFAULT_POLL_DELAY = 1000;
+class MailosaurClient {
+    apiKey;
+    serverId;
+    timeout;
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.serverId = opts.serverId;
+        this.timeout = opts.timeout;
+    }
+    async waitForEmail(address, filter) {
+        const now = new Date();
+        const bufferPeriod = 5_000;
+        const receivedAfter = new Date(now.getTime() - bufferPeriod);
+        const searchCriteria = {
+            sentTo: address,
+            ...(filter?.from && { sentFrom: filter.from }),
+            ...(filter?.subject && { subject: filter.subject }),
+            ...(filter?.body && { body: filter.body }),
+        };
+        const messageId = await this.searchWithPolling(searchCriteria, receivedAfter, address);
+        const message = await this.getMessageById(messageId);
+        return this.parseEmailResponse(message);
+    }
+    async searchWithPolling(criteria, receivedAfter, address) {
+        const startTime = Date.now();
+        let pollCount = 0;
+        while (true) {
+            const searchParams = new URLSearchParams({
+                server: this.serverId,
+                page: "0",
+                itemsPerPage: "1",
+                receivedAfter: receivedAfter.toISOString(),
+            });
+            const url = `${MAILOSAUR_BASE_URL}/messages/search?${searchParams.toString()}`;
+            let response;
+            try {
+                response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Basic ${Buffer.from(`${this.apiKey}:`).toString("base64")}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify(criteria),
+                });
+            }
+            catch (err) {
+                console.error("Mailosaur network error during search:", err);
+                throw new Error("Email provider error: Network request failed");
+            }
+            if (!response.ok) {
+                await this.handleMailosaurError(response, "search");
+            }
+            const body = (await response.json());
+            if (body.items && body.items.length > 0 && body.items[0]?.id) {
+                return body.items[0].id;
+            }
+            // Parse delay from response header, filtering out invalid values
+            const header = response.headers.get("x-ms-delay");
+            let delay = DEFAULT_POLL_DELAY;
+            if (header) {
+                const pattern = header
+                    .split(",")
+                    .map((x) => parseInt(x, 10))
+                    .filter((n) => Number.isFinite(n) && n > 0);
+                if (pattern.length > 0) {
+                    const index = Math.min(pollCount, pattern.length - 1);
+                    delay = pattern[index] ?? DEFAULT_POLL_DELAY;
+                }
+            }
+            pollCount += 1;
+            // Check if we'll exceed timeout
+            const elapsed = Date.now() - startTime;
+            if (elapsed + delay > this.timeout) {
+                throw new Error(`Email not received at ${address} within ${this.timeout}ms`);
+            }
+            await this.sleep(delay);
+        }
+    }
+    async getMessageById(messageId) {
+        const url = `${MAILOSAUR_BASE_URL}/messages/${messageId}`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    Authorization: `Basic ${Buffer.from(`${this.apiKey}:`).toString("base64")}`,
+                },
+            });
+        }
+        catch (err) {
+            console.error("Mailosaur network error during getMessageById:", err);
+            throw new Error("Email provider error: Network request failed");
+        }
+        if (!response.ok) {
+            await this.handleMailosaurError(response, "getMessageById");
+        }
+        return (await response.json());
+    }
+    async handleMailosaurError(response, context) {
+        const errorBody = await response.text().catch(() => "");
+        console.error(`Mailosaur error in ${context}:`, errorBody || response.statusText);
+        if (response.status === 401) {
+            throw new Error("Email provider error: Authentication error");
+        }
+        throw new Error(`Email provider error (${context}): HTTP ${response.status}${errorBody ? ` - ${errorBody}` : ""}`);
+    }
+    parseEmailResponse(email) {
+        const codesAsString = email.html?.codes
+            ?.map((code) => code.value)
+            .filter((v) => typeof v === "string") ?? [];
+        const htmlLinks = email.html?.links ?? [];
+        const textLinks = email.text?.links ?? [];
+        const allLinks = [...htmlLinks, ...textLinks];
+        return {
+            subject: email.subject,
+            text: email.text?.body,
+            html: email.html?.body,
+            links: allLinks,
+            codes: codesAsString,
+        };
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.MailosaurClient = MailosaurClient;

package/dist/test/index.d.ts

@@ -1,4 +1,5 @@
 import type { BrowserContext, BrowserContextOptions, expect, Page, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, TestType } from "@playwright/test";
+import { KVClient } from "../kv";
 import { injectLocatorHighlightScripts } from "./scripts";
 import { HighlighterOpts } from "./types";
 import { setVideoLabel } from "./video-labels";
@@ -12,6 +13,7 @@ declare global {
 declare const extendExpect: (expectInstance: typeof expect) => import("@playwright/test").Expect<{}>;
 type TestOptions = {
     page: Page;
+    kv: KVClient;
     customContextPageProvider: (options?: BrowserContextOptions) => Promise<{
         context: BrowserContext;
         page: Page;

package/dist/test/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,IAAI,EACJ,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAA8B,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc,CAAC;QACvB,UAAU,QAAQ,CAAC,CAAC;YAClB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;SAC9C;KACF;CACF;AAED,QAAA,MAAM,YAAY,GAAa,gBAAgB,OAAO,MAAM,0CAG3D,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,yBAAyB,EAAE,CACzB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACtD,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAYF,QAAA,MAAM,eAAe,GACnB,QAAQ,QAAQ,CACd,kBAAkB,GAAG,qBAAqB,EAC1C,oBAAoB,GAAG,uBAAuB,CAC/C,EACD,UAAS,eAAgC,uHAmG1C,CAAC;AAEF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,6BAA6B,EAC7B,aAAa,GACd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,IAAI,EACJ,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAA8B,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc,CAAC;QACvB,UAAU,QAAQ,CAAC,CAAC;YAClB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;SAC9C;KACF;CACF;AAED,QAAA,MAAM,YAAY,GAAa,gBAAgB,OAAO,MAAM,0CAG3D,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,yBAAyB,EAAE,CACzB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IACtD,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAYF,QAAA,MAAM,eAAe,GACnB,QAAQ,QAAQ,CACd,kBAAkB,GAAG,qBAAqB,EAC1C,oBAAoB,GAAG,uBAAuB,CAC/C,EACD,UAAS,eAAgC,uHAuG1C,CAAC;AAEF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,6BAA6B,EAC7B,aAAa,GACd,CAAC"}

package/dist/test/index.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setVideoLabel = exports.injectLocatorHighlightScripts = exports.extendExpect = exports.baseTestFixture = void 0;
 const path_1 = __importDefault(require("path"));
+const kv_1 = require("../kv");
 const expect_1 = require("./expect");
 const scripts_1 = require("./scripts");
 Object.defineProperty(exports, "injectLocatorHighlightScripts", { enumerable: true, get: function () { return scripts_1.injectLocatorHighlightScripts; } });
@@ -48,6 +49,10 @@ const baseTestFixture = function (testFn, options = defaultOptions) {
             });
             await use(page);
         },
+        kv: async ({}, use) => {
+            const client = new kv_1.KVClient();
+            await use(client);
+        },
         customContextPageProvider: async ({ browser }, use, testInfo) => {
             const contexts = [];
             async function createContext(contextOptions = {}) {

package/docs/kv.md

@@ -0,0 +1,26 @@
+# KV Store
+
+A simple key-value store for sharing data across test runs.
+
+## Fixture usage
+
+```ts
+test("example", async ({ page, kv }) => {
+  await kv.set("my-key", { some: "data" }, 3600);
+  const value = await kv.get<{ some: string }>("my-key");
+});
+```
+
+## Standalone usage
+
+```ts
+import { KVClient } from "@empiricalrun/playwright-utils";
+
+const kv = new KVClient();
+await kv.set("my-key", { some: "data" }, 3600); // ttl in seconds, max 2 days
+const value = await kv.get<{ some: string }>("my-key");
+```
+
+## Requirements
+
+- `EMPIRICALRUN_API_KEY` environment variable must be set

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empiricalrun/playwright-utils",
-  "version": "0.30.1",
+  "version": "0.32.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -40,12 +40,11 @@
     "async-retry": "^1.3.3",
     "authenticator": "^1.1.5",
     "console-log-level": "^1.4.1",
-    "mailosaur": "^8.6.1",
     "puppeteer-extra-plugin-recaptcha": "^3.6.8",
     "rimraf": "^6.0.1",
-    "@empiricalrun/llm": "^0.25.0",
+    "@empiricalrun/llm": "^0.25.1",
     "@empiricalrun/r2-uploader": "^0.4.0",
-    "@empiricalrun/test-gen": "^0.78.1"
+    "@empiricalrun/test-gen": "^0.78.2"
   },
   "scripts": {
     "dev": "tsc --build --watch",

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/email.ts","./src/index.ts","./src/logger.ts","./src/playwright-extensions.ts","./src/auth/google.ts","./src/auth/index.ts","./src/auth/types.ts","./src/captcha/index.ts","./src/captcha/vision.ts","./src/config/index.ts","./src/config/devices/types.ts","./src/overlay-tests/cache.spec.ts","./src/overlay-tests/click.spec.ts","./src/overlay-tests/fixtures.ts","./src/overlay-tests/patch.spec.ts","./src/reporter/empirical-reporter.ts","./src/reporter/uploader.ts","./src/reporter/util.ts","./src/test/constants.ts","./src/test/expect.ts","./src/test/index.ts","./src/test/types.ts","./src/test/video-labels.ts","./src/test/scripts/agent-capabilities.ts","./src/test/scripts/index.ts","./src/test/scripts/locator-highlights.ts","./src/test/scripts/locator-vision.ts","./src/test/scripts/mouse-pointer.ts","./src/test/scripts/types.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/cache.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/index.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/prompt.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/types.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/utils.ts","./src/test/scripts/pw-locator-patch/highlight/click.ts","./src/test/scripts/pw-locator-patch/highlight/expect.ts","./src/test/scripts/pw-locator-patch/highlight/hover.ts","./src/test/scripts/pw-locator-patch/highlight/inner-text.ts","./src/test/scripts/pw-locator-patch/highlight/input-value.ts","./src/test/scripts/pw-locator-patch/highlight/is-checked.ts","./src/test/scripts/pw-locator-patch/highlight/is-disabled.ts","./src/test/scripts/pw-locator-patch/highlight/is-editable.ts","./src/test/scripts/pw-locator-patch/highlight/text-content.ts","./src/test/scripts/pw-locator-patch/utils/index.ts","./src/test/scripts/pw-locator-patch/vision/query.ts"],"version":"5.8.3"}
+{"root":["./src/email.ts","./src/index.ts","./src/kv.ts","./src/logger.ts","./src/mailosaur-client.ts","./src/playwright-extensions.ts","./src/auth/google.ts","./src/auth/index.ts","./src/auth/types.ts","./src/captcha/index.ts","./src/captcha/vision.ts","./src/config/index.ts","./src/config/devices/types.ts","./src/overlay-tests/cache.spec.ts","./src/overlay-tests/click.spec.ts","./src/overlay-tests/fixtures.ts","./src/overlay-tests/patch.spec.ts","./src/reporter/empirical-reporter.ts","./src/reporter/uploader.ts","./src/reporter/util.ts","./src/test/constants.ts","./src/test/expect.ts","./src/test/index.ts","./src/test/types.ts","./src/test/video-labels.ts","./src/test/scripts/agent-capabilities.ts","./src/test/scripts/index.ts","./src/test/scripts/locator-highlights.ts","./src/test/scripts/locator-vision.ts","./src/test/scripts/mouse-pointer.ts","./src/test/scripts/types.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/cache.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/index.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/prompt.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/types.ts","./src/test/scripts/pw-locator-patch/dismiss-overlays/utils.ts","./src/test/scripts/pw-locator-patch/highlight/click.ts","./src/test/scripts/pw-locator-patch/highlight/expect.ts","./src/test/scripts/pw-locator-patch/highlight/hover.ts","./src/test/scripts/pw-locator-patch/highlight/inner-text.ts","./src/test/scripts/pw-locator-patch/highlight/input-value.ts","./src/test/scripts/pw-locator-patch/highlight/is-checked.ts","./src/test/scripts/pw-locator-patch/highlight/is-disabled.ts","./src/test/scripts/pw-locator-patch/highlight/is-editable.ts","./src/test/scripts/pw-locator-patch/highlight/text-content.ts","./src/test/scripts/pw-locator-patch/utils/index.ts","./src/test/scripts/pw-locator-patch/vision/query.ts"],"version":"5.8.3"}