# nestjs-common

Librería compartida para proyectos basados en NestJS, diseñada para contener utilidades, abstracciones e implementaciones comunes (transporte, caché, HTTP, etc.).

- Framework base: `@nestjs/common@^11.0.0`
- Manejador de paquetes: [`bun`](https://bun.sh) v1.2.15

---

## 🚀 Instalación

```bash
bun add @apex/nestjs-common
```

## 📌 Buenas prácticas y contribución

Si vas a colaborar o agregar nuevas funcionalidades, **por favor sigue estas pautas**:

- Mantén la estructura de carpetas organizada por dominio funcional (por ejemplo: `cache/`, `http/`, etc.).
- Usa nombres coherentes y consistentes con los ya existentes.
- Agrega pruebas unitarias si introduces lógica nueva o compleja.
- Pasa `bun lint` o `bun check` antes de hacer commits.

```

## 📦 Versionado semántico (SemVer)

Esta librería utiliza [versionado semántico](https://semver.org/lang/es/):

x.y.z
│ │ └─ Parches (z): Correcciones de bugs que no rompen la API.
│ └─── Menores (y): Nuevas funcionalidades compatibles.
└───── Mayores (x): Cambios incompatibles con versiones anteriores.

```

> 🔁 **IMPORTANTE**: Siempre que hagas un cambio, **actualiza la versión** en `package.json` correctamente.  
> Ejemplo: si agregas una nueva función compatible → `x.y+1.z`  
> Si haces un cambio que rompe compatibilidad → `x+1.0.0`