@ixiam/n8n-nodes-civicrm 0.4.4 → 1.0.0

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

@@ -6,22 +6,14 @@ const resources_1 = require("./descriptions/resources");
 const generic_1 = require("./descriptions/generic");
 const ENTITY_MAP = {
     contact: 'Contact',
-    event: 'Event',
-    case: 'Case',
-    contribution: 'Contribution',
     membership: 'Membership',
-    participant: 'Participant',
     group: 'Group',
     relationship: 'Relationship',
-    email: 'Email',
     activity: 'Activity',
 };
-/**
- * Caché global de location types
- * Se rellena la primera vez que se usa y dura hasta que se reinicia n8n.
- * key: normalizado (lowercase, sin espacios/ símbolos)
- * value: option_value.name (para usar en location_type_id:name)
- */
+/* ============================================================================
+   LOCATION TYPE CACHE
+============================================================================ */
 let locationTypeCache = null;
 function normalizeLocationKey(s) {
     return String(s || '')
@@ -36,24 +28,24 @@ async function getLocationTypeMap() {
         select: ['name', 'label'],
         limit: 0,
     });
-    const values = (res?.values || []);
     const map = {};
+    const values = (res?.values || []);
     for (const v of values) {
         const name = v.name || '';
         const label = v.label || '';
-        const normName = normalizeLocationKey(name);
-        const normLabel = normalizeLocationKey(label);
-        if (normName)
-            map[normName] = name;
-        if (normLabel)
-            map[normLabel] = name;
+        const k1 = normalizeLocationKey(name);
+        const k2 = normalizeLocationKey(label);
+        if (k1)
+            map[k1] = name;
+        if (k2)
+            map[k2] = name;
     }
     locationTypeCache = map;
     return map;
 }
-/**
- * Nodo principal CiviCRM para n8n
- */
+/* ============================================================================
+   NODE DEFINITION
+============================================================================ */
 class CiviCrm {
     constructor() {
         this.description = {
@@ -62,43 +54,23 @@ class CiviCrm {
             icon: 'file:civicrm.svg',
             group: ['transform'],
             version: 1,
-            description: 'Interact with CiviCRM API v4 (Civi-Go compatible).\\n\\n' +
-                'Email / Phone / Address mapping:\\n' +
-                '- You can send simple fields: email, phone, address.city, address.country_id, etc.\\n' +
-                '- You can also use dynamic prefixes based on real CiviCRM Location Types.\\n' +
-                '  Example prefixes (from Location Types): Home, Work, Billing, Mobile, Oficina, etc.\\n' +
-                '- Prefix format: <location-prefix>.<entity>[.<subfield>]\\n' +
-                '  Examples:\\n' +
-                '    email = test@ixiam.com\\n' +
-                '    phone = 600123123\\n' +
-                '    address.city = Barcelona\\n' +
-                '    work.email = test@company.com  (Location Type = Work)\\n' +
-                '    billing.address.postal_code = 28010  (Location Type = Billing)\\n' +
-                '    home.phone.phone_type_id = 2  (Location Type = Home)\\n\\n' +
-                'Subfields examples:\\n' +
-                '- email.is_primary, email.signature_html, email.signature_text\\n' +
-                '- phone.phone_type_id, phone.phone_ext\\n' +
-                '- address.country_id, address.state_province_id, address.postal_code, address.street_address\\n\\n' +
-                'Prefixes and Location Types:\\n' +
-                '- The prefix (e.g. work, home, billing, oficina) is matched against CiviCRM Location Types (name/label).\\n' +
-                '- If the prefix matches, the node sets location_type_id:name automatically.\\n' +
-                '- If no prefix is used (e.g. email, phone, address.city), the node uses the Location Type selectors.\\n\\n' +
-                'birth_date:\\n' +
-                '- Accepted formats: YYYY-MM-DD, DD/MM/YYYY, DD-MM-YYYY, YYYY/MM/DD, YYYY.MM.DD.\\n' +
-                '- The node normalizes and validates the date before sending it to CiviCRM.\\n\\n' +
-                'Filters in GET MANY:\\n' +
-                '- Use API4 "where" JSON array format, e.g.:\\n' +
-                '  [ ["contact_type","=","Individual"] ]\\n' +
-                '  [ ["first_name","LIKE","Jul%"] ]\\n' +
-                '  [ ["birth_date",">","1990-01-01"] ]\\n' +
-                '  [ ["gender_id","IN",[1,2]] ]',
+            description: 'Interact with CiviCRM API v4 (Civi-Go compatible).\n\n' +
+                'Supports Contact, Membership, Group, Relationship and Activity entities.\n' +
+                'Includes dynamic mapping of email, phone, address and location types.\n' +
+                'Includes birth_date validation and JSON filters for GET MANY.\n',
             defaults: { name: 'CiviCRM' },
             inputs: ['main'],
             outputs: ['main'],
             credentials: [{ name: 'civiCrmApi', required: true }],
             properties: [
+                //
+                // RESOURCE + OPERATION
+                //
                 resources_1.resourceProp,
                 resources_1.operationProp,
+                //
+                // CONTACT TYPE
+                //
                 {
                     displayName: 'Contact Type',
                     name: 'contactType',
@@ -110,9 +82,10 @@ class CiviCrm {
                         { name: 'Household', value: 'Household' },
                     ],
                     displayOptions: { show: { resource: ['contact'] } },
-                    description: 'Contact type to filter (GET MANY) or assign (CREATE/UPDATE). ' +
-                        'For GET MANY, if set, a condition [ "contact_type", "=", selectedType ] is added to the where.',
                 },
+                //
+                // LOCATION TYPES
+                //
                 {
                     displayName: 'Email Location Type',
                     name: 'emailLocation',
@@ -124,10 +97,6 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-                    description: 'Default Location Type used for email when no prefix is provided.\\n' +
-                        '- If you use "email" or "email.xxx" as field name, this Location Type will be used.\\n' +
-                        '- If you use a prefixed field like "work.email", "home.email", etc., ' +
-                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
                 {
                     displayName: 'Phone Location Type',
@@ -141,10 +110,6 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-                    description: 'Default Location Type used for phone when no prefix is provided.\\n' +
-                        '- If you use "phone" or "phone.xxx" as field name, this Location Type will be used.\\n' +
-                        '- If you use a prefixed field like "mobile.phone", "work.phone", etc., ' +
-                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
                 {
                     displayName: 'Address Location Type',
@@ -158,20 +123,20 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-                    description: 'Default Location Type used for address when no prefix is provided.\\n' +
-                        '- If you use "address.city", "address.country_id", etc., this Location Type will be used.\\n' +
-                        '- If you use a prefixed field like "billing.address.postal_code", "home.address.city", etc., ' +
-                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
+                //
+                // PRIMARY FLAG
+                //
                 {
                     displayName: 'Mark as Primary',
                     name: 'isPrimary',
                     type: 'boolean',
                     default: true,
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-                    description: 'If enabled, previous primary email/phone/address for this contact are deleted before creating the new ones. ' +
-                        'Useful when you want to replace existing primary contact details.',
                 },
+                //
+                // ID for GET / UPDATE / DELETE
+                //
                 {
                     displayName: 'ID',
                     name: 'id',
@@ -179,25 +144,29 @@ class CiviCrm {
                     default: 0,
                     required: true,
                     displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
-                    description: 'Record ID of the selected entity (Contact, Event, Case, etc.).',
                 },
+                //
+                // DYNAMIC FIELDS
+                //
                 ...generic_1.genericFields,
                 ...generic_1.upsertFields,
             ],
         };
+        /* ============================================================================
+           LOAD OPTIONS (required by n8n verification)
+        ============================================================================ */
         this.methods = {
             loadOptions: {
-                async getOptionValues() {
+                async loadOptionValues() {
                     const { baseUrl, apiToken } = (await this.getCredentials('civiCrmApi'));
-                    const url = `${baseUrl.replace(/\/$/, '')}/civicrm/ajax/api4/OptionValue/get`;
                     const res = await this.helpers.httpRequest({
                         method: 'POST',
-                        url,
+                        url: `${baseUrl.replace(/\/$/, '')}/civicrm/ajax/api4/OptionValue/get`,
                         headers: {
                             'X-Civi-Auth': `Bearer ${apiToken}`,
                             'Content-Type': 'application/x-www-form-urlencoded',
                         },
-                        body: { params: JSON.stringify({ limit: 5 }) },
+                        body: { params: JSON.stringify({ limit: 50, select: ['id', 'label'] }) },
                         json: true,
                     });
                     const values = (res?.values || []);
@@ -209,6 +178,9 @@ class CiviCrm {
             },
         };
     }
+    /* ============================================================================
+       EXECUTE
+    ============================================================================ */
     async execute() {
         const items = this.getInputData();
         const out = [];
@@ -220,17 +192,17 @@ class CiviCrm {
             const phoneLocationParam = this.getNodeParameter('phoneLocation', i, 'Work');
             const addressLocationParam = this.getNodeParameter('addressLocation', i, 'Home');
             const isPrimary = this.getNodeParameter('isPrimary', i, true);
-            // Valores de location type efectivos (pueden ser sobreescritos por prefijo)
             let emailLocationName = emailLocationParam;
             let phoneLocationName = phoneLocationParam;
             let addressLocationName = addressLocationParam;
-            // =========== GET ===========
+            /* ======================================================
+               GET
+            ====================================================== */
             if (operation === 'get') {
                 const id = this.getNodeParameter('id', i);
-                const where = [['id', '=', id]];
-                if (resource === 'contact') {
-                    const params = {
-                        where,
+                const params = resource === 'contact'
+                    ? {
+                        where: [['id', '=', id]],
                         limit: 1,
                         select: [
                             'id',
@@ -247,34 +219,39 @@ class CiviCrm {
                             phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
                             addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
                         },
-                    };
-                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/get', params);
-                    out.push({ json: (res?.values?.[0] ?? {}) });
-                }
-                else {
-                    const params = {
-                        where,
+                    }
+                    : {
+                        where: [['id', '=', id]],
                         limit: 1,
                         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] ?? {}) });
-                }
+                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, params);
+                out.push({ json: res?.values?.[0] ?? {} });
+                continue;
             }
-            // =========== GET MANY ===========
+            /* ======================================================
+               GET MANY
+            ====================================================== */
             if (operation === 'getMany') {
-                const returnAll = this.getNodeParameter('returnAll', i, false);
                 const limit = this.getNodeParameter('limit', i, 100);
+                const returnAll = this.getNodeParameter('returnAll', i, false);
                 const whereJson = this.getNodeParameter('whereJson', i, '');
-                let where = whereJson ? JSON.parse(whereJson) : [];
+                let where = [];
+                if (whereJson) {
+                    try {
+                        where = JSON.parse(whereJson);
+                    }
+                    catch {
+                        throw new Error('Invalid JSON in whereJson');
+                    }
+                }
                 if (resource === 'contact') {
                     const contactType = this.getNodeParameter('contactType', i, '');
                     if (contactType)
                         where.push(['contact_type', '=', contactType]);
                 }
-                let baseParams;
-                if (resource === 'contact') {
-                    baseParams = {
+                const params = resource === 'contact'
+                    ? {
                         where,
                         select: [
                             'id',
@@ -291,20 +268,17 @@ class CiviCrm {
                             phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
                             addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
                         },
-                    };
-                }
-                else {
-                    baseParams = {
+                    }
+                    : {
                         where,
                         select: ['id', 'name', 'title', 'subject', 'display_name'],
                     };
-                }
                 if (returnAll) {
                     let offset = 0;
                     const page = 500;
                     while (true) {
-                        const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...baseParams, limit: page, offset });
-                        const vals = (res?.values ?? []);
+                        const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit: page, offset });
+                        const vals = r?.values ?? [];
                         for (const v of vals)
                             out.push({ json: v });
                         if (vals.length < page)
@@ -313,262 +287,254 @@ class CiviCrm {
                     }
                 }
                 else {
-                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...baseParams, limit });
-                    const vals = (res?.values ?? []);
+                    const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, { ...params, limit });
+                    const vals = r?.values ?? [];
                     for (const v of vals)
                         out.push({ json: v });
                 }
+                continue;
             }
-            // =========== CREATE / UPDATE ===========
+            /* ======================================================
+               DELETE
+            ====================================================== */
+            if (operation === 'delete') {
+                const id = this.getNodeParameter('id', i);
+                const r = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/delete`, {
+                    where: [['id', '=', id]],
+                });
+                out.push({
+                    json: {
+                        success: true,
+                        message: `${entity} ${id} deleted`,
+                        deleted_id: id,
+                        api_response: r,
+                    },
+                });
+                continue;
+            }
+            /* ======================================================
+               CREATE / UPDATE
+            ====================================================== */
             const isCreate = operation === 'create';
-            if (isCreate || operation === 'update') {
-                const id = !isCreate ? this.getNodeParameter('id', i) : undefined;
-                const pairs = this.getNodeParameter('fields.field', i, []);
-                const values = {};
-                const emailData = {};
-                const phoneData = {};
-                const addressData = {};
-                // Normaliza birth_date a YYYY-MM-DD con validación
-                function normalizeBirthDate(input) {
-                    if (!input)
-                        return input;
-                    let val = input.trim();
-                    // YYYY-MM-DD
-                    if (/^\d{4}-\d{2}-\d{2}$/.test(val))
-                        return val;
-                    // DD/MM/YYYY
-                    if (/^\d{2}\/\d{2}\/\d{4}$/.test(val)) {
-                        const [d, m, y] = val.split('/');
-                        val = `${y}-${m}-${d}`;
-                    }
-                    // DD-MM-YYYY
-                    else if (/^\d{2}-\d{2}-\d{4}$/.test(val)) {
-                        const [d, m, y] = val.split('-');
-                        val = `${y}-${m}-${d}`;
-                    }
-                    // YYYY/MM/DD
-                    else if (/^\d{4}\/\d{2}\/\d{2}$/.test(val)) {
-                        val = val.replace(/\//g, '-');
-                    }
-                    // YYYY.MM.DD
-                    else if (/^\d{4}\.\d{2}\.\d{2}$/.test(val)) {
-                        val = val.replace(/\./g, '-');
-                    }
-                    const date = new Date(val);
-                    if (isNaN(date.getTime())) {
-                        throw new Error(`Invalid birth_date format: ${input}`);
-                    }
-                    return val;
+            const id = !isCreate ? this.getNodeParameter('id', i) : undefined;
+            const pairs = this.getNodeParameter('fields.field', i, []);
+            const values = {};
+            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)) {
                 }
-                // Cargar mapa de location types solo si estamos en contacto
-                let locationTypeMap = {};
-                if (resource === 'contact') {
-                    locationTypeMap = await getLocationTypeMap.call(this);
+                else if (/^\d{2}\/\d{2}\/\d{4}$/.test(v)) {
+                    const [d, m, y] = v.split('/');
+                    v = `${y}-${m}-${d}`;
                 }
-                // Field mapping con soporte para:
-                // - email, email.xxx
-                // - phone, phone.xxx
-                // - address.xxx
-                // - <prefix>.email[.field]
-                // - <prefix>.phone[.field]
-                // - <prefix>.address[.field]
-                for (const p of pairs) {
-                    if (!p.fieldName)
-                        continue;
-                    const key = p.fieldName.trim();
-                    const rawVal = convertValue(p.fieldValue);
-                    const val = rawVal;
-                    // 1) Casos simples sin prefijo: email / email.xxx / phone / phone.xxx / address.xxx
-                    // Email simple
-                    if (key === 'email') {
-                        emailData.email = val;
-                        continue;
-                    }
-                    if (key.startsWith('email.')) {
-                        emailData[key.replace(/^email\./, '')] = val;
-                        continue;
-                    }
-                    // Phone simple
-                    if (key === 'phone') {
-                        phoneData.phone = val;
-                        continue;
-                    }
-                    if (key.startsWith('phone.')) {
-                        phoneData[key.replace(/^phone\./, '')] = val;
-                        continue;
-                    }
-                    // Address simple
-                    if (key.startsWith('address.')) {
-                        addressData[key.replace(/^address\./, '')] = val;
-                        continue;
-                    }
-                    // 2) Prefijo dinámico: <prefix>.email[.field], <prefix>.phone[.field], <prefix>.address[.field]
-                    const segments = key.split('.');
-                    if (segments.length >= 2 && resource === 'contact') {
-                        const prefixRaw = segments[0];
-                        const root = segments[1]; // email / phone / address
-                        const subfield = segments.slice(2).join('.') || '';
-                        const normalizedPrefix = normalizeLocationKey(prefixRaw);
-                        const mappedLocationName = locationTypeMap[normalizedPrefix];
-                        if (root === 'email' || root === 'phone' || root === 'address') {
-                            // Si el prefijo coincide con un location type, sobreescribir el locationName correspondiente
-                            if (mappedLocationName) {
-                                if (root === 'email')
-                                    emailLocationName = mappedLocationName;
-                                if (root === 'phone')
-                                    phoneLocationName = mappedLocationName;
-                                if (root === 'address')
-                                    addressLocationName = mappedLocationName;
-                            }
-                            // Asignar campo
-                            if (root === 'email') {
-                                if (!subfield) {
-                                    emailData.email = val;
-                                }
-                                else {
-                                    emailData[subfield] = val;
-                                }
-                                continue;
-                            }
-                            if (root === 'phone') {
-                                if (!subfield) {
-                                    phoneData.phone = val;
-                                }
-                                else {
-                                    phoneData[subfield] = val;
-                                }
-                                continue;
-                            }
-                            if (root === 'address') {
-                                if (!subfield) {
-                                    // No existe campo address "plano", así que ignoramos si no hay subfield
-                                }
-                                else {
-                                    addressData[subfield] = val;
-                                }
-                                continue;
-                            }
-                        }
-                    }
-                    // 3) gender
-                    if (key === 'gender' || key === 'gender_id') {
-                        values.gender_id = val;
-                        continue;
-                    }
-                    // 4) birth_date
-                    if (key === 'birth_date' || key === 'birth') {
-                        values.birth_date = normalizeBirthDate(String(val));
-                        continue;
-                    }
-                    // 5) default → campo de Contact o de la entidad
-                    values[key] = val;
+                else if (/^\d{2}-\d{2}-\d{4}$/.test(v)) {
+                    const [d, m, y] = v.split('-');
+                    v = `${y}-${m}-${d}`;
                 }
-                // contact_type
-                const contactType = this.getNodeParameter('contactType', i, '');
-                if (resource === 'contact' && contactType) {
-                    values.contact_type = contactType;
+                else if (/^\d{4}\/\d{2}\/\d{2}$/.test(v)) {
+                    v = v.replace(/\//g, '-');
                 }
-                // --- CREATE / UPDATE CONTACT ---
-                let contactId = id;
-                if (isCreate) {
-                    const contactRes = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/create', { values });
-                    contactId = contactRes?.values?.[0]?.id;
-                    if (!contactId)
-                        throw new Error('Failed to create contact.');
+                else if (/^\d{4}\.\d{2}\.\d{2}$/.test(v)) {
+                    v = v.replace(/\./g, '-');
                 }
-                else {
-                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/update`, {
-                        values,
-                        where: [['id', '=', contactId]],
-                    });
+                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);
+            }
+            for (const p of pairs) {
+                if (!p.fieldName)
+                    continue;
+                const key = p.fieldName.trim();
+                const rawVal = convertValue(p.fieldValue);
+                const val = rawVal;
+                /* Email simple */
+                if (key === 'email') {
+                    emailData.email = val;
+                    continue;
                 }
-                // --- SUBENTITIES (solo para contact) ---
-                if (resource === 'contact') {
-                    // Si es primary, limpiar anteriores
-                    if (isPrimary) {
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/delete', {
-                            where: [
-                                ['contact_id', '=', contactId],
-                                ['is_primary', '=', true],
-                            ],
-                        });
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/delete', {
-                            where: [
-                                ['contact_id', '=', contactId],
-                                ['is_primary', '=', true],
-                            ],
-                        });
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/delete', {
-                            where: [
-                                ['contact_id', '=', contactId],
-                                ['is_primary', '=', true],
-                            ],
-                        });
-                    }
-                    // Email
-                    if (Object.keys(emailData).length) {
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/create', {
-                            values: {
-                                ...emailData,
-                                contact_id: contactId,
-                                is_primary: isPrimary,
-                                'location_type_id:name': emailLocationName,
-                            },
-                        });
-                    }
-                    // Phone
-                    if (Object.keys(phoneData).length) {
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/create', {
-                            values: {
-                                ...phoneData,
-                                contact_id: contactId,
-                                is_primary: isPrimary,
-                                'location_type_id:name': phoneLocationName,
-                            },
-                        });
-                    }
-                    // Address
-                    if (Object.keys(addressData).length) {
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/create', {
-                            values: {
-                                ...addressData,
-                                contact_id: contactId,
-                                is_primary: isPrimary,
-                                'location_type_id:name': addressLocationName,
-                            },
-                        });
+                if (key.startsWith('email.')) {
+                    emailData[key.replace(/^email\./, '')] = val;
+                    continue;
+                }
+                /* Phone simple */
+                if (key === 'phone') {
+                    phoneData.phone = val;
+                    continue;
+                }
+                if (key.startsWith('phone.')) {
+                    phoneData[key.replace(/^phone\./, '')] = val;
+                    continue;
+                }
+                /* Address */
+                if (key.startsWith('address.')) {
+                    addressData[key.replace(/^address\./, '')] = val;
+                    continue;
+                }
+                /* Prefijo dinámico */
+                const segments = key.split('.');
+                if (segments.length >= 2 && resource === 'contact') {
+                    const prefixRaw = segments[0];
+                    const root = segments[1];
+                    const subfield = segments.slice(2).join('.') || '';
+                    const normalizedPrefix = normalizeLocationKey(prefixRaw);
+                    const mappedLocationName = locationTypeMap[normalizedPrefix];
+                    if (root === 'email' || root === 'phone' || root === 'address') {
+                        if (mappedLocationName) {
+                            if (root === 'email')
+                                emailLocationName = mappedLocationName;
+                            if (root === 'phone')
+                                phoneLocationName = mappedLocationName;
+                            if (root === 'address')
+                                addressLocationName = mappedLocationName;
+                        }
+                        if (root === 'email') {
+                            if (!subfield)
+                                emailData.email = val;
+                            else
+                                emailData[subfield] = val;
+                            continue;
+                        }
+                        if (root === 'phone') {
+                            if (!subfield)
+                                phoneData.phone = val;
+                            else
+                                phoneData[subfield] = val;
+                            continue;
+                        }
+                        if (root === 'address') {
+                            if (subfield)
+                                addressData[subfield] = val;
+                            continue;
+                        }
                     }
                 }
-                // --- FINAL GET (con gender + birth_date + chain) ---
-                const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, {
+                /* gender */
+                if (key === 'gender' || key === 'gender_id') {
+                    values.gender_id = val;
+                    continue;
+                }
+                /* birth_date */
+                if (key === 'birth_date' || key === 'birth') {
+                    values.birth_date = normalizeBirthDate(String(val));
+                    continue;
+                }
+                /* default */
+                values[key] = val;
+            }
+            /* Contact type */
+            const contactType = this.getNodeParameter('contactType', i, '');
+            if (resource === 'contact' && contactType) {
+                values.contact_type = contactType;
+            }
+            /* CREATE/UPDATE contact */
+            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;
+                if (!contactId)
+                    throw new Error('Failed to create contact.');
+            }
+            else {
+                await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/update`, {
+                    values,
                     where: [['id', '=', contactId]],
-                    select: [
-                        'id',
-                        'display_name',
-                        'first_name',
-                        'last_name',
-                        'contact_type',
-                        'gender_id',
-                        'gender_id:name',
-                        'birth_date',
-                    ],
-                    ...(resource === 'contact'
-                        ? {
-                            chain: {
-                                emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
-                                phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
-                                addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
-                            },
-                        }
-                        : {}),
                 });
-                out.push({ json: (res?.values?.[0] ?? {}) });
             }
+            /* SUBENTITIES */
+            if (resource === 'contact') {
+                if (isPrimary) {
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/delete', {
+                        where: [
+                            ['contact_id', '=', contactId],
+                            ['is_primary', '=', true],
+                        ],
+                    });
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/delete', {
+                        where: [
+                            ['contact_id', '=', contactId],
+                            ['is_primary', '=', true],
+                        ],
+                    });
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/delete', {
+                        where: [
+                            ['contact_id', '=', contactId],
+                            ['is_primary', '=', true],
+                        ],
+                    });
+                }
+                if (Object.keys(emailData).length) {
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/create', {
+                        values: {
+                            ...emailData,
+                            contact_id: contactId,
+                            is_primary: isPrimary,
+                            'location_type_id:name': emailLocationName,
+                        },
+                    });
+                }
+                if (Object.keys(phoneData).length) {
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/create', {
+                        values: {
+                            ...phoneData,
+                            contact_id: contactId,
+                            is_primary: isPrimary,
+                            'location_type_id:name': phoneLocationName,
+                        },
+                    });
+                }
+                if (Object.keys(addressData).length) {
+                    await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/create', {
+                        values: {
+                            ...addressData,
+                            contact_id: contactId,
+                            is_primary: isPrimary,
+                            'location_type_id:name': addressLocationName,
+                        },
+                    });
+                }
+            }
+            /* FINAL GET */
+            const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, {
+                where: [['id', '=', contactId]],
+                select: [
+                    'id',
+                    'display_name',
+                    'first_name',
+                    'last_name',
+                    'contact_type',
+                    'gender_id',
+                    'gender_id:name',
+                    'birth_date',
+                ],
+                ...(resource === 'contact'
+                    ? {
+                        chain: {
+                            emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
+                            phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
+                            addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
+                        },
+                    }
+                    : {}),
+            });
+            out.push({ json: res?.values?.[0] ?? {} });
         }
         return [out];
     }
 }
 exports.CiviCrm = CiviCrm;
+/* ============================================================================
+   UTILS
+============================================================================ */
 function convertValue(val) {
     const t = String(val ?? '').trim();
     if (t === '')