INTÉGRATION NPM n8n : AUTOMATISER NPM AVEC N8N

L'action "Get Metadata" vous permet de récupérer toutes les informations détaillées d'un package npm : description, auteur, licence, dépendances, scripts disponibles, et bien plus. C'est l'action idéale pour alimenter un système de documentation automatique ou surveiller les caractéristiques de vos dépendances.

Paramètres de configuration :

• Credential to connect with : Sélectionnez vos identifiants npm configurés. Ce champ est requis pour authentifier la requête.
• Resource : Menu déroulant fixé sur "Package" — indique que l'action cible un package npm.
• Operation : Menu déroulant fixé sur "Get Metadata" — définit l'opération à effectuer.
• Package Name : Champ texte requis où vous entrez le nom exact du package (ex: "lodash", "express").
• Package Version : Champ texte optionnel. Laissez vide ou indiquez "latest" pour obtenir les métadonnées de la dernière version, ou spécifiez une version précise (ex: "4.17.21").

Cas d'usage typiques :

• Créer un inventaire automatique de toutes vos dépendances avec leurs licences
• Vérifier si un package a changé de mainteneur
• Alimenter un dashboard avec les informations de vos packages internes

Cette action récupère la liste complète de toutes les versions publiées d'un package npm. Particulièrement utile pour le monitoring de dépendances ou la création d'alertes sur les nouvelles releases.

Paramètres de configuration :

• Credential to connect with : Sélectionnez vos identifiants npm. Ce paramètre est requis.
• Resource : Défini sur "Package" pour cibler un package npm.
• Operation : Défini sur "Get Versions" pour lister toutes les versions.
• Package Name : Champ texte requis pour spécifier le package à interroger.

Cas d'usage typiques :

• Détecter automatiquement quand une nouvelle version d'une dépendance est publiée
• Comparer les versions installées dans vos projets avec les dernières disponibles
• Générer un changelog des nouvelles versions de vos propres packages

Quand l'utiliser : Cette action est parfaite dans un workflow de monitoring qui s'exécute périodiquement (toutes les heures, par exemple) pour vérifier si de nouvelles versions sont apparues.

L'action de recherche vous permet d'interroger le registre npm avec des mots-clés, exactement comme vous le feriez sur npmjs.com. Idéal pour découvrir des packages ou créer des outils de veille technologique automatisés.

Paramètres de configuration :

• Credential to connect with : Vos identifiants npm (requis).
• Resource : Défini sur "Package".
• Operation : Défini sur "Search" pour effectuer une recherche.
• Query : Champ texte optionnel pour votre terme de recherche. Laissez vide pour une recherche large, ou entrez des mots-clés précis.
• Limit : Nombre optionnel de résultats à retourner (défaut : 10). Ajustez selon vos besoins.
• Offset : Nombre optionnel pour la pagination. Commencez à 0, puis incrémentez de la valeur du Limit pour paginer.

Cas d'usage typiques :

• Veille automatique sur les nouveaux packages dans une catégorie (ex: "react hooks")
• Création d'un rapport hebdomadaire des packages populaires dans votre stack
• Recherche automatisée de packages pour des audits de sécurité

Les tags de distribution npm (comme "latest", "beta", "next") permettent d'identifier rapidement des versions spécifiques. Cette action récupère tous les tags configurés pour un package donné.

Paramètres de configuration :

• Credential to connect with : Identifiants npm (requis).
• Resource : Défini sur "Distribution Tag".
• Operation : Défini sur "Get All" pour récupérer tous les tags.
• Package Name : Champ texte requis spécifiant le package dont vous voulez les tags.

Cas d'usage typiques :

• Surveiller quand le tag "latest" pointe vers une nouvelle version
• Détecter la création de nouveaux tags (beta, canary, etc.)
• Synchroniser les informations de tags vers votre documentation interne

Quand l'utiliser : Combinez cette action avec "Get Package Versions" pour avoir une vue complète de l'état de publication d'un package.

Cette action permet de modifier un tag de distribution pour qu'il pointe vers une version spécifique de votre package. Essentielle pour automatiser vos processus de release via Jenkins ou GitLab CI.

Paramètres de configuration :

• Credential to connect with : Identifiants npm avec permissions d'écriture (requis).
• Resource : Défini sur "Distribution Tag".
• Operation : Défini sur "Update" pour modifier un tag.
• Package Name : Champ texte requis — le nom de votre package npm.
• Package Version : Champ texte requis — la version vers laquelle le tag doit pointer (ex: "2.1.0").
• Distribution Tag Name : Champ texte requis — le nom du tag à mettre à jour (ex: "latest", "beta").

Cas d'usage typiques :

• Automatiser la promotion d'une version beta vers latest après validation
• Mettre à jour le tag "stable" après une période de test réussie
• Créer un workflow de rollback qui repositionne "latest" sur une version antérieure

Quand l'utiliser : Intégrez cette action dans vos pipelines CI/CD. Par exemple, après qu'une version beta a passé tous les tests pendant 7 jours, déclenchez automatiquement la mise à jour du tag "latest".