Integration Testing Skill

Purpose

This skill provides integration testing conventions for facades, server actions, and database operations. Integration tests use real database interactions via Testcontainers.

Activation

This skill activates when:

• •Creating or modifying files in tests/integration/
• •Testing facades or business logic
• •Testing server actions
• •Testing database queries with real data
• •Working with Testcontainers

File Patterns

• •tests/integration/**/*.test.ts
• •tests/integration/**/*.integration.test.ts

Workflow

1. •Detect integration test work (file path contains tests/integration/)
2. •Load references/Integration-Testing-Conventions.md
3. •Also load testing-base skill for shared conventions
4. •Apply integration test patterns with database helpers
5. •Ensure proper database cleanup between tests

Key Patterns (REQUIRED)

Database Management

• •Database auto-starts via global setup (Testcontainers)
• •Use getTestDb() from tests/setup/test-db.ts
• •Use resetTestDatabase() or cleanupTable() in beforeEach
• •Mock @/lib/db to use test database

Factory Usage

• •Use factories from tests/fixtures/ for test data
• •Create realistic test scenarios with proper relationships
• •Clean up created data between tests

External Service Mocking

• •Mock Sentry for breadcrumb verification
• •Mock CacheService for cache behavior control
• •Mock Redis client to avoid connection issues

References

• •references/Integration-Testing-Conventions.md - Complete integration testing conventions