@belmontdigitalmarketing/n8n-nodes-flowlu 0.3.0 → 0.4.0

package/dist/nodes/Flowlu/Flowlu.node.js

@@ -38,9 +38,16 @@ function isFlowluRateLimit(value) {
 // GET wrapper that retries through Flowlu's rate limit with linear backoff. If it
 // never succeeds it throws, so callers surface the real cause instead of silently
 // returning no data (which previously masqueraded as "No fields found").
-async function flowluApiGetWithRetry(baseUrl, endpoint, apiKey, queryParams, maxRetries = 3) {
+async function flowluApiGetWithRetry(baseUrl, endpoint, apiKey, queryParams, maxRetries = 4) {
     let lastMessage = 'Flowlu request failed';
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        // Jittered wait before each attempt. The small random delay on the first
+        // attempt de-syncs the burst of dropdown loads fired on node-open so they
+        // don't hit Flowlu's rate limit in lockstep; later attempts back off longer.
+        const wait = attempt === 0 ? Math.floor(Math.random() * 1200) : 1500 * attempt + Math.floor(Math.random() * 1000);
+        await new Promise((resolve) => {
+            setTimeout(resolve, wait);
+        });
         try {
             const response = await flowluApiRequest.call(this, 'GET', baseUrl, endpoint, apiKey, undefined, queryParams);
             if (!isFlowluRateLimit(response?.error ?? response)) {
@@ -54,12 +61,6 @@ async function flowluApiGetWithRetry(baseUrl, endpoint, apiKey, queryParams, max
             }
             lastMessage = error.message || 'Flowlu request limit exceeded';
         }
-        // linear backoff before the next attempt (no wait after the final one)
-        if (attempt < maxRetries) {
-            await new Promise((resolve) => {
-                setTimeout(resolve, 1500 * (attempt + 1));
-            });
-        }
     }
     throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Flowlu API rate limit reached while loading data (${lastMessage}). Wait a moment and click Retry.`);
 }
@@ -104,6 +105,15 @@ function applyResourceMapperFields(context, body, paramName, itemIndex) {
         // No custom fields set - ignore
     }
 }
+// Read a resourceLocator parameter (or a legacy scalar value) as its underlying id.
+function getResourceValue(context, name, itemIndex) {
+    const raw = context.getNodeParameter(name, itemIndex, '');
+    if (raw && typeof raw === 'object' && 'value' in raw) {
+        const value = raw.value;
+        return value === undefined || value === null ? '' : String(value);
+    }
+    return raw ? String(raw) : '';
+}
 // Helper to load an entity's custom fields as name/value options.
 async function loadCustomFieldsForEntity(context, moduleFilter, modelFilter) {
     const { baseUrl, apiKey } = await getFlowluCredentials(context);
@@ -1299,13 +1309,21 @@ class Flowlu {
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Assignee Name or ID',
+                    displayName: 'Assignee',
                     name: 'responsible_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getUsers' },
+                    type: 'resourceLocator',
                     required: true,
-                    default: '',
-                    description: 'The user responsible for completing this task. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                    default: { mode: 'list', value: '' },
+                    description: 'The user responsible for completing this task',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchUsers', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 176265' },
+                    ],
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
@@ -1317,12 +1335,20 @@ class Flowlu {
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Owner Name or ID',
+                    displayName: 'Owner',
                     name: 'owner_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getUsers' },
-                    default: '',
-                    description: 'The user who owns this task. If left blank, the credential\'s Default Task Owner is used. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
+                    description: 'The user who owns this task. If left blank, the credential\'s Default Task Owner is used.',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchUsers', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 176265' },
+                    ],
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
@@ -1338,21 +1364,37 @@ class Flowlu {
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Contact Name or ID',
+                    displayName: 'Contact',
                     name: 'contact_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getContacts' },
-                    default: '',
-                    description: 'The contact this task is related to. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
+                    description: 'The contact this task is related to. Search by name, or enter a contact ID.',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchContacts', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 12345' },
+                    ],
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Project Name or ID',
+                    displayName: 'Project',
                     name: 'model_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getProjects' },
-                    default: '',
-                    description: 'The project this task belongs to. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
+                    description: 'The project this task belongs to',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchProjects', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 678' },
+                    ],
                     displayOptions: { show: { resource: ['task'], operation: ['create'] } },
                 },
                 {
@@ -2106,6 +2148,45 @@ class Flowlu {
                     }
                 },
             },
+            listSearch: {
+                async searchUsers(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/core/user/list', apiKey, {
+                        'filter[role_login]': '1',
+                    });
+                    const term = (filter ?? '').toLowerCase();
+                    const results = items
+                        .map((u) => ({ name: u.name || u.email || `User ${u.id}`, value: u.id.toString() }))
+                        .filter((r) => !term || r.name.toLowerCase().includes(term));
+                    return { results };
+                },
+                async searchProjects(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/st/projects/list', apiKey, {
+                        'filter[is_archive]': '0',
+                    });
+                    const term = (filter ?? '').toLowerCase();
+                    const results = items
+                        .map((p) => ({ name: p.name || `Project ${p.id}`, value: p.id.toString() }))
+                        .filter((r) => !term || r.name.toLowerCase().includes(term));
+                    return { results };
+                },
+                async searchContacts(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    const qs = { 'filter[type]': '2' };
+                    // Contacts can number in the thousands, so use Flowlu's server-side search and
+                    // take just the first page rather than paginating the whole list.
+                    if (filter)
+                        qs.search = filter;
+                    const response = await flowluApiGetWithRetry.call(this, baseUrl, '/api/v1/module/crm/account/list', apiKey, qs);
+                    const items = response?.response?.items ?? [];
+                    const results = items.map((c) => ({
+                        name: c.name || `Contact ${c.id}`,
+                        value: c.id.toString(),
+                    }));
+                    return { results };
+                },
+            },
         };
     }
     async execute() {
@@ -2529,7 +2610,7 @@ class Flowlu {
                     if (operation === 'create') {
                         const body = {
                             name: this.getNodeParameter('taskName', i),
-                            responsible_id: this.getNodeParameter('responsible_id', i),
+                            responsible_id: getResourceValue(this, 'responsible_id', i),
                         };
                         const description = this.getNodeParameter('description', i);
                         if (description)
@@ -2539,10 +2620,10 @@ class Flowlu {
                         body.workflow_stage_id = additional.workflow_stage_id || '1';
                         // Owner/Priority/Contact/Project/Start/End moved to top-level fields; fall back to
                         // Additional Fields so task-create nodes built before the move keep working.
-                        const ownerId = this.getNodeParameter('owner_id', i, '') || additional.owner_id || defaultOwnerId;
+                        const ownerId = getResourceValue(this, 'owner_id', i) || additional.owner_id || defaultOwnerId;
                         if (ownerId)
                             body.owner_id = ownerId;
-                        const contactId = this.getNodeParameter('contact_id', i, '') || additional.contact_id;
+                        const contactId = getResourceValue(this, 'contact_id', i) || additional.contact_id;
                         if (contactId)
                             body.crm_account_id = parseInt(contactId, 10);
                         body.priority =
@@ -2575,7 +2656,7 @@ class Flowlu {
                         if (additional.parent_id && additional.parent_id > 0) {
                             body.parent_id = additional.parent_id;
                         }
-                        const modelId = this.getNodeParameter('model_id', i, '') || additional.model_id;
+                        const modelId = getResourceValue(this, 'model_id', i) || additional.model_id;
                         if (modelId) {
                             body.model_id = modelId;
                             body.model = 'project';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belmontdigitalmarketing/n8n-nodes-flowlu",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "n8n community node for the Flowlu CRM, project management, and task API",
   "keywords": [
     "n8n-community-node-package",