n8n-nodes-mautic-advanced 0.5.2 → 0.7.0

package/README.md

@@ -125,6 +125,24 @@ This enhanced version extends the standard n8n Mautic node with:
 ### 📧 Email Operations
 - **Segment Email**: Send emails to segments
 
+### 👤 Users
+- **Create** a new Mautic user (administrator) with role, password, and profile fields
+- **Get** a user by ID
+- **Get Many** users with basic filtering and pagination
+- **Update** user details including role, profile fields, and password
+- **Delete** a user
+
+### 🔐 Roles
+- **Create** a new role with name, description, and permissions
+- **Get** a role by ID
+- **Get Many** roles with filtering and pagination
+- **Update** role details including permissions
+- **Delete** a role
+
+### 📈 Stats
+- **Get Available Tables** to list all statistical tables and their columns
+- **Get Stats** from a specific table with filtering, ordering, and pagination
+
 ## Installation
 
 ### Method 1: npm (Recommended)

package/dist/credentials/MauticAdvancedApi.credentials.js

@@ -14,6 +14,25 @@ class MauticAdvancedApi {
                 default: '',
                 placeholder: 'https://name.mautic.net',
             },
+            {
+                displayName: 'Mautic Version',
+                name: 'mauticVersion',
+                type: 'options',
+                default: 'v6',
+                options: [
+                    {
+                        name: 'v6 or lower',
+                        value: 'v6',
+                        description: 'Use legacy v1 API endpoints.',
+                    },
+                    {
+                        name: 'v7 or higher',
+                        value: 'v7',
+                        description: 'Use v2 API endpoints where available.',
+                    },
+                ],
+                description: 'Select the major Mautic version of this instance so the node can route API calls correctly.',
+            },
             {
                 displayName: 'Username',
                 name: 'username',

package/dist/credentials/MauticAdvancedOAuth2Api.credentials.js

@@ -21,6 +21,25 @@ class MauticAdvancedOAuth2Api {
                 default: '',
                 placeholder: 'https://name.mautic.net',
             },
+            {
+                displayName: 'Mautic Version',
+                name: 'mauticVersion',
+                type: 'options',
+                default: 'v6',
+                options: [
+                    {
+                        name: 'v6 or lower',
+                        value: 'v6',
+                        description: 'Use legacy v1 API endpoints.',
+                    },
+                    {
+                        name: 'v7 or higher',
+                        value: 'v7',
+                        description: 'Use v2 API endpoints where available.',
+                    },
+                ],
+                description: 'Select the major Mautic version of this instance so the node can route API calls correctly.',
+            },
             {
                 displayName: 'Authorization URL',
                 name: 'authUrl',

package/dist/nodes/MauticAdvanced/GenericFunctions.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateJSON = exports.serialiseMauticWhere = exports.mauticApiRequestAllItems = exports.mauticApiRequest = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-async function mauticApiRequest(method, endpoint, body = {}, query, uri) {
+async function mauticApiRequest(method, endpoint, body = {}, query, uri, headers) {
     const authenticationMethod = this.getNodeParameter('authentication', 0, 'credentials');
     const options = {
-        headers: {},
+        headers: headers || {},
         method,
         qs: query,
         uri: uri || `/api${endpoint}`,

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

@@ -11,6 +11,9 @@ const SegmentOperations_1 = require("./operations/SegmentOperations");
 const EmailOperations_1 = require("./operations/EmailOperations");
 const ThemeOperations_1 = require("./operations/ThemeOperations");
 const MiscellaneousOperations_1 = require("./operations/MiscellaneousOperations");
+const UserOperations_1 = require("./operations/UserOperations");
+const RoleOperations_1 = require("./operations/RoleOperations");
+const StatsOperations_1 = require("./operations/StatsOperations");
 const CampaignContactDescription_1 = require("./CampaignContactDescription");
 const CampaignDescription_1 = require("./CampaignDescription");
 const CategoryDescription_1 = require("./CategoryDescription");
@@ -26,6 +29,9 @@ const SegmentEmailDescription_1 = require("./SegmentEmailDescription");
 const SegmentDescription_1 = require("./SegmentDescription");
 const TagDescription_1 = require("./TagDescription");
 const ThemeDescription_1 = require("./ThemeDescription");
+const UserDescription_1 = require("./UserDescription");
+const RoleDescription_1 = require("./RoleDescription");
+const StatsDescription_1 = require("./StatsDescription");
 class MauticAdvanced {
     constructor() {
         this.description = {
@@ -135,6 +141,11 @@ class MauticAdvanced {
                             value: 'notification',
                             description: 'Create, update, and retrieve notifications',
                         },
+                        {
+                            name: 'Role',
+                            value: 'role',
+                            description: 'Create, update, and retrieve roles',
+                        },
                         {
                             name: 'Segment',
                             value: 'segment',
@@ -145,6 +156,11 @@ class MauticAdvanced {
                             value: 'segmentEmail',
                             description: 'Send an email',
                         },
+                        {
+                            name: 'Stats',
+                            value: 'stats',
+                            description: 'Get statistical data from Mautic tables',
+                        },
                         {
                             name: 'Tag',
                             value: 'tag',
@@ -155,6 +171,11 @@ class MauticAdvanced {
                             value: 'theme',
                             description: 'Create, update, and retrieve themes',
                         },
+                        {
+                            name: 'User',
+                            value: 'user',
+                            description: 'Create, update, and retrieve users',
+                        },
                     ],
                     default: 'contact',
                 },
@@ -186,6 +207,12 @@ class MauticAdvanced {
                 ...SegmentDescription_1.segmentFields,
                 ...ThemeDescription_1.themeOperations,
                 ...ThemeDescription_1.themeFields,
+                ...UserDescription_1.userOperations,
+                ...UserDescription_1.userFields,
+                ...RoleDescription_1.roleOperations,
+                ...RoleDescription_1.roleFields,
+                ...StatsDescription_1.statsOperations,
+                ...StatsDescription_1.statsFields,
             ],
         };
         this.methods = {
@@ -445,6 +472,15 @@ class MauticAdvanced {
                     case 'theme':
                         result = await (0, ThemeOperations_1.executeThemeOperation)(this, operation, i);
                         break;
+                    case 'user':
+                        result = await (0, UserOperations_1.executeUserOperation)(this, operation, i);
+                        break;
+                    case 'role':
+                        result = await (0, RoleOperations_1.executeRoleOperation)(this, operation, i);
+                        break;
+                    case 'stats':
+                        result = await (0, StatsOperations_1.executeStatsOperation)(this, operation, i);
+                        break;
                     default:
                         throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Resource '${resource}' is not supported.`, { itemIndex: i });
                 }

package/dist/nodes/MauticAdvanced/RoleDescription.js

@@ -0,0 +1,367 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roleFields = exports.roleOperations = void 0;
+exports.roleOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['role'],
+            },
+        },
+        options: [
+            {
+                name: 'Create',
+                value: 'create',
+                description: 'Create a new role',
+                action: 'Create a role',
+            },
+            {
+                name: 'Delete',
+                value: 'delete',
+                description: 'Delete a role',
+                action: 'Delete a role',
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                description: 'Get data of a role',
+                action: 'Get a role',
+            },
+            {
+                name: 'Get Many',
+                value: 'getAll',
+                description: 'Get data of many roles',
+                action: 'Get many roles',
+            },
+            {
+                name: 'Update',
+                value: 'update',
+                description: 'Update a role',
+                action: 'Update a role',
+            },
+        ],
+        default: 'create',
+    },
+];
+exports.roleFields = [
+    /* -------------------------------------------------------------------------- */
+    /*                                 role:create                                */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['create'],
+            },
+        },
+        default: '',
+        description: 'Name of the role',
+    },
+    {
+        displayName: 'Simplify',
+        name: 'simple',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['create'],
+            },
+        },
+        default: true,
+        description: 'Whether to return a simplified version of the response instead of the raw data',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['create'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Description',
+                name: 'description',
+                type: 'string',
+                default: '',
+                description: 'Description of the role',
+            },
+            {
+                displayName: 'Is Admin',
+                name: 'isAdmin',
+                type: 'boolean',
+                default: false,
+                description: 'Whether the role has full administrative access',
+            },
+            {
+                displayName: 'Is Published',
+                name: 'isPublished',
+                type: 'boolean',
+                default: true,
+                description: 'Whether the role is published (enabled)',
+            },
+            {
+                displayName: 'Raw Permissions (JSON)',
+                name: 'rawPermissions',
+                type: 'json',
+                default: '{}',
+                description: 'JSON object defining permissions. Example: {"email:emails": ["viewown", "viewother"]}',
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                 role:update                                */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Role ID',
+        name: 'roleId',
+        type: 'string',
+        displayOptions: {
+            show: {
+                operation: ['update'],
+                resource: ['role'],
+            },
+        },
+        default: '',
+        description: 'The ID of the role to update',
+    },
+    {
+        displayName: 'Simplify',
+        name: 'simple',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['update'],
+            },
+        },
+        default: true,
+        description: 'Whether to return a simplified version of the response instead of the raw data',
+    },
+    {
+        displayName: 'Update Fields',
+        name: 'updateFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['update'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Description',
+                name: 'description',
+                type: 'string',
+                default: '',
+                description: 'Description of the role',
+            },
+            {
+                displayName: 'Is Admin',
+                name: 'isAdmin',
+                type: 'boolean',
+                default: false,
+                description: 'Whether the role has full administrative access',
+            },
+            {
+                displayName: 'Is Published',
+                name: 'isPublished',
+                type: 'boolean',
+                default: true,
+                description: 'Whether the role is published (enabled)',
+            },
+            {
+                displayName: 'Name',
+                name: 'name',
+                type: 'string',
+                default: '',
+                description: 'Name of the role',
+            },
+            {
+                displayName: 'Raw Permissions (JSON)',
+                name: 'rawPermissions',
+                type: 'json',
+                default: '{}',
+                description: 'JSON object defining permissions. Example: {"email:emails": ["viewown", "viewother"]}',
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                  role:get                                  */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Role ID',
+        name: 'roleId',
+        type: 'string',
+        displayOptions: {
+            show: {
+                operation: ['get'],
+                resource: ['role'],
+            },
+        },
+        default: '',
+        description: 'The ID of the role to return',
+    },
+    {
+        displayName: 'Simplify',
+        name: 'simple',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['get'],
+            },
+        },
+        default: true,
+        description: 'Whether to return a simplified version of the response instead of the raw data',
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                 role:getAll                                */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                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: ['role'],
+                operation: ['getAll'],
+                returnAll: [false],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+        default: 30,
+        description: 'Max number of results to return. If you request more than 30 records, the node will automatically use pagination to fetch up to the requested number.',
+    },
+    {
+        displayName: 'Simplify',
+        name: 'simple',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['getAll'],
+            },
+        },
+        default: true,
+        description: 'Whether to return a simplified version of the response instead of the raw data',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['getAll'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Minimal',
+                name: 'minimal',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to return array of entities without additional lists in it',
+            },
+            {
+                displayName: 'Order By',
+                name: 'orderBy',
+                type: 'string',
+                default: '',
+                description: 'Column to sort by. Can use any column listed in the response.',
+            },
+            {
+                displayName: 'Order Direction',
+                name: 'orderByDir',
+                type: 'options',
+                options: [
+                    {
+                        name: 'ASC',
+                        value: 'asc',
+                    },
+                    {
+                        name: 'DESC',
+                        value: 'desc',
+                    },
+                ],
+                default: '',
+                description: 'Sort direction: asc or desc',
+            },
+            {
+                displayName: 'Published Only',
+                name: 'publishedOnly',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to return currently published entities',
+            },
+            {
+                displayName: 'Search',
+                name: 'search',
+                type: 'string',
+                default: '',
+                description: 'String or search command to filter entities by',
+            },
+        ],
+    },
+    /* -------------------------------------------------------------------------- */
+    /*                                role:delete                                 */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Role ID',
+        name: 'roleId',
+        type: 'string',
+        displayOptions: {
+            show: {
+                operation: ['delete'],
+                resource: ['role'],
+            },
+        },
+        default: '',
+        description: 'The ID of the role to delete',
+    },
+    {
+        displayName: 'Simplify',
+        name: 'simple',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['role'],
+                operation: ['delete'],
+            },
+        },
+        default: true,
+        description: 'Whether to return a simplified version of the response instead of the raw data',
+    },
+];