@ixiam/n8n-nodes-civicrm 1.1.19 → 1.1.23

package/README.md

@@ -1,5 +1,4 @@
 # n8n-nodes-civicrm
-<<<<<<< HEAD
 
 ![n8n Community Node](https://img.shields.io/badge/n8n-Community%20Node-blue.svg)
 ![CiviCRM API v4](https://img.shields.io/badge/CiviCRM-API%20v4-orange.svg)
@@ -8,101 +7,37 @@
 Community Node for **CiviCRM API v4** (Civi-Go compatible)  
 Developed and maintained by **Ixiam Global Solutions**.
 
-This package provides integration between **n8n** and **CiviCRM API v4**, supporting create, update, delete operations, advanced filtering, dynamic location types, and structured sub-entities (email, phone, address).  
-Custom fields are **not** supported.
+This node enables full integration between **n8n** and **CiviCRM API v4**, supporting create/update/delete operations, smart field mapping, dynamic location types, and advanced filtering on GET operations.
 
 ---
-# About CiviCRM
-
-CiviCRM is an open-source Constituent Relationship Management platform designed for nonprofits, NGOs, and advocacy organizations. It supports contact management, memberships, contributions, event registration, email marketing, case management, and reporting. CiviCRM integrates with WordPress, Drupal, and Joomla.
 
-Download: https://civicrm.org/download
+## About CiviCRM
 
+<p align="center">
+  <img src="https://civicrm.org/sites/civicrm.org/files/CiviCRM-logo-2019-F2-200px.png" alt="CiviCRM Logo" width="200"/>
+</p>
 
-## Installation
+CiviCRM is an open-source Constituent Relationship Management platform designed for nonprofits, NGOs, and advocacy organizations. It supports contact management, memberships, contributions, event registration, email marketing, case management, and reporting. CiviCRM integrates with WordPress, Drupal, and Joomla.
 
-1. In your n8n instance, open:  
-=======
-Community Node for **CiviCRM API v4** (Civi-Go compatible)  
-Developed and maintained by **Ixiam Global Solutions**.
+Download: https://civicrm.org/download
 
-This node enables full integration between **n8n** and **CiviCRM API v4**, supporting create/update/delete operations, smart field mapping, dynamic location types, and advanced filtering on GET operations.
+---
 
 ## 🚀 Installation
 
 1. In your n8n instance, go to:  
->>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
    **Settings → Community Nodes → Install**
 2. Enter the package name:
 
 ```
-<<<<<<< HEAD
 @ixiam/n8n-nodes-civicrm
 ```
 
-3. Confirm installation and enable Community Nodes.
+3. Approve installation and enable Community Nodes.
 4. If running n8n via Docker, restart/rebuild for the node to load.
 
 ---
 
-## Credentials
-
-Authentication uses **Bearer Token**.
-
-| Field | Description |
-|-------|-------------|
-| **Base URL** | Root URL of your CiviCRM instance (no trailing slash). Example: `https://crm.example.org` |
-| **API Token** | Sent as header `X-Civi-Auth: Bearer <token>` |
-
----
-
-## Supported Entities
-
-This node implements API v4 operations for:
-
-- Contact  
-- Membership  
-- Group  
-- Relationship  
-- Activity  
-- Custom API Call (raw API4 request)
-
-Each entity supports:
-- get  
-- getMany  
-- create  
-- update  
-- delete  
-
----
-
-## Features
-
-### Email, phone and address with location types  
-Two mapping modes:
-
-Simple:
-```
-email = test@example.org
-address.city = Barcelona
-```
-
-With location prefixes:
-```
-work.email = user@company.org
-billing.address.postal_code = 08014
-home.phone.phone_type_id = 2
-```
-
-### GET MANY with JSON filters  
-Example:
-```json
-=======
-n8n-nodes-civicrm
-```
-
-3. Approve installation and enable Community Nodes.
-
 ## 🔐 Credentials
 
 The node uses **Bearer Token Authentication**.
@@ -114,6 +49,8 @@ The node uses **Bearer Token Authentication**.
 
 After entering credentials, click **Save** to validate the connection.
 
+---
+
 ## 📦 Supported Entities
 
 The node includes full API v4 support for the following entities:
@@ -127,6 +64,8 @@ The node includes full API v4 support for the following entities:
 | **Activity** | get, getMany, create, update, delete |
 | **Custom API Call** | full custom API4 request |
 
+---
+
 ## 🧩 Key Features
 
 ### **1. Dynamic Field Mapping**
@@ -170,8 +109,8 @@ Accepted input formats:
 Auto-normalized to `YYYY-MM-DD`.
 
 ### **5. GET MANY with JSON Filters**
-```
->>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
+Example:
+```json
 [
   ["first_name", "LIKE", "Ju%"],
   ["birth_date", ">", "1990-01-01"],
@@ -179,24 +118,9 @@ Auto-normalized to `YYYY-MM-DD`.
 ]
 ```
 
-<<<<<<< HEAD
-### Birth date normalization  
-Accepted input formats:  
-- YYYY-MM-DD  
-- DD/MM/YYYY  
-- DD-MM-YYYY  
-- YYYY/MM/DD  
-- YYYY.MM.DD  
-
-Normalized to `YYYY-MM-DD`.
-
-### Custom API Call  
+### **6. Custom API Call Mode**
 Example:
 ```json
-=======
-### **6. Custom API Call Mode**
-```
->>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
 {
   "entity": "Contact",
   "action": "get",
@@ -204,7 +128,6 @@ Example:
 }
 ```
 
-<<<<<<< HEAD
 ---
 
 ## Compatibility
@@ -219,14 +142,14 @@ Example:
 
 Clone the repository and run:
 
-```
+```bash
 npm install
 npm run dev
 ```
 
 Build:
 
-```
+```bash
 npm run build
 ```
 
@@ -238,20 +161,13 @@ Pull requests and issues are welcome in the GitHub repository.
 
 ---
 
-## About Ixiam Global Solutions  
-Website: https://www.ixiam.com  
-Email: info@ixiam.com  
-
----
-
-## License
-=======
 ## 🧑‍💻 About Ixiam Global Solutions
 
 Website: **https://www.ixiam.com**  
 Contact: **info@ixiam.com**
 
+---
+
 ## 📄 License
->>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
 
 MIT License

package/dist/credentials/CiviCrmApi.credentials.js

@@ -6,30 +6,6 @@ class CiviCrmApi {
         this.name = 'civiCrmApi';
         this.displayName = 'CiviCRM API';
         this.documentationUrl = 'https://docs.civicrm.org/dev/en/latest/api/';
-        this.authenticate = {
-            type: 'generic',
-            properties: {
-                headers: {
-                    'X-Civi-Auth': '={{"Bearer " + $credentials.apiToken}}',
-                    'Content-Type': 'application/x-www-form-urlencoded',
-                },
-            },
-        };
-        // Credential test button
-        this.test = {
-            request: {
-                method: 'POST',
-                url: '={{$credentials.baseUrl.replace(/\\/$/, "")}}/civicrm/ajax/api4/Contact/get',
-                headers: {
-                    'X-Civi-Auth': '={{"Bearer " + $credentials.apiToken}}',
-                    'Content-Type': 'application/x-www-form-urlencoded',
-                },
-                body: {
-                    params: '={"limit":1}', // API4 compatible
-                },
-                json: true,
-            },
-        };
         this.properties = [
             {
                 displayName: 'Base URL',
@@ -37,8 +13,6 @@ class CiviCrmApi {
                 type: 'string',
                 default: '',
                 required: true,
-                placeholder: 'https://crm.example.org',
-                description: 'Base URL without a trailing slash.',
             },
             {
                 displayName: 'API Token',
@@ -47,9 +21,26 @@ class CiviCrmApi {
                 typeOptions: { password: true },
                 default: '',
                 required: true,
-                description: 'Sent as "X-Civi-Auth: Bearer <token>"',
             },
         ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-Civi-Auth': '={{ "Bearer " + $credentials.apiToken }}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                url: '={{ $credentials.baseUrl }}/civicrm/ajax/api4/Contact/get',
+                method: 'POST',
+                body: {
+                    limit: 1,
+                    select: ['id']
+                },
+            },
+        };
     }
 }
 exports.CiviCrmApi = CiviCrmApi;

package/dist/nodes/CiviCrm/CiviCrm.node.js

@@ -29,7 +29,7 @@ async function getLocationTypeMap() {
         limit: 0,
     });
     const map = {};
-    const values = (res?.values || []);
+    const values = ((res === null || res === void 0 ? void 0 : res.values) || []);
     for (const v of values) {
         const name = v.name || '';
         const label = v.label || '';
@@ -169,7 +169,7 @@ class CiviCrm {
                         body: { params: JSON.stringify({ limit: 50, select: ['id', 'label'] }) },
                         json: true,
                     });
-                    const values = (res?.values || []);
+                    const values = ((res === null || res === void 0 ? void 0 : res.values) || []);
                     return values.map((v) => ({
                         name: v.label,
                         value: v.id,
@@ -182,6 +182,7 @@ class CiviCrm {
        EXECUTE
     ============================================================================ */
     async execute() {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         const items = this.getInputData();
         const out = [];
         const resource = this.getNodeParameter('resource', 0);
@@ -226,7 +227,7 @@ class CiviCrm {
                         select: ['id', 'name', 'title', 'subject', 'display_name'],
                     };
                 const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, params);
-                out.push({ json: res?.values?.[0] ?? {} });
+                out.push({ json: (_b = (_a = res === null || res === void 0 ? void 0 : res.values) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : {} });
                 continue;
             }
             /* ======================================================
@@ -241,7 +242,7 @@ class CiviCrm {
                     try {
                         where = JSON.parse(whereJson);
                     }
-                    catch {
+                    catch (error) {
                         throw new Error('Invalid JSON in whereJson');
                     }
                 }
@@ -276,19 +277,23 @@ class CiviCrm {
                 if (returnAll) {
                     let offset = 0;
                     const page = 500;
-                    while (true) {
+                    let hasMore = true;
+                    while (hasMore) {
                         const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit: page, offset });
-                        const vals = r?.values ?? [];
+                        const vals = (_c = r === null || r === void 0 ? void 0 : r.values) !== null && _c !== void 0 ? _c : [];
                         for (const v of vals)
                             out.push({ json: v });
-                        if (vals.length < page)
-                            break;
-                        offset += page;
+                        if (vals.length < page) {
+                            hasMore = false;
+                        }
+                        else {
+                            offset += page;
+                        }
                     }
                 }
                 else {
                     const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit });
-                    const vals = r?.values ?? [];
+                    const vals = (_d = r === null || r === void 0 ? void 0 : r.values) !== null && _d !== void 0 ? _d : [];
                     for (const v of vals)
                         out.push({ json: v });
                 }
@@ -322,31 +327,6 @@ class CiviCrm {
             const emailData = {};
             const phoneData = {};
             const addressData = {};
-            function normalizeBirthDate(input) {
-                if (!input)
-                    return input;
-                let v = input.trim();
-                if (/^\d{4}-\d{2}-\d{2}$/.test(v)) {
-                }
-                else if (/^\d{2}\/\d{2}\/\d{4}$/.test(v)) {
-                    const [d, m, y] = v.split('/');
-                    v = `${y}-${m}-${d}`;
-                }
-                else if (/^\d{2}-\d{2}-\d{4}$/.test(v)) {
-                    const [d, m, y] = v.split('-');
-                    v = `${y}-${m}-${d}`;
-                }
-                else if (/^\d{4}\/\d{2}\/\d{2}$/.test(v)) {
-                    v = v.replace(/\//g, '-');
-                }
-                else if (/^\d{4}\.\d{2}\.\d{2}$/.test(v)) {
-                    v = v.replace(/\./g, '-');
-                }
-                const dt = new Date(v);
-                if (isNaN(dt.getTime()))
-                    throw new Error(`Invalid birth_date: ${input}`);
-                return v;
-            }
             let locationTypeMap = {};
             if (resource === 'contact') {
                 locationTypeMap = await getLocationTypeMap.call(this);
@@ -440,7 +420,7 @@ class CiviCrm {
             let contactId = id;
             if (isCreate) {
                 const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/create', { values });
-                contactId = r?.values?.[0]?.id;
+                contactId = (_f = (_e = r === null || r === void 0 ? void 0 : r.values) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.id;
                 if (!contactId)
                     throw new Error('Failed to create contact.');
             }
@@ -526,7 +506,7 @@ class CiviCrm {
                     }
                     : {}),
             });
-            out.push({ json: res?.values?.[0] ?? {} });
+            out.push({ json: (_h = (_g = res === null || res === void 0 ? void 0 : res.values) === null || _g === void 0 ? void 0 : _g[0]) !== null && _h !== void 0 ? _h : {} });
         }
         return [out];
     }
@@ -536,7 +516,7 @@ exports.CiviCrm = CiviCrm;
    UTILS
 ============================================================================ */
 function convertValue(val) {
-    const t = String(val ?? '').trim();
+    const t = String(val !== null && val !== void 0 ? val : '').trim();
     if (t === '')
         return '';
     if (t === 'true')
@@ -550,7 +530,35 @@ function convertValue(val) {
         if (typeof j === 'object')
             return j;
     }
-    catch { }
+    catch (error) {
+        // Not valid JSON, return original value
+    }
     return val;
 }
+function normalizeBirthDate(input) {
+    if (!input)
+        return input;
+    let v = input.trim();
+    if (/^\d{4}-\d{2}-\d{2}$/.test(v)) {
+        // Already in correct format
+    }
+    else if (/^\d{2}\/\d{2}\/\d{4}$/.test(v)) {
+        const [d, m, y] = v.split('/');
+        v = `${y}-${m}-${d}`;
+    }
+    else if (/^\d{2}-\d{2}-\d{4}$/.test(v)) {
+        const [d, m, y] = v.split('-');
+        v = `${y}-${m}-${d}`;
+    }
+    else if (/^\d{4}\/\d{2}\/\d{2}$/.test(v)) {
+        v = v.replace(/\//g, '-');
+    }
+    else if (/^\d{4}\.\d{2}\.\d{2}$/.test(v)) {
+        v = v.replace(/\./g, '-');
+    }
+    const dt = new Date(v);
+    if (isNaN(dt.getTime()))
+        throw new Error(`Invalid birth_date: ${input}`);
+    return v;
+}
 exports.default = CiviCrm;

package/dist/nodes/transport/GenericFunctions.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.api4 = exports.civicrmApiRequest = void 0;
+exports.civicrmApiRequest = civicrmApiRequest;
+exports.api4 = api4;
 const n8n_workflow_1 = require("n8n-workflow");
 /**
  * Ejecuta una llamada a la API de CiviCRM v4 (Civi-Go)
  * Usa form-urlencoded con el campo "params" serializado
  */
 async function civicrmApiRequest(method, path, body) {
+    var _a;
     const { baseUrl, apiToken } = (await this.getCredentials('civiCrmApi'));
     const options = {
         method,
@@ -17,7 +19,7 @@ async function civicrmApiRequest(method, path, body) {
         },
         // cuerpo plano como espera Civi-Go
         body: {
-            params: JSON.stringify(body.params ?? body),
+            params: JSON.stringify((_a = body.params) !== null && _a !== void 0 ? _a : body),
         },
         json: true,
     };
@@ -29,7 +31,6 @@ async function civicrmApiRequest(method, path, body) {
         throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
     }
 }
-exports.civicrmApiRequest = civicrmApiRequest;
 /**
  * Devuelve el cuerpo estándar para las llamadas API4 (plano)
  */
@@ -37,4 +38,3 @@ function api4(entity, action, params = {}) {
     // devolvemos los parámetros planos, no anidados
     return params;
 }
-exports.api4 = api4;

package/package.json

@@ -1,126 +1,63 @@
 {
-
   "name": "@ixiam/n8n-nodes-civicrm",
-
-  "version": "1.1.19",
-
+  "version": "1.1.23",
   "description": "Full-featured CiviCRM API v4 integration for n8n with support for Contacts, Memberships, Groups, Relationships, Activities and structured sub-entities like Email, Phone, and Address.",
-
   "license": "MIT",
-
   "keywords": [
-
     "n8n-community-node-package",
-
     "civicrm",
-
     "api4",
-
     "crm",
-
     "automation"
-
   ],
-
   "main": "dist/index.js",
-
   "types": "dist/index.d.ts",
-
   "scripts": {
-
     "dev": "n8n-node dev",
-
     "build": "n8n-node build && pnpm run copy:assets",
-
     "copy:assets": "cp src/nodes/CiviCrm/civicrm.svg dist/nodes/CiviCrm/",
-
     "lint": "n8n-node lint",
-
     "release": "n8n-node release",
-
     "test": "npm run build"
-
   },
-
   "repository": {
-
     "type": "git",
-
     "url": "git+https://github.com/ixiam/n8n-nodes-civicrm.git"
-
   },
-
   "homepage": "https://www.ixiam.com",
-
   "bugs": {
-
     "url": "https://github.com/ixiam/n8n-nodes-civicrm/issues"
-
   },
-
   "author": "Julian Reartes <j.reartes@ixiam.com>",
-
   "engines": {
-
     "node": ">=18"
-
   },
-
   "n8n": {
-
     "nodes": [
-
       "dist/nodes/CiviCrm/CiviCrm.node.js"
-
     ],
-
     "credentials": [
-
       "dist/credentials/CiviCrmApi.credentials.js"
-
     ]
-
   },
-
   "devDependencies": {
-
     "@n8n/node-cli": "0.16.0",
-
     "@types/node": "^20.11.30",
-
     "@typescript-eslint/eslint-plugin": "^7.0.0",
-
     "@typescript-eslint/parser": "^7.0.0",
-
     "eslint": "8.57.0",
-
     "eslint-plugin-n8n-nodes-base": "1.16.4",
-
     "n8n-core": "^1.0.0",
-
     "n8n-workflow": "^1.0.0",
-
     "typescript": "^5.0.0"
-
   },
-
   "pnpm": {
-
     "overrides": {
-
       "eslint": "8.57.0",
-
       "@typescript-eslint/parser": "6.21.0",
-
       "@typescript-eslint/eslint-plugin": "6.21.0",
-
       "change-case": "4.1.2"
-
     }
-
   },
-
   "packageManager": "pnpm@10.18.2+sha512.9fb969fa749b3ade6035e0f109f0b8a60b5d08a1a87fdf72e337da90dcc93336e2280ca4e44f2358a649b83c17959e9993e777c2080879f3801e6f0d999ad3dd"
-
-}
-
+}

package/reload-in-docker.md

@@ -0,0 +1,68 @@
+# Reload Node in Docker n8n
+
+If you're loading this node from a local folder in Docker and seeing cached/old versions, try these steps:
+
+## Option 1: Restart Docker Container (Quick)
+```bash
+# Restart your n8n container
+docker restart <container-name>
+# or if using docker-compose
+docker-compose restart
+```
+
+## Option 2: Clear n8n Cache (Better)
+```bash
+# Stop the container
+docker stop <container-name>
+
+# Remove the container (keeps volumes)
+docker rm <container-name>
+
+# Start fresh
+docker-compose up -d
+# or your docker run command
+```
+
+## Option 3: Verify Volume Mount
+If you're using a volume mount like `-v /path/to/n8n-nodes-civicrm:/data/custom-nodes/n8n-nodes-civicrm`:
+
+1. Make sure the path points to THIS directory
+2. Verify the dist folder is being mounted:
+```bash
+docker exec <container-name> ls -la /data/custom-nodes/n8n-nodes-civicrm/dist/credentials/
+docker exec <container-name> cat /data/custom-nodes/n8n-nodes-civicrm/dist/credentials/CiviCrmApi.credentials.js | grep baseURL
+```
+
+## Option 4: Check n8n Custom Nodes Path
+If using `N8N_CUSTOM_EXTENSION_ENV` environment variable:
+
+```bash
+# Check what path n8n is using
+docker exec <container-name> env | grep N8N_CUSTOM
+
+# Verify the file exists in that path
+docker exec <container-name> ls -la <custom-path>/dist/credentials/
+```
+
+## Option 5: Force Rebuild and Reload
+```bash
+# In this directory, clean and rebuild
+npm run build
+
+# If using npm link
+npm link
+
+# Then restart n8n container
+docker restart <container-name>
+```
+
+## Verify the Fix
+After restarting, check if the error is gone. The built file should have:
+```javascript
+baseURL: '={{ $credentials.baseUrl }}',
+```
+
+NOT:
+```javascript
+baseURL: '={{ $credentials.baseUrl.replace(/\\/$/, "") }}',
+```