cfw-autumn/scripts/testGroups

Test Groups

Organized test suites for the Autumn test framework.

Usage

From the project root:

# Run a specific test group
./scripts/testGroups/g1.sh

# Run with setup
./scripts/testGroups/g1.sh setup

From the server directory (legacy):

./run.sh /path/to/test/group/script.sh

Test Groups

G1: Upgrade & Downgrade Tests ✅ (Migrated to Bun)

Status: Fully migrated to Bun + TypeScript runner
Tests:

• server/tests/check/basic/*.test.ts
• server/tests/attach/basic/*.test.ts
• server/tests/attach/upgrade/*.test.ts
• server/tests/attach/downgrade/*.test.ts
• server/tests/attach/free/*.test.ts
• server/tests/attach/addOn/*.test.ts
• server/tests/attach/entities/*.test.ts
• server/tests/attach/checkout/*.test.ts

Features:

• Live spinner showing current test
• Beautiful success/failure indicators
• Concise error reports
• Compact mode for large test suites (reduces screen overflow)

G2: Migrations, Versions & Others ⏳ (Mocha)

Status: Uses Mocha (pending migration)
Tests:

• Migrations
• Version updates
• Prepaid features
• Interval upgrades

G3: Continuous Use Tests ⏳ (Mocha)

Status: Uses Mocha (pending migration)
Tests:

• Entity management
• Usage tracking
• Updates
• Roles

G4: Merged & Core Tests ⏳ (Mocha)

Status: Uses Mocha (pending migration)
Tests:

• Merged subscriptions
• Core cancellation
• Multi-attach scenarios

G5: Advanced Features ⏳ (Mocha)

Status: Uses Mocha (pending migration)
Tests:

• Multi-feature
• Coupons
• Referrals
• Rollovers
• Usage limits

G6: Alex Integration Tests ⏳ (Mocha)

Status: Uses Mocha (pending migration)
Tests:

• End-to-end scenarios
• Product switching
• Topups

Migration Progress

• ✅ Test runner built (TypeScript + Bun)
• ✅ G1 tests migrated to Bun
• ⏳ G2-G6 pending migration

Compact Mode 📦

When running many tests (dozens of test files), the standard output can overflow your terminal screen. Use compact mode to see only:

• Recently completed tests (last 3 with tick marks)
• Failed tests summary (updated in real-time)
• Currently running tests (up to 6) with their active test case
• A single line with test stats (progress, passed, failed)
• Full error details at the end

Usage

In shell scripts (recommended):

# Use BUN_PARALLEL_COMPACT instead of BUN_PARALLEL
BUN_PARALLEL_COMPACT \
  'server/tests/check/basic' \
  'server/tests/attach/basic'

Direct command line:

# Add --compact flag
bun scripts/testScripts/runTests.ts server/tests/attach/upgrade --compact

# Combine with other options
bun scripts/testScripts/runTests.ts server/tests/attach/upgrade --compact --max=10

When to Use Compact Mode

• ✅ Running 20+ test files (like in g1.sh)
• ✅ CI/CD pipelines with limited scrollback
• ✅ When you only care about failures
• ❌ Debugging specific tests (use full mode to see progress)
• ❌ Running < 10 test files

Adding New Test Groups

1. Create a new script in scripts/testGroups/
2. Use the TypeScript runner for new tests:

   bun scripts/testScripts/runTests.ts server/tests/your/tests
   

3. For large test suites, use BUN_PARALLEL_COMPACT instead of BUN_PARALLEL
4. Update this README with the test group details