update

readme.md

@@ -817,6 +817,47 @@ const performanceConfig = {
 
 MIT License - see LICENSE file for details.
 
+## Testing
+
+### Comprehensive Test Suite
+
+DcRouter includes a comprehensive test suite covering all aspects of the system:
+
+#### SMTP Protocol Tests
+- **Commands**: EHLO, HELO, MAIL FROM, RCPT TO, DATA, RSET, NOOP, QUIT, VRFY, EXPN, HELP
+- **Extensions**: SIZE, PIPELINING, STARTTLS
+- **Connection Management**: TLS/plain connections, timeouts, limits, rejection handling
+- **Error Handling**: Syntax errors, invalid sequences, temporary/permanent failures
+- **Email Processing**: Basic sending, multiple recipients, large emails, invalid addresses
+- **Security**: Authentication, rate limiting
+- **Performance**: Throughput testing
+- **Edge Cases**: Very large emails, special characters
+
+#### Running Tests
+
+```bash
+# Run all tests
+pnpm test
+
+# Run specific test categories
+tsx test/suite/commands/test.ehlo-command.ts
+tsx test/suite/connection/test.tls-connection.ts
+tsx test/suite/email-processing/test.basic-email.ts
+
+# Run with verbose output
+tstest test/suite/security/test.authentication.ts --verbose
+```
+
+### Test Infrastructure
+
+The test suite uses a self-contained pattern where each test:
+1. Starts its own SMTP server instance
+2. Runs comprehensive test scenarios
+3. Cleans up all resources
+4. Provides detailed logging for debugging
+
+This ensures tests are isolated, reliable, and can run in parallel.
+
 ## Support
 
 - Documentation: [https://docs.serve.zone/dcrouter](https://docs.serve.zone/dcrouter)