n8n-nodes-mautic-advanced 0.2.0 → 0.2.5

package/dist/nodes/MauticAdvanced/ContactDescription.js

@@ -31,6 +31,12 @@ exports.contactOperations = [
                 description: 'Delete a contact',
                 action: 'Delete a contact',
             },
+            {
+                name: 'Delete Batch',
+                value: 'deleteBatch',
+                description: 'Delete multiple contacts in one operation',
+                action: 'Delete multiple contacts',
+            },
             {
                 name: 'Edit Contact Points',
                 value: 'editContactPoint',
@@ -1315,6 +1321,46 @@ exports.contactFields = [
         default: '',
     },
     /* -------------------------------------------------------------------------- */
+    /*                             contact:deleteBatch                            */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Contact IDs',
+        name: 'contactIds',
+        type: 'string',
+        required: false,
+        displayOptions: {
+            show: {
+                resource: ['contact'],
+                operation: ['deleteBatch'],
+            },
+        },
+        default: '',
+        placeholder: '1,2,3,4,5',
+        description: 'Comma-separated list of contact IDs to delete (e.g., "1,2,3,4,5"). If left empty, all input items\' contactId fields will be used for batch deletion.',
+    },
+    {
+        displayName: 'Options',
+        name: 'options',
+        type: 'collection',
+        displayOptions: {
+            show: {
+                resource: ['contact'],
+                operation: ['deleteBatch'],
+            },
+        },
+        placeholder: 'Add option',
+        default: {},
+        options: [
+            {
+                displayName: 'RAW Data',
+                name: 'rawData',
+                type: 'boolean',
+                default: true,
+                description: 'Whether to return the raw response data from the API or just a success summary',
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
     /*                                 contact:all                                */
     /* -------------------------------------------------------------------------- */
     {
@@ -1326,7 +1372,7 @@ exports.contactFields = [
                 resource: ['contact'],
             },
             hide: {
-                operation: ['sendEmail', 'editDoNotContactList', 'editContactPoint'],
+                operation: ['sendEmail', 'editDoNotContactList', 'editContactPoint', 'deleteBatch'],
             },
         },
         placeholder: 'Add option',

package/dist/nodes/MauticAdvanced/GenericFunctions.js

@@ -43,26 +43,46 @@ exports.mauticApiRequest = mauticApiRequest;
  * Make an API request to paginated mautic endpoint
  * and return all results
  */
+// Optional: Slightly improved error handling
 async function mauticApiRequestAllItems(propertyName, method, endpoint, body = {}, query = {}, maxResults) {
     const returnData = [];
     let responseData;
     query.limit = 30;
     query.start = 0;
-    // Removed unused 'page' variable
-    do {
-        responseData = await mauticApiRequest.call(this, method, endpoint, body, query);
-        const values = Object.values(responseData[propertyName]);
-        if (maxResults !== undefined && returnData.length + values.length > maxResults) {
-            const needed = maxResults - returnData.length;
-            returnData.push(...values.slice(0, needed));
-            break;
+    while (true) {
+        try {
+            responseData = await mauticApiRequest.call(this, method, endpoint, body, query);
+            if (responseData.errors) {
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), responseData);
+            }
+            const pageItems = responseData[propertyName]
+                ? Object.values(responseData[propertyName])
+                : [];
+            if (!pageItems.length) {
+                break;
+            }
+            if (maxResults !== undefined && returnData.length + pageItems.length > maxResults) {
+                const needed = maxResults - returnData.length;
+                returnData.push(...pageItems.slice(0, needed));
+                break;
+            }
+            else {
+                returnData.push(...pageItems);
+            }
+            query.start = Number(query.start) + pageItems.length;
+            // If less than limit returned, no more data
+            if (pageItems.length < Number(query.limit)) {
+                break;
+            }
         }
-        else {
-            returnData.push(...values);
+        catch (error) {
+            // Optional: Only wrap non-NodeApiError errors
+            if (error instanceof n8n_workflow_1.NodeApiError) {
+                throw error;
+            }
+            throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
         }
-        query.start += query.limit;
-    } while ((responseData.total !== undefined && returnData.length - parseInt(responseData.total, 10) < 0) &&
-        (maxResults === undefined || returnData.length < maxResults));
+    }
     return returnData;
 }
 exports.mauticApiRequestAllItems = mauticApiRequestAllItems;

package/dist/nodes/MauticAdvanced/MauticAdvanced.node.js

@@ -12,13 +12,14 @@ const ContactDescription_1 = require("./ContactDescription");
 const ContactSegmentDescription_1 = require("./ContactSegmentDescription");
 const GenericFunctions_1 = require("./GenericFunctions");
 const SegmentEmailDescription_1 = require("./SegmentEmailDescription");
+const SegmentDescription_1 = require("./SegmentDescription");
 const TagDescription_1 = require("./TagDescription");
 class MauticAdvanced {
     constructor() {
         this.description = {
             displayName: 'Mautic Advanced',
             name: 'mauticAdvanced',
-            icon: 'file:MauticAdvanced.svg',
+            icon: 'file:mauticadvanced.svg',
             group: ['output'],
             version: 1,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
@@ -107,6 +108,11 @@ class MauticAdvanced {
                             value: 'contactSegment',
                             description: 'Add/remove contacts to/from a segment',
                         },
+                        {
+                            name: 'Segment',
+                            value: 'segment',
+                            description: 'Create, update, and retrieve segments',
+                        },
                         {
                             name: 'Segment Email',
                             value: 'segmentEmail',
@@ -138,6 +144,8 @@ class MauticAdvanced {
                 ...TagDescription_1.tagFields,
                 ...CategoryDescription_1.categoryOperations,
                 ...CategoryDescription_1.categoryFields,
+                ...SegmentDescription_1.segmentOperations,
+                ...SegmentDescription_1.segmentFields,
             ],
         };
         this.methods = {
@@ -226,7 +234,7 @@ class MauticAdvanced {
                 // select them easily
                 async getSegments() {
                     const returnData = [];
-                    const segments = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'lists', 'GET', '/segments');
+                    const segments = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'segments', 'GET', '/segments');
                     for (const segment of segments) {
                         returnData.push({
                             name: segment.name,
@@ -302,6 +310,48 @@ class MauticAdvanced {
         let responseData;
         const resource = this.getNodeParameter('resource', 0);
         const operation = this.getNodeParameter('operation', 0);
+        // Handle batch operations that process all items together
+        if (resource === 'contact' && operation === 'deleteBatch') {
+            // Only process once for all items
+            const options = this.getNodeParameter('options', 0, {});
+            let contactIds = this.getNodeParameter('contactIds', 0, '');
+            if (!contactIds) {
+                // Fallback: collect from all input items
+                const ids = items
+                    .map((item) => item.json.id)
+                    .filter((id) => id !== undefined && id !== null && id !== '')
+                    .map((id) => String(id));
+                contactIds = ids.join(',');
+            }
+            if (!contactIds) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No contact IDs provided or found in input items.');
+            }
+            try {
+                responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'DELETE', '/contacts/batch/delete', {}, { ids: contactIds });
+                if (options.rawData === false) {
+                    // Return simplified response
+                    responseData = {
+                        success: true,
+                        deletedIds: contactIds.split(','),
+                        message: `Successfully deleted ${contactIds.split(',').length} contacts.`,
+                    };
+                }
+            }
+            catch (error) {
+                if (error instanceof n8n_workflow_1.NodeApiError && error.httpCode === '404') {
+                    responseData = {
+                        success: true,
+                        deletedIds: contactIds.split(','),
+                        message: 'Some contacts were already deleted or not found.',
+                    };
+                }
+                else {
+                    throw error;
+                }
+            }
+            // Return as a single output item
+            return [this.helpers.returnJsonArray([responseData])];
+        }
         for (let i = 0; i < length; i++) {
             qs = {};
             try {
@@ -339,6 +389,13 @@ class MauticAdvanced {
                         const returnAll = this.getNodeParameter('returnAll', i);
                         const options = this.getNodeParameter('options', i);
                         qs = { ...options };
+                        // Patch: enforce default sort order by id ascending if not set by user
+                        if (!qs.orderBy) {
+                            qs.orderBy = 'id';
+                        }
+                        if (!qs.orderByDir) {
+                            qs.orderByDir = 'asc';
+                        }
                         if (returnAll) {
                             responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'campaigns', 'GET', '/campaigns', {}, qs);
                         }
@@ -368,6 +425,86 @@ class MauticAdvanced {
                         responseData = responseData.campaign;
                     }
                 }
+                if (resource === 'segment') {
+                    //https://developer.mautic.org/#segments
+                    if (operation === 'create') {
+                        const name = this.getNodeParameter('name', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        const body = {
+                            name,
+                            ...additionalFields,
+                        };
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'POST', '/segments/new', body);
+                        responseData = responseData.list; // Changed from .segment to .list
+                    }
+                    if (operation === 'update') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        const createIfNotFound = this.getNodeParameter('createIfNotFound', i);
+                        const name = this.getNodeParameter('name', i);
+                        const { ...additionalFields } = this.getNodeParameter('additionalFields', i);
+                        const body = {
+                            name,
+                            ...additionalFields,
+                        };
+                        const method = createIfNotFound ? 'PUT' : 'PATCH';
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, method, `/segments/${segmentId}/edit`, body);
+                        responseData = responseData.list; // Changed from .segment to .list
+                    }
+                    if (operation === 'get') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', `/segments/${segmentId}`);
+                        responseData = responseData.list; // Changed from .segment to .list
+                    }
+                    if (operation === 'getAll') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        const options = this.getNodeParameter('options', i);
+                        qs = { ...options };
+                        if (returnAll) {
+                            responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'lists', // Using 'lists' property name
+                            'GET', '/segments', {}, qs);
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs.limit = limit;
+                            responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/segments', {}, qs);
+                            responseData = responseData.lists ? Object.values(responseData.lists) : []; // Convert object to array
+                        }
+                    }
+                    if (operation === 'delete') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'DELETE', `/segments/${segmentId}/delete`);
+                        responseData = responseData.list; // Changed from .segment to .list
+                    }
+                    if (operation === 'addContact') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        const contactId = this.getNodeParameter('contactId', i);
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'POST', `/segments/${segmentId}/contact/${contactId}/add`);
+                    }
+                    if (operation === 'removeContact') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        const contactId = this.getNodeParameter('contactId', i);
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'POST', `/segments/${segmentId}/contact/${contactId}/remove`);
+                    }
+                    if (operation === 'addContacts') {
+                        const segmentId = this.getNodeParameter('segmentId', i);
+                        let contactIds = this.getNodeParameter('contactIds', i, '');
+                        if (!contactIds) {
+                            // Fallback: collect from all input items
+                            const ids = items
+                                .map((item) => item.json.contactId || item.json.id)
+                                .filter((id) => id !== undefined && id !== null && id !== '')
+                                .map((id) => String(id));
+                            contactIds = ids.join(',');
+                        }
+                        if (!contactIds) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No contact IDs provided or found in input items.');
+                        }
+                        const body = {
+                            ids: contactIds.split(','),
+                        };
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'POST', `/segments/${segmentId}/contacts/add`, body);
+                    }
+                }
                 if (resource === 'company') {
                     //https://developer.mautic.org/#create-company
                     if (operation === 'create') {
@@ -498,21 +635,19 @@ class MauticAdvanced {
                         const simple = this.getNodeParameter('simple', i);
                         const additionalFields = this.getNodeParameter('additionalFields', i);
                         qs = Object.assign(qs, additionalFields);
-                        if (returnAll) {
-                            responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'companies', 'GET', '/companies', {}, qs);
+                        // Patch: enforce default sort order by id ascending if not set by user
+                        if (!qs.orderBy) {
+                            qs.orderBy = 'id';
                         }
-                        else {
-                            qs.limit = this.getNodeParameter('limit', i);
-                            qs.start = 0;
-                            responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/companies', {}, qs);
-                            if (responseData.errors) {
-                                throw new n8n_workflow_1.NodeApiError(this.getNode(), responseData);
-                            }
-                            responseData = responseData.companies;
-                            responseData = Object.values(responseData);
+                        if (!qs.orderByDir) {
+                            qs.orderByDir = 'asc';
                         }
+                        let limit = undefined;
+                        if (!returnAll) {
+                            limit = this.getNodeParameter('limit', i);
+                        }
+                        responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'companies', 'GET', '/companies', {}, qs, limit);
                         if (simple) {
-                            //@ts-ignore
                             responseData = responseData.map((item) => item.fields.all);
                         }
                     }
@@ -555,14 +690,18 @@ class MauticAdvanced {
                         const returnAll = this.getNodeParameter('returnAll', i);
                         const options = this.getNodeParameter('options', i);
                         Object.assign(qs, options);
-                        if (returnAll) {
-                            responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'tags', 'GET', '/tags', {}, qs);
+                        // Patch: enforce default sort order by id ascending if not set by user
+                        if (!qs.orderBy) {
+                            qs.orderBy = 'id';
                         }
-                        else {
-                            qs.limit = this.getNodeParameter('limit', i);
-                            responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/tags', {}, qs);
-                            responseData = responseData.tags;
+                        if (!qs.orderByDir) {
+                            qs.orderByDir = 'asc';
+                        }
+                        let limit = undefined;
+                        if (!returnAll) {
+                            limit = this.getNodeParameter('limit', i);
                         }
+                        responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'tags', 'GET', '/tags', {}, qs, limit);
                     }
                     if (operation === 'delete') {
                         const tagId = this.getNodeParameter('tagId', i);
@@ -802,30 +941,22 @@ class MauticAdvanced {
                         const returnAll = this.getNodeParameter('returnAll', i);
                         const options = this.getNodeParameter('options', i);
                         qs = Object.assign(qs, options);
+                        // Patch: enforce default sort order by id ascending if not set by user
+                        if (!qs.orderBy) {
+                            qs.orderBy = 'id';
+                        }
+                        if (!qs.orderByDir) {
+                            qs.orderByDir = 'asc';
+                        }
                         if (qs.orderBy) {
                             qs.orderBy = (0, change_case_1.snakeCase)(qs.orderBy);
                         }
-                        if (returnAll) {
-                            responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'contacts', 'GET', '/contacts', {}, qs);
-                        }
-                        else {
-                            const limit = this.getNodeParameter('limit', i);
-                            if (limit > 30) {
-                                responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'contacts', 'GET', '/contacts', {}, qs, limit);
-                            }
-                            else {
-                                qs.limit = limit;
-                                qs.start = 0;
-                                responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/contacts', {}, qs);
-                                if (responseData.errors) {
-                                    throw new n8n_workflow_1.NodeApiError(this.getNode(), responseData);
-                                }
-                                responseData = responseData.contacts;
-                                responseData = Object.values(responseData);
-                            }
+                        let limit = undefined;
+                        if (!returnAll) {
+                            limit = this.getNodeParameter('limit', i);
                         }
+                        responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'contacts', 'GET', '/contacts', {}, qs, limit);
                         if (options.rawData === false) {
-                            //@ts-ignore
                             responseData = responseData.map((item) => item.fields.all);
                         }
                     }
@@ -847,7 +978,9 @@ class MauticAdvanced {
                         catch (error) {
                             // If the error is a 404 (not found), treat as successful delete (idempotent)
                             if (error instanceof n8n_workflow_1.NodeApiError && error.httpCode === '404') {
-                                responseData = [{ success: true, message: 'Contact already deleted or not found.' }];
+                                responseData = [
+                                    { success: true, message: 'Contact already deleted or not found.' },
+                                ];
                             }
                             else {
                                 throw error;
@@ -1039,19 +1172,15 @@ class MauticAdvanced {
                     }
                     if (operation === 'update') {
                         const categoryId = this.getNodeParameter('categoryId', i);
-                        const createIfNotFound = this.getNodeParameter('createIfNotFound', i);
-                        const { title, bundle, description, color } = this.getNodeParameter('updateFields', i);
+                        const { title, description, color } = this.getNodeParameter('updateFields', i);
                         const body = {};
                         if (title)
                             body.title = title;
-                        if (bundle)
-                            body.bundle = bundle;
                         if (description)
                             body.description = description;
                         if (color)
                             body.color = color;
-                        const method = createIfNotFound ? 'PUT' : 'PATCH';
-                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, method, `/categories/${categoryId}/edit`, body);
+                        responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'PATCH', `/categories/${categoryId}/edit`, body);
                         responseData = responseData.category;
                     }
                     if (operation === 'get') {
@@ -1063,14 +1192,18 @@ class MauticAdvanced {
                         const returnAll = this.getNodeParameter('returnAll', i);
                         const options = this.getNodeParameter('options', i);
                         Object.assign(qs, options);
-                        if (returnAll) {
-                            responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'categories', 'GET', '/categories', {}, qs);
+                        // Patch: enforce default sort order by id ascending if not set by user
+                        if (!qs.orderBy) {
+                            qs.orderBy = 'id';
                         }
-                        else {
-                            qs.limit = this.getNodeParameter('limit', i);
-                            responseData = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/categories', {}, qs);
-                            responseData = responseData.categories;
+                        if (!qs.orderByDir) {
+                            qs.orderByDir = 'asc';
+                        }
+                        let limit = undefined;
+                        if (!returnAll) {
+                            limit = this.getNodeParameter('limit', i);
                         }
+                        responseData = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'categories', 'GET', '/categories', {}, qs, limit);
                     }
                     if (operation === 'delete') {
                         const categoryId = this.getNodeParameter('categoryId', i);
@@ -1078,12 +1211,16 @@ class MauticAdvanced {
                         responseData = responseData.category;
                     }
                 }
-                const executionData = this.helpers.constructExecutionMetaData(this.helpers.returnJsonArray(responseData), { itemData: { item: i } });
-                returnData.push(...executionData);
+                if (Array.isArray(responseData)) {
+                    returnData.push(...this.helpers.returnJsonArray(responseData));
+                }
+                else {
+                    returnData.push(...this.helpers.returnJsonArray([responseData]));
+                }
             }
             catch (error) {
                 if (this.continueOnFail()) {
-                    returnData.push({ json: { error: error.message } });
+                    returnData.push(...this.helpers.returnJsonArray([{ error: error.message }]));
                     continue;
                 }
                 throw error;

package/dist/nodes/MauticAdvanced/MauticAdvanced.svg

@@ -1 +1,10 @@
-<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="349.779" height="349.779"><path fill="#FFF" d="M174.89 349.779C78.612 349.779 0 271.462 0 174.89S78.612 0 174.89 0c23.26 0 45.931 4.417 67.129 13.543 5.889 2.65 8.833 9.422 6.478 15.605-2.649 5.888-9.421 8.833-15.604 6.477-18.549-7.655-37.98-11.482-58.002-11.482-83.323 0-151.041 67.718-151.041 151.041s67.717 151.041 151.04 151.041 151.041-67.718 151.041-151.041c0-17.96-2.944-35.332-9.127-51.819-2.355-6.183.883-12.955 7.066-15.31s12.954.883 15.31 7.066c7.066 19.138 10.6 39.453 10.6 60.063-.001 95.983-78.318 174.595-174.89 174.595"/><path fill="#FDB933" d="m251.44 156.93-27.086 28.264 15.015 63.302h34.153zm-11.187-83.618 9.421 9.422-74.784 79.201-63.891-65.658-36.803 152.219h34.154l20.315-84.5 46.225 50.347 98.927-107.76 9.422 9.716 9.421-53.292z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="349.779" height="349.779">
+  <path
+    fill="#FFF"
+    d="M174.89 349.779C78.612 349.779 0 271.462 0 174.89S78.612 0 174.89 0c23.26 0 45.931 4.417 67.129 13.543 5.889 2.65 8.833 9.422 6.478 15.605-2.649 5.888-9.421 8.833-15.604 6.477-18.549-7.655-37.98-11.482-58.002-11.482-83.323 0-151.041 67.718-151.041 151.041s67.717 151.041 151.04 151.041 151.041-67.718 151.041-151.041c0-17.96-2.944-35.332-9.127-51.819-2.355-6.183.883-12.955 7.066-15.31s12.954.883 15.31 7.066c7.066 19.138 10.6 39.453 10.6 60.063-.001 95.983-78.318 174.595-174.89 174.595"
+  />
+  <path
+    fill="#FDB933"
+    d="m251.44 156.93-27.086 28.264 15.015 63.302h34.153zm-11.187-83.618 9.421 9.422-74.784 79.201-63.891-65.658-36.803 152.219h34.154l20.315-84.5 46.225 50.347 98.927-107.76 9.422 9.716 9.421-53.292z"
+  />
+</svg>

package/dist/nodes/MauticAdvanced/SegmentDescription.js

@@ -0,0 +1,360 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.segmentFields = exports.segmentOperations = void 0;
+exports.segmentOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+            },
+        },
+        options: [
+            {
+                name: 'Add Contact',
+                value: 'addContact',
+                description: 'Add a contact to a segment',
+                action: 'Add a contact to a segment',
+            },
+            {
+                name: 'Add Contacts',
+                value: 'addContacts',
+                description: 'Add contacts to a segment',
+                action: 'Add contacts to a segment',
+            },
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Create a new segment',
+                action: 'Create a segment',
+            },
+            {
+                name: 'Delete',
+                value: 'delete',
+                description: 'Delete a segment',
+                action: 'Delete a segment',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Get data of a segment',
+                action: 'Get a segment',
+            },
+            {
+                name: 'Get Many',
+                value: 'getAll',
+                description: 'Get data of many segments',
+                action: 'Get many segments',
+            },
+            {
+                name: 'Remove Contact',
+                value: 'removeContact',
+                description: 'Remove a contact from a segment',
+                action: 'Remove a contact from a segment',
+            },
+            {
+                name: 'Update',
+                value: 'update',
+                description: 'Update a segment',
+                action: 'Update a segment',
+            },
+        ],
+        default: 'create',
+    },
+];
+exports.segmentFields = [
+    /* -------------------------------------------------------------------------- */
+    /*                                segment:create                              */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['create', 'update'],
+            },
+        },
+        default: '',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['create', 'update'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Alias',
+                name: 'alias',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Description',
+                name: 'description',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Is Published',
+                name: 'isPublished',
+                type: 'boolean',
+                default: true,
+            },
+            {
+                displayName: 'Is Global',
+                name: 'isGlobal',
+                type: 'boolean',
+                default: false,
+            },
+            {
+                displayName: 'Filters',
+                name: 'filters',
+                type: 'fixedCollection',
+                placeholder: 'Add Filter',
+                typeOptions: {
+                    multiple: true,
+                },
+                default: {},
+                options: [
+                    {
+                        displayName: 'Filter',
+                        name: 'filter',
+                        values: [
+                            {
+                                displayName: 'Glue',
+                                name: 'glue',
+                                type: 'options',
+                                options: [
+                                    { name: 'And', value: 'and' },
+                                    { name: 'Or', value: 'or' },
+                                ],
+                                default: 'and',
+                            },
+                            {
+                                displayName: 'Field',
+                                name: 'field',
+                                type: 'string',
+                                default: 'email',
+                            },
+                            {
+                                displayName: 'Object',
+                                name: 'object',
+                                type: 'options',
+                                options: [
+                                    { name: 'Contact', value: 'lead' },
+                                    { name: 'Company', value: 'company' },
+                                ],
+                                default: 'lead',
+                            },
+                            {
+                                displayName: 'Type',
+                                name: 'type',
+                                type: 'string',
+                                default: 'email',
+                            },
+                            {
+                                displayName: 'Filter',
+                                name: 'filter',
+                                type: 'string',
+                                default: '',
+                            },
+                            {
+                                displayName: 'Operator',
+                                name: 'operator',
+                                type: 'options',
+                                options: [
+                                    { name: '=', value: '=' },
+                                    { name: '!=', value: '!=' },
+                                    { name: 'Empty', value: 'empty' },
+                                    { name: 'Not Empty', value: '!empty' },
+                                    { name: 'Like', value: 'like' },
+                                    { name: 'Not Like', value: '!like' },
+                                    { name: 'Regexp', value: 'regexp' },
+                                    { name: 'Not Regexp', value: '!regexp' },
+                                    { name: 'Starts With', value: 'startsWith' },
+                                    { name: 'Ends With', value: 'endsWith' },
+                                    { name: 'Contains', value: 'contains' },
+                                ],
+                                default: 'like',
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                segment:update                              */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Segment ID',
+        name: 'segmentId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['update', 'addContact', 'addContacts', 'removeContact'],
+            },
+        },
+        default: '',
+    },
+    {
+        displayName: 'Create If Not Found',
+        name: 'createIfNotFound',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['update'],
+            },
+        },
+        default: false,
+        description: 'Whether to create a segment if the given ID is not found',
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                 segment:get                                */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Segment ID',
+        name: 'segmentId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['get', 'delete'],
+            },
+        },
+        default: '',
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                 segment:getAll                             */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['getAll'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['getAll'],
+                returnAll: [false],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+        default: 30,
+        description: 'Max number of results to return',
+    },
+    {
+        displayName: 'Options',
+        name: 'options',
+        type: 'collection',
+        placeholder: 'Add Option',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['getAll'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Search',
+                name: 'search',
+                type: 'string',
+                default: '',
+                description: 'String or search command to filter entities by',
+            },
+            {
+                displayName: 'Order By',
+                name: 'orderBy',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Order By Direction',
+                name: 'orderByDir',
+                type: 'options',
+                options: [
+                    { name: 'ASC', value: 'asc' },
+                    { name: 'DESC', value: 'desc' },
+                ],
+                default: 'asc',
+            },
+            {
+                displayName: 'Published Only',
+                name: 'publishedOnly',
+                type: 'boolean',
+                default: false,
+            },
+            {
+                displayName: 'Minimal',
+                name: 'minimal',
+                type: 'boolean',
+                default: false,
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                           segment:addContact                               */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Contact ID',
+        name: 'contactId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['addContact', 'removeContact'],
+            },
+        },
+        default: '',
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                           segment:addContacts                              */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Contact IDs',
+        name: 'contactIds',
+        type: 'string',
+        required: false,
+        displayOptions: {
+            show: {
+                resource: ['segment'],
+                operation: ['addContacts'],
+            },
+        },
+        default: '',
+        description: "Comma-separated list of contact IDs to add. If left empty, all input items' contactId or id fields will be used for batch adding.",
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-mautic-advanced",
-  "version": "0.2.0",
+  "version": "0.2.5",
   "description": "Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, and advanced contact management",
   "keywords": [
     "n8n",
@@ -54,7 +54,9 @@
     "@typescript-eslint/eslint-plugin": "^7.7.0",
     "@typescript-eslint/parser": "^7.7.0",
     "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-n8n-nodes-base": "^1.16.3",
+    "eslint-plugin-prettier": "^5.5.1",
     "gulp": "^4.0.2",
     "n8n-workflow": "^1.70.0",
     "prettier": "^3.2.5",