rudemex / node-typescript-express-starter Goto Github PK

• 📝 Requerimientos básicos
• 🛠️ Instalar dependencias
• ⚙️ Configuración
• 💻 Scripts
• 📚 Swagger
• 📤 Commits
• 😝 Mocks

• Node.js v10.15.3 or higher (Download)
• NPM v6.4.1 or higher
• Typescript
• Mock Json Server

Cuando tenemos los requisitos básicos, clonamos el repositorio, vamos a la carpeta del proyecto e instalamos sus dependencias.

 npm install

Esta aplicación utiliza la dependencia de config para facilitar la configuración de las variables del entorno, lo que la hace escalable y robusta al desplegar la aplicación en diferentes entornos.

En el directorio ./config se encuentra un archivo llamado development.json que contiene la configuración para un entorno local, mientras que el archivo custom-environment-variables.json obtiene los valores por medio de los key definidos en las variables de entorno que se configuran en el el servidor.

Básicamente el archivo funciona como un objeto que se exporta y puede ser consumido invocándolo en el archivo que requiere utilizar la información cargada. Si se necesita añadir más datos para consumir, como la conexión a una base de datos, a una redis, la url de algún micro-servicio, API, etc. sólo hay que añadirlo en los archivos mencionados manteniendo el esquema.

{
  "server": {
    "port": 8080,
    "context": "/api",
    "origins": "http://localhost:3000,http://localhost:3001,http://localhost:8080",
    "originsReadOnly": "http://localhost:3001",
    "headersAllowed": "Content-Type,Authorization,Set-Cookie,Access-Control-Allow-Origin,Cache-Control,Pragma",
    "methodsAllowed": "GET,HEAD,PUT,POST,DELETE,PATCH,OPTIONS",
    "corsCredentials": "false",
    "corsEnabled": "true",
    "tz": "America/Argentina/Buenos_Aires",
    "showLogInterceptor": "false",
    "enabledLogs": "true"
  },
  "swagger": {
    "path":'api-docs',
    "enabled": "true"
  },
  "params": {
  },
  "services": {
  }
}

{
  ...
  "params": {
    "my-param": "<param-value>"
  },
  ...
}

{
  ...
  "services": {
    "my-microservice": "<url-my-microservice>"
  },
  ...
}

Inicia la aplicación en modo desarrollo usando nodemon y ts-node para hacer hot reloading.

npm run dev

Ejecuta la aplicación mockeada.

npm run mock

Transpile la aplicación limpiando primero la carpeta de destino ./dist.

npm run build

Inicia la aplicación de transpilada de la carpeta ./dist, se requiere previamente haber realizado el build.

npm run start

Inicia la fake app para correr los unit test con Jest y retorna el coverage.

npm run test

El proyecto cuenta con un Swagger que tiene documentado los endpoints con sus definiciones.

Para documentar los nuevos endpoints, se debe completar con la información de los mismos con la anotación en YAML en el archivo api-swagger.yaml que está en el root del proyecto.

Esta documentación puede ser activada o desactivada desde el archivo de configuración o en las variables de entorno del proyecto.

// ./config/development.json
{
  ...
  "swagger": {
    "path": 'api-docs',
    "enabled": "true"
  },
  ...
}

// ENV
SWAGGER_PATH=api-docs
SWAGGER_ENABLED=true;

Acceso a la documentación y testeo de los endpoints: http://localhost:8080/api-docs

<http|https>://<server_url><:port>/<path>

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 (más comunes)
• scope: indica la página, componente, funcionalidad
• description: comienza en minúsculas y no debe superar los 72 caracteres.

Para generar el Mock del endpoint, hay que generar un archivo javascript dentro del directorio ./mock/api correspondiente al endpoint.

El archivo del mock es un objeto json exportado como modulo, el cual tiene que tener la definición de la ruta, el método, el parámetro (en caso de que sea necesario), y la respuesta.

// ./mock/api/posts.js

module.exports = {
    '/api/posts': {
        get: [
            {
                userId: 1,
                id: 1,
                title:
                    'sunt aut facere repellat provident occaecati excepturi optio reprehenderit',
                body:
                    'quia et suscipit suscipit recusandae consequuntur expedita et cum reprehenderit molestiae ut ut quas totam nostrum rerum est autem sunt rem eveniet architecto',
            },
            ...{
                userId: 1,
                id: 2,
                title: 'qui est esse',
                body:
                    'est rerum tempore vitae sequi sint nihil reprehenderit dolor beatae ea dolores neque fugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis qui aperiam non debitis possimus qui neque nisi nulla',
            },
        ],
        post: {
            userId: 1,
            id: 1,
            title:
                'sunt aut facere repellat provident occaecati excepturi optio reprehenderit',
            body:
                'quia et suscipit suscipit recusandae consequuntur expedita et cum reprehenderit molestiae ut ut quas totam nostrum rerum est autem sunt rem eveniet architecto',
        },
    },
    '/api/posts/:id': {
        get: {
            userId: 1,
            id: 1,
            title: 'eum et est occaecati',
            body:
                'ullam et saepe reiciendis voluptatem adipisci sit amet autem assumenda provident rerum culpa quis hic commodi nesciunt rem tenetur doloremque ipsam iure quis sunt voluptatem rerum illo velit',
        },
    },
};

Una vez generado el archivo con la definición del endpoint junto a su respuesta, hay que requerirlo en el archivo routes.js que se encuentra en ./mock/api.

// ./mock/api/routes.js

const routes = {
    ...require('./posts'),
    ...
    ...require('./another-end-point'),
};

module.exports = routes;

Made with ❤