Testing Utilities

Production-ready testing utilities from /shared/testing-utilities/. 22 comprehensive utilities to streamline your testing workflow.

API Testing Utilities

🚀 API Client

Universal HTTP client with authentication, retries, performance tracking

  • • JWT, OAuth2, API Key, Basic Auth support
  • • Automatic retries with exponential backoff
  • • Performance metrics & monitoring
  • • Request/Response interceptors
api/api-client.ts

🔧 Additional API Tools

MSW Helpers - Mock Service Worker
GraphQL Helpers - Schema testing
Response Validators - Schema validation
Rate Limit Testers - Load testing
Error Simulators - Network failures
Pagination Helpers - Cursor & offset

Database Testing Utilities

🗃️ Database Helpers

PostgreSQL - Connections & migrations
MongoDB - Document testing
MySQL - Relational data
Connection Pool - Management
Transactions - Rollback & isolation
Performance - Query monitoring

🏭 Data Generation

DB Factories - Test data with Faker.js
Seeders - Database population
Migrations - Schema testing
Cleanup - Data cleanup
22 total utilities across API, Database, and Auth categories

Authentication Testing

🔐 Auth Utilities

Auth Helpers - User context
User Factories - Test users
JWT Utils - Token handling
Session Mocks - State testing
OAuth Mocks - Third-party auth

📁 File Structure

📂 /shared/testing-utilities/
📂 helpers/
📂 api/ (6 utilities)
📂 auth/ (5 utilities)
📂 database/ (10 utilities)
📂 e2e/ (1 utility)

Ready-to-Use Configurations

🎯 Allure Reporting

Centralized test reporting with Jest and Vitest integration. Uploads to https://allure.projectassistant.ai

allure-jest.js
allure-vitest.ts

🐳 Docker Templates

Complete Docker configurations for testing environments with service composition.

docker-compose.test.yml
docker-compose.services.yml

🔧 Linting Configs

ESLint, PHPStan, and language-specific configurations for code quality.

eslint.config.js
composer.json

Usage Examples

🚀 Quick Start

import { createApiClient } from '/shared/testing-utilities/helpers/api/api-client'

Import and use the universal API client

import { createUser } from '/shared/testing-utilities/helpers/auth/user-factories'

Generate test users with realistic data

📋 Coverage

API Testing6 utilities
Database Testing10 utilities
Auth Testing5 utilities

💡 Multi-Agent Workflow Integration

These utilities are designed to work with PA-QA's multi-agent testing workflow. Use /generate-test-suite command to automatically generate complete test suites using these utilities.