app/tests/helpers

Playwright Test Helpers

This directory contains reusable helper functions for both Magnitude tests and Playwright MCP testing.

Usage

In Magnitude Tests

import { test } from 'magnitude-test';
import {
  navigateToApp,
  loginWithBluesky,
  startConversation,
  createNodeDraft,
  publishNode,
  completeNodePublishFlow,
} from '../helpers/playwright-helpers';

test('User can publish a node', async (agent) => {
  const page = agent.page; // Get Playwright page from Magnitude agent

  await completeNodePublishFlow(page, 'My test conversation');

  await agent.check('Node published successfully');
});

In Playwright MCP

Use the helper functions directly with the Playwright MCP page instance:

import { loginWithBluesky, startConversation } from './tests/helpers/playwright-helpers';

// In your MCP session
await loginWithBluesky(page);
await startConversation(page, 'Hello AI');

Available Helpers

Authentication

• loginWithBluesky(page, credentials?) - Complete OAuth login flow
• logout(page) - Logout from application
• isLoggedIn(page) - Check if user is authenticated

Navigation

• navigateToApp(page, baseUrl?) - Go to app home page

Conversation

• startConversation(page, message) - Send first message in chat
• waitForAIResponse(page, timeout?) - Wait for AI to finish responding

Node Publishing

• createNodeDraft(page) - Click "Create Node" button
• editNodeDraft(page, title?, content?) - Modify draft before publishing
• publishNode(page) - Click "Publish" and wait for success
• completeNodePublishFlow(page, message?, credentials?) - Full end-to-end flow

Environment Variables

Set these in your .env.test file:

TEST_BLUESKY_USERNAME=your-test-user.bsky.social
TEST_BLUESKY_PASSWORD=your-test-password

If not set, helpers will use default values (which will fail for real OAuth).

Design Principles

1. Reusability - Each helper is atomic and can be composed
2. Reliability - Helpers wait for network and UI state before proceeding
3. Flexibility - Optional parameters allow customization
4. Error Handling - Helpers throw clear errors when expectations aren't met