Tresdoce NestJS Toolkit

Este toolkit está pensada para ser utilizado en NestJS Starter, o cualquier proyecto que utilice una configuración centralizada, siguiendo la misma arquitectura del starter.

Glosario

• 🥳 Demo
• 📝 Requerimientos básicos
• 💻 Scripts
• 🧰 Toolkit
• 📤 Commits
• 📜 License MIT

📝 Requerimientos básicos

• NestJS Starter
• Node.js v20.19.0 or higher (Download)
• YARN v1.22.22 or higher
• NPM v11.2.0 or higher
• NestJS v11.1.0 or higher (Documentación)
• Lerna

💻 Scripts

Instalar Lerna

npm i -g lerna

Instalar dependencias del monorepo

yarn install

Crear paquetes

yarn plop

Transpilar paquetes

yarn build

Test paquetes

yarn test

🧰 Toolkit

Los módulos de la siguiente lista, están pensados para ser consumidos por el NestJS Starter, siguiendo los lineamientos de schematics.

⚠️ Es recomendable utilizar las versiones stables, ya que las versiones beta están pensadas para ser utilizadas a modo de testing y pueden generar conflictos en el código.

Package	Descripción	Versión	Changelog
@tresdoce-nestjs-toolkit/archetype	Módulo informativo de la app		Changelog
@tresdoce-nestjs-toolkit/aws-sqs	Módulo de cola de mensajes de AWS Simple Queue Service		Changelog
@tresdoce-nestjs-toolkit/camunda	Módulo de procesos BPMN con Camunda		Changelog
@tresdoce-nestjs-toolkit/commons	Centralización de configuraciones		Changelog
@tresdoce-nestjs-toolkit/core	Funcionalidades a nivel core		Changelog
@tresdoce-nestjs-toolkit/dynamoose	Módulo de base de datos DynamoDB - Dynamoose		Changelog
@tresdoce-nestjs-toolkit/elk	Módulo de ElasticSearch Stack		Changelog
@tresdoce-nestjs-toolkit/filters	Librería para filtrar y formatear las excepciones		Changelog
@tresdoce-nestjs-toolkit/health	Módulo health checks liveness y readiness		Changelog
@tresdoce-nestjs-toolkit/http-client	Módulo http request con axios y axios-retry		Changelog
@tresdoce-nestjs-toolkit/mailer	Módulo para envíos de mail		Changelog
@tresdoce-nestjs-toolkit/paas	Librería centralizada de funcionalidades cross		Changelog
@tresdoce-nestjs-toolkit/qrcode	Módulo para crear códigos QR		Changelog
@tresdoce-nestjs-toolkit/rate-limit	Módulo para limitar los requests por segundo a los controllers		Changelog
@tresdoce-nestjs-toolkit/redis	Módulo de Redis para cache		Changelog
@tresdoce-nestjs-toolkit/response-parser	Interceptor de formateo de respuesta		Changelog
@tresdoce-nestjs-toolkit/snowflake-uid	Módulo de SnowFlake ID		Changelog
@tresdoce-nestjs-toolkit/test-utils	Utilities para testing		Changelog
@tresdoce-nestjs-toolkit/tracing	Módulo de traza con OpenTelemetry		Changelog
@tresdoce-nestjs-toolkit/typeorm	Módulo de ORM para base de datos		Changelog
@tresdoce-nestjs-toolkit/utils	Utilitarios para proyectos y librerías		Changelog

📤 Commits

Para los mensajes de commits se toma como referencia conventional commits.

<type>[optional scope]: <description>

[optional body]

[optional footer]

• type: chore, docs, feat, fix, refactor, test (más comunes)
• scope: indica la página, componente, funcionalidad
• description: comienza en minúsculas y no debe superar los 72 caracteres.

Ejemplo Commit

git commit -m "docs(core): add documentantion to readme core module"

Commit Breaking Change

git commit -am 'feat!: changes in application'

Made with ❤️

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

2.0.5 (2025-04-27)

👨‍💻 Chores

• update dependencies (97722a2)

2.0.4 (2025-04-03)

👨‍💻 Chores

• update dependencies (08e897d)

2.0.3 (2025-04-01)

👨‍💻 Chores

• update dependencies (6757fe2)

2.0.2 (2025-03-06)

👨‍💻 Chores

• update nestjs dependencies (604e008)
• updates (912ebda)

📝 Docs

• update version of badges (fd58d80)

2.0.1 (2025-01-20)

👨‍💻 Chores

• update dependencies (3e5acb5)

2.0.0 (2025-01-16)

⚠ BREAKING CHANGES

• update nestjs to v11

✨ Features

• update nestjs to v11 (ed37cd6)

📝 Docs

• edit versions of nestjs and npm (668aa40)

1.2.8 (2024-12-19)

👨‍💻 Chores

• update dependencies (6d88d49)

1.2.7 (2024-12-06)

👨‍💻 Chores

• update dependencies (6291d15)

1.2.6 (2024-11-27)

🐛 Bug Fixes

• resolve files to pack (915312c)

👨‍💻 Chores

• update dependencies (5c2af4d)

📝 Docs

• edit versions (132ea67)

1.2.5 (2024-11-25)

🐛 Bug Fixes

• resolve problem with package list to publish (23fe12d)
• rollback ts version (30e3d27)

👨‍💻 Chores

• update dependencies (bf0400c)

📝 Docs

• edit badges (c36edaa)

1.2.4 (2024-11-22)

📝 Docs

• edit badges (a146f14)

1.2.3 (2024-11-22)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

1.2.2 (2024-11-22)

👨‍💻 Chores

• edit versions (d887fd7)

1.2.1 (2024-11-22)

👨‍💻 Chores

• edit versions (2431c3e)

1.2.0 (2024-11-22)

✨ Features

• update dependencies and monorepo (ee38f92)

1.1.5 (2024-11-07)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

1.1.4 (2024-11-05)

👨‍💻 Chores

• edit eslint config (3952c6d)
• update dependencies (74862c6)

📝 Docs

• update version of node npm and nestjs (d66dfd3)

1.1.3 (2024-09-24)

👨‍💻 Chores

• update badges version (02ad466)
• update dependencies (7a92e4a)

1.1.2 (2024-07-29)

👨‍💻 Chores

• this project is compatible with node 18, 20 and 22 (dcdeb1b)

1.1.1 (2024-07-22)

👨‍💻 Chores

• edit to changes (69a03c1)
• update dependencies (5b05a58)

📝 Docs

• readmes: edit isologo nestjs of documentation (2a3c2b9)

1.1.0 (2024-07-03)

✨ Features

• core: add params decorator to pagination, sorting and filter (ef418e1)

👨‍💻 Chores

• add type yo archetype (7f0b3d1)
• add types (1559038)
• change node to v18.20.3 (4368ba4)
• update dependencies (f8055ac)
• update dependencies and documentation (9e0435d)

📝 Docs

• update badges versions (17a42ac)

1.0.3 (2024-01-16)

👨‍💻 Chores

• update dependencies to fix vulnerabilities (fa96999)

1.0.2 (2023-09-23)

👨‍💻 Chores

• update nestjs dependencies (8ad00ff)

1.0.1 (2023-08-29)

👨‍💻 Chores

• update dependencies (15fc47c)

📝 Docs

• edit link to demo nestjs starter (3371a42)

1.0.0 (2023-08-16)

⚠ BREAKING CHANGES

• upgrade to nestjs 10.1.3 and others libs

✨ Features

• upgrade to nestjs 10.1.3 and others libs (81db096)

🐛 Bug Fixes

• update libs and resolve problem with testcontainers (b79d094)

👨‍💻 Chores

• add jest junit (4962608)
• delete junit.xml file (d9f1c8e)
• edit gitigno (ca57424)
• remove junit archetype (dcb79ea)
• remove pretest script in packages (668c420)
• update dependencies to latest versions (3babf06)
• work with eslint (140515a)

📝 Docs

• edit versions in readmes (a966161)

0.4.3 (2023-07-17)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.4.2 (2023-07-08)

📝 Docs

• edit readme (5cf8db6)

0.4.1 (2023-05-25)

👨‍💻 Chores

• update dependencies (70808e2)

0.4.0 (2023-05-19)

🐛 Bug Fixes

• jest-reporter: remove fileName in suitesChilds and fix bug 2 describe with same testcase name (d5a20fe)

✨ Features

• add jest mochawesome report (3ec8286)
• core: add app stage param (a9d53d1)

👨‍💻 Chores

• delete test results (1a98b93)
• edit scripts and husky (e68ebac)
• jest-report: disabled auto open (2d57f6c)
• jest-reporter (5b99c1b)
• jest-reporter: generate jest reporter (cd78f21)
• jest-reporter: separete test generator and add speed in test (8a2568b)
• jest-reporter: work with fixes (2550bbc)
• jest-reporter: work with fixes in error test (a63a2b7)
• re install dependencies (37f3854)
• remove test reports (91dfcf5)
• update dependencies (bb50d6a)
• upload reports (0241b2b)

0.3.0 (2023-04-08)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.3.0-beta.0 (2023-04-08)

👨‍💻 Chores

• edit script test (d9f549f)
• resolve mailer module test and remove build types of pika (36dbf31)

✨ Features

• update dependencies (dabe1da)

0.2.1 (2023-01-25)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.2.1-beta.0 (2023-01-25)

🐛 Bug Fixes

• archetype: rename manifest to info controller (59ef162)

📝 Docs

• archetype: edit readme (b4c7302)

0.2.0 (2023-01-24)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.2.0-beta.0 (2023-01-24)

✨ Features

• health: add ping check to redis (9d48d7d)

👨‍💻 Chores

• changes in tsconfigs (73f1198)
• update dependencies (c5f119b)
• update version of nestjs badge (1a45d4f)

0.1.4 (2022-12-18)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.1.4-beta.0 (2022-12-18)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.1.3 (2022-11-19)

📝 Docs

• replace url of demo (81a8728)

🐛 Bug Fixes

• resolve problem with build pkgs and changes in scripts (f2d43dd)

0.1.2 (2022-09-09)

📝 Docs

• edit url demo starter (74f1569)

0.1.1 (2022-07-15)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.1.1-beta.0 (2022-07-15)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.1.0 (2022-07-13)

Note: Version bump only for package @tresdoce-nestjs-toolkit/archetype

0.1.0-beta.3 (2022-07-06)

👨‍💻 Chores

• edit scripts (54d07a2)

0.1.0-beta.2 (2022-06-01)

👨‍💻 Chores

• root: edit description of table toolkit (05969a0)

0.1.0-beta.1 (2022-05-18)

👨‍💻 Chores

• edit package json (576cdc6)
• test-utils: add functions and test (289ba05)

📝 Docs

• readme: edit badge of version (e82e040)

0.1.0-beta.0 (2022-04-12)

✨ Features

• archetype: add archetype module (ef9003b)

👨‍💻 Chores

• archetype: resolve code smell (4f6faae)

📝 Docs

• archetype: add documentation (85c917f)