Persisting Data with TypeORM

When to use

• Adding persistence to a feature
• Refactoring leaky ORM usage (entities with @Entity() in domain)
• Handling transactions across aggregates

Core rules

1. Domain entities: no ORM decorators, live in domain/
2. ORM models (with @Entity()) live in infrastructure/
3. Repository port in application/ports/, TypeORM implementation in infrastructure/
4. Transactions explicit via QueryRunner or @Transaction() decorator
5. Map between domain entity ↔ ORM model in repository

Reference shape (TypeScript)