INTEGRACIÓN NPM n8n: AUTOMATIZAR NPM CON N8N

Esta acción te permite modificar un distribution tag existente en un paquete Npm, es decir, hacer que un tag (como "latest", "beta" o "stable") apunte a una versión específica de tu paquete. Es particularmente útil para gestionar promociones de versiones en tus pipelines de despliegue automatizados.

Parámetros clave:

• Credential to connect with: Campo desplegable requerido para seleccionar la credencial Npm previamente configurada. Ejemplo: "Npm account".
• Resource: Desplegable requerido definido en "Distribution Tag" para especificar que esta acción opera sobre tags de distribución.
• Operation: Desplegable requerido configurado en "Update" para indicar que modificarás un tag existente.
• Package Name: Campo de texto requerido donde introduces el nombre exacto del paquete Npm (ej: "express", "lodash", "my-private-package").
• Package Version: Campo de texto requerido para especificar la versión exacta del paquete (ej: "2.1.5", "1.0.0-beta.3"). Acepta input fijo o expresión dinámica.
• Distribution Tag Name: Campo de texto requerido donde defines el nombre del tag a actualizar (ej: "latest", "beta", "next", "stable"). Por defecto muestra "latest".

Casos de uso típicos: Promover automáticamente una versión "beta" a "latest" después de que tus tests de integración pasen con éxito. Actualizar el tag "stable" cuando un responsable aprueba manualmente un despliegue en producción. Crear un workflow que actualice múltiples tags ("canary", "preview") tras un merge en una rama específica de Git usando la integración GitHub.

Cuándo usarlo: Perfecto para equipos que gestionan múltiples entornos (desarrollo, staging, producción) y necesitan automatizar la promoción de versiones sin intervención manual en la CLI. Combina con acciones GitHub, GitLab o webhooks para crear pipelines completos.

Esta acción recupera la lista completa de todos los distribution tags configurados para un paquete Npm dado, junto con las versiones a las que cada tag apunta actualmente. Ideal para auditorías, sincronización de estado o dashboards de monitorización.

Parámetros clave:

• Credential to connect with: Desplegable requerido para seleccionar tu credencial Npm (ej: "Npm account").
• Resource: Desplegable requerido configurado en "Distribution Tag" para indicar que consultarás tags de distribución.
• Operation: Desplegable requerido en "Get All" para recuperar todos los tags del paquete.
• Package Name: Campo de texto requerido donde especificas el nombre del paquete Npm a consultar. Acepta valor fijo o expresión para input dinámico.

Casos de uso: Esta acción es especialmente útil para workflows de auditoría o sincronización. Por ejemplo, consulta periódicamente los tags de tus paquetes críticos y almacena el resultado en una base de datos (Airtable, PostgreSQL) para seguimiento histórico. O bien, compara los tags actuales con una configuración esperada y envía una alerta Slack si detectas una diferencia (tag "latest" apuntando a una versión no esperada).

Cuándo usarlo: Cuando necesitas visibilidad sobre el estado de distribución de tus paquetes, o cuando quieres verificar automáticamente que los tags están correctamente configurados tras un despliegue. Combina con acciones de notificación o almacenamiento para crear sistemas de monitorización robustos.

Esta acción ejecuta una búsqueda en el registro Npm según criterios que defines, retornando una lista paginada de paquetes correspondientes a tu consulta. Útil para descubrimiento automatizado de paquetes o monitorización de publicaciones.

Parámetros clave:

• Credential to connect with: Desplegable requerido para seleccionar tu cuenta Npm autenticada.
• Resource: Desplegable requerido en "Package", indicando que la búsqueda se efectúa sobre paquetes.
• Operation: Desplegable requerido en "Search" para lanzar una búsqueda.
• Query: Campo de texto opcional donde introduces tu término de búsqueda (ej: "react ui components", "typescript utilities"). Si lo dejas vacío, realizarás una búsqueda amplia o puedes proporcionar un valor dinámico vía expresión.
• Limit: Entrada numérica opcional que especifica el número máximo de resultados a retornar (valor por defecto: 10). Ajusta según tus necesidades (5, 20, 50...).
• Offset: Entrada numérica opcional para la paginación. Define cuántos resultados saltar desde el inicio (valor por defecto: 0). Útil para recuperar resultados en múltiples páginas.

Casos de uso: Automatiza la detección de nuevos paquetes en un dominio específico (ej: busca cada semana "graphql plugins" y notifica a tu equipo si aparecen novedades), o crea un workflow que busca paquetes matching con una keyword y los añade a una lista de candidatos para evaluación. Combina con acciones de almacenamiento o notificación para construir sistemas de veille tecnológica.

Esta acción lista todas las versiones publicadas de un paquete Npm específico, permitiéndote conocer el historial completo de releases disponibles. Esencial para workflows de actualización o análisis de dependencias.

Parámetros clave:

• Credential to connect with: Desplegable requerido para autenticar con tu cuenta Npm.
• Resource: Desplegable requerido en "Package", definiendo que operas sobre un paquete.
• Operation: Desplegable requerido en "Get Versions" para recuperar la lista de versiones.
• Package Name: Campo de texto requerido donde introduces el nombre exacto del paquete (ej: "lodash", "axios", "my-company-lib").

Casos de uso: Consulta periódicamente las versiones de tus dependencias críticas y compara con las versiones actualmente utilizadas en tus proyectos. Envía una alerta cuando una nueva versión major está disponible, o actualiza automáticamente un fichero de seguimiento. Combina con acciones de bases de datos o notificaciones para crear dashboards de gestión de dependencias.

Cuándo usarlo: Cuando gestionas actualizaciones de dependencias a escala, o cuando necesitas verificar la disponibilidad de versiones específicas antes de lanzar un proceso de migración. Útil también para workflows de compliance que documentan las versiones de paquetes utilizadas en producción.

Esta acción recupera los metadatos completos de un paquete Npm: descripción, autor, licencia, dependencias, repositorio, palabras clave, y mucho más. Permite un análisis detallado de un paquete antes de su integración o para fines de documentación automatizada.

Parámetros clave:

• Credential to connect with: Desplegable requerido para seleccionar tus credenciales Npm.
• Resource: Desplegable requerido en "Package", indicando que consultarás un paquete.
• Operation: Desplegable requerido en "Get Metadata" para obtener información detallada.
• Package Name: Campo de texto requerido con el nombre exacto del paquete Npm a consultar.
• Package Version: Campo de texto opcional para especificar una versión particular (ej: "2.1.0"). Si lo dejas vacío o introduces "latest", recuperarás los metadatos de la versión más reciente del paquete.

Casos de uso: Antes de integrar un paquete en tu proyecto, consulta automáticamente sus metadatos para verificar la licencia (¿MIT? GPL?), el mantenimiento activo (fecha de última publicación), o las dependencias que introduce. Almacena estos metadatos en una base de datos para análisis posterior, o genera automáticamente reportes de compliance sobre las licencias de tus dependencias. Combina con acciones de notificación para alertar si un paquete tiene una licencia incompatible con tu política empresarial.

Cuándo usarlo: Esencial para workflows de auditoría de seguridad (verificar que un paquete no tiene vulnerabilidades conocidas consultando metadatos externos), para documentación automatizada (generar un fichier listando todas las dependencias con sus descripciones), o para workflows de aprobación (notificar a un responsable cuando un paquete con licencia GPL es detectado).