@ixiam/n8n-nodes-civicrm 1.1.0 → 1.1.19

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 iXiam Global Solutions
+
+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

@@ -1,33 +1,42 @@
 # 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)
 ![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)
 
-
-Community Node for **CiviCRM API v4** (Civi-Go compatible)
+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).
+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.
 
-**About CiviCRM**
-<p align="center">
-<img src="https://civicrm.org/sites/civicrm.org/files/CiviCRM-logo-2019-F2-200px.png" alt="CiviCRM Logo" width="260" />
-</p>
+---
+# 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
 
----
+
 ## Installation
 
 1. In your n8n instance, open:  
+=======
+Community Node for **CiviCRM API v4** (Civi-Go compatible)  
+Developed and maintained by **Ixiam Global Solutions**.
+
+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
 ```
 
@@ -88,6 +97,81 @@ 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**.
+
+| Field | Description |
+|-------|-------------|
+| **Base URL** | The root URL of your CiviCRM instance (without trailing slash). Example: `https://crm.example.org` |
+| **API Token** | Sent as header `X-Civi-Auth: Bearer <token>` |
+
+After entering credentials, click **Save** to validate the connection.
+
+## 📦 Supported Entities
+
+The node includes full API v4 support for the following entities:
+
+| Entity | Operations |
+|--------|------------|
+| **Contact** | get, getMany, create, update, delete |
+| **Membership** | get, getMany, create, update, delete |
+| **Group** | get, getMany, create, update, delete |
+| **Relationship** | get, getMany, create, update, delete |
+| **Activity** | get, getMany, create, update, delete |
+| **Custom API Call** | full custom API4 request |
+
+## 🧩 Key Features
+
+### **1. Dynamic Field Mapping**
+Supports any standard or custom field:
+
+```
+first_name = John
+last_name = Doe
+custom_45 = Blue
+```
+
+### **2. Smart Email, Phone & Address Mapping**
+Two ways to set location-aware fields:
+
+**(A) Simple fields**
+```
+email = test@example.org
+phone.mobile = 600123456
+address.city = Barcelona
+```
+
+**(B) Dynamic prefixes matched to CiviCRM Location Types**
+```
+work.email = user@company.org
+billing.address.postal_code = 80331
+home.phone.phone_type_id = 2
+```
+
+### **3. Default Location Type selectors**
+If no prefix is used, default types are applied.
+
+### **4. Birth Date Normalization**
+Accepted input formats:
+
+- YYYY-MM-DD
+- DD/MM/YYYY
+- DD-MM-YYYY
+- YYYY/MM/DD
+- YYYY.MM.DD
+
+Auto-normalized to `YYYY-MM-DD`.
+
+### **5. GET MANY with JSON Filters**
+```
+>>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
 [
   ["first_name", "LIKE", "Ju%"],
   ["birth_date", ">", "1990-01-01"],
@@ -95,6 +179,7 @@ Example:
 ]
 ```
 
+<<<<<<< HEAD
 ### Birth date normalization  
 Accepted input formats:  
 - YYYY-MM-DD  
@@ -108,6 +193,10 @@ Normalized to `YYYY-MM-DD`.
 ### Custom API Call  
 Example:
 ```json
+=======
+### **6. Custom API Call Mode**
+```
+>>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
 {
   "entity": "Contact",
   "action": "get",
@@ -115,6 +204,7 @@ Example:
 }
 ```
 
+<<<<<<< HEAD
 ---
 
 ## Compatibility
@@ -155,5 +245,13 @@ Email: info@ixiam.com
 ---
 
 ## License
+=======
+## 🧑‍💻 About Ixiam Global Solutions
+
+Website: **https://www.ixiam.com**  
+Contact: **info@ixiam.com**
+
+## 📄 License
+>>>>>>> 03f29e40d265531031a602d4bdcf4724e39bd809
 
 MIT License

package/credentials/CiviCrmApi.credentials.ts

@@ -0,0 +1,58 @@
+import type {
+	ICredentialType,
+	INodeProperties,
+	IHttpRequestMethods,
+} from 'n8n-workflow';
+
+export class CiviCrmApi implements ICredentialType {
+	name = 'civiCrmApi';
+	displayName = 'CiviCRM API';
+	documentationUrl = 'https://docs.civicrm.org/dev/en/latest/api/';
+
+	authenticate = {
+		type: 'generic' as const,
+		properties: {
+			headers: {
+				'X-Civi-Auth': '={{"Bearer " + $credentials.apiToken}}',
+				'Content-Type': 'application/x-www-form-urlencoded',
+			},
+		},
+	};
+
+	// Credential test button
+	test = {
+		request: {
+			method: 'POST' as IHttpRequestMethods,
+			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,
+		},
+	};
+
+	properties: INodeProperties[] = [
+		{
+			displayName: 'Base URL',
+			name: 'baseUrl',
+			type: 'string',
+			default: '',
+			required: true,
+			placeholder: 'https://crm.example.org',
+			description: 'Base URL without a trailing slash.',
+		},
+		{
+			displayName: 'API Token',
+			name: 'apiToken',
+			type: 'string',
+			typeOptions: { password: true },
+			default: '',
+			required: true,
+			description: 'Sent as "X-Civi-Auth: Bearer <token>"',
+		},
+	];
+}

package/dist/credentials/CiviCrmApi.credentials.d.ts

@@ -0,0 +1,30 @@
+import type { ICredentialType, INodeProperties, IHttpRequestMethods } from 'n8n-workflow';
+export declare class CiviCrmApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    authenticate: {
+        type: "generic";
+        properties: {
+            headers: {
+                'X-Civi-Auth': string;
+                'Content-Type': string;
+            };
+        };
+    };
+    test: {
+        request: {
+            method: IHttpRequestMethods;
+            url: string;
+            headers: {
+                'X-Civi-Auth': string;
+                'Content-Type': string;
+            };
+            body: {
+                params: string;
+            };
+            json: boolean;
+        };
+    };
+    properties: INodeProperties[];
+}

package/dist/credentials/CiviCrmApi.credentials.js

@@ -6,6 +6,30 @@ 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',
@@ -13,6 +37,8 @@ class CiviCrmApi {
                 type: 'string',
                 default: '',
                 required: true,
+                placeholder: 'https://crm.example.org',
+                description: 'Base URL without a trailing slash.',
             },
             {
                 displayName: 'API Token',
@@ -21,28 +47,9 @@ class CiviCrmApi {
                 typeOptions: { password: true },
                 default: '',
                 required: true,
+                description: 'Sent as "X-Civi-Auth: Bearer <token>"',
             },
         ];
-        // ← ESTA ES LA PARTE CRÍTICA
-        this.authenticate = {
-            type: 'generic',
-            properties: {
-                headers: {
-                    'X-Civi-Auth': '={{ "Bearer " + $credentials.apiToken }}',
-                },
-            },
-        };
-        this.test = {
-            request: {
-                method: 'POST',
-                url: '={{ $credentials.baseUrl.replace(/\\/$/, "") }}/civicrm/ajax/api4/Contact/get',
-                headers: {
-                    'X-Civi-Auth': '={{ "Bearer " + $credentials.apiToken }}',
-                    'Content-Type': 'application/json',
-                },
-                body: { limit: 1 },
-            },
-        };
     }
 }
 exports.CiviCrmApi = CiviCrmApi;

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

@@ -0,0 +1,14 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class CiviCrm implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            loadOptionValues(this: ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: number;
+            }[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+export default CiviCrm;

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

@@ -29,7 +29,7 @@ async function getLocationTypeMap() {
         limit: 0,
     });
     const map = {};
-    const values = ((res === null || res === void 0 ? void 0 : res.values) || []);
+    const values = (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 === null || res === void 0 ? void 0 : res.values) || []);
+                    const values = (res?.values || []);
                     return values.map((v) => ({
                         name: v.label,
                         value: v.id,
@@ -182,7 +182,6 @@ 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);
@@ -227,7 +226,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: (_b = (_a = res === null || res === void 0 ? void 0 : res.values) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : {} });
+                out.push({ json: res?.values?.[0] ?? {} });
                 continue;
             }
             /* ======================================================
@@ -279,7 +278,7 @@ class CiviCrm {
                     const page = 500;
                     while (true) {
                         const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit: page, offset });
-                        const vals = (_c = r === null || r === void 0 ? void 0 : r.values) !== null && _c !== void 0 ? _c : [];
+                        const vals = r?.values ?? [];
                         for (const v of vals)
                             out.push({ json: v });
                         if (vals.length < page)
@@ -289,7 +288,7 @@ class CiviCrm {
                 }
                 else {
                     const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit });
-                    const vals = (_d = r === null || r === void 0 ? void 0 : r.values) !== null && _d !== void 0 ? _d : [];
+                    const vals = r?.values ?? [];
                     for (const v of vals)
                         out.push({ json: v });
                 }
@@ -441,7 +440,7 @@ class CiviCrm {
             let contactId = id;
             if (isCreate) {
                 const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/create', { values });
-                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;
+                contactId = r?.values?.[0]?.id;
                 if (!contactId)
                     throw new Error('Failed to create contact.');
             }
@@ -527,7 +526,7 @@ class CiviCrm {
                     }
                     : {}),
             });
-            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 : {} });
+            out.push({ json: res?.values?.[0] ?? {} });
         }
         return [out];
     }
@@ -537,7 +536,7 @@ exports.CiviCrm = CiviCrm;
    UTILS
 ============================================================================ */
 function convertValue(val) {
-    const t = String(val !== null && val !== void 0 ? val : '').trim();
+    const t = String(val ?? '').trim();
     if (t === '')
         return '';
     if (t === 'true')

package/dist/nodes/CiviCrm/civicrm.svg

@@ -0,0 +1,28 @@
+<svg xml:space="preserve" style="max-height: 500px" viewBox="190.4982463465553 39.1683 70.07818371607516 70.33139999999999" y="0px" x="0px" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" id="Layer_1" version="1.1" width="70.07818371607516" height="70.33139999999999">
+<style type="text/css">
+	.st0{fill:#086287;}
+	.st1{fill:#81C459;}
+</style>
+<g>
+	<g>
+		<g>
+			<path d="M216.26,104.26C216.26,104.26,216.26,104.26,216.26,104.26c-3.77-0.07-5.2-4.43-5.35-4.92l-12.85-42.11&#xA;&#9;&#9;&#9;&#9;c-0.76-2.47-0.58-4.46,0.51-5.92c0.71-0.94,2.12-2.04,4.83-1.99c0.99,0.02,1.77,0.19,1.85,0.21l42.78,9.97&#xA;&#9;&#9;&#9;&#9;c2.75,0.64,4.44,1.94,5.02,3.85c0.93,3.04-1.65,5.92-1.95,6.24l-29.94,32.12C219.57,103.43,217.91,104.29,216.26,104.26z&#xA;&#9;&#9;&#9;&#9; M203.19,53.73c-0.77-0.01-1.02,0.19-1.06,0.26c-0.22,0.31-0.26,0.44,0.19,1.93l12.85,42.11c0.29,0.9,0.76,1.74,1.18,1.77l0,0&#xA;&#9;&#9;&#9;&#9;c0.01,0,0.52,0,1.57-1.13l29.94-32.12c0.55-0.61,1.06-1.6,0.95-1.9c-0.08-0.22-0.43-0.5-1.77-0.81l-42.78-9.97l0,0&#xA;&#9;&#9;&#9;&#9;C204.24,53.87,203.7,53.74,203.19,53.73z" class="st0"/>
+		</g>
+		<g>
+			<path d="M211.45,100.83c-1.38,0.51-2.83,0.61-3.96,0.24c0,0,0,0,0,0c-3.57-1.17-3.68-5.74-3.68-6.26l0-41l4.21,0.94&#xA;&#9;&#9;&#9;&#9;l0.02,40.15c0.01,0.94,0.25,1.84,0.83,1.94l0,0c0,0,0.3,0.09,1.15-0.3L211.45,100.83z M214.02,94.31l34.62-20.03&#xA;&#9;&#9;&#9;&#9;c0.7-0.42,1.53-1.04,1.46-1.54c-0.01-0.07-0.17-0.52-0.92-1.05l2.9-3.3c1.64,1.25,2.47,2.71,2.47,4.35c0,3.17-3.3,5.17-3.68,5.39&#xA;&#9;&#9;&#9;&#9;l-35.51,20.4L214.02,94.31z M245.14,69.42l-34.02-19.79c0,0-0.85-0.54-1.34-0.7c-0.73-0.24-1.08,0-1.15,0.05&#xA;&#9;&#9;&#9;&#9;c-0.2,0.14-0.27,0.24-0.35,1.24l-4.38-0.82c0.24-1.82,0.95-3.17,2.12-4.03c0.95-0.69,2.62-1.33,5.19-0.5&#xA;&#9;&#9;&#9;&#9;c0.94,0.31,1.63,0.7,1.71,0.74l35.39,20.42L245.14,69.42z" class="st1"/>
+		</g>
+	</g>
+	<g>
+		<path d="M183.02,66.82c-0.48-0.28-0.86-0.67-1.15-1.15c-0.28-0.48-0.42-1-0.42-1.57c0-0.56,0.14-1.09,0.42-1.57&#xA;&#9;&#9;&#9;s0.66-0.86,1.15-1.15s1-0.42,1.57-0.42s1.09,0.14,1.57,0.42s0.86,0.66,1.15,1.15s0.42,1,0.42,1.57c0,0.57-0.14,1.09-0.42,1.57&#xA;&#9;&#9;&#9;c-0.28,0.48-0.66,0.86-1.15,1.15s-1,0.42-1.57,0.42S183.5,67.1,183.02,66.82z M185.93,66.42c0.41-0.24,0.74-0.57,0.98-0.98&#xA;&#9;&#9;&#9;c0.24-0.41,0.36-0.86,0.36-1.35c0-0.48-0.12-0.93-0.36-1.34c-0.24-0.41-0.57-0.73-0.98-0.98c-0.41-0.24-0.86-0.36-1.35-0.36&#xA;&#9;&#9;&#9;c-0.48,0-0.93,0.12-1.34,0.36c-0.41,0.24-0.73,0.57-0.98,0.98c-0.24,0.41-0.36,0.85-0.36,1.34c0,0.49,0.12,0.94,0.36,1.35&#xA;&#9;&#9;&#9;c0.24,0.41,0.57,0.74,0.98,0.98s0.85,0.36,1.34,0.36C185.07,66.79,185.52,66.66,185.93,66.42z M183.37,65.8&#xA;&#9;&#9;&#9;c-0.06-0.05-0.08-0.12-0.08-0.21v-2.83c0-0.11,0.04-0.21,0.11-0.28s0.17-0.12,0.28-0.12h1.05c0.46,0,0.8,0.1,1.03,0.29&#xA;&#9;&#9;&#9;s0.34,0.45,0.34,0.76c0,0.21-0.06,0.39-0.18,0.53c-0.12,0.14-0.28,0.25-0.46,0.32c0.16,0.06,0.3,0.18,0.42,0.35&#xA;&#9;&#9;&#9;c0.12,0.18,0.18,0.42,0.18,0.74v0.24c0,0.08-0.03,0.15-0.09,0.21c-0.06,0.06-0.13,0.09-0.21,0.09s-0.15-0.03-0.21-0.09&#xA;&#9;&#9;&#9;c-0.06-0.06-0.09-0.13-0.09-0.21v-0.16c0-0.25-0.04-0.46-0.11-0.63c-0.07-0.17-0.25-0.26-0.53-0.26h-0.95v1.06&#xA;&#9;&#9;&#9;c0,0.08-0.03,0.15-0.09,0.21c-0.06,0.06-0.13,0.08-0.21,0.08C183.49,65.88,183.42,65.86,183.37,65.8z M184.7,64.02&#xA;&#9;&#9;&#9;c0.25,0,0.45-0.05,0.6-0.15c0.15-0.1,0.22-0.25,0.22-0.44c0-0.18-0.06-0.32-0.19-0.42c-0.13-0.1-0.34-0.14-0.65-0.14h-0.81v1.15&#xA;&#9;&#9;&#9;H184.7z" class="st0"/>
+	</g>
+	<g>
+		<path d="M31.72,88.55c-2.15-1.18-3.85-2.87-5.08-5.08c-1.23-2.21-1.85-4.79-1.85-7.74s0.62-5.53,1.85-7.74&#xA;&#9;&#9;&#9;c1.23-2.21,2.93-3.9,5.08-5.08c2.15-1.18,4.58-1.77,7.29-1.77c1.84,0,3.49,0.22,4.94,0.65c1.45,0.43,2.89,1.06,4.33,1.87&#xA;&#9;&#9;&#9;c0.6,0.32,0.89,0.84,0.89,1.54c0,0.41-0.15,0.77-0.45,1.08c-0.3,0.31-0.69,0.47-1.18,0.47c-0.27,0-0.51-0.05-0.73-0.16&#xA;&#9;&#9;&#9;c-1.19-0.62-2.36-1.1-3.49-1.42c-1.14-0.32-2.45-0.49-3.94-0.49c-2.33,0-4.31,0.48-5.95,1.44c-1.64,0.96-2.87,2.28-3.7,3.94&#xA;&#9;&#9;&#9;c-0.83,1.67-1.24,3.55-1.24,5.67s0.41,4,1.24,5.67c0.83,1.67,2.06,2.98,3.7,3.94c1.64,0.96,3.62,1.44,5.95,1.44&#xA;&#9;&#9;&#9;c1.49,0,2.8-0.16,3.94-0.49c1.14-0.32,2.3-0.8,3.49-1.42c0.22-0.11,0.46-0.16,0.73-0.16c0.49,0,0.88,0.15,1.18,0.45&#xA;&#9;&#9;&#9;c0.3,0.3,0.45,0.66,0.45,1.1c0,0.7-0.3,1.22-0.89,1.54c-1.44,0.81-2.88,1.44-4.33,1.87c-1.45,0.43-3.09,0.65-4.94,0.65&#xA;&#9;&#9;&#9;C36.3,90.32,33.87,89.73,31.72,88.55z" class="st0"/>
+		<path d="M53.47,64.35c-0.41-0.41-0.61-0.89-0.61-1.46v-0.16c0-0.57,0.2-1.06,0.61-1.46c0.41-0.41,0.89-0.61,1.46-0.61&#xA;&#9;&#9;&#9;h0.24c0.57,0,1.06,0.2,1.46,0.61s0.61,0.89,0.61,1.46v0.16c0,0.57-0.2,1.06-0.61,1.46c-0.41,0.41-0.89,0.61-1.46,0.61h-0.24&#xA;&#9;&#9;&#9;C54.37,64.96,53.88,64.76,53.47,64.35z M53.72,89.58c-0.35-0.35-0.53-0.79-0.53-1.3V70.86c0-0.51,0.18-0.96,0.53-1.32&#xA;&#9;&#9;&#9;c0.35-0.37,0.79-0.55,1.3-0.55c0.54,0,0.99,0.18,1.34,0.53c0.35,0.35,0.53,0.8,0.53,1.34v17.43c0,0.51-0.18,0.95-0.55,1.3&#xA;&#9;&#9;&#9;c-0.37,0.35-0.81,0.53-1.32,0.53C54.5,90.11,54.07,89.94,53.72,89.58z" class="st0"/>
+		<path d="M68.5,89.69c-0.41-0.28-0.7-0.64-0.89-1.08l-7.07-16.9c-0.14-0.32-0.2-0.61-0.2-0.85&#xA;&#9;&#9;&#9;c0-0.51,0.18-0.96,0.53-1.32c0.35-0.37,0.79-0.55,1.3-0.55c0.35,0,0.68,0.1,1,0.3c0.31,0.2,0.53,0.45,0.67,0.75l6.22,15.76&#xA;&#9;&#9;&#9;l6.22-15.76c0.14-0.3,0.36-0.55,0.67-0.75c0.31-0.2,0.64-0.3,1-0.3c0.51,0,0.95,0.18,1.3,0.55c0.35,0.37,0.53,0.81,0.53,1.32&#xA;&#9;&#9;&#9;c0,0.24-0.07,0.53-0.2,0.85l-7.07,16.9c-0.19,0.43-0.49,0.79-0.89,1.08s-0.85,0.43-1.34,0.43h-0.41&#xA;&#9;&#9;&#9;C69.36,90.11,68.91,89.97,68.5,89.69z" class="st0"/>
+		<path d="M83.5,64.35c-0.41-0.41-0.61-0.89-0.61-1.46v-0.16c0-0.57,0.2-1.06,0.61-1.46c0.41-0.41,0.89-0.61,1.46-0.61&#xA;&#9;&#9;&#9;h0.24c0.57,0,1.06,0.2,1.46,0.61s0.61,0.89,0.61,1.46v0.16c0,0.57-0.2,1.06-0.61,1.46c-0.41,0.41-0.89,0.61-1.46,0.61h-0.24&#xA;&#9;&#9;&#9;C84.39,64.96,83.9,64.76,83.5,64.35z M83.74,89.58c-0.35-0.35-0.53-0.79-0.53-1.3V70.86c0-0.51,0.18-0.96,0.53-1.32&#xA;&#9;&#9;&#9;c0.35-0.37,0.79-0.55,1.3-0.55c0.54,0,0.99,0.18,1.34,0.53c0.35,0.35,0.53,0.8,0.53,1.34v17.43c0,0.51-0.18,0.95-0.55,1.3&#xA;&#9;&#9;&#9;c-0.37,0.35-0.81,0.53-1.32,0.53C84.53,90.11,84.09,89.94,83.74,89.58z" class="st0"/>
+		<path d="M97.65,88.55c-2.15-1.18-3.85-2.87-5.08-5.08c-1.23-2.21-1.85-4.79-1.85-7.74s0.62-5.53,1.85-7.74&#xA;&#9;&#9;&#9;c1.23-2.21,2.93-3.9,5.08-5.08c2.15-1.18,4.58-1.77,7.29-1.77c1.84,0,3.49,0.22,4.94,0.65c1.45,0.43,2.89,1.06,4.33,1.87&#xA;&#9;&#9;&#9;c0.6,0.32,0.89,0.84,0.89,1.54c0,0.41-0.15,0.77-0.45,1.08c-0.3,0.31-0.69,0.47-1.18,0.47c-0.27,0-0.51-0.05-0.73-0.16&#xA;&#9;&#9;&#9;c-1.19-0.62-2.36-1.1-3.49-1.42c-1.14-0.32-2.45-0.49-3.94-0.49c-2.33,0-4.31,0.48-5.95,1.44c-1.64,0.96-2.87,2.28-3.7,3.94&#xA;&#9;&#9;&#9;c-0.83,1.67-1.24,3.55-1.24,5.67s0.41,4,1.24,5.67c0.83,1.67,2.06,2.98,3.7,3.94c1.64,0.96,3.62,1.44,5.95,1.44&#xA;&#9;&#9;&#9;c1.49,0,2.8-0.16,3.94-0.49c1.14-0.32,2.3-0.8,3.49-1.42c0.22-0.11,0.46-0.16,0.73-0.16c0.49,0,0.88,0.15,1.18,0.45&#xA;&#9;&#9;&#9;c0.3,0.3,0.45,0.66,0.45,1.1c0,0.7-0.3,1.22-0.89,1.54c-1.44,0.81-2.88,1.44-4.33,1.87c-1.45,0.43-3.09,0.65-4.94,0.65&#xA;&#9;&#9;&#9;C102.24,90.32,99.81,89.73,97.65,88.55z" class="st0"/>
+		<path d="M119.9,89.58c-0.35-0.35-0.53-0.79-0.53-1.3V63.42c0-0.51,0.18-0.96,0.53-1.32s0.79-0.55,1.3-0.55h9.47&#xA;&#9;&#9;&#9;c3.68,0,6.45,0.76,8.29,2.28c1.84,1.52,2.76,3.51,2.76,5.97c0,1.62-0.45,3.11-1.36,4.45c-0.91,1.34-2.23,2.31-3.96,2.9&#xA;&#9;&#9;&#9;c1.95,0.51,3.28,1.73,4,3.64c0.72,1.91,1.08,3.79,1.08,5.63v1.87c0,0.51-0.18,0.95-0.53,1.3c-0.35,0.35-0.79,0.53-1.3,0.53&#xA;&#9;&#9;&#9;c-0.57,0-1.02-0.17-1.36-0.51c-0.34-0.34-0.51-0.78-0.51-1.32v-1.22c0-1.35-0.12-2.61-0.37-3.76s-0.83-2.18-1.75-3.09&#xA;&#9;&#9;&#9;c-0.92-0.91-2.32-1.36-4.18-1.36h-8.41v9.43c0,0.51-0.18,0.95-0.55,1.3s-0.81,0.53-1.32,0.53&#xA;&#9;&#9;&#9;C120.68,90.11,120.25,89.94,119.9,89.58z M130.42,75.37c2.33,0,4.18-0.46,5.55-1.38c1.37-0.92,2.05-2.22,2.05-3.9&#xA;&#9;&#9;&#9;c0-1.62-0.59-2.87-1.77-3.74c-1.18-0.87-3.19-1.3-6.03-1.3h-7.15v10.32H130.42z" class="st0"/>
+		<path d="M146.71,89.58c-0.35-0.35-0.53-0.79-0.53-1.3V64.03c0-0.73,0.26-1.36,0.77-1.89&#xA;&#9;&#9;&#9;c0.51-0.53,1.14-0.79,1.87-0.79h1.34c0.54,0,1.04,0.16,1.48,0.49c0.45,0.33,0.78,0.73,1,1.22l9.22,22.99l9.22-22.99&#xA;&#9;&#9;&#9;c0.22-0.49,0.55-0.89,1-1.22c0.45-0.32,0.94-0.49,1.48-0.49h1.34c0.73,0,1.35,0.26,1.87,0.79c0.51,0.53,0.77,1.16,0.77,1.89v24.25&#xA;&#9;&#9;&#9;c0,0.51-0.18,0.95-0.53,1.3c-0.35,0.35-0.79,0.53-1.3,0.53c-0.52,0-0.96-0.18-1.32-0.53c-0.37-0.35-0.55-0.79-0.55-1.3V65.21&#xA;&#9;&#9;&#9;l-9.38,23.2c-0.22,0.51-0.56,0.93-1.04,1.24c-0.47,0.31-1,0.47-1.56,0.47s-1.09-0.16-1.56-0.47c-0.47-0.31-0.82-0.72-1.04-1.24&#xA;&#9;&#9;&#9;l-9.38-23.2v23.08c0,0.51-0.18,0.95-0.55,1.3s-0.81,0.53-1.32,0.53C147.5,90.11,147.06,89.94,146.71,89.58z" class="st0"/>
+	</g>
+</g>
+</svg>

package/dist/nodes/CiviCrm/descriptions/generic.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const genericFields: INodeProperties[];
+export declare const upsertFields: INodeProperties[];

package/dist/nodes/CiviCrm/descriptions/resources.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const resourceProp: INodeProperties;
+export declare const operationProp: INodeProperties;

package/dist/nodes/transport/GenericFunctions.d.ts

@@ -0,0 +1,10 @@
+import type { IExecuteFunctions } from 'n8n-workflow';
+/**
+ * Ejecuta una llamada a la API de CiviCRM v4 (Civi-Go)
+ * Usa form-urlencoded con el campo "params" serializado
+ */
+export declare function civicrmApiRequest(this: IExecuteFunctions, method: 'POST', path: string, body: Record<string, unknown>): Promise<any>;
+/**
+ * Devuelve el cuerpo estándar para las llamadas API4 (plano)
+ */
+export declare function api4(entity: string, action: string, params?: Record<string, unknown>): Record<string, unknown>;

package/dist/nodes/transport/GenericFunctions.js

@@ -7,7 +7,6 @@ const n8n_workflow_1 = require("n8n-workflow");
  * 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,
@@ -18,7 +17,7 @@ async function civicrmApiRequest(method, path, body) {
         },
         // cuerpo plano como espera Civi-Go
         body: {
-            params: JSON.stringify((_a = body.params) !== null && _a !== void 0 ? _a : body),
+            params: JSON.stringify(body.params ?? body),
         },
         json: true,
     };