@chrryai/waffles 1.1.78

package/README.md

@@ -0,0 +1,235 @@
+# 🧇 Waffles
+
+**Production-ready Playwright testing utilities** — Battle-tested helpers from [Vex](https://askvex.com)
+
+## 🎯 Why Waffles?
+
+Waffles provides a collection of battle-tested Playwright utilities that make E2E testing delightful. Born from real-world production testing at Vex, these helpers solve common testing challenges.
+
+## ✨ Features
+
+- 🎭 **Playwright-first** - Built specifically for Playwright
+- 🧪 **Production-tested** - Used in Vex's extensive test suite
+- 📦 **Zero config** - Works out of the box
+- 🎯 **TypeScript** - Full type safety
+- 🚀 **Lightweight** - Minimal dependencies
+
+## 📦 Installation
+
+```bash
+npm install @askvex/waffles @playwright/test
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { test, expect } from "@playwright/test"
+import {
+  wait,
+  simulateInputPaste,
+  waitForElement,
+  generateTestEmail,
+} from "@askvex/waffles"
+
+test("chat interaction", async ({ page }) => {
+  await page.goto("https://yourapp.com")
+
+  // Wait for chat to load
+  await waitForElement(page, '[data-testid="chat-textarea"]')
+
+  // Simulate pasting text
+  await simulateInputPaste(page, "Hello, AI!")
+
+  // Wait for response
+  await wait(1000)
+
+  // Assert
+  await expect(page.locator(".message")).toBeVisible()
+})
+```
+
+## 📚 API Reference
+
+### Timing Utilities
+
+#### `wait(ms: number)`
+
+Wait for a specified number of milliseconds.
+
+```typescript
+await wait(1000) // Wait 1 second
+```
+
+#### `waitForElement(page, selector, timeout?)`
+
+Wait for an element to be visible.
+
+```typescript
+await waitForElement(page, ".loading-spinner", 5000)
+```
+
+#### `waitForElementToDisappear(page, selector, timeout?)`
+
+Wait for an element to disappear.
+
+```typescript
+await waitForElementToDisappear(page, ".loading-spinner")
+```
+
+### Input Simulation
+
+#### `simulateInputPaste(page, text, selector?)`
+
+Simulate pasting text into a textarea.
+
+```typescript
+await simulateInputPaste(page, "Pasted content")
+```
+
+#### `simulatePaste(page, text, buttonSelector?)`
+
+Simulate pasting using clipboard API and clicking paste button.
+
+```typescript
+await simulatePaste(page, "Clipboard content")
+```
+
+### Navigation
+
+#### `getURL(options)`
+
+Generate a URL with optional fingerprint for testing.
+
+```typescript
+const url = getURL({
+  baseURL: "https://app.com",
+  path: "/chat",
+  isMember: true,
+  memberFingerprint: "abc-123",
+})
+```
+
+#### `scrollToBottom(page)`
+
+Scroll to the bottom of the page.
+
+```typescript
+await scrollToBottom(page)
+```
+
+### Utilities
+
+#### `capitalizeFirstLetter(str: string)`
+
+Capitalize the first letter of a string.
+
+```typescript
+capitalizeFirstLetter("hello") // "Hello"
+```
+
+#### `generateTestEmail(prefix?)`
+
+Generate a unique test email.
+
+```typescript
+const email = generateTestEmail("user") // user-1234567890-abc123@test.com
+```
+
+#### `generateTestPassword(length?)`
+
+Generate a random password for testing.
+
+```typescript
+const password = generateTestPassword(16)
+```
+
+### Cleanup
+
+#### `clearLocalStorage(page)`
+
+Clear browser local storage.
+
+```typescript
+await clearLocalStorage(page)
+```
+
+#### `clearCookies(page)`
+
+Clear browser cookies.
+
+```typescript
+await clearCookies(page)
+```
+
+### Screenshots
+
+#### `takeScreenshot(page, name, fullPage?)`
+
+Take a screenshot with a custom name.
+
+```typescript
+await takeScreenshot(page, "error-state", true)
+```
+
+## 🎨 Real-World Examples
+
+### Testing Chat Flow
+
+```typescript
+import { test } from "@playwright/test"
+import { simulateInputPaste, waitForElement, wait } from "@askvex/waffles"
+
+test("complete chat interaction", async ({ page }) => {
+  await page.goto("https://app.com/chat")
+
+  // Wait for chat to be ready
+  await waitForElement(page, '[data-testid="chat-textarea"]')
+
+  // Send message
+  await simulateInputPaste(page, "What's the weather?")
+  await page.click('[data-testid="send-button"]')
+
+  // Wait for AI response
+  await wait(2000)
+  await waitForElement(page, ".ai-message")
+})
+```
+
+### Testing Authentication
+
+```typescript
+import { test } from "@playwright/test"
+import { generateTestEmail, generateTestPassword, wait } from "@askvex/waffles"
+
+test("user registration", async ({ page }) => {
+  const email = generateTestEmail("newuser")
+  const password = generateTestPassword()
+
+  await page.goto("https://app.com/signup")
+  await page.fill('[name="email"]', email)
+  await page.fill('[name="password"]', password)
+  await page.click('button[type="submit"]')
+
+  await wait(1000)
+  await expect(page).toHaveURL(/dashboard/)
+})
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Waffles is extracted from Vex's production test suite, and we're always improving it.
+
+## 📄 License
+
+MIT © [AskVex](https://askvex.com)
+
+## 🔗 Links
+
+- [GitHub](https://github.com/askvex/waffles)
+- [npm](https://npmjs.com/package/@askvex/waffles)
+- [Issues](https://github.com/askvex/waffles/issues)
+- [Vex - Powered by Waffles](https://askvex.com)
+
+---
+
+**Built with ❤️ by the Vex team**

package/dist/index.d.mts

@@ -0,0 +1,107 @@
+import { Page, Browser } from '@playwright/test';
+import { Page as Page$1 } from 'playwright';
+
+declare const TEST_GUEST_FINGERPRINTS: string[];
+declare const TEST_MEMBER_FINGERPRINTS: string[];
+declare const TEST_MEMBER_EMAILS: string[];
+declare const VEX_TEST_EMAIL: string;
+declare const VEX_TEST_PASSWORD: string;
+declare const VEX_TEST_FINGERPRINT: string | undefined;
+declare const VEX_TEST_EMAIL_2: string;
+declare const VEX_TEST_PASSWORD_2: string;
+declare const VEX_TEST_FINGERPRINT_2: string | undefined;
+declare const VEX_TEST_EMAIL_3: string;
+declare const VEX_TEST_PASSWORD_3: string;
+declare const VEX_TEST_FINGERPRINT_3: string | undefined;
+declare const TEST_URL: string;
+declare const LIVE_URL = "https://askvex.com";
+declare const wait: (ms: number) => Promise<unknown>;
+declare const isCI: string | undefined;
+declare const getURL: ({ isLive, isMember, path, fingerprint, }?: {
+    isLive: boolean;
+    isMember?: boolean;
+    path?: string;
+    fingerprint?: string;
+}) => string;
+declare const simulateInputPaste: (page: Page, text: string) => Promise<void>;
+declare const simulatePaste: (page: Page, text: string) => Promise<void>;
+declare function capitalizeFirstLetter(val: string): string;
+
+type modelName = "chatGPT" | "claude" | "deepSeek" | "gemini" | "flux";
+declare const chat: ({ artifacts, page, isMember, isSubscriber, instruction, prompts, agentMessageTimeout, isNewChat, isLiveTest, threadId, creditsConsumed, bookmark, }: {
+    isSubscriber?: boolean;
+    artifacts?: {
+        text?: number;
+        paste?: number;
+        pdf?: number;
+    };
+    page: Page;
+    isMember?: boolean;
+    instruction?: string;
+    prompts?: {
+        debateAgent?: modelName;
+        stop?: boolean;
+        text: string;
+        instruction?: string;
+        deleteMessage?: boolean;
+        deleteAgentMessage?: boolean;
+        model?: modelName;
+        agentMessageTimeout?: number;
+        shouldFail?: boolean;
+        like?: boolean;
+        delete?: boolean;
+        webSearch?: boolean;
+        image?: number;
+        video?: number;
+        audio?: number;
+        paste?: number;
+        pdf?: number;
+        mix?: {
+            image?: number;
+            video?: number;
+            audio?: number;
+            paste?: number;
+            pdf?: number;
+        };
+    }[];
+    agentMessageTimeout?: number;
+    isNewChat?: boolean;
+    isLiveTest?: boolean;
+    threadId?: string;
+    creditsConsumed?: number;
+    bookmark?: boolean;
+}) => Promise<void>;
+
+declare function collaboration({ page, isLive, isMember, browser, withShareLink, fingerprint, collaborate, }: {
+    page: Page$1;
+    isLive?: boolean;
+    isMember?: boolean;
+    browser: Browser;
+    withShareLink?: boolean;
+    collaborate?: string;
+    fingerprint?: string;
+}): Promise<void>;
+
+declare const limit: ({ page, isMember, isSubscriber, }: {
+    page: Page;
+    isMember?: boolean;
+    isSubscriber?: boolean;
+}) => Promise<void>;
+
+declare const signIn: ({ page, isOpened, signOut, register, email, password, }: {
+    page: Page;
+    isOpened?: boolean;
+    signOut?: boolean;
+    register?: boolean;
+    email?: string;
+    password?: string;
+}) => Promise<void>;
+
+declare const thread: ({ page, isMember, bookmark, createChat, }: {
+    page: Page;
+    isMember?: boolean;
+    createChat?: boolean;
+    bookmark?: boolean;
+}) => Promise<void>;
+
+export { LIVE_URL, TEST_GUEST_FINGERPRINTS, TEST_MEMBER_EMAILS, TEST_MEMBER_FINGERPRINTS, TEST_URL, VEX_TEST_EMAIL, VEX_TEST_EMAIL_2, VEX_TEST_EMAIL_3, VEX_TEST_FINGERPRINT, VEX_TEST_FINGERPRINT_2, VEX_TEST_FINGERPRINT_3, VEX_TEST_PASSWORD, VEX_TEST_PASSWORD_2, VEX_TEST_PASSWORD_3, capitalizeFirstLetter, chat, collaboration, getURL, isCI, limit, type modelName, signIn, simulateInputPaste, simulatePaste, thread, wait };

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+import { Page, Browser } from '@playwright/test';
+import { Page as Page$1 } from 'playwright';
+
+declare const TEST_GUEST_FINGERPRINTS: string[];
+declare const TEST_MEMBER_FINGERPRINTS: string[];
+declare const TEST_MEMBER_EMAILS: string[];
+declare const VEX_TEST_EMAIL: string;
+declare const VEX_TEST_PASSWORD: string;
+declare const VEX_TEST_FINGERPRINT: string | undefined;
+declare const VEX_TEST_EMAIL_2: string;
+declare const VEX_TEST_PASSWORD_2: string;
+declare const VEX_TEST_FINGERPRINT_2: string | undefined;
+declare const VEX_TEST_EMAIL_3: string;
+declare const VEX_TEST_PASSWORD_3: string;
+declare const VEX_TEST_FINGERPRINT_3: string | undefined;
+declare const TEST_URL: string;
+declare const LIVE_URL = "https://askvex.com";
+declare const wait: (ms: number) => Promise<unknown>;
+declare const isCI: string | undefined;
+declare const getURL: ({ isLive, isMember, path, fingerprint, }?: {
+    isLive: boolean;
+    isMember?: boolean;
+    path?: string;
+    fingerprint?: string;
+}) => string;
+declare const simulateInputPaste: (page: Page, text: string) => Promise<void>;
+declare const simulatePaste: (page: Page, text: string) => Promise<void>;
+declare function capitalizeFirstLetter(val: string): string;
+
+type modelName = "chatGPT" | "claude" | "deepSeek" | "gemini" | "flux";
+declare const chat: ({ artifacts, page, isMember, isSubscriber, instruction, prompts, agentMessageTimeout, isNewChat, isLiveTest, threadId, creditsConsumed, bookmark, }: {
+    isSubscriber?: boolean;
+    artifacts?: {
+        text?: number;
+        paste?: number;
+        pdf?: number;
+    };
+    page: Page;
+    isMember?: boolean;
+    instruction?: string;
+    prompts?: {
+        debateAgent?: modelName;
+        stop?: boolean;
+        text: string;
+        instruction?: string;
+        deleteMessage?: boolean;
+        deleteAgentMessage?: boolean;
+        model?: modelName;
+        agentMessageTimeout?: number;
+        shouldFail?: boolean;
+        like?: boolean;
+        delete?: boolean;
+        webSearch?: boolean;
+        image?: number;
+        video?: number;
+        audio?: number;
+        paste?: number;
+        pdf?: number;
+        mix?: {
+            image?: number;
+            video?: number;
+            audio?: number;
+            paste?: number;
+            pdf?: number;
+        };
+    }[];
+    agentMessageTimeout?: number;
+    isNewChat?: boolean;
+    isLiveTest?: boolean;
+    threadId?: string;
+    creditsConsumed?: number;
+    bookmark?: boolean;
+}) => Promise<void>;
+
+declare function collaboration({ page, isLive, isMember, browser, withShareLink, fingerprint, collaborate, }: {
+    page: Page$1;
+    isLive?: boolean;
+    isMember?: boolean;
+    browser: Browser;
+    withShareLink?: boolean;
+    collaborate?: string;
+    fingerprint?: string;
+}): Promise<void>;
+
+declare const limit: ({ page, isMember, isSubscriber, }: {
+    page: Page;
+    isMember?: boolean;
+    isSubscriber?: boolean;
+}) => Promise<void>;
+
+declare const signIn: ({ page, isOpened, signOut, register, email, password, }: {
+    page: Page;
+    isOpened?: boolean;
+    signOut?: boolean;
+    register?: boolean;
+    email?: string;
+    password?: string;
+}) => Promise<void>;
+
+declare const thread: ({ page, isMember, bookmark, createChat, }: {
+    page: Page;
+    isMember?: boolean;
+    createChat?: boolean;
+    bookmark?: boolean;
+}) => Promise<void>;
+
+export { LIVE_URL, TEST_GUEST_FINGERPRINTS, TEST_MEMBER_EMAILS, TEST_MEMBER_FINGERPRINTS, TEST_URL, VEX_TEST_EMAIL, VEX_TEST_EMAIL_2, VEX_TEST_EMAIL_3, VEX_TEST_FINGERPRINT, VEX_TEST_FINGERPRINT_2, VEX_TEST_FINGERPRINT_3, VEX_TEST_PASSWORD, VEX_TEST_PASSWORD_2, VEX_TEST_PASSWORD_3, capitalizeFirstLetter, chat, collaboration, getURL, isCI, limit, type modelName, signIn, simulateInputPaste, simulatePaste, thread, wait };