n8n-nodes-nextcloud-ext 1.0.7 → 1.0.8

package/README.md

@@ -1,6 +1,6 @@
-# n8n-nodes-nextcloud
+# n8n-nodes-nextcloud-ext
 
-[![npm version](https://img.shields.io/npm/v/n8n-nodes-nextcloud.svg)](https://www.npmjs.com/package/n8n-nodes-nextcloud)
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-nextcloud-ext.svg)](https://www.npmjs.com/package/n8n-nodes-nextcloud-ext)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![n8n community node](https://img.shields.io/badge/n8n-community%20node-orange)](https://docs.n8n.io/integrations/community-nodes/)
 
@@ -33,14 +33,13 @@ Nodes n8n communautaires pour **Nextcloud** — l'équivalent self-hosted des no
 
 1. Ouvrez n8n → **Settings** → **Community Nodes**
 2. Cliquez **Install a community node**
-3. Entrez `n8n-nodes-nextcloud`
+3. Entrez `n8n-nodes-nextcloud-ext`
 4. Cliquez **Install**
 
 ### Installation manuelle
 
 ```bash
-# Dans le répertoire de données n8n
-npm install n8n-nodes-nextcloud
+npm install n8n-nodes-nextcloud-ext
 ```
 
 Puis redémarrez n8n.
@@ -77,23 +76,6 @@ Gestion de fichiers, dossiers et partages via l'API WebDAV de Nextcloud.
 | **Move** | Déplace ou renomme un fichier |
 | **Copy** | Copie un fichier vers un autre chemin |
 
-**Exemple — List**
-```
-Folder Path : /Documents/Factures
-```
-Retourne pour chaque fichier :
-```json
-{
-  "name": "facture-2024-01.pdf",
-  "path": "/Documents/Factures/facture-2024-01.pdf",
-  "isDirectory": false,
-  "size": 245120,
-  "contentType": "application/pdf",
-  "lastModified": "Mon, 15 Jan 2024 10:30:00 GMT",
-  "fileId": "12345"
-}
-```
-
 **Exemple — Upload** (après un node qui produit des données binaires)
 ```
 File Path       : /Rapports/rapport-{{ $now.format('yyyy-MM') }}.xlsx
@@ -128,16 +110,6 @@ Permissions : Read Only (1)
 Password    : MonMotDePasse
 Expiry Date : 2025-12-31
 ```
-Retourne :
-```json
-{
-  "data": {
-    "id": 42,
-    "url": "https://cloud.mondomaine.fr/s/AbCdEfGh",
-    "token": "AbCdEfGh"
-  }
-}
-```
 
 ---
 
@@ -145,16 +117,31 @@ Retourne :
 
 Lit et écrit dans des fichiers tableur stockés sur Nextcloud. Supporte `.xlsx`, `.xls`, `.ods` et `.csv`.
 
-**Principe** : le node télécharge le fichier depuis Nextcloud via WebDAV, applique l'opération en mémoire (via [SheetJS](https://sheetjs.com/)), puis ré-uploade le fichier modifié. Aucune donnée n'est stockée en dehors de votre instance.
+**Principe** : le node télécharge le fichier depuis Nextcloud via WebDAV, applique l'opération en mémoire ([SheetJS](https://sheetjs.com/) + [JSZip](https://stuk.github.io/jszip/) pour les tables nommées), puis ré-uploade le fichier modifié.
+
+---
+
+### Sélection du fichier
 
-### Sélection du fichier, de la feuille et de la table
+La sélection d'un fichier se fait en 3 champs enchaînés :
 
-Chaque sélecteur propose deux modes :
+```
+From    ▼  From List           ← mode : liste ou chemin direct
+Folder  ▼  📁 Documents        ← filtre la liste au dossier choisi
+              └ Finance
+           📁 Tableaux
+           / (root)
+File    ▼  Arrêtés.xlsx        ← fichiers du dossier sélectionné
+           Suivi.xlsx
+```
 
-| Mode | Description |
+| Champ | Description |
 |---|---|
-| **From List** | Menu déroulant chargé dynamiquement depuis votre Nextcloud |
-| **By Path / By Name** | Saisie libre ou expression n8n (`{{ $json.filePath }}`) |
+| **From** | `From List` (menu déroulant) ou `By Path` (expression n8n) |
+| **Folder** | Sélectionne le dossier (racine + 2 niveaux) — recharge la liste de fichiers |
+| **File** | Fichiers tableur disponibles dans le dossier choisi |
+
+Pour la feuille et la table, deux modes sont aussi disponibles : **From List** ou **By Name (Expression)**.
 
 ---
 
@@ -164,52 +151,51 @@ Travaille sur les données d'une feuille de calcul. La **première ligne est tra
 
 | Opération | Description |
 |---|---|
-| **Get Rows** | Retourne toutes les lignes en tant qu'items n8n (filtres disponibles) |
+| **Get Rows** | Retourne toutes les lignes en tant qu'items n8n |
 | **Append Row** | Ajoute une nouvelle ligne à la fin de la feuille |
 | **Update Row** | Modifie une ligne existante par son numéro (1 = première ligne de données) |
 | **Delete Row** | Supprime une ligne par son numéro |
 | **Get Columns** | Retourne la liste des en-têtes de colonnes |
 | **Clear** | Supprime toutes les lignes de données en conservant l'en-tête |
 
-**Exemple — Get Rows avec filtre**
-```
-File   : /Tableaux/Arrêtés.xlsx   (From list)
-Sheet  : Suivi                     (From list)
+#### Sélection des colonnes (Get Rows)
+
+Le champ **Column Names or IDs** est un sélecteur multiple :
+- Laissez vide → toutes les colonnes sont retournées
+- Sélectionnez une ou plusieurs colonnes → seules celles-ci apparaissent dans le résultat
+- Les colonnes disponibles sont chargées dynamiquement depuis votre fichier
 
-Filters:
-  Column : Statut
-  Value  : En attente
 ```
-Retourne chaque ligne correspondante :
-```json
-{
-  "N°": "2024-001",
-  "Objet": "Arrêté municipal",
-  "Date": "2024-01-15",
-  "Statut": "En attente"
-}
+Column Names or IDs :  N°  ×   INTITULÉ  ×
+                       ↓
+                       N°          ✓
+                       INTITULÉ    ✓
+                       DATE
+                       Service
 ```
 
-**Exemple — Append Row**
+**Exemple — Get Rows (colonnes filtrées)**
 ```
-File   : /Tableaux/Suivi.xlsx
-Sheet  : Feuil1
-
-Column Values:
-  N°     → {{ $json.numero }}
-  Objet  → {{ $json.objet }}
-  Date   → {{ $now.format('dd/MM/yyyy') }}
-  Statut → Nouveau
+From    : From List
+Folder  : 📁 Tableaux
+File    : Arrêtés.xlsx
+Sheet   : Suivi
+Columns : N°  ×  INTITULÉ  ×
+```
+Retourne uniquement N° et INTITULÉ pour chaque ligne :
+```json
+{ "N°": "2024-001", "INTITULÉ": "Arrêté de voirie" }
 ```
 
-**Exemple — Update Row**
+**Exemple — Append Row**
 ```
-File       : /Tableaux/Suivi.xlsx
-Sheet      : Feuil1
-Row Number : {{ $json.rowIndex }}
+File   : Arrêtés.xlsx  /  Sheet : Suivi
 
 Column Values:
-  Statut → Validé
+  N°          → {{ $json.numero }}
+  INTITULÉ    → {{ $json.objet }}
+  DATE        → {{ $now.format('dd/MM/yyyy') }}
+  Service     → {{ $json.service }}
 ```
 
 ---
@@ -218,14 +204,16 @@ Column Values:
 
 Travaille sur une **table Excel nommée** (créée via *Insertion → Tableau* dans Excel, ou `Ctrl+T`).
 
-Contrairement à la resource Sheet, les opérations Table maintiennent automatiquement la **plage de la table** : Append étend le `ref` de la table, Delete le rétracte. Les filtres automatiques et styles Excel sont préservés.
+Les tables nommées sont lues directement depuis le XML interne du fichier `.xlsx` (via JSZip), ce qui garantit une **compatibilité totale** avec Excel, même pour des fichiers créés ou modifiés en dehors de n8n.
+
+Contrairement à la resource Sheet, les opérations Table maintiennent automatiquement la **plage de la table** : Append étend le `ref`, Delete le rétracte — les styles et filtres automatiques Excel sont préservés.
 
 | Opération | Description |
 |---|---|
 | **List** | Liste toutes les tables nommées du classeur (nom, feuille, plage, colonnes, nb de lignes) |
-| **Get Rows** | Retourne les lignes de la table comme items n8n (filtres disponibles) |
+| **Get Rows** | Retourne les lignes de la table (avec sélection de colonnes) |
 | **Append Row** | Ajoute une ligne à la fin **et étend la plage de la table** |
-| **Update Row** | Modifie une ligne existante par son numéro dans la table |
+| **Update Row** | Modifie une ligne par son numéro (1 = première ligne de données) |
 | **Delete Row** | Supprime une ligne et **rétracte la plage de la table** |
 | **Get Columns** | Retourne les en-têtes de colonnes de la table |
 
@@ -236,32 +224,28 @@ Contrairement à la resource Sheet, les opérations Table maintiennent automatiq
   "displayName": "Tableau1",
   "sheetName": "Suivi",
   "ref": "A1:E42",
-  "columns": ["N°", "Objet", "Date", "Responsable", "Statut"],
+  "columns": ["N°", "INTITULÉ", "DATE", "Responsable", "Service"],
   "dataRowCount": 41
 }
 ```
 
-**Exemple — Get Rows avec filtre**
+**Exemple — Get Rows (colonnes filtrées)**
 ```
-File   : /Tableaux/Arrêtés.xlsx
-Table  : Tableau1               (From list : "Tableau1  [Suivi · A1:E42 · 41 rows]")
-
-Filters:
-  Column : Statut
-  Value  : Validé
+File    : Arrêtés.xlsx
+Table   : Tableau1  [Suivi · A1:E42 · 41 rows]
+Columns : N°  ×  INTITULÉ  ×
 ```
 
 **Exemple — Append Row**
 ```
-File  : /Tableaux/Suivi.xlsx
-Table : Tableau1
+File  : Arrêtés.xlsx  /  Table : Tableau1
 
 Column Values:
   N°          → {{ $json.numero }}
-  Objet       → Arrêté de voirie
-  Date        → {{ $now.format('dd/MM/yyyy') }}
+  INTITULÉ    → Arrêté de voirie
+  DATE        → {{ $now.format('dd/MM/yyyy') }}
   Responsable → {{ $json.agent }}
-  Statut      → Nouveau
+  Service     → Travaux
 ```
 → La table passe automatiquement de `A1:E42` à `A1:E43`.
 
@@ -285,8 +269,8 @@ Tous les chemins sont **relatifs à la racine de votre espace Nextcloud** :
 ```
 /                              → racine
 /Documents/                    → dossier Documents
-/Documents/rapport.xlsx        → fichier rapport.xlsx dans Documents
-/Tableaux/Arrêtés/suivi.xlsx  → sous-dossier
+/Documents/rapport.xlsx        → fichier dans Documents
+/Tableaux/Arrêtés/suivi.xlsx  → sous-dossier imbriqué
 ```
 
 ---
@@ -295,23 +279,17 @@ Tous les chemins sont **relatifs à la racine de votre espace Nextcloud** :
 
 ```bash
 git clone https://github.com/wdebonne/n8n-nodes-nextcloud-ext.git
-cd n8n-nodes-nextcloud
+cd n8n-nodes-nextcloud-ext
 
-# Installer les dépendances
-# Sur Windows avec proxy SSL (antivirus, Zscaler, etc.) :
+# Installer les dépendances (Windows avec proxy SSL)
 NODE_OPTIONS=--use-system-ca npm install
-# Sinon :
-npm install
 
 # Compiler TypeScript → dist/
 npm run build
 
-# Vérification des types seule (sans émettre)
+# Vérification des types seule
 npx tsc --noEmit
 
-# Linter
-npm run lint
-
 # Mode watch (recompile à chaque sauvegarde)
 npm run dev
 ```
@@ -319,14 +297,12 @@ npm run dev
 ### Tester dans n8n en local
 
 ```bash
-# Dans ce répertoire :
 npm run build
 npm link
 
 # Dans le répertoire de données n8n :
-npm link n8n-nodes-nextcloud
-
-# Redémarrer n8n — le node apparaît dans la palette
+npm link n8n-nodes-nextcloud-ext
+# Redémarrer n8n
 ```
 
 ---
@@ -337,8 +313,8 @@ npm link n8n-nodes-nextcloud
 - [ ] Node **Nextcloud Talk** (messages, salons)
 - [ ] Node **Nextcloud Contacts** (CardDAV)
 - [ ] Node **Nextcloud Calendar** (CalDAV)
-- [ ] Pagination automatique pour les grands dossiers
-- [ ] Filtre de comparaison avancé (>, <, contains, regex)
+- [ ] Filtrage de lignes par valeur (column = value)
+- [ ] Navigation de dossiers en cascade (3+ niveaux)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-nextcloud-ext",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "n8n community nodes for Nextcloud — file management (list, upload, download, share) and spreadsheet operations equivalent to the Microsoft 365 Excel node, including named Excel table support",
   "keywords": [
     "n8n-community-node-package",