Creación de entidades ORM con decoradores en TypeScript

Contenido del curso

Fundamentos y Primer CRUD

Base de Datos y Persistencia con TypeORM

Autenticación y Autorización

Tu API Completa

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:009:17

Creación de entidades ORM con decoradores en TypeScript

Curso de Backend con NestJS

Clase 13 de 35

Clase 13 / 35

Recursos

Desarrollar aplicaciones modernas requiere gestionar datos de manera eficiente y segura. Entender cómo crear entidades con un ORM en TypeScript permite estructurar la información siguiendo principios sólidos de la programación orientada a objetos, facilitando así la persistencia y adaptabilidad de proyectos en distintos motores de base de datos.

¿Qué ventajas ofrece usar un ORM en proyectos TypeScript?

Los ORMs permiten definir entidades y sus atributos directamente en el código usando clases y decoradores. Puedes especificar restricciones, tipos de datos como varchar, e incluso longitudes máximas de las columnas. Además, los ORMs ofrecen abstracción del motor: si decides cambiar de PostgreSQL a MySQL solo adaptas el driver de conexión, sin modificar la lógica de las entidades.

Mapeo directo entre clases y tablas.
Independencia del motor de base de datos.
Facilidad para definir restricciones y atributos.

¿Cómo crear la primera entidad de usuario en TypeScript?

El proceso inicia creando una carpeta llamada Entities dentro del módulo users. Allí, generas un archivo llamado user.entity.ts, siguiendo la convención de usar clases exportadas. Los decoradores permiten definir columnas, identificadores y restricción de unicidad.

Se define un ID autoincremental usando un decorador como @PrimaryGeneratedColumn, lo que evita colisiones incluso si se eliminan registros.
Para el campo email, se especifica tipo varchar, longitud máxima de 155 y la restricción unique: true para evitar duplicados.
Los campos createdAt y updatedAt aprovechan decoradores especiales para autocalcular fechas sin intervención manual.

El uso correcto del naming es crucial. Aunque en TypeScript se emplea el camelCase, en base de datos se recomienda seguir el estándar con guion bajo, explícitamente señalado mediante la propiedad name en los decoradores.

Se define el nombre de tabla en plural, como "users", por coherencia en la base de datos.

¿Qué estructura debe tener la entidad de perfil y cómo modificar la de usuario?

Se sugiere dividir la información personal en dos entidades:

User: Solo debe contener el email y el password, enfocado exclusivamente en datos de acceso.
Profile: Debe incluir ID, createdAt, updatedAt, nombre, apellido y avatar. Esta entidad queda separada y sin relación por ahora, siguiendo los mismos principios que la de usuario.

Se recomienda ubicar la nueva entidad profile.entity.ts dentro de la carpeta entities, permitiendo mantener una estructura organizada y coherente.

No es necesario modificar DTOs ni servicios todavía, solo crear y ajustar las entidades según lo aprendido.

¿Listo para crear tus entidades y mejorar la estructura de tu proyecto? Comparte tus avances, dudas o experiencias relacionadas con ORMs y TypeScript para enriquecer el aprendizaje.

Alejandro Zapata

Hace 5 meses

Mi propuesta del reto:

user.entity.ts

import { Column, Entity, PrimaryGeneratedColumn, CreateDateColumn, UpdateDateColumn } from 'typeorm';

@Entity({ name: 'users' })
export class User {
  @PrimaryGeneratedColumn()
  id!: number;

  @Column({ type: 'varchar', length: 255 })
  username!: string;

  @Column({ type: 'varchar', length: 255, unique: true })
  email!: string;

  @Column({ type: 'text' })
  password!: string;

  @CreateDateColumn({ type: 'timestamptz', default: () => 'CURRENT_TIMESTAMP', name: 'created_at' })
  createdAt!: Date;

  @UpdateDateColumn({ type: 'timestamptz', default: () => 'CURRENT_TIMESTAMP', onUpdate: 'CURRENT_TIMESTAMP', name: 'updated_at' })
  updatedAt!: Date;
}

profile.entity.ts

import { Column, Entity, PrimaryGeneratedColumn, CreateDateColumn, UpdateDateColumn } from 'typeorm';

@Entity({ name: 'profiles' })
export class Profile {
  @PrimaryGeneratedColumn()
  id!: number;

  @Column({ type: 'varchar', length: 255 })
  name!: string;

  @Column({ type: 'varchar', length: 255, name: 'last_name' })
  lastName!: string;

  @Column({ type: 'varchar', length: 255, name: 'avatar_url' })
  avatarUrl!: string;

  @Column({ type: 'varchar', length: 255 })
  headline!: string;

  @Column({ type: 'text' })
  bio!: string;

  @CreateDateColumn({ type: 'timestamptz', default: () => 'CURRENT_TIMESTAMP', name: 'created_at' })
  createdAt!: Date;

  @UpdateDateColumn({ type: 'timestamptz', default: () => 'CURRENT_TIMESTAMP', onUpdate: 'CURRENT_TIMESTAMP', name: 'updated_at' })
  updatedAt!: Date;
}

Fundamentos y Primer CRUD

Crea una API RESTful con NestJS

Instalación del CLI de NestJS y primer proyecto con API

Creación de endpoints dinámicos para consultar usuarios en NestJS

Operaciones CRUD en APIs REST con Postman

Método PUT para actualizar usuarios con ID automático

Manejo de status codes HTTP en NestJS

DTOs y validación automática de datos en APIs con NestJS

Servicios y lógica de negocio en NestJS

Variables de entorno seguras en NestJS

Programación modular en NestJS con UserModule

Base de Datos y Persistencia con TypeORM

Configuración de PostgreSQL con Docker y Docker Compose

Configuración de PostgreSQL con TypeORM en aplicaciones NestJS

Creación de entidades ORM con decoradores en TypeScript

Repository Pattern con TypeORM en NestJS

Relaciones uno a uno entre usuarios y perfiles en PostgreSQL

Actualización de DTOs con mapped types en NestJS para perfil y usuario

Generación automática de módulos CRUD con NestJS y AI

Relación uno a muchos con TypeORM

CRUD de categorías con IA en NestJS

Relaciones many-to-many con TypeORM y validación de arrays

Reutilización de servicios entre módulos en NestJS

Migraciones en TypeORM sin perder datos

Cómo evitar perder datos al migrar columnas

Autenticación y Autorización

Hashing de contraseñas con Bcrypt en NestJS

Excluir campos sensibles con ClassTransformer

Autenticación local con Passport en NestJS

Endpoint de login con Passport en NestJS

Implementación de JSON Web Token para autenticación en NestJS

Rutas protegidas con JWT en NestJS

User ID automático desde JWT en NestJS

Tu API Completa

Autogenera resúmenes e imágenes con OpenAI en NestJS

Documentación automática de APIs con Swagger en NestJS

Preparar tu API NestJS para producción

Desplegar aplicación Node.js a producción con Railway y PostgreSQL

Desarrollo de API REST escalable con NestJS en producción

Creación de entidades ORM con decoradores en TypeScript