n8n-nodes-ovhcloud 0.0.4 → 0.0.6

package/README.md

@@ -1,29 +1,39 @@
 # n8n-nodes-ovhcloud
 
-Ce projet est un nœud communautaire n8n qui permet d'intégrer les services OVH Cloud dans vos workflows n8n.
+Nœud communautaire n8n pour interagir avec les APIs OVHcloud.
 
-[n8n](https://n8n.io/) est une plateforme d'automatisation de workflows sous [licence fair-code](https://docs.n8n.io/sustainable-use-license/).
+[n8n](https://n8n.io/) est une plateforme d’automatisation de workflows sous [licence fair-code](https://docs.n8n.io/sustainable-use-license/).
 
-## Table des matières
+## Sommaire
 
+- [Fonctionnalités](#fonctionnalités)
 - [Installation](#installation)
-- [Opérations](#opérations)
-- [Identifiants](#identifiants)
+- [Configuration des credentials OVH](#configuration-des-credentials-ovh)
+- [Opérations disponibles](#opérations-disponibles)
 - [Compatibilité](#compatibilité)
 - [Développement](#développement)
-- [License](#license)
+- [Contribution](#contribution)
+- [Licence](#licence)
 - [Ressources](#ressources)
 
+## Fonctionnalités
+
+- Ressource **Services** : lister les services, récupérer un service par ID, obtenir les formulaires, options et upgrades disponibles
+- Ressource **Me** : informations du compte, factures, dette, commandes
+- Ressource **VPS** : lister les VPS, obtenir les détails d'un VPS, lister les datacenters, créer des snapshots, gérer les disques
+- Authentification OVH via signature (`Application Key`, `Application Secret`, `Consumer Key`)
+- Support multi-endpoints : OVH Europe/Canada/USA, SoYouStart, Kimsufi
+
 ## Installation
 
-Suivez le [guide d'installation](https://docs.n8n.io/integrations/community-nodes/installation/) dans la documentation des nœuds communautaires n8n.
+Suivez le [guide d'installation des community nodes n8n](https://docs.n8n.io/integrations/community-nodes/installation/).
 
-### Installation via l'interface n8n
+### Depuis l’interface n8n
 
-1. Allez dans **Settings** > **Community Nodes**
-2. Sélectionnez **Install**
-3. Entrez `n8n-nodes-ovhcloud` dans le champ de recherche
-4. Cliquez sur **Install**
+1. Ouvrez **Settings** > **Community Nodes**
+2. Cliquez sur **Install**
+3. Recherchez `n8n-nodes-ovhcloud`
+4. Installez le package
 
 ### Installation manuelle
 
@@ -31,74 +41,106 @@ Suivez le [guide d'installation](https://docs.n8n.io/integrations/community-node
 npm install n8n-nodes-ovhcloud
 ```
 
-## Opérations
-
-### Services
-
-- **List Services** - Liste tous les services disponibles
-  - Filtrage par nom de service
-  - Filtrage par route
-  - Tri par Service ID (ascendant/descendant)
-  
-- **Get Service** - Récupère un service spécifique par son ID
-  - Supporte plusieurs types de services : Dedicated Server, Domain, Email, Hosting, etc.
-
-### Domaines (en développement)
-
-- **List Domains** - Liste tous les domaines
-- **Get Domain** - Récupère un domaine spécifique par son ID
-
-## Identifiants
-
-Ce nœud utilise l'authentification par clés API OVH. Vous devez créer une application et obtenir vos clés d'accès.
+## Configuration des credentials OVH
 
-### Configuration des identifiants
+Le nœud utilise le credential **OVH API** avec :
 
-1. Rendez-vous sur le portail de création d'applications OVH selon votre région :
-   - Europe : https://eu.api.ovh.com/createApp/
-   - Canada : https://ca.api.ovh.com/createApp/
-   - USA : https://api.us.ovhcloud.com/createApp/
+- `Endpoint`
+- `Application Key`
+- `Application Secret`
+- `Consumer Key`
 
-2. Remplissez les informations requises :
-   - **Application name** : Nom descriptif (ex: "n8n integration")
-   - **Application description** : Description de votre application
+Portails de création d’application OVHcloud :
 
-3. Récupérez vos clés :
-   - **Application Key** : Votre clé d'application
-   - **Application Secret** : Votre secret d'application
+- Europe : https://eu.api.ovh.com/createApp/
+- Canada : https://ca.api.ovh.com/createApp/
+- USA : https://api.us.ovhcloud.com/createApp/
 
-4. Générez un **Consumer Key** :
-   - Utilisez le script de génération ou créez une requête vers `/auth/credential`
-   - Définissez les droits d'accès nécessaires pour vos workflows
+### Permissions API recommandées
 
-5. Dans n8n, créez un nouveau credential "OVH API" et renseignez :
-   - **Endpoint** : Sélectionnez votre région (OVH Europe, Canada, USA, etc.)
-   - **Application Key**
-   - **Application Secret**
-   - **Consumer Key**
-
-### Droits d'accès recommandés
-
-Pour utiliser toutes les fonctionnalités du nœud, les droits suivants sont recommandés :
-
-```
+```text
+GET /me
+GET /me/bill
+GET /me/bill/*
+GET /me/debtAccount
+GET /me/order
+GET /me/order/*
 GET /services
 GET /services/*
-GET /domain
-GET /hosting/web
+GET /vps
+GET /vps/*
+GET /vps/*/snapshot
+POST /vps/*/snapshot
+GET /vps/*/disks
+GET /vps/*/disks/*
+GET /dedicated/ceph/*
+GET /dedicated/cluster/*
+GET /dedicated/housing/*
+GET /dedicated/server/*
+GET /domain/*
+GET /email/domain/*
+GET /email/pro/*
+GET /hosting/web/*
 ```
 
-Référez-vous à la [documentation API OVH](https://api.ovh.com/console/) pour plus d'informations sur les endpoints et les droits d'accès.
+## Opérations disponibles
+
+### Resource: Services
+
+- **List Services**
+   - Tri par `serviceId` (asc/desc)
+   - Filtre par nom de service (`resourceName`)
+   - Filtre par route (`routes`, liste séparée par virgules)
+- **Get Service**
+   - Sélection du type de service (Dedicated Ceph, Dedicated Cluster, Dedicated Housing, Dedicated Server, Domain, Email, Email Pro, Hosting)
+   - Sélection du service depuis une liste dynamique
+- **Get Service Forms**
+   - Récupère les formulaires disponibles pour un service spécifique
+- **Get Service Options**
+   - Récupère les options disponibles pour un service spécifique
+- **Get Service Upgrades**
+   - Liste les offres vers lesquelles un service peut être converti
+
+### Resource: Me
+
+- **Sub-resource Me**
+   - **Get My Info** (`GET /me`) : informations du compte authentifié
+- **Sub-resource Bills**
+   - **List Bills** : liste toutes les factures avec détails
+   - **Get Bill** : récupère une facture spécifique par ID
+   - Filtres disponibles : catégorie (autorenew, earlyrenewal, purchase, purchase-cloud, purchase-servers, purchase-telecom, purchase-web), `orderId`
+- **Sub-resource Debt Account**
+   - **Get Debt Account** (`GET /me/debtAccount`) : informations sur le compte de dette
+- **Sub-resource Orders**
+   - **List Orders** : liste toutes les commandes
+   - **Get Order** : récupère une commande spécifique par ID
+   - Filtres disponibles : `date.from`, `date.to`
+
+### Resource: VPS
+
+- **List VPS**
+   - Liste tous les VPS disponibles
+- **List Datacenters**
+   - Liste tous les datacenters disponibles pour l'utilisateur authentifié
+- **Get VPS Details**
+   - Récupère les détails d'un VPS spécifique
+   - Sous-ressources disponibles : Automated Backup, Available Upgrade, Backup FTP, Datacenter, Disks, Distribution, IP Country Available, IPs, Models, Option, Secondary DNS Domains, Service Infos, Snapshot, Status, VPS
+   - **Disks Operations** :
+     - List Disks : liste tous les disques d'un VPS
+     - Get Disk : récupère les détails d'un disque spécifique
+- **Create VPS Snapshot**
+   - Crée un snapshot d'un VPS
+   - Description personnalisable du snapshot
 
 ## Compatibilité
 
-Compatible avec n8n@1.60.0 ou ultérieur
+- n8n `>= 1.60.0`
 
 ## Développement
 
 ### Prérequis
 
-- Node.js (version recommandée dans le dev container)
+- Node.js
 - npm
 
 ### Installation des dépendances
@@ -107,89 +149,58 @@ Compatible avec n8n@1.60.0 ou ultérieur
 npm install
 ```
 
-### Scripts disponibles
+### Scripts
 
 ```bash
-# Compilation du projet
 npm run build
-
-# Compilation en mode watch
 npm run build:watch
-
-# Démarrage en mode développement
 npm run dev
-
-# Vérification du code (linting)
 npm run lint
-
-# Correction automatique du linting
 npm run lint:fix
-
-# Publication d'une nouvelle version
 npm run release
 ```
 
 ### Structure du projet
 
-```
+```text
 .
-├── credentials/          # Configuration des identifiants
-│   └── OvhCloudApi.credentials.ts
-├── nodes/               # Nœuds n8n
+├── credentials/
+│   ├── OvhCloudApi.credentials.ts
+│   └── OvhCloudApi.credentials.js
+├── nodes/
 │   └── OvhCloud/
 │       ├── OvhCloud.node.ts
-│       ├── listSearch/  # Fonctions de recherche
-│       └── resources/   # Ressources (services, domaines, etc.)
-├── icons/              # Icônes du nœud
-└── dist/               # Fichiers compilés
+│       ├── resources/
+│       │   ├── me.ts
+│       │   ├── services.ts
+│       │   └── vps.ts
+│       └── shared/
+│           └── OvhCloudApiClient.ts
+├── icons/
+│   ├── ovh.svg
+│   └── ovh_vertical.svg
+└── dist/
 ```
 
-### Ajout d'une nouvelle ressource
-
-1. Créez un nouveau dossier dans `nodes/OvhCloud/resources/`
-2. Implémentez les opérations dans des fichiers séparés (list.ts, get.ts, etc.)
-3. Créez un fichier index.ts pour exporter les descriptions et méthodes
-4. Ajoutez la ressource dans `nodes/OvhCloud/OvhCloud.node.ts`
-
-### Tests
-
-Pour tester votre nœud localement :
-
-1. Lancez n8n en mode développement :
-   ```bash
-   npm run dev
-   ```
+## Contribution
 
-2. n8n sera accessible à l'adresse indiquée dans la console
+Les contributions sont bienvenues.
 
-3. Créez un nouveau workflow et ajoutez le nœud "OVH Cloud"
+1. Fork du dépôt
+2. Création d’une branche (`git checkout -b feature/ma-feature`)
+3. Commit (`git commit -m "feat: ..."`)
+4. Push
+5. Ouverture d’une Pull Request
 
-## License
+## Licence
 
-[MIT License](LICENSE)
+[MIT](LICENSE)
 
 Copyright (c) 2026 Cyril MARIN
 
 ## Ressources
 
-- [Documentation des nœuds communautaires n8n](https://docs.n8n.io/integrations/#community-nodes)
-- [Documentation API OVH](https://api.ovh.com/)
-- [Console API OVH](https://api.ovh.com/console/)
-- [Guide de création d'application OVH](https://help.ovhcloud.com/csm/en-manage-ovhcloud-api-tokens?id=kb_article_view&sysparm_article=KB0042784)
-
-## Contribution
-
-Les contributions sont les bienvenues ! N'hésitez pas à :
-
-1. Fork le projet
-2. Créer une branche pour votre fonctionnalité (`git checkout -b feature/AmazingFeature`)
-3. Commit vos changements (`git commit -m 'Add some AmazingFeature'`)
-4. Push vers la branche (`git push origin feature/AmazingFeature`)
-5. Ouvrir une Pull Request
-
-## Support
-
-Pour toute question ou problème :
-
-- Ouvrez une [issue](https://github.com/ziouf/n8n-nodes-ovhcloud/issues) sur GitHub
-- Contactez l'auteur : marin.cyril@gmail.com
+- [Documentation n8n community nodes](https://docs.n8n.io/integrations/#community-nodes)
+- [Documentation API OVHcloud](https://api.ovh.com/)
+- [API Console OVHcloud](https://api.ovh.com/console/)
+- [Guide OVHcloud - API tokens](https://help.ovhcloud.com/csm/en-manage-ovhcloud-api-tokens?id=kb_article_view&sysparm_article=KB0042784)

package/dist/nodes/OvhCloud/OvhCloud.node.d.ts

@@ -1,10 +1,6 @@
 import { IExecuteFunctions, type INodeExecutionData, type INodeType, type INodeTypeDescription } from 'n8n-workflow';
 export declare class OvhCloud implements INodeType {
     description: INodeTypeDescription;
-    methods: {
-        listSearch: {
-            getServices: typeof import("./listSearch/getServices").getServices;
-        };
-    };
+    methods: INodeType['methods'];
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

package/dist/nodes/OvhCloud/OvhCloud.node.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OvhCloud = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const services_1 = require("./resources/services");
 const OvhCloudApi_credentials_1 = require("../../credentials/OvhCloudApi.credentials");
-const domain_1 = require("./resources/domain");
 const me_1 = require("./resources/me");
+const services_1 = require("./resources/services");
+const vps_1 = require("./resources/vps");
 class OvhCloud {
     constructor() {
         this.description = {
@@ -35,10 +35,6 @@ class OvhCloud {
                     type: 'options',
                     noDataExpression: true,
                     options: [
-                        {
-                            name: 'Domain',
-                            value: 'domain',
-                        },
                         {
                             name: 'Service',
                             value: 'services',
@@ -47,28 +43,43 @@ class OvhCloud {
                             name: 'Me',
                             value: 'me',
                         },
+                        {
+                            name: 'VPS',
+                            value: 'vps',
+                        }
                     ],
                     default: 'services',
                 },
-                ...services_1.servicesDescription,
-                ...me_1.meDescription,
+                ...(0, me_1.description)({ show: { resource: ['me'] } }),
+                ...(0, services_1.description)({ show: { resource: ['services'] } }),
+                ...(0, vps_1.description)({ show: { resource: ['vps'] } }),
             ],
         };
         this.methods = {
-            listSearch: Object.assign({}, services_1.servicesMethods, domain_1.domainMethods),
+            listSearch: {
+                ...me_1.methodsListSearch,
+                ...services_1.methodsListSearch,
+                ...vps_1.methodsListSearch,
+            },
         };
     }
     async execute() {
         const resource = this.getNodeParameter('resource', 0);
+        let responseData;
         switch (resource) {
+            case 'me':
+                responseData = await me_1.execute.call(this);
+                break;
             case 'services':
-                return await services_1.servicesExecute.call(this);
-            case 'domain':
+                responseData = await services_1.execute.call(this);
                 break;
-            case 'me':
-                return await me_1.meExecute.call(this);
+            case 'vps':
+                responseData = await vps_1.execute.call(this);
+                break;
+            default:
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), { message: `The resource "${resource}" cannot be executed directly. Please select an operation to execute.` });
         }
-        throw new n8n_workflow_1.NodeApiError(this.getNode(), { message: `The resource "${resource}" cannot be executed directly. Please select an operation to execute.` });
+        return [this.helpers.returnJsonArray(responseData)];
     }
 }
 exports.OvhCloud = OvhCloud;

package/dist/nodes/OvhCloud/OvhCloud.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"OvhCloud.node.js","sourceRoot":"","sources":["../../../nodes/OvhCloud/OvhCloud.node.ts"],"names":[],"mappings":";;;AAAA,+CAOsB;AACtB,mDAA6F;AAC7F,uFAAkF;AAClF,+CAAmD;AACnD,uCAA0D;AAE1D,MAAa,QAAQ;IAArB;QACI,gBAAW,GAAyB;YAChC,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,mCAAmC;YACzC,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,2BAA2B;YACxC,QAAQ,EAAE;gBACN,IAAI,EAAE,WAAW;aACpB;YACD,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE;gBACT;oBACI,IAAI,EAAE,+CAAqB;oBAC3B,QAAQ,EAAE,IAAI;iBACjB;aACJ;YACD,UAAU,EAAE;gBAER;oBACI,WAAW,EAAE,UAAU;oBACvB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS;oBACf,gBAAgB,EAAE,IAAI;oBACtB,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,QAAQ;4BACd,KAAK,EAAE,QAAQ;yBAClB;wBACD;4BACI,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE,UAAU;yBACpB;wBACD;4BACI,IAAI,EAAE,IAAI;4BACV,KAAK,EAAE,IAAI;yBACd;qBACJ;oBACD,OAAO,EAAE,UAAU;iBACtB;gBACD,GAAG,8BAAmB;gBACtB,GAAG,kBAAa;aACnB;SACJ,CAAC;QAEF,YAAO,GAAG;YACN,UAAU,EAAE,MAAM,CAAC,MAAM,CACrB,EAAE,EACF,0BAAe,EACf,sBAAa,CAChB;SACJ,CAAA;IAgBL,CAAC;IAdG,KAAK,CAAC,OAAO;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAEtD,QAAQ,QAAQ,EAAE,CAAC;YACf,KAAK,UAAU;gBACX,OAAO,MAAM,0BAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,KAAK,QAAQ;gBACT,MAAM;YACV,KAAK,IAAI;gBACL,OAAO,MAAM,cAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,IAAI,2BAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,QAAQ,uEAAuE,EAAE,CAAC,CAAC;IAC1J,CAAC;CACJ;AAvED,4BAuEC"}
+{"version":3,"file":"OvhCloud.node.js","sourceRoot":"","sources":["../../../nodes/OvhCloud/OvhCloud.node.ts"],"names":[],"mappings":";;;AAAA,+CAOsB;AACtB,uFAAkF;AAClF,uCAIwB;AACxB,mDAI8B;AAC9B,yCAIyB;AAEzB,MAAa,QAAQ;IAArB;QACI,gBAAW,GAAyB;YAChC,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,mCAAmC;YACzC,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,2BAA2B;YACxC,QAAQ,EAAE;gBACN,IAAI,EAAE,WAAW;aACpB;YACD,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE;gBACT;oBACI,IAAI,EAAE,+CAAqB;oBAC3B,QAAQ,EAAE,IAAI;iBACjB;aACJ;YACD,UAAU,EAAE;gBAER;oBACI,WAAW,EAAE,UAAU;oBACvB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS;oBACf,gBAAgB,EAAE,IAAI;oBACtB,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE,UAAU;yBACpB;wBACD;4BACI,IAAI,EAAE,IAAI;4BACV,KAAK,EAAE,IAAI;yBACd;wBACD;4BAEI,IAAI,EAAE,KAAK;4BACX,KAAK,EAAE,KAAK;yBACf;qBACJ;oBACD,OAAO,EAAE,UAAU;iBACtB;gBACD,GAAG,IAAA,gBAAa,EAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAChD,GAAG,IAAA,sBAAmB,EAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;gBAC5D,GAAG,IAAA,iBAAc,EAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;aACrD;SACJ,CAAC;QAEF,YAAO,GAAyB;YAC5B,UAAU,EAAE;gBACR,GAAG,sBAAmB;gBACtB,GAAG,4BAAyB;gBAC5B,GAAG,uBAAoB;aAC1B;SACJ,CAAA;IAuBL,CAAC;IArBG,KAAK,CAAC,OAAO;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAEtD,IAAI,YAAkC,CAAC;QAEvC,QAAQ,QAAQ,EAAE,CAAC;YACf,KAAK,IAAI;gBACL,YAAY,GAAG,MAAM,YAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM;YACV,KAAK,UAAU;gBACX,YAAY,GAAG,MAAM,kBAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM;YACV,KAAK,KAAK;gBACN,YAAY,GAAG,MAAM,aAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3C,MAAM;YACV;gBACI,MAAM,IAAI,2BAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,QAAQ,uEAAuE,EAAE,CAAC,CAAC;QAC9J,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;IACxD,CAAC;CACJ;AAhFD,4BAgFC"}

package/dist/nodes/OvhCloud/resources/me.d.ts

@@ -0,0 +1,4 @@
+import { IExecuteFunctions, INodeExecutionData, INodeProperties, IDisplayOptions } from "n8n-workflow";
+export declare function description(displayOptions: IDisplayOptions): INodeProperties[];
+export declare const methodsListSearch: {};
+export declare function execute(this: IExecuteFunctions): Promise<INodeExecutionData[]>;