@limetech/n8n-nodes-lime 3.2.2 → 3.4.0

package/nodes/lime-crm/index.ts

@@ -7,3 +7,4 @@ export * from './resources/admin';
 export * from './transport';
 export * from './LimeCrmNode.node';
 export * from './LimeCrmTrigger.node';
+export * from './serializers';

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

@@ -9,7 +9,7 @@ import {
 } from 'n8n-workflow';
 import { getProperties } from '../transport';
 import { LimetypeProperty } from '../models';
-
+import { serializeResourceMapperValues } from '../serializers';
 /**
  * A map of Lime CRM field types to n8n native types
  */
@@ -19,6 +19,8 @@ const LimeCrmTypeToFieldType = new Map(
         yesno: 'boolean',
         decimal: 'number',
         number: 'number',
+        time: 'dateTime',
+        date: 'dateTime',
     })
 );
 
@@ -98,7 +100,6 @@ async function getMappingColumns(
         }),
     };
 }
-
 /**
  * Parse resource mapper fields from n8n workflow
  * @param context - Node execution context
@@ -117,7 +118,12 @@ export function parseResourceMapperFields(
         i
     ) as ResourceMapperValue;
 
-    return propertiesInput.value as IDataObject;
+    const parsedData = propertiesInput.value as IDataObject;
+
+    return serializeResourceMapperValues(
+        parsedData,
+        propertiesInput.schema
+    ) as IDataObject;
 }
 
 /**

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

@@ -16,10 +16,10 @@ import { parseResourceMapperFields } from '../../../methods';
  * @public
  */
 export const description = {
-    name: 'Create Single Object',
+    name: 'Create an Object',
     value: 'createSingleObject',
     description: 'Create a single new object',
-    action: 'Create single object',
+    action: 'Create an object',
 };
 
 /**

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

@@ -10,10 +10,10 @@ import { WorkflowResponse } from '../../../../response';
  * @public
  */
 export const description = {
-    name: 'Delete Single Object',
+    name: 'Delete an Object',
     value: 'deleteSingleObject',
     description: 'Delete one specific object',
-    action: 'Delete single object',
+    action: 'Delete an object',
 };
 
 /**

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

@@ -199,7 +199,9 @@ export const properties: INodeProperties[] = [
         name: 'limit',
         type: 'number',
         default: DEFAULT_API_OBJECT_LIMIT,
-        description: 'The maximum number of records to return',
+        description:
+            'The maximum number of objects to return. Leaving an empty input or specifying "0" will return ' +
+            'all objects.',
         displayOptions: {
             show: {
                 resource: [DATA_RESOURCE],

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

@@ -13,10 +13,10 @@ import { DATA_RESOURCE } from '../../../models';
  * @public
  */
 export const description = {
-    name: 'Get Single File',
+    name: 'Get a File',
     value: 'getSingleFile',
     description: 'Get the file data for one specific file',
-    action: 'Get single file',
+    action: 'Get a file',
 };
 
 /**

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

@@ -10,10 +10,10 @@ import { WorkflowFileResponse } from '../../../../response';
  * @public
  */
 export const description = {
-    name: 'Get Single Object',
+    name: 'Get an Object',
     value: 'getSingleObject',
     description: 'Get one specific object',
-    action: 'Get single object',
+    action: 'Get an object',
 };
 
 /**

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

@@ -15,10 +15,10 @@ import { parseResourceMapperFields } from '../../../methods';
  * @public
  */
 export const description = {
-    name: 'Update Single Object',
+    name: 'Update an Object',
     value: 'updateSingleObject',
     description: 'Update one specific object',
-    action: 'Update single object',
+    action: 'Update an object',
 };
 
 /**

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

@@ -14,10 +14,10 @@ import { handleWorkflowError } from '../../../../errorHandling';
  * @public
  */
 export const description = {
-    name: 'Get Single File Metadata',
+    name: 'Get File Metadata',
     value: 'getSingleFileMetadata',
     description: 'Get the metadata for a single file',
-    action: 'Get single file metadata',
+    action: 'Get file metadata',
 };
 
 /**

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

@@ -9,10 +9,10 @@ import { WorkflowResponse } from '../../../../response';
  * @public
  */
 export const description = {
-    name: 'Get Single Limetype',
+    name: 'Get a Limetype',
     value: 'getSingleLimetype',
     description: 'Get details about a specific Limetype',
-    action: 'Get single Limetype',
+    action: 'Get a Limetype',
 };
 
 /**

package/nodes/lime-crm/serializers/commons.ts

@@ -0,0 +1,32 @@
+import { GenericValue, IDataObject } from 'n8n-workflow';
+
+/**
+ * A type that represents a serialized value in the system.
+ * It can either be a GenericValue, which is a broad, flexible type,
+ * or an IDataObject, which is a structure adhering to a specific data format.
+ */
+export type SerializedValue = GenericValue | IDataObject;
+
+/**
+ * A type definition for a serializer function that transforms a value of type `GenericValue`
+ * into a value of type `SerializedValue`.
+ *
+ * This function is typically used to process and convert data into a desired format suitable
+ * for a specific application or context.
+ *
+ * @callback SerializerFn
+ * @param {GenericValue} value - The input value to be serialized or transformed.
+ * @returns {SerializedValue} - The resulting transformed value.
+ */
+export type SerializerFn = (value: GenericValue) => SerializedValue;
+
+/**
+ * Custom error class for serialization errors.
+ */
+export class SerializerError extends Error {
+    constructor(message: string) {
+        super(message);
+        this.name = 'SerializerError';
+        Object.setPrototypeOf(this, SerializerError.prototype);
+    }
+}

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

@@ -0,0 +1,2 @@
+export { serializeResourceMapperValues } from './resourceMapperSerializer';
+export { SerializerError } from './commons';

package/nodes/lime-crm/serializers/resourceMapperSerializer.ts

@@ -0,0 +1,110 @@
+import { FieldType, IDataObject, ResourceMapperField } from 'n8n-workflow';
+import { SerializerFn, SerializedValue, SerializerError } from './commons';
+
+interface ResourceMapperFieldMap {
+    [id: string]: FieldType;
+}
+
+/**
+ * Serializes a given value into an ISO 8601 datetime string.
+ *
+ * This function accepts a value of type stringr, interprets it as a date,
+ * and converts it into a standardized ISO 8601 string representation of the datetime.
+ *
+ * Throws an error if the provided value is not of type string, or if
+ * the value cannot be successfully parsed into a valid date.
+ *
+ * @param value - The input value to be serialized, expected
+ * to represent a date. Must be a string.
+ * @throws {SerializerError} If the input value is not a string or does not represent a date.
+ * @returns The ISO 8601 formatted string representation of the datetime.
+ */
+const serializeDatetime: SerializerFn = (value) => {
+    if (typeof value !== 'string') {
+        throw new SerializerError(
+            `Expected string as dateTime, got ${typeof value}`
+        );
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new SerializerError(`Invalid date value: ${String(value)}`);
+    }
+    return date.toISOString();
+};
+
+/**
+ * A mapping of field types to their corresponding serializer functions.
+ * This map is used to associate specific field types with the appropriate
+ * logic for serializing their values.
+ */
+const SerializerMap: Partial<Record<FieldType, SerializerFn>> = {
+    dateTime: serializeDatetime,
+};
+
+/**
+ * Serializes the provided value using the serializer mapped to the specified Lime CRM type.
+ *
+ * This function retrieves a serializer associated with the given `limeCrmType` from
+ * the `SerializerMap`. If a serializer is found, it processes the `value`
+ * with the serializer and returns the serialized result. If no serializer is found
+ * for the specified type, the function returns the original value unchanged.
+ *
+ * @param value - The value to be serialized or returned as-is.
+ * @param type
+ * @returns - The serialized value or the original value if no
+ *                                serializer is found.
+ */
+const getSerializedValue = (
+    value: SerializedValue,
+    type: FieldType
+): SerializedValue => {
+    const serializer = SerializerMap[type];
+    return serializer === undefined ? value : serializer(value);
+};
+
+/**
+ * Converts an array of resource mapper fields into a mapped object where
+ * the field IDs serve as keys and their corresponding types as values.
+ *
+ * @param schema - The input array of resource mapper fields.
+ * @returns An object mapping each field ID to its corresponding type.
+ */
+const fetchResourceMapperFieldMap = (
+    schema: ResourceMapperField[]
+): ResourceMapperFieldMap => {
+    const resourceMapperFieldMap: ResourceMapperFieldMap = {};
+    for (const field of schema) {
+        if (field.type) {
+            resourceMapperFieldMap[field.id] = field.type;
+        }
+    }
+    return resourceMapperFieldMap;
+};
+
+/**
+ * Serializes resource mapper values based on the provided schema.
+ *
+ * This function takes a set of resource mapper values and a corresponding schema,
+ * and transforms the values into a serialized format as defined by the schema.
+ *
+ * @param resourceMapperValues - An object containing the key-value pairs of resource values to be serialized.
+ * @param resourceMapperSchema - An array defining the schema for serializing the resource values.
+ * @returns The serialized representation of the resource values, structured according to the provided schema.
+ */
+export const serializeResourceMapperValues = (
+    resourceMapperValues: IDataObject,
+    resourceMapperSchema: ResourceMapperField[]
+): IDataObject => {
+    const serializedData: IDataObject = {};
+    const resourceMapperFieldMap =
+        fetchResourceMapperFieldMap(resourceMapperSchema);
+    for (const resourceMapperValue in resourceMapperValues) {
+        if (resourceMapperValues[resourceMapperValue] !== undefined) {
+            serializedData[resourceMapperValue] = getSerializedValue(
+                resourceMapperValues[resourceMapperValue],
+                resourceMapperFieldMap[resourceMapperValue]
+            );
+        }
+    }
+    return serializedData;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limetech/n8n-nodes-lime",
-  "version": "3.2.2",
+  "version": "3.4.0",
   "description": "n8n node to connect to Lime CRM",
   "license": "Apache-2.0",
   "main": "nodes/index.ts",