@ixiam/n8n-nodes-civicrm 0.2.4 → 0.3.8

package/.eslintignore

@@ -0,0 +1 @@
+dist/

package/.eslintrc.cjs

@@ -0,0 +1,10 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint','n8n-nodes-base'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:n8n-nodes-base/community'
+  ],
+  ignorePatterns: ['dist/**'],
+};

package/credentials/CiviCrmApi.credentials.ts

@@ -0,0 +1,61 @@
+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/v4/';
+
+  authenticate = {
+    type: 'generic' as const,
+    properties: {
+      headers: {
+        'X-Civi-Auth': '={{"Bearer " + $credentials.apiToken}}',
+        'Content-Type': 'application/json',
+      },
+    },
+  };
+
+  // Button "Test" in credential UI
+  test = {
+    request: {
+      // IMPORTANT: method must be typed as IHttpRequestMethods
+      method: 'POST' as IHttpRequestMethods,
+      url: '={{$credentials.baseUrl.replace(/\\/$/, "")}}/civicrm/ajax/api4/Contact/get',
+      headers: {
+        'X-Civi-Auth': '={{"Bearer " + $credentials.apiToken}}',
+        'Content-Type': 'application/json',
+      },
+      body: {
+        entity: 'Contact',
+        action: 'get',
+        params: { limit: 1 },
+      },
+      json: true,
+    },
+  };
+
+  properties: INodeProperties[] = [
+    {
+      displayName: 'Base URL',
+      name: 'baseUrl',
+      type: 'string',
+      default: '',
+      required: true,
+      placeholder: 'https://crm.example.org',
+      description: 'Sin la barra final',
+    },
+    {
+      displayName: 'API Token',
+      name: 'apiToken',
+      type: 'string',
+      typeOptions: { password: true },
+      default: '',
+      required: true,
+      description: 'Se envía como X-Civi-Auth: Bearer <token>',
+    },
+  ];
+}

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

@@ -11,3 +11,4 @@ export declare class CiviCrm implements INodeType {
     };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }
+export default CiviCrm;

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

@@ -10,6 +10,11 @@ const ENTITY_MAP = {
     case: 'Case',
     contribution: 'Contribution',
     membership: 'Membership',
+    participant: 'Participant',
+    group: 'Group',
+    relationship: 'Relationship',
+    email: 'Email',
+    activity: 'Activity',
 };
 /**
  * Nodo principal CiviCRM para n8n
@@ -22,7 +27,7 @@ class CiviCrm {
             icon: 'file:civicrm.svg',
             group: ['transform'],
             version: 1,
-            description: 'Interact with CiviCRM API v4',
+            description: 'Interact with CiviCRM API v4 (Civi-Go compatible)',
             defaults: { name: 'CiviCRM' },
             inputs: ['main'],
             outputs: ['main'],
@@ -52,9 +57,11 @@ class CiviCrm {
                         url,
                         headers: {
                             'X-Civi-Auth': `Bearer ${apiToken}`,
-                            'Content-Type': 'application/json',
+                            'Content-Type': 'application/x-www-form-urlencoded',
+                        },
+                        body: {
+                            params: JSON.stringify({ limit: 5 }),
                         },
-                        body: (0, GenericFunctions_1.api4)('OptionValue', 'get', { limit: 5 }),
                         json: true,
                     });
                     const values = (res?.values || []);
@@ -71,42 +78,68 @@ class CiviCrm {
         const out = [];
         const resource = this.getNodeParameter('resource', 0);
         const operation = this.getNodeParameter('operation', 0);
+        const entity = ENTITY_MAP[resource];
         for (let i = 0; i < items.length; i++) {
-            const entity = ENTITY_MAP[resource];
-            // GET
+            // === GET ===
             if (operation === 'get') {
                 const id = this.getNodeParameter('id', i);
-                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, (0, GenericFunctions_1.api4)(entity, 'get', { where: [['id', '=', id]], limit: 1 }));
+                const params = {
+                    where: [['id', '=', id]],
+                    limit: 1,
+                    select: [
+                        'id',
+                        'display_name',
+                        'first_name',
+                        'last_name',
+                        'contact_type',
+                        'email.email',
+                        'phone.phone',
+                        'address.city',
+                        'address.country_id:label',
+                        'address.postal_code',
+                        'address.street_address',
+                    ],
+                    join: [
+                        ['Email AS email', 'LEFT'],
+                        ['Phone AS phone', 'LEFT'],
+                        ['Address AS address', 'LEFT'],
+                    ],
+                };
+                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, params);
                 out.push({ json: (res?.values?.[0] ?? {}) });
             }
-            // GET MANY
+            // === GET MANY ===
             if (operation === 'getMany') {
                 const returnAll = this.getNodeParameter('returnAll', i, false);
                 const limit = this.getNodeParameter('limit', i, 100);
                 const whereJson = this.getNodeParameter('whereJson', i, '');
-                let where;
-                if (whereJson) {
-                    try {
-                        where = JSON.parse(whereJson);
-                    }
-                    catch (e) {
-                        throw new Error('Where (JSON) debe ser JSON válido: usa un objeto o un array de condiciones.');
-                    }
-                }
-                // Normalize where: allow object or array; API4 accepts both
-                if (where && typeof where === 'object' && !Array.isArray(where)) {
-                    where = where;
-                }
-                if (Array.isArray(where)) {
-                    // leave as-is; expected [[field, op, value], ...]
-                }
-                // Cap limit to a reasonable page size
-                const cappedLimit = Math.max(1, Math.min(limit, 500));
+                const where = whereJson ? JSON.parse(whereJson) : undefined;
+                const baseParams = {
+                    where,
+                    select: [
+                        'id',
+                        'display_name',
+                        'first_name',
+                        'last_name',
+                        'contact_type',
+                        'email.email',
+                        'phone.phone',
+                        'address.city',
+                        'address.country_id:label',
+                        'address.postal_code',
+                        'address.street_address',
+                    ],
+                    join: [
+                        ['Email AS email', 'LEFT'],
+                        ['Phone AS phone', 'LEFT'],
+                        ['Address AS address', 'LEFT'],
+                    ],
+                };
                 if (returnAll) {
                     let offset = 0;
                     const page = 500;
                     while (true) {
-                        const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, (0, GenericFunctions_1.api4)(entity, 'get', { where, limit: page, offset }));
+                        const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...baseParams, limit: page, offset });
                         const vals = (res?.values ?? []);
                         for (const v of vals)
                             out.push({ json: v });
@@ -116,41 +149,43 @@ class CiviCrm {
                     }
                 }
                 else {
-                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, (0, GenericFunctions_1.api4)(entity, 'get', { where, limit: cappedLimit, offset: 0 }));
-                    let vals = (res?.values ?? []);
-                    if (vals.length > cappedLimit) {
-                        vals = vals.slice(0, cappedLimit);
-                    }
+                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...baseParams, limit });
+                    const vals = (res?.values ?? []);
                     for (const v of vals)
                         out.push({ json: v });
                 }
             }
-            // CREATE
+            // === CREATE ===
             if (operation === 'create') {
                 const pairs = this.getNodeParameter('fields.field', i, []);
-                const params = Object.fromEntries(pairs
+                const values = Object.fromEntries(pairs
                     .filter((p) => p.fieldName)
                     .map((p) => [p.fieldName, convertValue(p.fieldValue)]));
-                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/create`, (0, GenericFunctions_1.api4)(entity, 'create', params));
+                const params = { values };
+                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/create`, params);
                 out.push({ json: res });
             }
-            // UPDATE
+            // === UPDATE ===
             if (operation === 'update') {
                 const id = this.getNodeParameter('id', i);
                 const pairs = this.getNodeParameter('fields.field', i, []);
+                const values = Object.fromEntries(pairs
+                    .filter((p) => p.fieldName)
+                    .map((p) => [p.fieldName, convertValue(p.fieldValue)]));
                 const params = {
-                    id,
-                    ...Object.fromEntries(pairs
-                        .filter((p) => p.fieldName)
-                        .map((p) => [p.fieldName, convertValue(p.fieldValue)])),
+                    values,
+                    where: [['id', '=', id]],
                 };
-                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/update`, (0, GenericFunctions_1.api4)(entity, 'update', params));
+                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/update`, params);
                 out.push({ json: res });
             }
-            // DELETE
+            // === DELETE ===
             if (operation === 'delete') {
                 const id = this.getNodeParameter('id', i);
-                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/delete`, (0, GenericFunctions_1.api4)(entity, 'delete', { id }));
+                const params = {
+                    where: [['id', '=', id]],
+                };
+                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/delete`, params);
                 out.push({ json: res });
             }
         }
@@ -179,3 +214,5 @@ function convertValue(val) {
     catch { }
     return val;
 }
+// Requerido por n8n >=1.110
+exports.default = CiviCrm;

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

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

package/dist/nodes/CiviCrm/descriptions/resources.js

@@ -1,33 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.operationProp = exports.resourceProp = void 0;
-const RESOURCE_OPTIONS = [
-    { name: 'Contact', value: 'contact' },
-    { name: 'Event', value: 'event' },
-    { name: 'Case', value: 'case' },
-    { name: 'Contribution', value: 'contribution' },
-    { name: 'Membership', value: 'membership' },
-];
 exports.resourceProp = {
     displayName: 'Resource',
     name: 'resource',
     type: 'options',
     default: 'contact',
-    options: RESOURCE_OPTIONS, // sin readonly/as const
+    options: [
+        { name: 'Contact', value: 'contact' },
+        { name: 'Event', value: 'event' },
+        { name: 'Case', value: 'case' },
+        { name: 'Contribution', value: 'contribution' },
+        { name: 'Membership', value: 'membership' },
+        { name: 'Participant', value: 'participant' },
+        { name: 'Group', value: 'group' },
+        { name: 'Relationship', value: 'relationship' },
+        { name: 'Email', value: 'email' },
+        { name: 'Activity', value: 'activity' },
+        { name: 'Custom API Call', value: 'customApi' },
+    ],
 };
 exports.operationProp = {
     displayName: 'Operation',
     name: 'operation',
     type: 'options',
-    displayOptions: {
-        show: { resource: ['contact', 'event', 'case', 'contribution', 'membership'] },
-    },
-    default: 'get',
+    default: 'getMany',
     options: [
+        { name: 'Create', value: 'create' },
+        { name: 'Delete', value: 'delete' },
         { name: 'Get', value: 'get' },
         { name: 'Get Many', value: 'getMany' },
-        { name: 'Create', value: 'create' },
         { name: 'Update', value: 'update' },
-        { name: 'Delete', value: 'delete' },
-    ], // tipo mutable
+    ],
 };

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

@@ -1,13 +1,10 @@
-import { type IExecuteFunctions } from 'n8n-workflow';
+import type { IExecuteFunctions } from 'n8n-workflow';
 /**
- * Ejecuta una llamada a la API de CiviCRM v4
+ * 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 formato estándar para una llamada API4
+ * Devuelve el cuerpo estándar para las llamadas API4 (plano)
  */
-export declare function api4(entity: string, action: string, params?: Record<string, unknown>): {
-    entity: string;
-    action: string;
-    params: Record<string, unknown>;
-};
+export declare function api4(entity: string, action: string, params?: Record<string, unknown>): Record<string, unknown>;

package/dist/nodes/transport/GenericFunctions.js

@@ -3,25 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.api4 = exports.civicrmApiRequest = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 /**
- * Ejecuta una llamada a la API de CiviCRM v4
+ * 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) {
     const { baseUrl, apiToken } = (await this.getCredentials('civiCrmApi'));
     const options = {
         method,
-        url: `${baseUrl}${path}`,
+        url: `${baseUrl.replace(/\/$/, '')}${path}`,
         headers: {
-            'Content-Type': 'application/json',
+            'Content-Type': 'application/x-www-form-urlencoded',
             'X-Civi-Auth': `Bearer ${apiToken}`,
         },
-        body,
+        // cuerpo plano como espera Civi-Go
+        body: {
+            params: JSON.stringify(body.params ?? body),
+        },
         json: true,
     };
     try {
         const response = await this.helpers.httpRequest(options);
-        if (response?.is_error) {
-            throw new n8n_workflow_1.NodeApiError(this.getNode(), response);
-        }
         return response;
     }
     catch (error) {
@@ -30,9 +31,10 @@ async function civicrmApiRequest(method, path, body) {
 }
 exports.civicrmApiRequest = civicrmApiRequest;
 /**
- * Devuelve el formato estándar para una llamada API4
+ * Devuelve el cuerpo estándar para las llamadas API4 (plano)
  */
 function api4(entity, action, params = {}) {
-    return { entity, action, params };
+    // devolvemos los parámetros planos, no anidados
+    return params;
 }
 exports.api4 = api4;

package/nodes/CiviCrm/CiviCrm.node.ts

@@ -0,0 +1,302 @@
+import type {
+	IExecuteFunctions,
+	ILoadOptionsFunctions,
+	INodeExecutionData,
+	INodePropertyOptions,
+	INodeType,
+	INodeTypeDescription,
+	IDataObject,
+} from 'n8n-workflow';
+
+import { civicrmApiRequest } from '../transport/GenericFunctions';
+import { resourceProp, operationProp } from './descriptions/resources';
+import { genericFields, upsertFields } from './descriptions/generic';
+
+/**
+ * Recursos soportados
+ */
+type Resource =
+	| 'contact'
+	| 'event'
+	| 'case'
+	| 'contribution'
+	| 'membership'
+	| 'participant'
+	| 'group'
+	| 'relationship'
+	| 'email'
+	| 'activity';
+
+const ENTITY_MAP: Record<Resource, string> = {
+	contact: 'Contact',
+	event: 'Event',
+	case: 'Case',
+	contribution: 'Contribution',
+	membership: 'Membership',
+	participant: 'Participant',
+	group: 'Group',
+	relationship: 'Relationship',
+	email: 'Email',
+	activity: 'Activity',
+};
+
+type Operation = 'get' | 'getMany' | 'create' | 'update' | 'delete';
+
+/**
+ * Nodo principal CiviCRM para n8n
+ */
+export class CiviCrm implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'CiviCRM',
+		name: 'civiCrm',
+		icon: 'file:civicrm.svg',
+		group: ['transform'],
+		version: 1,
+		description: 'Interact with CiviCRM API v4 (Civi-Go compatible)',
+		defaults: { name: 'CiviCRM' },
+		inputs: ['main'],
+		outputs: ['main'],
+		credentials: [{ name: 'civiCrmApi', required: true }],
+		properties: [
+			resourceProp,
+			operationProp,
+			{
+				displayName: 'ID',
+				name: 'id',
+				type: 'number',
+				default: 0,
+				required: true,
+				displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+			},
+			...genericFields,
+			...upsertFields,
+		],
+	};
+
+	methods = {
+		loadOptions: {
+			async getOptionValues(this: ILoadOptionsFunctions) {
+				const { baseUrl, apiToken } = (await this.getCredentials('civiCrmApi')) as {
+					baseUrl: string;
+					apiToken: string;
+				};
+
+				const url = `${baseUrl.replace(/\/$/, '')}/civicrm/ajax/api4/OptionValue/get`;
+
+				const res = await this.helpers.httpRequest({
+					method: 'POST',
+					url,
+					headers: {
+						'X-Civi-Auth': `Bearer ${apiToken}`,
+						'Content-Type': 'application/x-www-form-urlencoded',
+					},
+					body: {
+						params: JSON.stringify({ limit: 5 }),
+					},
+					json: true,
+				});
+
+				const values = (res?.values || []) as Array<{ id: number; label: string }>;
+				return values.map((v): INodePropertyOptions => ({
+					name: v.label,
+					value: v.id,
+				}));
+			},
+		},
+	};
+
+	async execute(this: IExecuteFunctions) {
+		const items = this.getInputData();
+		const out: INodeExecutionData[] = [];
+
+		const resource = this.getNodeParameter('resource', 0) as Resource;
+		const operation = this.getNodeParameter('operation', 0) as Operation;
+		const entity = ENTITY_MAP[resource];
+
+		for (let i = 0; i < items.length; i++) {
+			// === GET ===
+if (operation === 'get') {
+  const id = this.getNodeParameter('id', i) as number;
+
+  const params = {
+    where: [['id', '=', id]],
+    limit: 1,
+    select: [
+      'id',
+      'display_name',
+      'first_name',
+      'last_name',
+      'contact_type',
+      'email.email',
+      'phone.phone',
+      'address.city',
+      'address.country_id:label',
+      'address.postal_code',
+      'address.street_address',
+    ],
+    join: [
+      ['Email AS email', 'LEFT'],
+      ['Phone AS phone', 'LEFT'],
+      ['Address AS address', 'LEFT'],
+    ],
+  };
+
+  const res = await civicrmApiRequest.call(
+    this,
+    'POST',
+    `/civicrm/ajax/api4/${entity}/get`,
+    params,
+  );
+
+  out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
+}
+
+// === GET MANY ===
+if (operation === 'getMany') {
+  const returnAll = this.getNodeParameter('returnAll', i, false) as boolean;
+  const limit = this.getNodeParameter('limit', i, 100) as number;
+  const whereJson = this.getNodeParameter('whereJson', i, '') as string;
+  const where = whereJson ? JSON.parse(whereJson) : undefined;
+
+  const baseParams = {
+    where,
+    select: [
+      'id',
+      'display_name',
+      'first_name',
+      'last_name',
+      'contact_type',
+      'email.email',
+      'phone.phone',
+      'address.city',
+      'address.country_id:label',
+      'address.postal_code',
+      'address.street_address',
+    ],
+    join: [
+      ['Email AS email', 'LEFT'],
+      ['Phone AS phone', 'LEFT'],
+      ['Address AS address', 'LEFT'],
+    ],
+  };
+
+  if (returnAll) {
+    let offset = 0;
+    const page = 500;
+    while (true) {
+      const res = await civicrmApiRequest.call(
+        this,
+        'POST',
+        `/civicrm/ajax/api4/${entity}/get`,
+        { ...baseParams, limit: page, offset },
+      );
+      const vals = (res?.values ?? []) as IDataObject[];
+      for (const v of vals) out.push({ json: v });
+      if (vals.length < page) break;
+      offset += page;
+    }
+  } else {
+    const res = await civicrmApiRequest.call(
+      this,
+      'POST',
+      `/civicrm/ajax/api4/${entity}/get`,
+      { ...baseParams, limit },
+    );
+    const vals = (res?.values ?? []) as IDataObject[];
+    for (const v of vals) out.push({ json: v });
+  }
+}
+
+
+			// === CREATE ===
+			if (operation === 'create') {
+				const pairs = this.getNodeParameter('fields.field', i, []) as Array<{
+					fieldName: string;
+					fieldValue: string;
+				}>;
+
+				const values = Object.fromEntries(
+					pairs
+						.filter((p) => p.fieldName)
+						.map((p) => [p.fieldName, convertValue(p.fieldValue)]),
+				);
+
+				const params = { values };
+
+				const res = await civicrmApiRequest.call(
+					this,
+					'POST',
+					`/civicrm/ajax/api4/${entity}/create`,
+					params,
+				);
+				out.push({ json: res as IDataObject });
+			}
+
+			// === UPDATE ===
+			if (operation === 'update') {
+				const id = this.getNodeParameter('id', i) as number;
+				const pairs = this.getNodeParameter('fields.field', i, []) as Array<{
+					fieldName: string;
+					fieldValue: string;
+				}>;
+
+				const values = Object.fromEntries(
+					pairs
+						.filter((p) => p.fieldName)
+						.map((p) => [p.fieldName, convertValue(p.fieldValue)]),
+				);
+
+				const params = {
+					values,
+					where: [['id', '=', id]],
+				};
+
+				const res = await civicrmApiRequest.call(
+					this,
+					'POST',
+					`/civicrm/ajax/api4/${entity}/update`,
+					params,
+				);
+				out.push({ json: res as IDataObject });
+			}
+
+			// === DELETE ===
+			if (operation === 'delete') {
+				const id = this.getNodeParameter('id', i) as number;
+
+				const params = {
+					where: [['id', '=', id]],
+				};
+
+				const res = await civicrmApiRequest.call(
+					this,
+					'POST',
+					`/civicrm/ajax/api4/${entity}/delete`,
+					params,
+				);
+				out.push({ json: res as IDataObject });
+			}
+		}
+
+		return [out];
+	}
+}
+
+/**
+ * Convierte string a número, boolean, objeto o deja string
+ */
+function convertValue(val: string): unknown {
+	const t = String(val ?? '').trim();
+	if (t === '') return '';
+	if (t === 'true') return true;
+	if (t === 'false') return false;
+	if (/^-?\d+(\.\d+)?$/.test(t)) return Number(t);
+	try {
+		const j = JSON.parse(t);
+		if (typeof j === 'object') return j;
+	} catch {}
+	return val;
+}
+
+// Requerido por n8n >=1.110
+export default CiviCrm;

package/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/nodes/CiviCrm/descriptions/generic.ts

@@ -0,0 +1,9 @@
+import type { INodeProperties } from 'n8n-workflow';
+export const genericFields: INodeProperties[] = [
+  { displayName: 'Return All', name: 'returnAll', type: 'boolean', default: false, displayOptions: { show: { operation: ['getMany'] } } },
+  { displayName: 'Limit', name: 'limit', type: 'number', typeOptions: { minValue: 1, maxValue: 1000 }, default: 100, displayOptions: { show: { operation: ['getMany'], returnAll: [false] } } },
+  { displayName: 'Where (JSON)', name: 'whereJson', type: 'string', default: '', placeholder: `[["first_name","=","Alice"]]`, displayOptions: { show: { operation: ['getMany'] } } },
+];
+export const upsertFields: INodeProperties[] = [
+  { displayName: 'Fields', name: 'fields', type: 'fixedCollection', typeOptions: { multipleValues: true }, default: {}, options: [{ name:'field', displayName:'Field', values:[{displayName:'Name',name:'fieldName',type:'string',default:''},{displayName:'Value',name:'fieldValue',type:'string',default:''}]}], displayOptions: { show: { operation: ['create','update'] } } }
+];

package/nodes/CiviCrm/descriptions/resources.ts

@@ -0,0 +1,35 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const resourceProp: INodeProperties = {
+	displayName: 'Resource',
+	name: 'resource',
+	type: 'options',
+	default: 'contact',
+	options: [
+		{ name: 'Contact', value: 'contact' },
+		{ name: 'Event', value: 'event' },
+		{ name: 'Case', value: 'case' },
+		{ name: 'Contribution', value: 'contribution' },
+		{ name: 'Membership', value: 'membership' },
+		{ name: 'Participant', value: 'participant' },
+		{ name: 'Group', value: 'group' },
+		{ name: 'Relationship', value: 'relationship' },
+		{ name: 'Email', value: 'email' },
+		{ name: 'Activity', value: 'activity' },
+		{ name: 'Custom API Call', value: 'customApi' },
+	],
+};
+
+export const operationProp: INodeProperties = {
+	displayName: 'Operation',
+	name: 'operation',
+	type: 'options',
+	default: 'getMany',
+	options: [
+		{ name: 'Create', value: 'create' },
+		{ name: 'Delete', value: 'delete' },
+		{ name: 'Get', value: 'get' },
+		{ name: 'Get Many', value: 'getMany' },
+		{ name: 'Update', value: 'update' },
+	],
+};

package/nodes/transport/GenericFunctions.ts

@@ -0,0 +1,51 @@
+import type { IExecuteFunctions, IHttpRequestOptions, JsonObject } from 'n8n-workflow';
+import { NodeApiError } from 'n8n-workflow';
+
+/**
+ * Ejecuta una llamada a la API de CiviCRM v4 (Civi-Go)
+ * Usa form-urlencoded con el campo "params" serializado
+ */
+export async function civicrmApiRequest(
+  this: IExecuteFunctions,
+  method: 'POST',
+  path: string,
+  body: Record<string, unknown>,
+) {
+  const { baseUrl, apiToken } = (await this.getCredentials('civiCrmApi')) as {
+    baseUrl: string;
+    apiToken: string;
+  };
+
+  const options: IHttpRequestOptions = {
+    method,
+    url: `${baseUrl.replace(/\/$/, '')}${path}`,
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+      'X-Civi-Auth': `Bearer ${apiToken}`,
+    },
+    // cuerpo plano como espera Civi-Go
+    body: {
+      params: JSON.stringify(body.params ?? body),
+    },
+    json: true,
+  };
+
+  try {
+    const response = await this.helpers.httpRequest(options);
+    return response;
+  } catch (error: unknown) {
+    throw new NodeApiError(this.getNode(), error as JsonObject);
+  }
+}
+
+/**
+ * Devuelve el cuerpo estándar para las llamadas API4 (plano)
+ */
+export function api4(
+  entity: string,
+  action: string,
+  params: Record<string, unknown> = {},
+) {
+  // devolvemos los parámetros planos, no anidados
+  return params;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ixiam/n8n-nodes-civicrm",
-  "version": "0.2.4",
-  "description": "CiviCRM API v4 for n8n",
+  "version": "0.3.8",
+  "description": "CiviCRM API v4",
   "license": "MIT",
   "keywords": [
     "n8n-community-node-package",
@@ -10,12 +10,6 @@
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "icons",
-    "README.md",
-    "LICENSE"
-  ],
   "scripts": {
     "dev": "n8n-node dev",
     "build": "n8n-node build",
@@ -30,17 +24,6 @@
       "dist/credentials/CiviCrmApi.credentials.js"
     ]
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://git.ixiam.com/dev/research.git"
-  },
-  "bugs": {
-    "url": "https://git.ixiam.com/dev/research/issues"
-  },
-  "homepage": "https://git.ixiam.com/dev/research#readme",
   "devDependencies": {
     "@n8n/node-cli": "0.11.0",
     "@types/node": "^20.11.30",

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "lib": ["es2020"],
+    "module": "commonjs",
+    "target": "es2020",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true
+  },
+  "include": ["nodes/**/*.ts", "credentials/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}