first commit

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/create/description.ts

@@ -0,0 +1,105 @@
+import { addressFixedCollection } from '../../../methods/sharedFields';
+import type { CustomerProperties } from '../../Interfaces';
+
+export const customerCreateDescription: CustomerProperties = [
+	{
+		displayName: 'Email',
+		name: 'email',
+		type: 'string',
+		placeholder: 'name@email.com',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['create'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['create'],
+			},
+		},
+		default: {},
+		options: [
+			addressFixedCollection,
+			{
+				displayName: 'Business Name',
+				name: 'businessName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'First Name',
+				name: 'firstName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Get SMS',
+				name: 'getSms',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Invoice Emails',
+				name: 'invoiceCcEmails',
+				type: 'string',
+				typeOptions: {
+					multipleValues: true,
+					multipleValueButtonText: 'Add Email',
+				},
+				default: '',
+			},
+			{
+				displayName: 'Last Name',
+				name: 'lastname',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'No Email',
+				name: 'noEmail',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Notes',
+				name: 'notes',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Notification Email',
+				name: 'notificationEmail',
+				type: 'string',
+				default: '',
+				displayOptions: {
+					show: {
+						noEmail: [false],
+					},
+				},
+			},
+			{
+				displayName: 'Phone',
+				name: 'phone',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Referred By',
+				name: 'referredBy',
+				type: 'string',
+				default: '',
+				description:
+					'Source from which customer is referred to the platform like Linkedin, Google, Customer name etc',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/create/execute.ts

@@ -0,0 +1,53 @@
+import type { IExecuteFunctions, IDataObject, INodeExecutionData } from 'n8n-workflow';
+
+import { apiRequest } from '../../../transport';
+
+export async function addCustomer(
+	this: IExecuteFunctions,
+	index: number,
+): Promise<INodeExecutionData[]> {
+	const email = this.getNodeParameter('email', index) as IDataObject;
+	const {
+		address,
+		getSms,
+		businessName,
+		lastname,
+		firstName,
+		invoiceCcEmails,
+		noEmail,
+		notes,
+		notificationEmail,
+		phone,
+		referredBy,
+	} = this.getNodeParameter('additionalFields', index);
+
+	const qs = {} as IDataObject;
+	const requestMethod = 'POST';
+	const endpoint = 'customers';
+	let body = {} as IDataObject;
+	let addressData = address as IDataObject;
+
+	if (addressData) {
+		addressData = addressData.addressFields as IDataObject;
+		addressData.address_2 = addressData.address2;
+	}
+
+	body = {
+		...addressData,
+		business_name: businessName,
+		email,
+		firstname: firstName,
+		get_sms: getSms,
+		invoice_cc_emails: ((invoiceCcEmails as string[]) || []).join(','),
+		lastname,
+		no_email: noEmail,
+		notes,
+		notification_email: notificationEmail,
+		phone,
+		referred_by: referredBy,
+	};
+
+	const responseData = await apiRequest.call(this, requestMethod, endpoint, body, qs);
+
+	return this.helpers.returnJsonArray(responseData.customer as IDataObject);
+}

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/create/index.ts

@@ -0,0 +1,4 @@
+import { customerCreateDescription as description } from './description';
+import { addCustomer as execute } from './execute';
+
+export { description, execute };

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/del/description.ts

@@ -0,0 +1,18 @@
+import type { CustomerProperties } from '../../Interfaces';
+
+export const customerDeleteDescription: CustomerProperties = [
+	{
+		displayName: 'Customer ID',
+		name: 'customerId',
+		type: 'string',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['delete'],
+			},
+		},
+		default: '',
+		description: 'Delete a specific customer by ID',
+	},
+];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/del/execute.ts

@@ -0,0 +1,18 @@
+import type { IExecuteFunctions, IDataObject, INodeExecutionData } from 'n8n-workflow';
+
+import { apiRequest } from '../../../transport';
+
+export async function deleteCustomer(
+	this: IExecuteFunctions,
+	index: number,
+): Promise<INodeExecutionData[]> {
+	const id = this.getNodeParameter('customerId', index) as string;
+
+	const qs = {} as IDataObject;
+	const requestMethod = 'DELETE';
+	const endpoint = `customers/${id}`;
+	const body = {} as IDataObject;
+
+	const responseData = await apiRequest.call(this, requestMethod, endpoint, body, qs);
+	return this.helpers.returnJsonArray(responseData as IDataObject[]);
+}

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/del/index.ts

@@ -0,0 +1,4 @@
+import { customerDeleteDescription as description } from './description';
+import { deleteCustomer as execute } from './execute';
+
+export { description, execute };

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/get/description.ts

@@ -0,0 +1,18 @@
+import type { CustomerProperties } from '../../Interfaces';
+
+export const customerGetDescription: CustomerProperties = [
+	{
+		displayName: 'Cutomer ID',
+		name: 'customerId',
+		type: 'string',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['get'],
+			},
+		},
+		default: '',
+		description: 'Get specific customer by ID',
+	},
+];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/get/execute.ts

@@ -0,0 +1,18 @@
+import type { IExecuteFunctions, IDataObject, INodeExecutionData } from 'n8n-workflow';
+
+import { apiRequest } from '../../../transport';
+
+export async function getCustomer(
+	this: IExecuteFunctions,
+	index: number,
+): Promise<INodeExecutionData[]> {
+	const id = this.getNodeParameter('customerId', index) as string;
+
+	const qs = {} as IDataObject;
+	const requestMethod = 'GET';
+	const endpoint = `customers/${id}`;
+	const body = {} as IDataObject;
+
+	const responseData = await apiRequest.call(this, requestMethod, endpoint, body, qs);
+	return this.helpers.returnJsonArray(responseData.customer as IDataObject);
+}

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/get/index.ts

@@ -0,0 +1,4 @@
+import { customerGetDescription as description } from './description';
+import { getCustomer as execute } from './execute';
+
+export { description, execute };

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/getAll/description.ts

@@ -0,0 +1,97 @@
+import type { CustomerProperties } from '../../Interfaces';
+
+export const customerGetAllDescription: CustomerProperties = [
+	{
+		displayName: 'Return All',
+		name: 'returnAll',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['getAll'],
+			},
+		},
+		default: false,
+		noDataExpression: true,
+		description: 'Whether to return all results or only up to a given limit',
+	},
+	{
+		displayName: 'Limit',
+		name: 'limit',
+		type: 'number',
+		typeOptions: {
+			minValue: 1,
+		},
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['getAll'],
+				returnAll: [false],
+			},
+		},
+		default: 25,
+		description: 'Max number of results to return',
+	},
+	{
+		displayName: 'Filters',
+		name: 'filters',
+		type: 'collection',
+		placeholder: 'Add Filter',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['getAll'],
+			},
+		},
+		default: {},
+		options: [
+			{
+				displayName: 'Business Name',
+				name: 'businessName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Email',
+				name: 'email',
+				type: 'string',
+				placeholder: 'name@email.com',
+				default: '',
+			},
+			{
+				displayName: 'First Name',
+				name: 'firstName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Include Disabled',
+				name: 'includeDisabled',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Last Name',
+				name: 'lastname',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Search Query',
+				name: 'query',
+				type: 'string',
+				default: '',
+				placeholder: 'John Doe',
+				description: 'Search query, it can be anything related to customer data like name etc',
+			},
+			{
+				displayName: 'Sort',
+				name: 'sort',
+				type: 'string',
+				default: '',
+				placeholder: 'firstname ASC',
+				description: 'Customer field to order by, eg: "firstname ASC", "city DESC" etc',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/getAll/execute.ts

@@ -0,0 +1,39 @@
+import type { IExecuteFunctions, IDataObject, INodeExecutionData } from 'n8n-workflow';
+
+import { apiRequest, apiRequestAllItems } from '../../../transport';
+
+export async function getAll(
+	this: IExecuteFunctions,
+	index: number,
+): Promise<INodeExecutionData[]> {
+	const returnAll = this.getNodeParameter('returnAll', index);
+	const filters = this.getNodeParameter('filters', index);
+
+	let qs = {} as IDataObject;
+	const requestMethod = 'GET';
+	const endpoint = 'customers';
+	const body = {} as IDataObject;
+
+	if (filters) {
+		qs = filters;
+		if (qs.businessName) {
+			qs.business_name = qs.businessName;
+		}
+		if (qs.includeDisabled) {
+			qs.include_disabled = qs.includeDisabled;
+		}
+	}
+
+	if (!returnAll) {
+		qs.per_page = this.getNodeParameter('limit', index);
+	}
+
+	let responseData;
+	if (returnAll) {
+		responseData = await apiRequestAllItems.call(this, requestMethod, endpoint, body, qs);
+		return this.helpers.returnJsonArray(responseData);
+	} else {
+		responseData = await apiRequest.call(this, requestMethod, endpoint, body, qs);
+		return this.helpers.returnJsonArray(responseData.customers as IDataObject[]);
+	}
+}

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/getAll/index.ts

@@ -0,0 +1,4 @@
+import { customerGetAllDescription as description } from './description';
+import { getAll as execute } from './execute';
+
+export { description, execute };

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/index.ts

@@ -0,0 +1,61 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+import * as create from './create';
+import * as del from './del';
+import * as get from './get';
+import * as getAll from './getAll';
+import * as update from './update';
+
+export { getAll, create, del as delete, update, get };
+
+export const descriptions = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+			},
+		},
+		options: [
+			{
+				name: 'Create',
+				value: 'create',
+				description: 'Create new customer',
+				action: 'Create a customer',
+			},
+			{
+				name: 'Delete',
+				value: 'delete',
+				description: 'Delete customer',
+				action: 'Delete a customer',
+			},
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Retrieve customer',
+				action: 'Get a customer',
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				description: 'Retrieve many customers',
+				action: 'Get many customers',
+			},
+			{
+				name: 'Update',
+				value: 'update',
+				description: 'Update customer',
+				action: 'Update a customer',
+			},
+		],
+		default: 'getAll',
+	},
+	...getAll.description,
+	...get.description,
+	...create.description,
+	...del.description,
+	...update.description,
+] as INodeProperties[];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/update/description.ts

@@ -0,0 +1,111 @@
+import { addressFixedCollection } from '../../../methods/sharedFields';
+import type { CustomerProperties } from '../../Interfaces';
+
+export const customerUpdateDescription: CustomerProperties = [
+	{
+		displayName: 'Customer ID',
+		name: 'customerId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['update'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'Update Fields',
+		name: 'updateFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		displayOptions: {
+			show: {
+				resource: ['customer'],
+				operation: ['update'],
+			},
+		},
+		default: {},
+		options: [
+			addressFixedCollection,
+			{
+				displayName: 'Business Name',
+				name: 'businessName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Email',
+				name: 'email',
+				type: 'string',
+				placeholder: 'name@email.com',
+				default: '',
+			},
+			{
+				displayName: 'First Name',
+				name: 'firstName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Get SMS',
+				name: 'getSms',
+				type: 'boolean',
+				default: true,
+			},
+			{
+				displayName: 'Invoice Emails',
+				name: 'invoiceCcEmails',
+				type: 'string',
+				typeOptions: {
+					multipleValues: true,
+					multipleValueButtonText: 'Add Email',
+				},
+				default: '',
+			},
+			{
+				displayName: 'Last Name',
+				name: 'lastName',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'No Email',
+				name: 'noEmail',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Notes',
+				name: 'notes',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Notification Email',
+				name: 'notificationEmail',
+				type: 'string',
+				default: '',
+				displayOptions: {
+					show: {
+						noEmail: [false],
+					},
+				},
+			},
+			{
+				displayName: 'Phone',
+				name: 'phone',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Referred By',
+				name: 'referredBy',
+				type: 'string',
+				default: '',
+				description:
+					'Source from which customer is referred to the platform like Linkedin, Google, Customer name etc',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/update/execute.ts

@@ -0,0 +1,60 @@
+import type { IDataObject, IExecuteFunctions, INodeExecutionData, JsonObject } from 'n8n-workflow';
+import { NodeApiError } from 'n8n-workflow';
+
+import { apiRequest } from '../../../transport';
+
+export async function updateCustomer(
+	this: IExecuteFunctions,
+	index: number,
+): Promise<INodeExecutionData[]> {
+	const id = this.getNodeParameter('customerId', index) as IDataObject;
+	const {
+		address,
+		businessName,
+		email,
+		firstName,
+		getSms,
+		invoiceCcEmails,
+		lastName,
+		noEmail,
+		notes,
+		notificationEmail,
+		phone,
+		referredBy,
+	} = this.getNodeParameter('updateFields', index);
+
+	const qs = {} as IDataObject;
+	const requestMethod = 'PUT';
+	const endpoint = `customers/${id}`;
+	let body = {} as IDataObject;
+	let addressData = address as IDataObject;
+
+	if (addressData) {
+		addressData = addressData.addressFields as IDataObject;
+		addressData.address_2 = addressData.address2;
+	}
+
+	body = {
+		...addressData,
+		business_name: businessName,
+		email,
+		firstname: firstName,
+		get_sms: getSms,
+		invoice_cc_emails: ((invoiceCcEmails as string[]) || []).join(','),
+		lastname: lastName,
+		no_email: noEmail,
+		notes,
+		notification_email: notificationEmail,
+		phone,
+		referred_by: referredBy,
+	};
+
+	const responseData = await apiRequest.call(this, requestMethod, endpoint, body, qs);
+	if (!responseData.customer) {
+		throw new NodeApiError(this.getNode(), responseData as JsonObject, {
+			httpCode: '404',
+			message: 'Customer ID not found',
+		});
+	}
+	return this.helpers.returnJsonArray(responseData.customer as IDataObject[]);
+}

packages/nodes-base/nodes/SyncroMSP/v1/actions/customer/update/index.ts

@@ -0,0 +1,4 @@
+import { customerUpdateDescription as description } from './description';
+import { updateCustomer as execute } from './execute';
+
+export { description, execute };