@belmontdigitalmarketing/n8n-nodes-flowlu 0.3.1 → 0.5.0

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

@@ -105,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);
@@ -635,32 +644,56 @@ class Flowlu {
                     displayOptions: { show: { resource: ['opportunity'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Pipeline Name or ID',
+                    displayName: 'Pipeline',
                     name: 'pipeline_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getPipelines' },
+                    type: 'resourceLocator',
                     required: true,
-                    default: '',
-                    description: 'The sales pipeline for this opportunity. 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 sales pipeline for this opportunity',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchPipelines', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 3' },
+                    ],
                     displayOptions: { show: { resource: ['opportunity'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Pipeline Stage Name or ID',
+                    displayName: 'Pipeline Stage',
                     name: 'pipeline_stage_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getPipelineStages' },
+                    type: 'resourceLocator',
                     required: true,
-                    default: '',
-                    description: 'The stage within the pipeline. 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 stage within the pipeline',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchPipelineStages', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 12' },
+                    ],
                     displayOptions: { show: { resource: ['opportunity'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Assignee Name or ID',
+                    displayName: 'Assignee',
                     name: 'opportunityAssignee',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getUsers' },
-                    default: '',
-                    description: 'The user responsible for this opportunity. 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 responsible for this opportunity',
+                    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: ['opportunity'], operation: ['create'] } },
                 },
                 // Opportunity Create: Additional Fields
@@ -859,24 +892,37 @@ class Flowlu {
                     displayOptions: { show: { resource: ['opportunity'], operation: ['getAll'] } },
                 },
                 {
-                    displayName: 'Pipeline Name or ID',
+                    displayName: 'Pipeline',
                     name: 'opportunityFilterPipeline',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getPipelines' },
-                    default: '',
-                    description: 'Filter by pipeline (also controls which stages appear below). 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: 'Filter by pipeline (also controls which stages appear below)',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchPipelines', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 3' },
+                    ],
                     displayOptions: { show: { resource: ['opportunity'], operation: ['getAll'] } },
                 },
                 {
-                    displayName: 'Pipeline Stage Name or ID',
+                    displayName: 'Pipeline Stage',
                     name: 'opportunityFilterStage',
-                    type: 'options',
-                    typeOptions: {
-                        loadOptionsMethod: 'getFilteredPipelineStages',
-                        loadOptionsDependsOn: ['opportunityFilterPipeline'],
-                    },
-                    default: '',
-                    description: 'Filter by stage (select a pipeline first to see its stages). 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: 'Filter by stage (select a pipeline first to narrow the list)',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: { searchListMethod: 'searchFilteredPipelineStages', searchable: true },
+                        },
+                        { displayName: 'By ID', name: 'id', type: 'string', placeholder: 'e.g. 12' },
+                    ],
                     displayOptions: { show: { resource: ['opportunity'], operation: ['getAll'] } },
                 },
                 {
@@ -939,12 +985,20 @@ class Flowlu {
                     displayOptions: { show: { resource: ['project'], operation: ['create'] } },
                 },
                 {
-                    displayName: 'Manager Name or ID',
+                    displayName: 'Manager',
                     name: 'manager_id',
-                    type: 'options',
-                    typeOptions: { loadOptionsMethod: 'getUsers' },
-                    default: '',
-                    description: 'The user responsible for managing this project. 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 responsible for managing this project',
+                    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: ['project'], operation: ['create'] } },
                 },
                 {
@@ -1300,13 +1354,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'] } },
                 },
                 {
@@ -1318,12 +1380,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'] } },
                 },
                 {
@@ -1339,21 +1409,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'] } },
                 },
                 {
@@ -1804,21 +1890,6 @@ class Flowlu {
                         description: `Pipeline ID: ${s.pipeline_id}`,
                     }));
                 },
-                async getFilteredPipelineStages() {
-                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
-                    let pipelineId;
-                    try {
-                        pipelineId = this.getNodeParameter('opportunityFilterPipeline');
-                    }
-                    catch {
-                        /* not set yet */
-                    }
-                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/crm/pipeline_stage/list', apiKey);
-                    const stages = pipelineId
-                        ? items.filter((s) => s.pipeline_id?.toString() === pipelineId)
-                        : items;
-                    return stages.map((s) => ({ name: s.name || `Stage ${s.id}`, value: s.id.toString() }));
-                },
                 async getAllCrmAccounts() {
                     const { baseUrl, apiKey } = await getFlowluCredentials(this);
                     const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/crm/account/list', apiKey);
@@ -2107,6 +2178,80 @@ 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 searchPipelines(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/crm/pipeline/list', apiKey);
+                    const term = (filter ?? '').toLowerCase();
+                    const results = items
+                        .map((p) => ({ name: p.name || `Pipeline ${p.id}`, value: p.id.toString() }))
+                        .filter((r) => !term || r.name.toLowerCase().includes(term));
+                    return { results };
+                },
+                async searchPipelineStages(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/crm/pipeline_stage/list', apiKey);
+                    const term = (filter ?? '').toLowerCase();
+                    const results = items
+                        .map((s) => ({ name: s.name || `Stage ${s.id}`, value: s.id.toString() }))
+                        .filter((r) => !term || r.name.toLowerCase().includes(term));
+                    return { results };
+                },
+                async searchFilteredPipelineStages(filter) {
+                    const { baseUrl, apiKey } = await getFlowluCredentials(this);
+                    let pipelineId = '';
+                    try {
+                        pipelineId = this.getCurrentNodeParameter('opportunityFilterPipeline', { extractValue: true }) || '';
+                    }
+                    catch {
+                        /* pipeline not selected yet */
+                    }
+                    const items = await flowluListAll.call(this, baseUrl, '/api/v1/module/crm/pipeline_stage/list', apiKey);
+                    const term = (filter ?? '').toLowerCase();
+                    const results = items
+                        .filter((s) => !pipelineId || s.pipeline_id?.toString() === pipelineId)
+                        .map((s) => ({ name: s.name || `Stage ${s.id}`, value: s.id.toString() }))
+                        .filter((r) => !term || r.name.toLowerCase().includes(term));
+                    return { results };
+                },
+            },
         };
     }
     async execute() {
@@ -2250,10 +2395,10 @@ class Flowlu {
                     if (operation === 'create') {
                         const body = {
                             name: this.getNodeParameter('opportunityName', i),
-                            pipeline_id: this.getNodeParameter('pipeline_id', i),
-                            pipeline_stage_id: this.getNodeParameter('pipeline_stage_id', i),
+                            pipeline_id: getResourceValue(this, 'pipeline_id', i),
+                            pipeline_stage_id: getResourceValue(this, 'pipeline_stage_id', i),
                         };
-                        const assignee = this.getNodeParameter('opportunityAssignee', i);
+                        const assignee = getResourceValue(this, 'opportunityAssignee', i);
                         if (assignee)
                             body.assignee_id = assignee;
                         const additional = this.getNodeParameter('opportunityAdditionalFields', i);
@@ -2308,8 +2453,8 @@ class Flowlu {
                     }
                     else if (operation === 'getAll') {
                         const limit = this.getNodeParameter('limit', i);
-                        const pipelineId = this.getNodeParameter('opportunityFilterPipeline', i);
-                        const stageId = this.getNodeParameter('opportunityFilterStage', i);
+                        const pipelineId = getResourceValue(this, 'opportunityFilterPipeline', i);
+                        const stageId = getResourceValue(this, 'opportunityFilterStage', i);
                         const filters = this.getNodeParameter('opportunityFilters', i);
                         const qs = { limit: limit.toString() };
                         if (pipelineId)
@@ -2380,7 +2525,7 @@ class Flowlu {
                         const body = {
                             name: this.getNodeParameter('projectName', i),
                         };
-                        const managerId = this.getNodeParameter('manager_id', i);
+                        const managerId = getResourceValue(this, 'manager_id', i);
                         if (managerId)
                             body.manager_id = managerId;
                         const desc = this.getNodeParameter('projectDescription', i);
@@ -2530,7 +2675,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)
@@ -2540,10 +2685,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 =
@@ -2576,7 +2721,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.1",
+  "version": "0.5.0",
   "description": "n8n community node for the Flowlu CRM, project management, and task API",
   "keywords": [
     "n8n-community-node-package",