import { NodeConnectionType, type INode, type INodeParameters, type INodeProperties, type INodeType, type INodeTypeDescription, } from '@/Interfaces'; import { getNodeParameters, getNodeHints, isSingleExecution, isSubNodeType, applyDeclarativeNodeOptionParameters, convertNodeToAiTool, } from '@/NodeHelpers'; import type { Workflow } from '@/Workflow'; describe('NodeHelpers', () => { describe('getNodeParameters', () => { const tests: Array<{ description: string; input: { nodePropertiesArray: INodeProperties[]; nodeValues: INodeParameters | null; }; output: { noneDisplayedFalse: { defaultsFalse: INodeParameters; defaultsTrue: INodeParameters; }; noneDisplayedTrue: { defaultsFalse: INodeParameters; defaultsTrue: INodeParameters; }; }; }> = [ { description: 'simple values.', input: { nodePropertiesArray: [ { name: 'string1', displayName: 'String 1', type: 'string', default: '', }, { name: 'string2', displayName: 'String 2', type: 'string', default: 'default string 2', }, { name: 'string3', displayName: 'String 3', type: 'string', default: 'default string 3', }, { name: 'number1', displayName: 'Number 1', type: 'number', default: 10, }, { name: 'number2', displayName: 'Number 2', type: 'number', default: 10, }, { name: 'number3', displayName: 'Number 3', type: 'number', default: 10, }, { name: 'boolean1', displayName: 'Boolean 1', type: 'boolean', default: false, }, { name: 'boolean2', displayName: 'Boolean 2', type: 'boolean', default: false, }, { name: 'boolean3', displayName: 'Boolean 3', type: 'boolean', default: true, }, { name: 'boolean4', displayName: 'Boolean 4', type: 'boolean', default: true, }, { name: 'boolean5', displayName: 'Boolean 5', type: 'boolean', default: false, }, { name: 'boolean6', displayName: 'Boolean 6', type: 'boolean', default: true, }, ], nodeValues: { boolean1: true, boolean3: false, boolean5: false, boolean6: true, string1: 'different', number1: 1, number3: 0, }, }, output: { noneDisplayedFalse: { defaultsFalse: { boolean1: true, boolean3: false, string1: 'different', number1: 1, number3: 0, }, defaultsTrue: { boolean1: true, boolean2: false, boolean3: false, boolean4: true, boolean5: false, boolean6: true, string1: 'different', string2: 'default string 2', string3: 'default string 3', number1: 1, number2: 10, number3: 0, }, }, noneDisplayedTrue: { defaultsFalse: { boolean1: true, boolean3: false, string1: 'different', number1: 1, number3: 0, }, defaultsTrue: { boolean1: true, boolean2: false, boolean3: false, boolean4: true, boolean5: false, boolean6: true, string1: 'different', string2: 'default string 2', string3: 'default string 3', number1: 1, number2: 10, number3: 0, }, }, }, }, { description: 'simple values with displayOptions "show" (match) which is boolean. All values set.', input: { nodePropertiesArray: [ { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, { name: 'string1', displayName: 'string1', displayOptions: { show: { boolean1: [true], }, }, type: 'string', default: 'default string1', }, ], nodeValues: { boolean1: true, string1: 'own string1', }, }, output: { noneDisplayedFalse: { defaultsFalse: { boolean1: true, string1: 'own string1', }, defaultsTrue: { boolean1: true, string1: 'own string1', }, }, noneDisplayedTrue: { defaultsFalse: { boolean1: true, string1: 'own string1', }, defaultsTrue: { boolean1: true, string1: 'own string1', }, }, }, }, { description: 'simple values with displayOptions "hide" (match) which is boolean. All values set.', input: { nodePropertiesArray: [ { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, { name: 'string1', displayName: 'string1', displayOptions: { hide: { boolean1: [true], }, }, type: 'string', default: 'default string1', }, ], nodeValues: { boolean1: true, }, }, output: { noneDisplayedFalse: { defaultsFalse: { boolean1: true, }, defaultsTrue: { boolean1: true, }, }, noneDisplayedTrue: { defaultsFalse: { boolean1: true, }, defaultsTrue: { boolean1: true, string1: 'default string1', }, }, }, }, { description: 'simple values with displayOptions "show" (match) which is boolean. One values set.', input: { nodePropertiesArray: [ { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, { name: 'string1', displayName: 'string1', displayOptions: { show: { boolean1: [true], }, }, type: 'string', default: 'default string1', }, ], nodeValues: { boolean1: true, }, }, output: { noneDisplayedFalse: { defaultsFalse: { boolean1: true, }, defaultsTrue: { boolean1: true, string1: 'default string1', }, }, noneDisplayedTrue: { defaultsFalse: { boolean1: true, }, defaultsTrue: { boolean1: true, string1: 'default string1', }, }, }, }, { description: 'simple values with displayOptions "show" (match). No values set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'string1', displayName: 'string1', displayOptions: { show: { mode: ['mode1'], }, }, type: 'string', default: 'default string1', }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, }, }, { description: 'simple values with displayOptions "show" (match) on two which depend on each other of which is boolean. One value should be displayed. One values set (none-default).', input: { nodePropertiesArray: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', displayOptions: { show: { string1: ['default string1'], }, }, type: 'boolean', default: false, }, { name: 'string2', displayName: 'string2', displayOptions: { show: { boolean1: [true], }, }, type: 'string', default: 'default string2', }, ], nodeValues: { boolean1: true, }, }, output: { noneDisplayedFalse: { defaultsFalse: { boolean1: true, }, defaultsTrue: { string1: 'default string1', boolean1: true, string2: 'default string2', }, }, noneDisplayedTrue: { defaultsFalse: { boolean1: true, }, defaultsTrue: { string1: 'default string1', boolean1: true, string2: 'default string2', }, }, }, }, { description: 'simple values with displayOptions "show" (match) on two which depend on each other of which is boolean. One value should be displayed. One values set. (default)', input: { nodePropertiesArray: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', displayOptions: { show: { string1: ['default string1'], }, }, type: 'boolean', default: false, }, { name: 'string2', displayName: 'string2', displayOptions: { show: { boolean1: [true], }, }, type: 'string', default: 'default string2', }, ], nodeValues: { boolean1: false, }, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { string1: 'default string1', boolean1: false, }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { string1: 'default string1', boolean1: false, string2: 'default string2', }, }, }, }, { description: 'simple values with displayOptions "show" (match). All values set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'string1', displayName: 'string1', displayOptions: { show: { mode: ['mode1'], }, }, type: 'string', default: 'default string1', }, ], nodeValues: { mode: 'mode1', string1: 'default string1', }, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, }, }, { description: 'simple values with displayOptions "show" (no-match). No values set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'string1', displayName: 'string1', displayOptions: { show: { mode: ['mode2'], }, }, type: 'string', default: 'default string1', }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, }, }, { description: 'simple values with displayOptions "show" (no-match). All values set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'string1', displayName: 'string1', displayOptions: { show: { mode: ['mode2'], }, }, type: 'string', default: 'default string1', }, ], nodeValues: { mode: 'mode1', string1: 'default string1', }, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', string1: 'default string1', }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true". One value set.', input: { nodePropertiesArray: [ { name: 'values', displayName: 'Values', type: 'fixedCollection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'boolean', displayName: 'Boolean', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, ], }, { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { displayName: 'number1', name: 'number1', type: 'number', default: 0, }, ], }, ], }, ], nodeValues: { values: { number: [ { number1: 1, }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: [ { number1: 1, }, ], }, }, defaultsTrue: { values: { number: [ { string1: 'default string1', number1: 1, }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: [ { number1: 1, }, ], }, }, defaultsTrue: { values: { number: [ { string1: 'default string1', number1: 1, }, ], }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false". One value set.', input: { nodePropertiesArray: [ { displayName: 'Values', name: 'values', type: 'fixedCollection', default: {}, options: [ { name: 'boolean', displayName: 'Boolean', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, ], }, { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { displayName: 'number1', name: 'number1', type: 'number', default: 0, }, ], }, { name: 'singleString', displayName: 'Single String', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default singleString1', }, ], }, ], }, ], nodeValues: { values: { number: { number1: 1, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: { number1: 1, }, }, }, defaultsTrue: { values: { number: { string1: 'default string1', number1: 1, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { number1: 1, }, }, }, defaultsTrue: { values: { number: { string1: 'default string1', number1: 1, }, }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false". Two values set one single one.', input: { nodePropertiesArray: [ { displayName: 'Values', name: 'values', type: 'fixedCollection', default: {}, options: [ { name: 'boolean', displayName: 'Boolean', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, ], }, { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { displayName: 'number1', name: 'number1', type: 'number', default: 0, }, ], }, { name: 'singleString', displayName: 'Single String', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default singleString1', }, ], }, ], }, ], nodeValues: { values: { number: { number1: 1, }, singleString: { string1: 'value1', }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: { number1: 1, }, singleString: { string1: 'value1', }, }, }, defaultsTrue: { values: { number: { string1: 'default string1', number1: 1, }, singleString: { string1: 'value1', }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { number1: 1, }, singleString: { string1: 'value1', }, }, }, defaultsTrue: { values: { number: { string1: 'default string1', number1: 1, }, singleString: { string1: 'value1', }, }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true" and complex type "collection" with "multipleValues: true". One value set each.', input: { nodePropertiesArray: [ { displayName: 'Values', name: 'values', type: 'fixedCollection', typeOptions: { multipleValues: true, }, description: 'The value to set.', default: {}, options: [ { name: 'boolean', displayName: 'Boolean', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'boolean1', displayName: 'boolean1', type: 'boolean', default: false, }, ], }, { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, { name: 'collection1', displayName: 'collection1', type: 'collection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'string2', displayName: 'string2', type: 'string', default: 'default string2', }, ], }, ], }, ], }, ], nodeValues: { values: { number: [ { number1: 1, collection1: [ { string1: 'value1', }, ], }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: [ { number1: 1, collection1: [ { string1: 'value1', }, ], }, ], }, }, defaultsTrue: { values: { number: [ { string1: 'default string1', number1: 1, collection1: [ { string1: 'value1', }, ], }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: [ { number1: 1, collection1: [ { string1: 'value1', }, ], }, ], }, }, defaultsTrue: { values: { number: [ { string1: 'default string1', number1: 1, collection1: [ { string1: 'value1', }, ], }, ], }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false" and with displayOptions "show" (match) on option. One value set.', input: { nodePropertiesArray: [ { name: 'values', displayName: 'Values', type: 'fixedCollection', default: {}, options: [ { name: 'number', displayName: 'Number', values: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { mode: ['mode1'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], }, ], nodeValues: { values: { number: { number1: 1, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: { number1: 1, }, }, }, defaultsTrue: { values: { number: { mode: 'mode1', string1: 'default string1', number1: 1, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { number1: 1, }, }, }, defaultsTrue: { values: { number: { mode: 'mode1', string1: 'default string1', number1: 1, }, }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false" and with displayOptions "show" (match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'fixedCollection', default: {}, options: [ { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode1'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], }, ], nodeValues: { values: { number: { string1: 'own string1', }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: { string1: 'own string1', }, }, }, defaultsTrue: { mode: 'mode1', values: { number: { string1: 'own string1', number1: 0, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { string1: 'own string1', }, }, }, defaultsTrue: { mode: 'mode1', values: { number: { string1: 'own string1', number1: 0, }, }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false" and with displayOptions "show" (no-match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'fixedCollection', default: {}, options: [ { name: 'number', displayName: 'Number', values: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode2'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], }, ], nodeValues: { values: { number: { string1: 'own string1', }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mode: 'mode1', values: { number: { number1: 0, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { string1: 'own string1', }, }, }, defaultsTrue: { mode: 'mode1', values: { number: { string1: 'own string1', number1: 0, }, }, }, }, }, }, // Remember it is correct that default strings get returned here even when returnDefaults // is set to false because if they would not, there would be no way to know which value // got added and which one not. { description: 'complex type "collection" with "multipleValues: false" and with displayOptions "show" (match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'collection', default: {}, options: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode1'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], nodeValues: { values: { string1: 'own string1', }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { string1: 'own string1', }, }, defaultsTrue: { mode: 'mode1', values: { string1: 'own string1', }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { string1: 'own string1', }, }, defaultsTrue: { mode: 'mode1', values: { string1: 'own string1', }, }, }, }, }, // Remember it is correct that default strings get returned here even when returnDefaults // is set to false because if they would not, there would be no way to know which value // got added and which one not. { description: 'complex type "collection" with "multipleValues: false" and with displayOptions "show" (no-match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'collection', default: {}, options: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode2'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], nodeValues: { values: { string1: 'own string1', }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { // TODO: Write some code which cleans up data like that values: {}, }, defaultsTrue: { mode: 'mode1', values: {}, }, }, noneDisplayedTrue: { defaultsFalse: { values: { string1: 'own string1', }, }, defaultsTrue: { mode: 'mode1', values: { string1: 'own string1', }, }, }, }, }, // Remember it is correct that default strings get returned here even when returnDefaults // is set to false because if they would not, there would be no way to know which value // got added and which one not. { description: 'complex type "collection" with "multipleValues: true" and with displayOptions "show" (match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'collection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode1'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], nodeValues: { values: [ { string1: 'own string1', }, ], }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: [ { string1: 'own string1', }, ], }, defaultsTrue: { mode: 'mode1', values: [ { string1: 'own string1', }, ], }, }, noneDisplayedTrue: { defaultsFalse: { values: [ { string1: 'own string1', }, ], }, defaultsTrue: { mode: 'mode1', values: [ { string1: 'own string1', }, ], }, }, }, }, // Remember it is correct that default strings get returned here even when returnDefaults // is set to false because if they would not, there would be no way to know which value // got added and which one not. { description: 'complex type "collection" with "multipleValues: true" and with displayOptions "show" (no-match) on option which references root-value. One value set.', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { name: 'values', displayName: 'Values', type: 'collection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'string1', displayName: 'string1', type: 'string', displayOptions: { show: { '/mode': ['mode2'], }, }, default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], nodeValues: { values: [ { string1: 'own string1', number1: 0, }, ], }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: [ { string1: 'own string1', number1: 0, }, ], }, defaultsTrue: { mode: 'mode1', values: [ { string1: 'own string1', number1: 0, }, ], }, }, noneDisplayedTrue: { defaultsFalse: { values: [ { string1: 'own string1', number1: 0, }, ], }, defaultsTrue: { mode: 'mode1', values: [ { string1: 'own string1', number1: 0, }, ], }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: false" and with displayOptions "show" (no-match) on option. One value set also the not displayed one.', input: { nodePropertiesArray: [ { name: 'values', displayName: 'Values', type: 'fixedCollection', default: {}, options: [ { name: 'number', displayName: 'Number', values: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { displayName: 'string1', name: 'string1', type: 'string', displayOptions: { show: { mode: ['mode1'], }, }, default: 'default string1', }, { displayName: 'number1', name: 'number1', type: 'number', default: 0, }, ], }, ], }, ], nodeValues: { values: { number: { mode: 'mode2', string1: 'default string1', number1: 1, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { number: { mode: 'mode2', number1: 1, }, }, }, defaultsTrue: { values: { number: { mode: 'mode2', number1: 1, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { number: { mode: 'mode2', number1: 1, }, }, }, defaultsTrue: { values: { number: { mode: 'mode2', string1: 'default string1', number1: 1, }, }, }, }, }, }, { description: 'complex type "collection" with "multipleValues: true". One none-default value set.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', typeOptions: { multipleValues: true, }, default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: { collection1: [ { string1: 'value1', }, ], }, }, output: { noneDisplayedFalse: { defaultsFalse: { collection1: [ { string1: 'value1', }, ], }, defaultsTrue: { collection1: [ { string1: 'value1', }, ], }, }, noneDisplayedTrue: { defaultsFalse: { collection1: [ { string1: 'value1', }, ], }, defaultsTrue: { collection1: [ { string1: 'value1', }, ], }, }, }, }, // Remember it is correct that default strings get returned here even when returnDefaults // is set to false because if they would not, there would be no way to know which value // got added and which one not. { description: 'complex type "collection" with "multipleValues: true". One default value set.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', typeOptions: { multipleValues: true, }, default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: { collection1: [ { string1: 'default string1', }, ], }, }, output: { noneDisplayedFalse: { defaultsFalse: { collection1: [ { string1: 'default string1', }, ], }, defaultsTrue: { collection1: [ { string1: 'default string1', }, ], }, }, noneDisplayedTrue: { defaultsFalse: { collection1: [ { string1: 'default string1', }, ], }, defaultsTrue: { collection1: [ { string1: 'default string1', }, ], }, }, }, }, { description: 'complex type "collection" with "multipleValues: false". One none-default value set.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: { collection1: { string1: 'own string1', }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { collection1: { string1: 'own string1', }, }, defaultsTrue: { collection1: { string1: 'own string1', }, }, }, noneDisplayedTrue: { defaultsFalse: { collection1: { string1: 'own string1', }, }, defaultsTrue: { collection1: { string1: 'own string1', }, }, }, }, }, { description: 'complex type "collection" with "multipleValues: false". One default value set.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: { collection1: { string1: 'default string1', }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { collection1: { string1: 'default string1', }, }, defaultsTrue: { collection1: { string1: 'default string1', }, }, }, noneDisplayedTrue: { defaultsFalse: { collection1: { string1: 'default string1', }, }, defaultsTrue: { collection1: { string1: 'default string1', }, }, }, }, }, { description: 'complex type "collection" with "multipleValues: false". Only outer value set.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: { collection1: {}, }, }, output: { noneDisplayedFalse: { defaultsFalse: { collection1: {}, }, defaultsTrue: { collection1: {}, }, }, noneDisplayedTrue: { defaultsFalse: { collection1: {}, }, defaultsTrue: { collection1: {}, }, }, }, }, { description: 'complex type "collection" with "multipleValues: false". No value set at all.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', default: {}, options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { collection1: {}, }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { collection1: {}, }, }, }, }, { description: 'complex type "collection" with "multipleValues: true". No value set at all.', input: { nodePropertiesArray: [ { displayName: 'collection1', name: 'collection1', type: 'collection', typeOptions: { multipleValues: true, }, default: [], options: [ { displayName: 'string1', name: 'string1', type: 'string', default: 'default string1', }, { displayName: 'string2', name: 'string2', type: 'string', default: 'default string2', }, ], }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { collection1: [], }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { collection1: [], }, }, }, }, { description: 'two identically named properties of which only one gets displayed with different options. No value set at all.', input: { nodePropertiesArray: [ { displayName: 'mainOption', name: 'mainOption', type: 'options', options: [ { name: 'option1', value: 'option1', }, { name: 'option2', value: 'option2', }, ], default: 'option1', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option1'], }, }, options: [ { name: 'option1a', value: 'option1a', }, { name: 'option1b', value: 'option1b', }, ], default: 'option1a', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option2'], }, }, options: [ { name: 'option2a', value: 'option2a', }, { name: 'option2b', value: 'option2b', }, ], default: 'option2a', }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', }, }, }, }, { description: 'One property which is dependency on two identically named properties of which only one gets displayed with different options. No value set at all.', input: { nodePropertiesArray: [ { displayName: 'mainOption', name: 'mainOption', type: 'options', options: [ { name: 'option1', value: 'option1', }, { name: 'option2', value: 'option2', }, ], default: 'option1', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option1'], }, }, options: [ { name: 'option1a', value: 'option1a', }, { name: 'option1b', value: 'option1b', }, ], default: 'option1a', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option2'], }, }, options: [ { name: 'option2a', value: 'option2a', }, { name: 'option2b', value: 'option2b', }, ], default: 'option2a', }, { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value1', required: true, displayOptions: { show: { mainOption: ['option1'], subOption: ['option1a'], }, }, }, { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value2', required: true, displayOptions: { show: { mainOption: ['option2'], subOption: ['option2a'], }, }, }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', dependentParameter: 'value1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', dependentParameter: 'value1', }, }, }, }, { description: 'One property which is dependency on two identically named properties of which only one gets displayed with different options. No value set at all. Order reversed', input: { nodePropertiesArray: [ { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value2', required: true, displayOptions: { show: { mainOption: ['option2'], subOption: ['option2a'], }, }, }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option2'], }, }, options: [ { name: 'option2a', value: 'option2a', }, { name: 'option2b', value: 'option2b', }, ], default: 'option2a', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option1'], }, }, options: [ { name: 'option1a', value: 'option1a', }, { name: 'option1b', value: 'option1b', }, ], default: 'option1a', }, { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value1', required: true, displayOptions: { show: { mainOption: ['option1'], subOption: ['option1a'], }, }, }, { displayName: 'mainOption', name: 'mainOption', type: 'options', options: [ { name: 'option1', value: 'option1', }, { name: 'option2', value: 'option2', }, ], default: 'option1', }, ], nodeValues: {}, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', dependentParameter: 'value1', }, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: { mainOption: 'option1', subOption: 'option1a', dependentParameter: 'value1', }, }, }, }, { description: 'One property which is dependency on two identically named properties of which only one gets displayed with different options. No value set at all.', input: { nodePropertiesArray: [ { displayName: 'mainOption', name: 'mainOption', type: 'options', options: [ { name: 'option1', value: 'option1', }, { name: 'option2', value: 'option2', }, ], default: 'option1', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option1'], }, }, options: [ { name: 'option1a', value: 'option1a', }, { name: 'option1b', value: 'option1b', }, ], default: 'option1a', }, { displayName: 'subOption', name: 'subOption', type: 'options', displayOptions: { show: { mainOption: ['option2'], }, }, options: [ { name: 'option2a', value: 'option2a', }, { name: 'option2b', value: 'option2b', }, ], default: 'option2a', }, { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value1', required: true, displayOptions: { show: { mainOption: ['option1'], subOption: ['option1a'], }, }, }, { displayName: 'dependentParameter', name: 'dependentParameter', type: 'string', default: 'value2', required: true, displayOptions: { show: { mainOption: ['option2'], subOption: ['option2a'], }, }, }, ], nodeValues: { mainOption: 'option2', }, }, output: { noneDisplayedFalse: { defaultsFalse: { mainOption: 'option2', }, defaultsTrue: { mainOption: 'option2', subOption: 'option2a', dependentParameter: 'value2', }, }, noneDisplayedTrue: { defaultsFalse: { mainOption: 'option2', }, defaultsTrue: { mainOption: 'option2', subOption: 'option2a', dependentParameter: 'value2', }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true". Which contains complex type "fixedCollection" with "multipleValues: true". One value set.', input: { nodePropertiesArray: [ { displayName: 'Values1', name: 'values1', type: 'fixedCollection', typeOptions: { multipleValues: true, }, description: 'The value to set.', default: {}, options: [ { displayName: 'Options1', name: 'options1', values: [ { displayName: 'Values2', name: 'values2', type: 'fixedCollection', typeOptions: { multipleValues: true, }, description: 'The value to set.', default: {}, options: [ { displayName: 'Options2', name: 'options2', values: [ { name: 'string1', displayName: 'string1', type: 'string', default: 'default string1', }, { name: 'number1', displayName: 'number1', type: 'number', default: 0, }, ], }, ], }, ], }, ], }, ], nodeValues: { values1: { options1: [ { values2: { options2: [ { number1: 1, }, ], }, }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values1: { options1: [ { values2: { options2: [ { number1: 1, }, ], }, }, ], }, }, defaultsTrue: { values1: { options1: [ { values2: { options2: [ { string1: 'default string1', number1: 1, }, ], }, }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values1: { options1: [ { values2: { options2: [ { number1: 1, }, ], }, }, ], }, }, defaultsTrue: { values1: { options1: [ { values2: { options2: [ { string1: 'default string1', number1: 1, }, ], }, }, ], }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true". Which contains parameters which get displayed on a parameter with a default expression with relative parameter references.', input: { nodePropertiesArray: [ { displayName: 'Values1', name: 'values1', type: 'fixedCollection', typeOptions: { multipleValues: true, }, description: 'The value to set.', default: {}, options: [ { displayName: 'Options1', name: 'options1', values: [ { displayName: 'Key', name: 'key', type: 'string', default: '', }, { displayName: 'Type', name: 'type', type: 'hidden', default: '={{$parameter["&key"].split("|")[1]}}', }, { displayName: 'Title Value', name: 'titleValue', displayOptions: { show: { type: ['title'], }, }, type: 'string', default: 'defaultTitle', }, { displayName: 'Title Number', name: 'numberValue', displayOptions: { show: { type: ['number'], }, }, type: 'number', default: 1, }, ], }, ], }, ], nodeValues: { values1: { options1: [ { key: 'asdf|title', titleValue: 'different', }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values1: { options1: [ { key: 'asdf|title', titleValue: 'different', }, ], }, }, defaultsTrue: { values1: { options1: [ { key: 'asdf|title', type: '={{$parameter["&key"].split("|")[1]}}', // This is not great that it displays this theoretically hidden parameter // but because we can not resolve the values for now numberValue: 1, titleValue: 'different', }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values1: { options1: [ { key: 'asdf|title', titleValue: 'different', }, ], }, }, defaultsTrue: { values1: { options1: [ { key: 'asdf|title', type: '={{$parameter["&key"].split("|")[1]}}', titleValue: 'different', numberValue: 1, }, ], }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true". Which contains parameter of type "multiOptions" and has so an array default value', input: { nodePropertiesArray: [ { name: 'values', displayName: 'Values', type: 'fixedCollection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'propertyValues', displayName: 'Property', values: [ { displayName: 'Options', name: 'multiSelectValue', type: 'multiOptions', options: [ { name: 'Value1', value: 'value1', }, { name: 'Value2', value: 'value2', }, ], default: [], }, ], }, ], }, ], nodeValues: { values: { propertyValues: [ { multiSelectValue: [], }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { propertyValues: [{}], }, }, defaultsTrue: { values: { propertyValues: [ { multiSelectValue: [], }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { propertyValues: [{}], }, }, defaultsTrue: { values: { propertyValues: [ { multiSelectValue: [], }, ], }, }, }, }, }, { description: 'complex type "fixedCollection" with "multipleValues: true". Which contains parameter of type "string" with "multipleValues: true" and a custom default value', input: { nodePropertiesArray: [ { name: 'values', displayName: 'Values', type: 'fixedCollection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'propertyValues', displayName: 'Property', values: [ { displayName: 'MultiString', name: 'multiString', type: 'string', typeOptions: { multipleValues: true, }, default: ['value1'], }, ], }, ], }, ], nodeValues: { values: { propertyValues: [ { multiString: ['value1'], }, ], }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { values: { propertyValues: [{}], }, }, defaultsTrue: { values: { propertyValues: [ { multiString: ['value1'], }, ], }, }, }, noneDisplayedTrue: { defaultsFalse: { values: { propertyValues: [{}], }, }, defaultsTrue: { values: { propertyValues: [ { multiString: ['value1'], }, ], }, }, }, }, }, { description: 'complex type "collection" which contains a "fixedCollection" with "multipleValues: false" that has all values set to the default values (by having it as an empty object) in combination with another value', input: { nodePropertiesArray: [ { name: 'mode', displayName: 'mode', type: 'string', default: 'mode1', }, { displayName: 'Options', name: 'options', placeholder: 'Add Option', type: 'collection', default: {}, options: [ { displayName: 'Sort', name: 'sort', type: 'fixedCollection', typeOptions: { multipleValues: false, }, default: {}, placeholder: 'Add Sort', options: [ { displayName: 'Sort', name: 'value', values: [ { displayName: 'Descending', name: 'descending', type: 'boolean', default: true, description: 'Sort by descending order', }, { displayName: 'Order By', name: 'ordering', type: 'options', default: 'date', options: [ { name: 'Date', value: 'date', }, { name: 'Name', value: 'name', }, ], }, ], }, ], }, ], }, ], nodeValues: { mode: 'changed', options: { sort: { value: {}, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { mode: 'changed', options: { sort: { value: {}, }, }, }, defaultsTrue: { mode: 'changed', options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { mode: 'changed', options: { sort: { value: {}, }, }, }, defaultsTrue: { mode: 'changed', options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, }, }, { description: 'complex type "collection" which contains a "fixedCollection" with "multipleValues: false" that has all values set to the default values (by having it as an empty object)', input: { nodePropertiesArray: [ { displayName: 'Options', name: 'options', placeholder: 'Add Option', type: 'collection', default: {}, options: [ { displayName: 'Sort', name: 'sort', type: 'fixedCollection', typeOptions: { multipleValues: false, }, default: {}, placeholder: 'Add Sort', options: [ { displayName: 'Sort', name: 'value', values: [ { displayName: 'Descending', name: 'descending', type: 'boolean', default: true, description: 'Sort by descending order', }, { displayName: 'Order By', name: 'ordering', type: 'options', default: 'date', options: [ { name: 'Date', value: 'date', }, { name: 'Name', value: 'name', }, ], }, ], }, ], }, ], }, ], nodeValues: { options: { sort: { value: {}, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { options: { sort: { value: {}, }, }, }, defaultsTrue: { options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { options: { sort: { value: {}, }, }, }, defaultsTrue: { options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, }, }, { description: 'complex type "collection" which contains a "fixedCollection" with "multipleValues: false" that has all values set to the default values (by having each value set)', input: { nodePropertiesArray: [ { displayName: 'Options', name: 'options', placeholder: 'Add Option', type: 'collection', default: {}, options: [ { displayName: 'Sort', name: 'sort', type: 'fixedCollection', typeOptions: { multipleValues: false, }, default: {}, options: [ { displayName: 'Sort', name: 'value', values: [ { displayName: 'Descending', name: 'descending', type: 'boolean', default: true, }, { displayName: 'Order By', name: 'ordering', type: 'options', default: 'date', options: [ { name: 'Date', value: 'date', }, { name: 'Name', value: 'name', }, ], }, ], }, ], }, ], }, ], nodeValues: { options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, output: { noneDisplayedFalse: { defaultsFalse: { options: { sort: { value: {}, }, }, }, defaultsTrue: { options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, noneDisplayedTrue: { defaultsFalse: { options: { sort: { value: {}, }, }, }, defaultsTrue: { options: { sort: { value: { descending: true, ordering: 'date', }, }, }, }, }, }, }, { description: 'nodeValues is null (for example when resolving expression fails)', input: { nodePropertiesArray: [ { displayName: 'Custom Properties', name: 'customPropertiesUi', placeholder: 'Add Custom Property', type: 'fixedCollection', typeOptions: { multipleValues: true, }, default: {}, options: [ { name: 'customPropertiesValues', displayName: 'Custom Property', values: [ { displayName: 'Property Name or ID', name: 'property', type: 'options', typeOptions: { loadOptionsMethod: 'getDealCustomProperties', }, default: '', description: 'Name of the property. Choose from the list, or specify an ID using an expression.', }, { displayName: 'Value', name: 'value', type: 'string', default: '', required: true, description: 'Value of the property', }, ], }, ], }, ], nodeValues: null, }, output: { noneDisplayedFalse: { defaultsFalse: {}, defaultsTrue: {}, }, noneDisplayedTrue: { defaultsFalse: {}, defaultsTrue: {}, }, }, }, ]; for (const testData of tests) { test(testData.description, () => { // returnDefaults: false | returnNoneDisplayed: false let result = getNodeParameters( testData.input.nodePropertiesArray, testData.input.nodeValues, false, false, null, ); expect(result).toEqual(testData.output.noneDisplayedFalse.defaultsFalse); // returnDefaults: true | returnNoneDisplayed: false result = getNodeParameters( testData.input.nodePropertiesArray, testData.input.nodeValues, true, false, null, ); expect(result).toEqual(testData.output.noneDisplayedFalse.defaultsTrue); // returnDefaults: false | returnNoneDisplayed: true result = getNodeParameters( testData.input.nodePropertiesArray, testData.input.nodeValues, false, true, null, ); expect(result).toEqual(testData.output.noneDisplayedTrue.defaultsFalse); // returnDefaults: true | returnNoneDisplayed: true result = getNodeParameters( testData.input.nodePropertiesArray, testData.input.nodeValues, true, true, null, ); expect(result).toEqual(testData.output.noneDisplayedTrue.defaultsTrue); }); } }); describe('getNodeHints', () => { //TODO: Add more tests here when hints are added to some node types test('should return node hints if present in node type', () => { const testType = { hints: [ { message: 'TEST HINT', }, ], } as INodeTypeDescription; const workflow = {} as unknown as Workflow; const node: INode = { name: 'Test Node Hints', } as INode; const nodeType = testType; const hints = getNodeHints(workflow, node, nodeType); expect(hints).toHaveLength(1); expect(hints[0].message).toEqual('TEST HINT'); }); test('should not include hint if displayCondition is false', () => { const testType = { hints: [ { message: 'TEST HINT', displayCondition: 'FALSE DISPLAY CONDITION EXPESSION', }, ], } as INodeTypeDescription; const workflow = { expression: { getSimpleParameterValue( _node: string, _parameter: string, _mode: string, _additionalData = {}, ) { return false; }, }, } as unknown as Workflow; const node: INode = { name: 'Test Node Hints', } as INode; const nodeType = testType; const hints = getNodeHints(workflow, node, nodeType); expect(hints).toHaveLength(0); }); test('should include hint if displayCondition is true', () => { const testType = { hints: [ { message: 'TEST HINT', displayCondition: 'TRUE DISPLAY CONDITION EXPESSION', }, ], } as INodeTypeDescription; const workflow = { expression: { getSimpleParameterValue( _node: string, _parameter: string, _mode: string, _additionalData = {}, ) { return true; }, }, } as unknown as Workflow; const node: INode = { name: 'Test Node Hints', } as INode; const nodeType = testType; const hints = getNodeHints(workflow, node, nodeType); expect(hints).toHaveLength(1); }); }); describe('isSingleExecution', () => { test('should determine based on node parameters if it would be executed once', () => { expect(isSingleExecution('n8n-nodes-base.code', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.code', { mode: 'runOnceForEachItem' })).toEqual( false, ); expect(isSingleExecution('n8n-nodes-base.executeWorkflow', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.executeWorkflow', { mode: 'each' })).toEqual(false); expect(isSingleExecution('n8n-nodes-base.crateDb', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.crateDb', { operation: 'update' })).toEqual(true); expect(isSingleExecution('n8n-nodes-base.timescaleDb', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.timescaleDb', { operation: 'update' })).toEqual( true, ); expect(isSingleExecution('n8n-nodes-base.microsoftSql', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.microsoftSql', { operation: 'update' })).toEqual( true, ); expect(isSingleExecution('n8n-nodes-base.microsoftSql', { operation: 'delete' })).toEqual( true, ); expect(isSingleExecution('n8n-nodes-base.questDb', {})).toEqual(true); expect(isSingleExecution('n8n-nodes-base.mongoDb', { operation: 'insert' })).toEqual(true); expect(isSingleExecution('n8n-nodes-base.mongoDb', { operation: 'update' })).toEqual(true); expect(isSingleExecution('n8n-nodes-base.redis', {})).toEqual(true); }); }); describe('isSubNodeType', () => { const tests: Array<[boolean, Pick | null]> = [ [false, null], [false, { outputs: '={{random_expression}}' }], [false, { outputs: [] }], [false, { outputs: [NodeConnectionType.Main] }], [true, { outputs: [NodeConnectionType.AiAgent] }], [true, { outputs: [NodeConnectionType.Main, NodeConnectionType.AiAgent] }], ]; test.each(tests)('should return %p for %o', (expected, nodeType) => { expect(isSubNodeType(nodeType)).toBe(expected); }); }); describe('applyDeclarativeNodeOptionParameters', () => { test.each([ [ 'node with execute method', { execute: jest.fn(), description: { properties: [], }, }, ], [ 'node with trigger method', { trigger: jest.fn(), description: { properties: [], }, }, ], [ 'node with webhook method', { webhook: jest.fn(), description: { properties: [], }, }, ], [ 'a polling node-type', { description: { polling: true, properties: [], }, }, ], [ 'a node-type with a non-main output', { description: { outputs: ['main', 'ai_agent'], properties: [], }, }, ], ])('should not modify properties on node with %s method', (_, nodeTypeName) => { const nodeType = nodeTypeName as unknown as INodeType; applyDeclarativeNodeOptionParameters(nodeType); expect(nodeType.description.properties).toEqual([]); }); }); describe('convertNodeToAiTool', () => { let fullNodeWrapper: { description: INodeTypeDescription }; beforeEach(() => { fullNodeWrapper = { description: { displayName: 'Test Node', name: 'testNode', group: ['test'], description: 'A test node', version: 1, defaults: {}, inputs: [NodeConnectionType.Main], outputs: [NodeConnectionType.Main], properties: [], }, }; }); it('should modify the name and displayName correctly', () => { const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.name).toBe('testNodeTool'); expect(result.description.displayName).toBe('Test Node Tool'); }); it('should update inputs and outputs', () => { const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.inputs).toEqual([]); expect(result.description.outputs).toEqual([NodeConnectionType.AiTool]); }); it('should remove the usableAsTool property', () => { fullNodeWrapper.description.usableAsTool = true; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.usableAsTool).toBeUndefined(); }); it("should add toolDescription property if it doesn't exist", () => { const result = convertNodeToAiTool(fullNodeWrapper); const toolDescriptionProp = result.description.properties.find( (prop) => prop.name === 'toolDescription', ); expect(toolDescriptionProp).toBeDefined(); expect(toolDescriptionProp?.type).toBe('string'); expect(toolDescriptionProp?.default).toBe(fullNodeWrapper.description.description); }); it('should set codex categories correctly', () => { const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.codex).toEqual({ categories: ['AI'], subcategories: { AI: ['Tools'], Tools: ['Other Tools'], }, resources: {}, }); }); it('should preserve existing properties', () => { const existingProp: INodeProperties = { displayName: 'Existing Prop', name: 'existingProp', type: 'string', default: 'test', }; fullNodeWrapper.description.properties = [existingProp]; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.properties).toHaveLength(3); // Existing prop + toolDescription + notice expect(result.description.properties).toContainEqual(existingProp); }); it('should handle nodes with resource property', () => { const resourceProp: INodeProperties = { displayName: 'Resource', name: 'resource', type: 'options', options: [{ name: 'User', value: 'user' }], default: 'user', }; fullNodeWrapper.description.properties = [resourceProp]; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.properties[1].name).toBe('descriptionType'); expect(result.description.properties[2].name).toBe('toolDescription'); expect(result.description.properties[3]).toEqual(resourceProp); }); it('should handle nodes with operation property', () => { const operationProp: INodeProperties = { displayName: 'Operation', name: 'operation', type: 'options', options: [{ name: 'Create', value: 'create' }], default: 'create', }; fullNodeWrapper.description.properties = [operationProp]; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.properties[1].name).toBe('descriptionType'); expect(result.description.properties[2].name).toBe('toolDescription'); expect(result.description.properties[3]).toEqual(operationProp); }); it('should handle nodes with both resource and operation properties', () => { const resourceProp: INodeProperties = { displayName: 'Resource', name: 'resource', type: 'options', options: [{ name: 'User', value: 'user' }], default: 'user', }; const operationProp: INodeProperties = { displayName: 'Operation', name: 'operation', type: 'options', options: [{ name: 'Create', value: 'create' }], default: 'create', }; fullNodeWrapper.description.properties = [resourceProp, operationProp]; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.properties[1].name).toBe('descriptionType'); expect(result.description.properties[2].name).toBe('toolDescription'); expect(result.description.properties[3]).toEqual(resourceProp); expect(result.description.properties[4]).toEqual(operationProp); }); it('should handle nodes with empty properties', () => { fullNodeWrapper.description.properties = []; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.properties).toHaveLength(2); expect(result.description.properties[1].name).toBe('toolDescription'); }); it('should handle nodes with existing codex property', () => { fullNodeWrapper.description.codex = { categories: ['Existing'], subcategories: { Existing: ['Category'], }, resources: { primaryDocumentation: [{ url: 'https://example.com' }], }, }; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.codex).toEqual({ categories: ['AI'], subcategories: { AI: ['Tools'], Tools: ['Other Tools'], }, resources: { primaryDocumentation: [{ url: 'https://example.com' }], }, }); }); it('should handle nodes with very long names', () => { fullNodeWrapper.description.name = 'veryLongNodeNameThatExceedsNormalLimits'.repeat(10); fullNodeWrapper.description.displayName = 'Very Long Node Name That Exceeds Normal Limits'.repeat(10); const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.name.endsWith('Tool')).toBe(true); expect(result.description.displayName.endsWith('Tool')).toBe(true); }); it('should handle nodes with special characters in name and displayName', () => { fullNodeWrapper.description.name = 'special@#$%Node'; fullNodeWrapper.description.displayName = 'Special @#$% Node'; const result = convertNodeToAiTool(fullNodeWrapper); expect(result.description.name).toBe('special@#$%NodeTool'); expect(result.description.displayName).toBe('Special @#$% Node Tool'); }); }); });