@edgelogistics/eslint-plugin-backend-nodejs-typescript

ESLint config preset for Node.js + TypeScript backend projects at EdgeLogistics.

Requisitos

• eslint >= 8.x
• typescript >= 4.7.x
• @typescript-eslint/parser ^6.x (incluido como peer dependency)

Instalación

npm install @edgelogistics/eslint-plugin-backend-nodejs-typescript --save-dev

Uso

En tu .eslintrc.js:

module.exports = {
  extends: ['plugin:@edgelogistics/backend-nodejs-typescript/recommended'],
};

O si usas Flat Config (eslint.config.js):

const backendPlugin = require('@edgelogistics/eslint-plugin-backend-nodejs-typescript');

module.exports = [...backendPlugin.configs.recommended];

Desarrollo Local

Instalación de dependencias

npm install

Probar cambios localmente

Para probar el plugin en otro proyecto sin publicar a npm:

# 1. En el directorio del plugin, crear un link simbólico
npm link

# 2. En el proyecto que quiere usar el plugin
npm link @edgelogistics/eslint-plugin-backend-nodejs-typescript

Para desvincular:

# En el proyecto que usaba el plugin
npm unlink @edgelogistics/eslint-plugin-backend-nodejs-typescript

# En el directorio del plugin (opcional, para limpiar)
npm unlink

Usar directamente desde file: (alternativa a npm link)

En el package.json del proyecto que quiere usar el plugin:

{
  "devDependencies": {
    "@edgelogistics/eslint-plugin-backend-nodejs-typescript": "file:../eslint-backend-nodejs-typescript"
  }
}

Luego:

npm install

Lint y format del propio plugin

npm run lint    # Solo lint
npm run format  # Format + lint fix

Publicar a npm

Este proyecto usa semantic-release para releases automáticos.

Flujo de release

1. Haz tus cambios en una rama
2. Commitea siguiendo Conventional Commits:
   • feat: nuevo rule → patch release
   • fix: correccion de bug → patch release
   • feat!: cambio breaking → major release
3. Haz merge a master (via PR)
4. El pipeline ejecutará npm run release automáticamente

Release manual

npm run release

Esto publicá a npm usando el versionado semántico basado en los commits.

Estructura del proyecto

src/
├── index.js      # Entry point del plugin
├── plugins.js    # Lista de plugins que se importan
├── rules.js      # Todas las reglas configuradas
└── config.js     # Configuración del preset 'recommended'

Changelog

Ver CHANGELOG.md para el historial de versiones.