n8n-nodes-docx-filler 1.0.0 → 1.1.0

package/README.md

@@ -14,6 +14,7 @@ n8n community node to automatically fill DOCX documents (French DC1, DC2, AE adm
 - Automatic field detection (SIRET, TVA, email, address, etc.)
 - Checkbox state copying
 - Compatible with n8n AI Agents (`usableAsTool: true`)
+- **Multiple input formats**: file path, binary property, or base64
 
 ## Installation
 
@@ -46,8 +47,8 @@ Fills a template document with data extracted from a source document.
 
 | Parameter | Description |
 |-----------|-------------|
-| `sourceDocument` | Document containing company data (binary property or base64) |
-| `templateDocument` | Empty template to fill (binary property or base64) |
+| `sourceDocument` | Document containing company data |
+| `templateDocument` | Empty template to fill |
 | `outputProperty` | Binary property name for output (default: "data") |
 
 ### Extract Data
@@ -56,7 +57,7 @@ Extracts company data from a filled document.
 
 | Parameter | Description |
 |-----------|-------------|
-| `document` | Document to analyze (binary property or base64) |
+| `document` | Document to analyze |
 
 ### Analyze
 
@@ -66,6 +67,16 @@ Analyzes document structure for debugging.
 |-----------|-------------|
 | `document` | Document to analyze |
 
+### Input Formats
+
+All document parameters accept **3 input formats** (auto-detected):
+
+| Format | Example | Use Case |
+|--------|---------|----------|
+| **File path** | `/home/node/shared_docs/doc.docx` | AI Agents, direct file access |
+| **Binary property** | `data` | Standard n8n workflow |
+| **Base64** | `UEsDBBQAAAAI...` | Inline data |
+
 ## Supported Fields
 
 The node automatically recognizes these fields in French administrative documents:
@@ -82,19 +93,21 @@ The node automatically recognizes these fields in French administrative document
 
 ## Usage with AI Agent
 
-This node is compatible with n8n AI Agents.
+This node is compatible with n8n AI Agents. You can pass **file paths directly** - no need for binary data handling.
 
 **Example agent prompt:**
 ```
 You have access to the DOCX Filler tool to fill documents.
 
 Use the "fill" operation with:
-- sourceDocument: the document containing company data
-- templateDocument: the empty form to fill
+- sourceDocument: /home/node/shared_docs/company_data.docx
+- templateDocument: /home/node/shared_docs/template_DC2.docx
 
 Execute directly without asking for confirmation.
 ```
 
+> **Note**: When using file paths in Docker, ensure the directory is mounted and accessible from the container.
+
 ## Example Workflow
 
 ```
@@ -115,7 +128,7 @@ cd n8n-nodes-docx-filler
 # Install dependencies
 npm install
 
-# Build
+# Build & | package.json Version 1.0.0 → 1.1.0 
 npm run build
 
 # Watch mode

package/dist/DocxFiller/DocxFiller.node.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocxFiller = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 const pizzip_1 = __importDefault(require("pizzip"));
+const fs = __importStar(require("fs"));
 // Labels spécifiques à rechercher dans les documents DC/AE
 const LABEL_PATTERNS = [
     ['siret', ['numéro siret', 'n° siret', 'siret']],
@@ -224,6 +258,48 @@ function escapeXml(text) {
         .replace(/"/g, '&quot;')
         .replace(/'/g, '&apos;');
 }
+/**
+ * Détecte le type d'entrée et retourne le buffer du document
+ * Supporte : chemin de fichier, nom de propriété binaire, ou base64
+ */
+async function getDocumentBuffer(context, itemIndex, input, items) {
+    // 1. Vérifier si c'est un chemin de fichier (commence par / ou contient .docx)
+    const looksLikePath = input.startsWith('/') ||
+        input.startsWith('./') ||
+        input.startsWith('../') ||
+        /^[a-zA-Z]:\\/.test(input) || // Windows path
+        (input.includes('.docx') && !input.includes(' ') && input.length < 500);
+    if (looksLikePath) {
+        // Tenter de lire le fichier depuis le système de fichiers
+        try {
+            if (fs.existsSync(input)) {
+                return fs.readFileSync(input);
+            }
+        }
+        catch {
+            // Si la lecture échoue, continuer avec les autres méthodes
+        }
+    }
+    // 2. Vérifier si c'est un nom de propriété binaire
+    if (items[itemIndex].binary && items[itemIndex].binary[input]) {
+        return await context.helpers.getBinaryDataBuffer(itemIndex, input);
+    }
+    // 3. Vérifier si c'est du base64 valide (longueur raisonnable et caractères valides)
+    const base64Regex = /^[A-Za-z0-9+/]+=*$/;
+    if (input.length > 100 && base64Regex.test(input.replace(/\s/g, ''))) {
+        const buffer = Buffer.from(input, 'base64');
+        // Vérifier que c'est bien un ZIP (DOCX = ZIP)
+        if (buffer.length > 4 && buffer[0] === 0x50 && buffer[1] === 0x4B) {
+            return buffer;
+        }
+    }
+    // 4. Si rien n'a fonctionné, donner un message d'erreur clair
+    throw new Error(`Impossible de charger le document "${input.substring(0, 50)}..."\n` +
+        `Formats acceptés:\n` +
+        `- Chemin de fichier: /path/to/document.docx\n` +
+        `- Propriété binaire: data (si le fichier est attaché en binaire)\n` +
+        `- Base64: contenu encodé en base64`);
+}
 class DocxFiller {
     constructor() {
         this.description = {
@@ -281,7 +357,7 @@ class DocxFiller {
                             operation: ['fill'],
                         },
                     },
-                    description: 'Document source contenant les données entreprise (binary property name ou base64)',
+                    description: 'Document source contenant les données entreprise (chemin fichier, binary property name, ou base64)',
                 },
                 {
                     displayName: 'Template Document',
@@ -294,7 +370,7 @@ class DocxFiller {
                             operation: ['fill'],
                         },
                     },
-                    description: 'Document template vide à remplir (binary property name ou base64)',
+                    description: 'Document template vide à remplir (chemin fichier, binary property name, ou base64)',
                 },
                 {
                     displayName: 'Output Property',
@@ -320,7 +396,7 @@ class DocxFiller {
                             operation: ['extract', 'analyze'],
                         },
                     },
-                    description: 'Document à analyser (binary property name ou base64)',
+                    description: 'Document à analyser (chemin fichier, binary property name, ou base64)',
                 },
             ],
         };
@@ -336,25 +412,9 @@ class DocxFiller {
                     const sourceDocParam = this.getNodeParameter('sourceDocument', i);
                     const templateDocParam = this.getNodeParameter('templateDocument', i);
                     const outputProperty = this.getNodeParameter('outputProperty', i);
-                    // Charger les documents (depuis binary ou base64)
-                    let sourceBuffer;
-                    let templateBuffer;
-                    // Source document
-                    if (items[i].binary && items[i].binary[sourceDocParam]) {
-                        sourceBuffer = await this.helpers.getBinaryDataBuffer(i, sourceDocParam);
-                    }
-                    else {
-                        // Assume base64
-                        sourceBuffer = Buffer.from(sourceDocParam, 'base64');
-                    }
-                    // Template document
-                    if (items[i].binary && items[i].binary[templateDocParam]) {
-                        templateBuffer = await this.helpers.getBinaryDataBuffer(i, templateDocParam);
-                    }
-                    else {
-                        // Assume base64
-                        templateBuffer = Buffer.from(templateDocParam, 'base64');
-                    }
+                    // Charger les documents (depuis chemin, binary ou base64)
+                    const sourceBuffer = await getDocumentBuffer(this, i, sourceDocParam, items);
+                    const templateBuffer = await getDocumentBuffer(this, i, templateDocParam, items);
                     // Charger les DOCX avec PizZip
                     const sourceZip = new pizzip_1.default(sourceBuffer);
                     const templateZip = new pizzip_1.default(templateBuffer);
@@ -392,13 +452,7 @@ class DocxFiller {
                 }
                 else if (operation === 'extract') {
                     const documentParam = this.getNodeParameter('document', i);
-                    let docBuffer;
-                    if (items[i].binary && items[i].binary[documentParam]) {
-                        docBuffer = await this.helpers.getBinaryDataBuffer(i, documentParam);
-                    }
-                    else {
-                        docBuffer = Buffer.from(documentParam, 'base64');
-                    }
+                    const docBuffer = await getDocumentBuffer(this, i, documentParam, items);
                     const zip = new pizzip_1.default(docBuffer);
                     const xml = ((_c = zip.file('word/document.xml')) === null || _c === void 0 ? void 0 : _c.asText()) || '';
                     const paragraphs = extractParagraphs(xml);
@@ -423,13 +477,7 @@ class DocxFiller {
                 }
                 else if (operation === 'analyze') {
                     const documentParam = this.getNodeParameter('document', i);
-                    let docBuffer;
-                    if (items[i].binary && items[i].binary[documentParam]) {
-                        docBuffer = await this.helpers.getBinaryDataBuffer(i, documentParam);
-                    }
-                    else {
-                        docBuffer = Buffer.from(documentParam, 'base64');
-                    }
+                    const docBuffer = await getDocumentBuffer(this, i, documentParam, items);
                     const zip = new pizzip_1.default(docBuffer);
                     const xml = ((_d = zip.file('word/document.xml')) === null || _d === void 0 ? void 0 : _d.asText()) || '';
                     const paragraphs = extractParagraphs(xml);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-docx-filler",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "n8n node to automatically fill DOCX documents (French DC1, DC2, AE forms) with company data. Works as AI Agent tool.",
   "keywords": [
     "n8n-community-node-package",