n8n-nodes-nextcloud-ext 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 wdebonne
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,357 @@
+# n8n-nodes-nextcloud
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-nextcloud.svg)](https://www.npmjs.com/package/n8n-nodes-nextcloud)
+[![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/)
+
+Nodes n8n communautaires pour **Nextcloud** — l'équivalent self-hosted des nodes Microsoft 365 (OneDrive + Excel) intégrés à n8n.
+
+> Gérez vos fichiers Nextcloud et manipulez vos feuilles de calcul (`.xlsx`, `.ods`, `.csv`) — y compris les **tables Excel nommées** — directement depuis vos workflows n8n, sans aucune dépendance au cloud Microsoft.
+
+---
+
+## Nodes inclus
+
+| Node | Équivalent Microsoft 365 | Description |
+|---|---|---|
+| **Nextcloud** | OneDrive | Gestion de fichiers et dossiers via WebDAV |
+| **Nextcloud Spreadsheet** | Excel | Lecture/écriture de fichiers tableur + tables nommées |
+
+---
+
+## Prérequis
+
+- n8n **≥ 1.0.0**
+- Instance Nextcloud **≥ 20** accessible en HTTPS
+- Node.js **≥ 18.10**
+
+---
+
+## Installation
+
+### Via l'interface n8n (recommandé)
+
+1. Ouvrez n8n → **Settings** → **Community Nodes**
+2. Cliquez **Install a community node**
+3. Entrez `n8n-nodes-nextcloud`
+4. Cliquez **Install**
+
+### Installation manuelle
+
+```bash
+# Dans le répertoire de données n8n
+npm install n8n-nodes-nextcloud
+```
+
+Puis redémarrez n8n.
+
+---
+
+## Configuration des credentials
+
+1. Dans n8n → **Credentials** → **New** → cherchez **Nextcloud API**
+2. Renseignez les trois champs :
+
+| Champ | Description | Exemple |
+|---|---|---|
+| **Server URL** | URL de base de votre Nextcloud (sans slash final) | `https://cloud.mondomaine.fr` |
+| **Username** | Votre identifiant Nextcloud | `admin` |
+| **Password / App Password** | Mot de passe ou mot de passe d'application | `xxxx-xxxx-xxxx-xxxx` |
+
+> **Recommandé** : créez un **mot de passe d'application** dans Nextcloud → *Paramètres → Sécurité → Mots de passe d'application* pour ne pas exposer votre mot de passe principal.
+
+---
+
+## Node — Nextcloud
+
+Gestion de fichiers, dossiers et partages via l'API WebDAV de Nextcloud.
+
+### Resource : File
+
+| Opération | Description |
+|---|---|
+| **List** | Liste les fichiers d'un dossier |
+| **Download** | Télécharge un fichier (sortie binaire) |
+| **Upload** | Envoie un fichier binaire vers Nextcloud |
+| **Delete** | Supprime un fichier |
+| **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
+Binary Property : data
+```
+
+---
+
+### Resource : Folder
+
+| Opération | Description |
+|---|---|
+| **List** | Liste le contenu d'un dossier |
+| **Create** | Crée un dossier |
+| **Delete** | Supprime un dossier et son contenu |
+
+---
+
+### Resource : Share
+
+| Opération | Description |
+|---|---|
+| **Create** | Crée un lien de partage public ou vers un utilisateur/groupe |
+| **Delete** | Supprime un partage par son ID |
+| **Get All** | Liste tous vos partages actifs |
+
+**Exemple — Créer un lien public protégé par mot de passe**
+```
+Path        : /Documents/rapport-annuel.pdf
+Share Type  : Public Link
+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"
+  }
+}
+```
+
+---
+
+## Node — Nextcloud Spreadsheet
+
+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.
+
+### Sélection du fichier, de la feuille et de la table
+
+Chaque sélecteur propose deux modes :
+
+| Mode | Description |
+|---|---|
+| **From List** | Menu déroulant chargé dynamiquement depuis votre Nextcloud |
+| **By Path / By Name** | Saisie libre ou expression n8n (`{{ $json.filePath }}`) |
+
+---
+
+### Resource : Sheet
+
+Travaille sur les données d'une feuille de calcul. La **première ligne est traitée comme les en-têtes de colonnes**.
+
+| Opération | Description |
+|---|---|
+| **Get Rows** | Retourne toutes les lignes en tant qu'items n8n (filtres disponibles) |
+| **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)
+
+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"
+}
+```
+
+**Exemple — Append Row**
+```
+File   : /Tableaux/Suivi.xlsx
+Sheet  : Feuil1
+
+Column Values:
+  N°     → {{ $json.numero }}
+  Objet  → {{ $json.objet }}
+  Date   → {{ $now.format('dd/MM/yyyy') }}
+  Statut → Nouveau
+```
+
+**Exemple — Update Row**
+```
+File       : /Tableaux/Suivi.xlsx
+Sheet      : Feuil1
+Row Number : {{ $json.rowIndex }}
+
+Column Values:
+  Statut → Validé
+```
+
+---
+
+### Resource : Table
+
+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.
+
+| 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) |
+| **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 |
+| **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 |
+
+**Exemple — List** (retourne une ligne par table)
+```json
+{
+  "name": "Tableau1",
+  "displayName": "Tableau1",
+  "sheetName": "Suivi",
+  "ref": "A1:E42",
+  "columns": ["N°", "Objet", "Date", "Responsable", "Statut"],
+  "dataRowCount": 41
+}
+```
+
+**Exemple — Get Rows avec filtre**
+```
+File   : /Tableaux/Arrêtés.xlsx
+Table  : Tableau1               (From list : "Tableau1  [Suivi · A1:E42 · 41 rows]")
+
+Filters:
+  Column : Statut
+  Value  : Validé
+```
+
+**Exemple — Append Row**
+```
+File  : /Tableaux/Suivi.xlsx
+Table : Tableau1
+
+Column Values:
+  N°          → {{ $json.numero }}
+  Objet       → Arrêté de voirie
+  Date        → {{ $now.format('dd/MM/yyyy') }}
+  Responsable → {{ $json.agent }}
+  Statut      → Nouveau
+```
+→ La table passe automatiquement de `A1:E42` à `A1:E43`.
+
+---
+
+### Resource : Workbook
+
+Inspecte la structure du classeur sans lire les données.
+
+| Opération | Description |
+|---|---|
+| **Get Sheets** | Retourne tous les noms de feuilles du classeur |
+| **Get Tables** | Retourne toutes les tables nommées de toutes les feuilles |
+
+---
+
+## Structure des chemins
+
+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
+```
+
+---
+
+## Développement local
+
+```bash
+git clone https://github.com/wdebonne/n8n-nodes-nextcloud-ext.git
+cd n8n-nodes-nextcloud
+
+# Installer les dépendances
+# Sur Windows avec proxy SSL (antivirus, Zscaler, etc.) :
+NODE_OPTIONS=--use-system-ca npm install
+# Sinon :
+npm install
+
+# Compiler TypeScript → dist/
+npm run build
+
+# Vérification des types seule (sans émettre)
+npx tsc --noEmit
+
+# Linter
+npm run lint
+
+# Mode watch (recompile à chaque sauvegarde)
+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
+```
+
+---
+
+## Roadmap
+
+- [ ] Support OAuth2 Nextcloud (PKCE)
+- [ ] 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)
+
+---
+
+## Licence
+
+[MIT](LICENSE) — © 2025 wdebonne
+
+---
+
+## Liens utiles
+
+- [Documentation n8n — Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
+- [Documentation WebDAV Nextcloud](https://docs.nextcloud.com/server/latest/developer_manual/client_apis/WebDAV/basic.html)
+- [API OCS Partage Nextcloud](https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/ocs-share-api.html)
+- [SheetJS (xlsx)](https://sheetjs.com/)
+- [Guide de déploiement npm](DEPLOY.md)

package/dist/credentials/NextCloudApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class NextCloudApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/NextCloudApi.credentials.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextCloudApi = void 0;
+class NextCloudApi {
+    constructor() {
+        this.name = 'nextCloudApi';
+        this.displayName = 'Nextcloud API';
+        this.documentationUrl = 'https://docs.nextcloud.com/server/latest/developer_manual/client_apis/WebDAV/basic.html';
+        this.properties = [
+            {
+                displayName: 'Server URL',
+                name: 'serverUrl',
+                type: 'string',
+                default: '',
+                placeholder: 'https://nextcloud.example.com',
+                description: 'The base URL of your Nextcloud instance (no trailing slash)',
+                required: true,
+            },
+            {
+                displayName: 'Username',
+                name: 'user',
+                type: 'string',
+                default: '',
+                required: true,
+            },
+            {
+                displayName: 'Password / App Password',
+                name: 'password',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Your Nextcloud password or an app password generated in Settings → Security',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                auth: {
+                    username: '={{$credentials.user}}',
+                    password: '={{$credentials.password}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.serverUrl}}',
+                url: '/ocs/v1.php/cloud/capabilities?format=json',
+                headers: {
+                    'OCS-APIREQUEST': 'true',
+                },
+            },
+        };
+    }
+}
+exports.NextCloudApi = NextCloudApi;
+//# sourceMappingURL=NextCloudApi.credentials.js.map

package/dist/credentials/NextCloudApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextCloudApi.credentials.js","sourceRoot":"","sources":["../../credentials/NextCloudApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,YAAY;IAAzB;QACC,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,eAAe,CAAC;QAC9B,qBAAgB,GAAG,yFAAyF,CAAC;QAC7G,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,+BAA+B;gBAC5C,WAAW,EAAE,6DAA6D;gBAC1E,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,yBAAyB;gBACtC,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,6EAA6E;gBAC1F,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,IAAI,EAAE;oBACL,QAAQ,EAAE,wBAAwB;oBAClC,QAAQ,EAAE,4BAA4B;iBACtC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,4CAA4C;gBACjD,OAAO,EAAE;oBACR,gBAAgB,EAAE,MAAM;iBACxB;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAnDD,oCAmDC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { NextCloudApi } from './credentials/NextCloudApi.credentials';
+export { NextCloud } from './nodes/NextCloud/NextCloud.node';
+export { NextCloudSpreadsheet } from './nodes/NextCloudSpreadsheet/NextCloudSpreadsheet.node';

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextCloudSpreadsheet = exports.NextCloud = exports.NextCloudApi = void 0;
+var NextCloudApi_credentials_1 = require("./credentials/NextCloudApi.credentials");
+Object.defineProperty(exports, "NextCloudApi", { enumerable: true, get: function () { return NextCloudApi_credentials_1.NextCloudApi; } });
+var NextCloud_node_1 = require("./nodes/NextCloud/NextCloud.node");
+Object.defineProperty(exports, "NextCloud", { enumerable: true, get: function () { return NextCloud_node_1.NextCloud; } });
+var NextCloudSpreadsheet_node_1 = require("./nodes/NextCloudSpreadsheet/NextCloudSpreadsheet.node");
+Object.defineProperty(exports, "NextCloudSpreadsheet", { enumerable: true, get: function () { return NextCloudSpreadsheet_node_1.NextCloudSpreadsheet; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,mFAAsE;AAA7D,wHAAA,YAAY,OAAA;AACrB,mEAA6D;AAApD,2GAAA,SAAS,OAAA;AAClB,oGAA8F;AAArF,iIAAA,oBAAoB,OAAA"}

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

@@ -0,0 +1,10 @@
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class NextCloud implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getFolderFiles(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}