@limetech/n8n-nodes-lime 3.11.3 → 3.13.0

package/nodes/lime-crm/{LimeCrm.node.json → LimeCrmNode.node.json}

@@ -6,12 +6,12 @@
   "resources": {
     "credentialDocumentation": [
       {
-        "url": "https://lime-crm.com/api-docs/"
+        "url": "https://platform.docs.lime-crm.com/en/latest/workflows-and-integrations/node-reference/"
       }
     ],
     "primaryDocumentation": [
       {
-        "url": "https://lime-crm.com/api-docs/"
+        "url": "https://platform.docs.lime-crm.com/en/latest/workflows-and-integrations/node-reference/"
       }
     ]
   }

package/nodes/lime-crm/LimeCrmNode.node.ts

@@ -22,7 +22,7 @@ import {
 import {
     getFileProperties,
     getLimetypeProperties,
-    getLimetypes,
+    searchLimetypes,
     getNoHasManyProperties,
     getRelationProperties,
     getCreateMappingColumns,
@@ -80,6 +80,8 @@ export class LimeCrmNode implements INodeType {
     description: INodeTypeDescription = {
         displayName: 'Lime CRM',
         name: 'limeCrm',
+        documentationUrl:
+            'https://platform.docs.lime-crm.com/en/latest/workflows-and-integrations/node-reference/',
         icon: 'file:assets/lime-crm.svg',
         group: ['transform'],
         version: 1,
@@ -138,7 +140,7 @@ export class LimeCrmNode implements INodeType {
      * @remarks
      * These functions are used to populate dropdowns and lists in the node's
      * parameter editor. For details, see:
-     * - {@link getLimetypes}
+     * - {@link searchLimetypes}
      * - {@link getFileProperties}
      * - {@link getLimetypeProperties}
      * - {@link getNoHasManyProperties}
@@ -147,13 +149,15 @@ export class LimeCrmNode implements INodeType {
      */
     methods = {
         loadOptions: {
-            getLimetypes,
             getLimetypeProperties,
             getFileProperties,
             getNoHasManyProperties,
             getRelationProperties,
             getRelationPropertiesWithLookupField,
         },
+        listSearch: {
+            searchLimetypes,
+        },
         resourceMapping: {
             getUpdateMappingColumns,
             getCreateMappingColumns,

package/nodes/lime-crm/LimeCrmTrigger.node.ts

@@ -52,6 +52,8 @@ export class LimeCrmTrigger implements INodeType {
     description: INodeTypeDescription = {
         displayName: 'Lime CRM Trigger',
         name: 'limeCrmTrigger',
+        documentationUrl:
+            'https://platform.docs.lime-crm.com/en/latest/workflows-and-integrations/node-reference/',
         icon: 'file:assets/lime-crm.svg',
         group: ['trigger'],
         version: 1,

package/nodes/lime-crm/methods/getLimetypeProperties.ts

@@ -18,7 +18,9 @@ import { getProperties } from '../transport/';
  * @group Load Options Methods
  */
 async function fetchAllProperties(nodeContext: ILoadOptionsFunctions) {
-    const limetype = nodeContext.getNodeParameter('limetype', '') as string;
+    const limetype = nodeContext.getNodeParameter('limetype', '', {
+        extractValue: true,
+    }) as string;
     Logger.info(`Fetching file properties for Lime type: ${limetype}`);
     if (!limetype) return [];
     try {
@@ -143,7 +145,9 @@ export async function getRelationProperties(
 export async function getRelationPropertiesWithLookupField(
     this: ILoadOptionsFunctions
 ): Promise<INodePropertyOptions[]> {
-    const limetype = this.getNodeParameter('limetype', '') as string;
+    const limetype = this.getNodeParameter('limetype', '', {
+        extractValue: true,
+    }) as string;
 
     if (!limetype) return [];
 

package/nodes/lime-crm/methods/index.ts

@@ -1,4 +1,5 @@
 export { getLimetypes } from './getLimetypes';
+export { searchLimetypes } from './searchLimetypes';
 export {
     getFileProperties,
     getFilteredLimetypeProperties,

package/nodes/lime-crm/methods/resourceMapping.ts

@@ -138,7 +138,9 @@ export function parseResourceMapperFields(
 export async function getCreateMappingColumns(
     this: ILoadOptionsFunctions
 ): Promise<ResourceMapperFields> {
-    const limetype = this.getNodeParameter('limetype') as string;
+    const limetype = this.getNodeParameter('limetype', undefined, {
+        extractValue: true,
+    }) as string;
     return getMappingColumns(this, 'create', limetype);
 }
 
@@ -148,7 +150,9 @@ export async function getCreateMappingColumns(
 export async function getUpdateMappingColumns(
     this: ILoadOptionsFunctions
 ): Promise<ResourceMapperFields> {
-    const limetype = this.getNodeParameter('limetype') as string;
+    const limetype = this.getNodeParameter('limetype', undefined, {
+        extractValue: true,
+    }) as string;
     return getMappingColumns(this, 'update', limetype);
 }
 
@@ -159,7 +163,9 @@ export async function getUpdateMappingColumns(
 export async function getRelationLookupMappingColumns(
     this: ILoadOptionsFunctions
 ): Promise<ResourceMapperFields> {
-    const limetype = this.getNodeParameter('limetype') as string;
+    const limetype = this.getNodeParameter('limetype', undefined, {
+        extractValue: true,
+    }) as string;
     if (!limetype) {
         return { fields: [] };
     }

package/nodes/lime-crm/methods/searchLimetypes.ts

@@ -0,0 +1,33 @@
+import { ILoadOptionsFunctions, INodeListSearchResult } from 'n8n-workflow';
+import { getLimetypesFromApi } from '../transport';
+
+/**
+ * Search available Limetypes for a `resourceLocator` list mode.
+ *
+ * @param filter - Optional text to filter Limetypes by their display name
+ * @returns Matching Limetypes as resource locator search results
+ *
+ * @public
+ * @group List Search Methods
+ */
+export async function searchLimetypes(
+    this: ILoadOptionsFunctions,
+    filter?: string
+): Promise<INodeListSearchResult> {
+    const response = await getLimetypesFromApi(this);
+    if (!response.success) return { results: [] };
+
+    const results = response.data
+        .map((limetype) => ({
+            name: limetype.localname?.singular || limetype.name,
+            value: limetype.name,
+        }))
+        .filter((item) =>
+            filter
+                ? item.name.toLowerCase().includes(filter.toLowerCase())
+                : true
+        )
+        .sort((a, b) => a.name.localeCompare(b.name));
+
+    return { results };
+}

package/nodes/lime-crm/resources/data/operations/bulkImportCommons.ts

@@ -57,13 +57,27 @@ export function getBulkImportProperties(
         {
             displayName: 'Limetype',
             name: 'limetype',
-            type: 'options',
-            typeOptions: {
-                loadOptionsMethod: 'getLimetypes',
-            },
+            type: 'resourceLocator',
+            default: { mode: 'list', value: '' },
             required: true,
-            default: '',
             description: 'The type of object to import',
+            modes: [
+                {
+                    displayName: 'From List',
+                    name: 'list',
+                    type: 'list',
+                    typeOptions: {
+                        searchListMethod: 'searchLimetypes',
+                        searchable: true,
+                    },
+                },
+                {
+                    displayName: 'By Name',
+                    name: 'name',
+                    type: 'string',
+                    placeholder: 'e.g. company',
+                },
+            ],
             displayOptions: {
                 show: {
                     resource: [DATA_RESOURCE],
@@ -217,7 +231,9 @@ export async function executeBulkImport(
         return undefined;
     }
 
-    const limetype = context.getNodeParameter('limetype', i) as string;
+    const limetype = context.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const inputMethod = context.getNodeParameter('inputMethod', i) as string;
     const items = context.getInputData();
 

package/nodes/lime-crm/resources/data/operations/createSingleObject.operation.ts

@@ -36,13 +36,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity to create',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -140,7 +154,9 @@ export const properties: INodeProperties[] = [
  * @public
  */
 export async function execute(this: IExecuteFunctions, i: number) {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const inputMethod = this.getNodeParameter('inputMethod', i) as string;
 
     let objectData: IDataObject;

package/nodes/lime-crm/resources/data/operations/deleteSingleObject.operation.ts

@@ -29,13 +29,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity to delete',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -80,7 +94,9 @@ export async function execute(
     this: IExecuteFunctions,
     i: number
 ): Promise<WorkflowResponse<Record<string, never>>> {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const objectId = this.getNodeParameter('objectId', i) as string;
 
     const response = await deleteLimeobject(this, limetype, objectId);

package/nodes/lime-crm/resources/data/operations/getManyObjects.operation.ts

@@ -90,13 +90,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity to query',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -211,6 +225,21 @@ export const properties: INodeProperties[] = [
             },
         },
     },
+    {
+        displayName: 'Offset',
+        name: 'offset',
+        type: 'number',
+        default: '',
+        placeholder: 'e.g. 200',
+        description:
+            'Use together with Limit to manually control pagination when fetching data in batches. This is useful when the number of records exceeds tens of thousands and you want to keep each workflow iteration lightweight. Leave empty to fetch all objects at once, using automatic pagination under the hood.',
+        displayOptions: {
+            show: {
+                resource: [DATA_RESOURCE],
+                operation: ['getManyObjects'],
+            },
+        },
+    },
     {
         displayName: 'Order By',
         name: 'orderByInputMethod',
@@ -386,6 +415,7 @@ function getOrderBy(orderByCollection: OrderByCollection) {
  * @param filter - JSON string representing the filter conditions for the query
  * @param limit - Maximum number of objects to fetch in this request
  * @param orderBy - Array of objects defining the sorting of the results
+ * @param offset - Starting offset for fetching. Defaults to 0, which preserves automatic pagination from the beginning.
  *
  * @returns Array of fetched objects or an error response as an array.
  */
@@ -395,7 +425,8 @@ async function fetchLimeObjects(
     responseFormat: ResponseFormat,
     filter: string,
     limit: number | null,
-    orderBy: Record<string, 'ASC' | 'DESC'>[]
+    orderBy: Record<string, 'ASC' | 'DESC'>[],
+    offset = 0
 ): Promise<WorkflowResponse<IncludedProperties[]>> {
     const allResults: IncludedProperties[] = [];
     const parsedFilter = JSON.parse(filter);
@@ -403,7 +434,7 @@ async function fetchLimeObjects(
     const targetLimit = unlimited ? Infinity : limit;
 
     let fetched = 0;
-    let currentOffset = 0;
+    let currentOffset = offset;
 
     while (fetched < targetLimit) {
         const currentLimit =
@@ -458,7 +489,9 @@ async function fetchLimeObjects(
  * @public
  */
 export async function execute(this: IExecuteFunctions, i: number) {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const responseFormatInputMethod = this.getNodeParameter(
         'responseFormatInputMethod',
         i
@@ -473,6 +506,7 @@ export async function execute(this: IExecuteFunctions, i: number) {
         i,
         DEFAULT_API_OBJECT_LIMIT
     ) as number;
+    const offset = (this.getNodeParameter('offset', i, 0) as number) || 0;
 
     let response;
     if (responseFormatInputMethod === 'fields') {
@@ -504,6 +538,7 @@ export async function execute(this: IExecuteFunctions, i: number) {
         response,
         filter,
         limit,
-        orderBy
+        orderBy,
+        offset
     );
 }

package/nodes/lime-crm/resources/data/operations/getSingleFile.operation.ts

@@ -59,13 +59,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity associated with the file',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -145,7 +159,9 @@ export async function execute(
         };
     }
     if (source == 'byLimeobject') {
-        const limetype = this.getNodeParameter('limetype', i) as string;
+        const limetype = this.getNodeParameter('limetype', i, undefined, {
+            extractValue: true,
+        }) as string;
         const property = this.getNodeParameter('property', i) as string;
 
         const fileResponse = await getFileContentByLimetype(

package/nodes/lime-crm/resources/data/operations/getSingleObject.operation.ts

@@ -29,13 +29,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity to retrieve',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -98,7 +112,9 @@ export async function execute(
     this: IExecuteFunctions,
     i: number
 ): Promise<WorkflowFileResponse<Limeobject>> {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const objectId = this.getNodeParameter('objectId', i) as string;
     const includeFileContent = this.getNodeParameter(
         'includeFileContent',

package/nodes/lime-crm/resources/data/operations/updateSingleObject.operation.ts

@@ -36,13 +36,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity to update',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],
@@ -160,7 +174,9 @@ export async function execute(
     this: IExecuteFunctions,
     i: number
 ): Promise<WorkflowFileResponse<Limeobject>> {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
     const id = this.getNodeParameter('id', i) as string;
     const inputType = this.getNodeParameter('inputType', i) as string;
 

package/nodes/lime-crm/resources/metadata/operations/getSingleFileMetadata.operation.ts

@@ -60,13 +60,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The type of entity associated with the file',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [METADATA_RESOURCE],
@@ -133,7 +147,9 @@ export async function execute(
     if (source == 'byFile') {
         response = await getFileMetadata(this, id);
     } else if (source == 'byLimeobject') {
-        const limetype = this.getNodeParameter('limetype', i) as string;
+        const limetype = this.getNodeParameter('limetype', i, undefined, {
+            extractValue: true,
+        }) as string;
         const property = this.getNodeParameter('property', i) as string;
         response = await getFileMetadataByLimeobject(
             this,

package/nodes/lime-crm/resources/metadata/operations/getSingleLimetype.operation.ts

@@ -26,13 +26,27 @@ export const properties: INodeProperties[] = [
     {
         displayName: 'Limetype',
         name: 'limetype',
-        type: 'options',
-        typeOptions: {
-            loadOptionsMethod: 'getLimetypes',
-        },
+        type: 'resourceLocator',
+        default: { mode: 'list', value: '' },
         required: true,
-        default: '',
         description: 'The name of the entity type to get details for',
+        modes: [
+            {
+                displayName: 'From List',
+                name: 'list',
+                type: 'list',
+                typeOptions: {
+                    searchListMethod: 'searchLimetypes',
+                    searchable: true,
+                },
+            },
+            {
+                displayName: 'By Name',
+                name: 'name',
+                type: 'string',
+                placeholder: 'e.g. company',
+            },
+        ],
         displayOptions: {
             show: {
                 resource: [METADATA_RESOURCE],
@@ -56,7 +70,9 @@ export async function execute(
     this: IExecuteFunctions,
     i: number
 ): Promise<WorkflowResponse<Limetype>> {
-    const limetype = this.getNodeParameter('limetype', i) as string;
+    const limetype = this.getNodeParameter('limetype', i, undefined, {
+        extractValue: true,
+    }) as string;
 
     const response = await getLimetype(this, limetype);
     return response.data;

package/nodes/lime-forms/LimeFormsTrigger.node.ts

@@ -32,6 +32,8 @@ export class LimeFormsTrigger implements INodeType {
     description: INodeTypeDescription = {
         displayName: 'Lime CRM Forms Trigger',
         name: 'limeCrmFormsTrigger',
+        documentationUrl:
+            'https://platform.docs.lime-crm.com/en/latest/workflows-and-integrations/node-reference/',
         group: ['trigger'],
         version: 1,
         icon: 'file:assets/lime-crm.svg',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limetech/n8n-nodes-lime",
-  "version": "3.11.3",
+  "version": "3.13.0",
   "description": "n8n node to connect to Lime CRM",
   "author": {
     "name": "Lime Technologies",