n8n-nodes-mautic-advanced 0.5.2 → 0.6.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/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',
+    },
+];

package/dist/nodes/MauticAdvanced/StatsDescription.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statsFields = exports.statsOperations = void 0;
+exports.statsOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['stats'],
+            },
+        },
+        options: [
+            {
+                name: 'Get Available Tables',
+                value: 'getAvailableTables',
+                description: 'Get list of available statistical tables',
+                action: 'Get available tables',
+            },
+            {
+                name: 'Get Stats',
+                value: 'get',
+                description: 'Get statistics from a specific table',
+                action: 'Get stats from a table',
+            },
+        ],
+        default: 'getAvailableTables',
+    },
+];
+exports.statsFields = [
+    /* -------------------------------------------------------------------------- */
+    /*                           stats:getAvailableTables                         */
+    /* -------------------------------------------------------------------------- */
+    // No additional fields needed for getAvailableTables
+    /* -------------------------------------------------------------------------- */
+    /*                                  stats:get                                 */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Table Name',
+        name: 'table',
+        type: 'options',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['stats'],
+                operation: ['get'],
+            },
+        },
+        options: [
+            { name: 'Asset Downloads', value: 'asset_downloads' },
+            { name: 'Audit Log', value: 'audit_log' },
+            { name: 'Campaign Lead Event Log', value: 'campaign_lead_event_log' },
+            { name: 'Campaign Leads', value: 'campaign_leads' },
+            { name: 'Channel URL Trackables', value: 'channel_url_trackables' },
+            { name: 'Companies Leads', value: 'companies_leads' },
+            { name: 'Dynamic Content Lead Data', value: 'dynamic_content_lead_data' },
+            { name: 'Dynamic Content Stats', value: 'dynamic_content_stats' },
+            { name: 'Email Stat Replies', value: 'email_stat_replies' },
+            { name: 'Email Stats', value: 'email_stats' },
+            { name: 'Email Stats Devices', value: 'email_stats_devices' },
+            { name: 'Focus Stats', value: 'focus_stats' },
+            { name: 'Form Submissions', value: 'form_submissions' },
+            { name: 'IP Addresses', value: 'ip_addresses' },
+            { name: 'Lead Categories', value: 'lead_categories' },
+            { name: 'Lead Companies Change Log', value: 'lead_companies_change_log' },
+            { name: 'Lead Devices', value: 'lead_devices' },
+            { name: 'Lead Do Not Contact', value: 'lead_donotcontact' },
+            { name: 'Lead Event Log', value: 'lead_event_log' },
+            { name: 'Lead Frequency Rules', value: 'lead_frequencyrules' },
+            { name: 'Lead Lists Leads', value: 'lead_lists_leads' },
+            { name: 'Lead Points Change Log', value: 'lead_points_change_log' },
+            { name: 'Lead Stages Change Log', value: 'lead_stages_change_log' },
+            { name: 'Lead UTM Tags', value: 'lead_utmtags' },
+            { name: 'Page Hits', value: 'page_hits' },
+            { name: 'Page Redirects', value: 'page_redirects' },
+            { name: 'Plugin Citrix Events', value: 'plugin_citrix_events' },
+            { name: 'Point Lead Action Log', value: 'point_lead_action_log' },
+            { name: 'Point Lead Event Log', value: 'point_lead_event_log' },
+            { name: 'Push Notification Stats', value: 'push_notification_stats' },
+            { name: 'SMS Message Stats', value: 'sms_message_stats' },
+            { name: 'Stage Lead Action Log', value: 'stage_lead_action_log' },
+            { name: 'Tweet Stats', value: 'tweet_stats' },
+            { name: 'Video Hits', value: 'video_hits' },
+            { name: 'Webhook Logs', value: 'webhook_logs' },
+        ],
+        default: 'email_stats',
+        description: 'The statistical table to retrieve data from',
+    },
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['stats'],
+                operation: ['get'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['stats'],
+                operation: ['get'],
+                returnAll: [false],
+            },
+        },
+        typeOptions: {
+            minValue: 1,
+        },
+        default: 50,
+        description: 'Max number of results to return',
+    },
+    {
+        displayName: 'Additional Options',
+        name: 'additionalOptions',
+        type: 'collection',
+        placeholder: 'Add Option',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['stats'],
+                operation: ['get'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Order By',
+                name: 'orderBy',
+                type: 'string',
+                default: 'id',
+                description: 'Column to sort by (e.g. id, date_sent, lead_id)',
+            },
+            {
+                displayName: 'Order Direction',
+                name: 'orderByDir',
+                type: 'options',
+                options: [
+                    {
+                        name: 'ASC',
+                        value: 'asc',
+                    },
+                    {
+                        name: 'DESC',
+                        value: 'desc',
+                    },
+                ],
+                default: 'asc',
+                description: 'Sort direction',
+            },
+            {
+                displayName: 'Start',
+                name: 'start',
+                type: 'number',
+                typeOptions: {
+                    minValue: 0,
+                },
+                default: 0,
+                description: 'Row offset to start from',
+            },
+            {
+                displayName: 'Where Conditions (JSON)',
+                name: 'where',
+                type: 'json',
+                default: '[]',
+                description: 'JSON array of where conditions. Example: [{"col": "lead_id", "expr": "eq", "val": 123}]. Available expressions: eq, neq, gt, gte, lt, lte, like, notLike, in, notIn, isNull, isNotNull.',
+            },
+        ],
+    },
+];