📘 Tutorial TypeScript con Node.js y Express. ¡Crea tu API REST con tipos estáticos DESDE CERO!

En este tutorial, aprenderás cómo crear una API REST utilizando TypeScript, Node.js y Express. TypeScript es un lenguaje de programación que extiende JavaScript agregando tipos estáticos, lo cual te permite reducir errores durante el desarrollo y tener un código más robusto.

Antes de comenzar, asegúrate de tener Node.js instalado en tu máquina. Puedes descargarlo desde https://nodejs.org.

Paso 1: Configuración del proyecto

Lo primero que debemos hacer es crear una nueva carpeta para nuestro proyecto. Abre tu terminal y ejecuta el siguiente comando:

mkdir tutorial-typescript

Luego, ingresa al directorio recién creado:

cd tutorial-typescript

Ahora, inicialicemos nuestro proyecto de Node.js ejecutando el siguiente comando:

npm init -y

Este comando creará un archivo package.json con la configuración básica de nuestro proyecto.

Paso 2: Instalación de dependencias

Para poder utilizar TypeScript, necesitamos instalarlo como una dependencia de desarrollo. Ejecuta el siguiente comando:

npm install typescript --save-dev

También necesitaremos instalar los tipos de TypeScript para Node.js y Express:

npm install @types/node @types/express --save-dev

Además, instalaremos Express como una dependencia regular:

npm install express

Ahora que tenemos todas las dependencias instaladas, podemos pasar al siguiente paso.

Paso 3: Configuración de TypeScript

En la raíz de tu proyecto, crea un archivo llamado tsconfig.json con la siguiente configuración:

{
"compilerOptions": {
"target": "es6",
"module": "commonjs",
"outDir": "dist",
"strict": true,
"esModuleInterop": true
},
"include": [
"src/**/*.ts"
],
"exclude": [
"node_modules"
]
}

Esta configuración le indica al compilador de TypeScript cómo debe transpilar nuestro código y dónde debe colocar los archivos de salida.

Paso 4: Creación de la API REST

Crea una carpeta llamada src en la raíz de tu proyecto. Dentro de esta carpeta, crea un archivo llamado index.ts con el siguiente código:

import express, { Request, Response } from 'express';

app.listen(port, () => {
console.log(`Servidor corriendo en http://localhost:${port}`);
});

En este código, estamos importando el módulo express y las interfaces Request y Response de este módulo. Luego, estamos creando una instancia de la aplicación express y definiendo un punto de entrada en la ruta ‘/’ que devuelve un mensaje de saludo.

Finalmente, iniciamos el servidor en el puerto 3000.

Paso 5: Compilación y ejecución del proyecto

Para compilar nuestro proyecto TypeScript, ejecuta el siguiente comando:

npx tsc

Esto generará los archivos JavaScript en la carpeta dist.

Una vez que la compilación haya finalizado, puedes ejecutar tu API REST con el siguiente comando:

node dist/index.js

¡Felicidades! Ahora podrás acceder a tu API REST en http://localhost:3000 y ver el mensaje de saludo.

En este tutorial, has aprendido cómo crear una API REST utilizando TypeScript, Node.js y Express. Has visto cómo configurar el proyecto, instalar las dependencias necesarias, configurar TypeScript y crear una API básica. Ahora puedes explorar y expandir tu API agregando más rutas, controladores y lógica de negocio.

¡Diviértete creando tu propia API REST con tipos estáticos!