TypeScript Code Doctrine

TypeScript is NOT optional. We use it to structurally guarantee application integrity at build time, not merely for editor autocompletion.

The Iron Law

Never use any unless absolutely necessary and heavily justified with a comment.

Core Principles

1. Strict Everything: Ensure strict: true is in tsconfig.json. This implies no implicit anys and strict null checks.
2. Layered Architecture: Use strict DTOs (Data Transfer Objects) and clear interfaces for communication between your Controllers, Services, and Repositories.
3. Interfaces vs Types: Use interface for structural definitions (objects, classes) and extendibility. Use type for unions, intersections, and primitives. Be consistent.
4. Enums are Banned: Avoid TS enum. They transpile to bloated reverse-mapped objects and cause runtime vs build-time confusion. Use const objects or union types (type Status = 'active' | 'inactive').

Best Practices