smoothschedule/frontend/QUICK_TEST_GUIDE.md

Quick Test Guide - useTenantExists Hook

Setup (One-time)

cd /home/poduck/Desktop/smoothschedule2/frontend
./install-test-deps.sh

Then add to package.json:

{
  "scripts": {
    "test": "vitest",
    "test:ui": "vitest --ui",
    "test:run": "vitest run",
    "test:coverage": "vitest run --coverage"
  }
}

Run Tests

# Run all tests (watch mode)
npm run test

# Run once (CI mode)
npm run test:run

# Run with UI
npm run test:ui

# Run with coverage
npm run test:coverage

# Run only useTenantExists tests
npm run test -- useTenantExists

# Run specific test by name
npm run test -- -t "returns exists: true"

Files Created

File	Location	Purpose
Test Suite	src/hooks/__tests__/useTenantExists.test.ts	19 comprehensive tests
Vitest Config	vitest.config.ts	Test runner configuration
Test Setup	src/test/setup.ts	Global test setup
Install Script	install-test-deps.sh	Dependency installation

Test Coverage

✓ All Required Tests Implemented:

1. Returns exists: true when API returns 200
2. Returns exists: false when API returns 404
3. Returns exists: false when subdomain is null
4. Returns exists: false on other API errors
5. Shows loading state while fetching
6. Caches results (5 minute staleTime)
7. Does not make API call when subdomain is null

Plus 12 additional tests for edge cases and error handling.

Expected Output

✓ src/hooks/__tests__/useTenantExists.test.ts (19)
  ✓ useTenantExists
    ✓ API Success Cases (2)
    ✓ API Error Cases (4)
    ✓ Null Subdomain Cases (3)
    ✓ Loading States (2)
    ✓ Caching Behavior (2)
    ✓ Query Key Behavior (1)
    ✓ Edge Cases (3)
    ✓ Query Retry Behavior (2)

Test Files  1 passed (1)
Tests  19 passed (19)

Troubleshooting

Issue	Solution
Cannot find module 'vitest'	Run ./install-test-deps.sh
beforeAll is not defined	Check vitest.config.ts has globals: true
document is not defined	Ensure environment: 'jsdom' in config
Tests timeout	Increase testTimeout in config

Documentation

• TEST_SUMMARY.md - Complete test suite documentation
• SETUP_TESTING.md - Detailed setup instructions
• TESTING.md - Comprehensive testing guide
• src/hooks/tests/README.md - Hook testing patterns

Next Steps

1. ✓ Test files created
2. → Install dependencies: ./install-test-deps.sh
3. → Update package.json scripts
4. → Run tests: npm run test
5. → Check coverage: npm run test:coverage

---

Quick Start:

cd /home/poduck/Desktop/smoothschedule2/frontend
./install-test-deps.sh
# Add scripts to package.json
npm run test