first commit

packages/nodes-base/nodes/Demio/Demio.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "n8n-nodes-base.demio",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Communication"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/credentials/demio/"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.demio/"
+			}
+		]
+	}
+}

packages/nodes-base/nodes/Demio/Demio.node.ts

@@ -0,0 +1,206 @@
+import type {
+	IExecuteFunctions,
+	IDataObject,
+	ILoadOptionsFunctions,
+	INodeExecutionData,
+	INodePropertyOptions,
+	INodeType,
+	INodeTypeDescription,
+} from 'n8n-workflow';
+import { NodeConnectionTypes } from 'n8n-workflow';
+
+import { eventFields, eventOperations } from './EventDescription';
+import { demioApiRequest } from './GenericFunctions';
+import { reportFields, reportOperations } from './ReportDescription';
+
+export class Demio implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Demio',
+		name: 'demio',
+		icon: 'file:demio.svg',
+		group: ['output'],
+		version: 1,
+		subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+		description: 'Consume the Demio API',
+		defaults: {
+			name: 'Demio',
+		},
+		usableAsTool: true,
+		inputs: [NodeConnectionTypes.Main],
+		outputs: [NodeConnectionTypes.Main],
+		credentials: [
+			{
+				name: 'demioApi',
+				required: true,
+			},
+		],
+		properties: [
+			{
+				displayName: 'Resource',
+				name: 'resource',
+				type: 'options',
+				noDataExpression: true,
+				options: [
+					{
+						name: 'Event',
+						value: 'event',
+					},
+					{
+						name: 'Report',
+						value: 'report',
+					},
+				],
+				default: 'event',
+			},
+			// Event
+			...eventOperations,
+			...eventFields,
+			// Report
+			...reportOperations,
+			...reportFields,
+		],
+	};
+
+	methods = {
+		loadOptions: {
+			// Get all the events to display them to user so that they can
+			// select them easily
+			async getEvents(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
+				const returnData: INodePropertyOptions[] = [];
+				const events = await demioApiRequest.call(this, 'GET', '/events', {}, { type: 'upcoming' });
+				for (const event of events) {
+					returnData.push({
+						name: event.name,
+						value: event.id,
+					});
+				}
+				return returnData;
+			},
+
+			// Get all the sessions to display them to user so that they can
+			// select them easily
+			async getEventSessions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
+				const eventId = this.getCurrentNodeParameter('eventId') as string;
+				const qs: IDataObject = {};
+
+				const resource = this.getCurrentNodeParameter('resource') as string;
+
+				if (resource !== 'report') {
+					qs.active = true;
+				}
+
+				const returnData: INodePropertyOptions[] = [];
+				const { dates } = await demioApiRequest.call(this, 'GET', `/event/${eventId}`, {});
+				for (const date of dates) {
+					returnData.push({
+						name: date.datetime,
+						value: date.date_id,
+					});
+				}
+				return returnData;
+			},
+		},
+	};
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: IDataObject[] = [];
+		const length = items.length;
+		const qs: IDataObject = {};
+		let responseData;
+		const resource = this.getNodeParameter('resource', 0);
+		const operation = this.getNodeParameter('operation', 0);
+
+		for (let i = 0; i < length; i++) {
+			try {
+				if (resource === 'event') {
+					if (operation === 'get') {
+						const id = this.getNodeParameter('eventId', i) as string;
+						const additionalFields = this.getNodeParameter('additionalFields', i);
+
+						if (additionalFields.date_id !== undefined) {
+							responseData = await demioApiRequest.call(
+								this,
+								'GET',
+								`/event/${id}/date/${additionalFields.date_id}`,
+							);
+						} else {
+							Object.assign(qs, additionalFields);
+							responseData = await demioApiRequest.call(this, 'GET', `/event/${id}`, {}, qs);
+						}
+					}
+					if (operation === 'getAll') {
+						const filters = this.getNodeParameter('filters', i);
+						const returnAll = this.getNodeParameter('returnAll', i);
+
+						Object.assign(qs, filters);
+
+						responseData = await demioApiRequest.call(this, 'GET', '/events', {}, qs);
+
+						if (!returnAll) {
+							const limit = this.getNodeParameter('limit', i);
+							responseData = responseData.splice(0, limit);
+						}
+					}
+					if (operation === 'register') {
+						const eventId = this.getNodeParameter('eventId', i) as string;
+						const firstName = this.getNodeParameter('firstName', i) as string;
+						const email = this.getNodeParameter('email', i) as string;
+						const additionalFields = this.getNodeParameter('additionalFields', i);
+
+						const body: IDataObject = {
+							name: firstName,
+							email,
+							id: eventId,
+						};
+
+						Object.assign(body, additionalFields);
+
+						if (additionalFields.customFieldsUi) {
+							const customFields =
+								((additionalFields.customFieldsUi as IDataObject)
+									?.customFieldsValues as IDataObject[]) || [];
+							const data = customFields.reduce(
+								(obj, value) => Object.assign(obj, { [`${value.fieldId}`]: value.value }),
+								{},
+							);
+							Object.assign(body, data);
+							delete additionalFields.customFields;
+						}
+
+						responseData = await demioApiRequest.call(this, 'PUT', '/event/register', body);
+					}
+				}
+				if (resource === 'report') {
+					if (operation === 'get') {
+						const sessionId = this.getNodeParameter('dateId', i) as string;
+						const filters = this.getNodeParameter('filters', i);
+
+						Object.assign(qs, filters);
+
+						responseData = await demioApiRequest.call(
+							this,
+							'GET',
+							`/report/${sessionId}/participants`,
+							{},
+							qs,
+						);
+						responseData = responseData.participants;
+					}
+				}
+				if (Array.isArray(responseData)) {
+					returnData.push.apply(returnData, responseData as IDataObject[]);
+				} else {
+					returnData.push(responseData as IDataObject);
+				}
+			} catch (error) {
+				if (this.continueOnFail()) {
+					returnData.push({ error: error.message });
+					continue;
+				}
+				throw error;
+			}
+		}
+		return [this.helpers.returnJsonArray(returnData)];
+	}
+}

packages/nodes-base/nodes/Demio/EventDescription.ts

@@ -0,0 +1,307 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const eventOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['event'],
+			},
+		},
+		options: [
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Get an event',
+				action: 'Get an event',
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				description: 'Get many events',
+				action: 'Get many events',
+			},
+			{
+				name: 'Register',
+				value: 'register',
+				description: 'Register someone to an event',
+				action: 'Register an event',
+			},
+		],
+		default: 'get',
+	},
+];
+
+export const eventFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                                   event:getAll                             */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Return All',
+		name: 'returnAll',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				operation: ['getAll'],
+				resource: ['event'],
+			},
+		},
+		default: false,
+		description: 'Whether to return all results or only up to a given limit',
+	},
+	{
+		displayName: 'Limit',
+		name: 'limit',
+		type: 'number',
+		displayOptions: {
+			show: {
+				operation: ['getAll'],
+				resource: ['event'],
+				returnAll: [false],
+			},
+		},
+		typeOptions: {
+			minValue: 1,
+			maxValue: 500,
+		},
+		default: 100,
+		description: 'Max number of results to return',
+	},
+	{
+		displayName: 'Filters',
+		name: 'filters',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['getAll'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Type',
+				name: 'type',
+				type: 'options',
+				options: [
+					{
+						name: 'Automated',
+						value: 'automated',
+					},
+					{
+						name: 'Past',
+						value: 'past',
+					},
+					{
+						name: 'Upcoming',
+						value: 'upcoming',
+					},
+				],
+				default: '',
+			},
+		],
+	},
+
+	/* -------------------------------------------------------------------------- */
+	/*                                   event:get                                */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Event ID',
+		name: 'eventId',
+		type: 'string',
+		default: '',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['get'],
+			},
+		},
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['get'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Active',
+				name: 'active',
+				type: 'boolean',
+				default: false,
+				description: 'Whether to return only active dates in series',
+			},
+			{
+				displayName: 'Session ID',
+				name: 'date_id',
+				type: 'string',
+				default: '',
+				description: 'Event Date ID',
+			},
+		],
+	},
+
+	/* -------------------------------------------------------------------------- */
+	/*                                   event:register                           */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Event Name or ID',
+		name: 'eventId',
+		type: 'options',
+		description:
+			'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+		typeOptions: {
+			loadOptionsMethod: 'getEvents',
+		},
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['register'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'First Name',
+		name: 'firstName',
+		type: 'string',
+		default: '',
+		required: true,
+		description: "The registrant's first name",
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['register'],
+			},
+		},
+	},
+	{
+		displayName: 'Email',
+		name: 'email',
+		type: 'string',
+		placeholder: 'name@email.com',
+		default: '',
+		required: true,
+		description: "The registrant's email address",
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['register'],
+			},
+		},
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['event'],
+				operation: ['register'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Company',
+				name: 'company',
+				type: 'string',
+				default: '',
+				description: 'The value for the predefined Company field',
+			},
+			{
+				displayName: 'Custom Fields',
+				name: 'customFieldsUi',
+				placeholder: 'Add Field',
+				type: 'fixedCollection',
+				typeOptions: {
+					multipleValues: true,
+				},
+				default: {},
+				options: [
+					{
+						name: 'customFieldsValues',
+						displayName: 'Custom Field',
+						values: [
+							{
+								displayName: 'Field ID',
+								name: 'fieldId',
+								type: 'string',
+								default: '',
+								description:
+									"Each custom field's unique identifier can be found within the Event's Registration block in the Customize tab",
+							},
+							{
+								displayName: 'Value',
+								name: 'value',
+								type: 'string',
+								default: '',
+								description: 'The value to set on custom field',
+							},
+						],
+					},
+				],
+			},
+			{
+				displayName: 'Event Registration URL',
+				name: 'ref_url',
+				type: 'string',
+				default: '',
+				description:
+					'Event Registration page URL. It can be useful when you do not know Event ID, but have Event link.',
+			},
+			{
+				displayName: 'GDPR',
+				name: 'gdpr',
+				type: 'string',
+				default: '',
+				description: 'The value for the predefined GDPR field',
+			},
+			{
+				displayName: 'Last Name',
+				name: 'last_name',
+				type: 'string',
+				default: '',
+				description: 'The value for the predefined Last Name field',
+			},
+			{
+				displayName: 'Phone Number',
+				name: 'phone_number',
+				type: 'string',
+				default: '',
+				description: 'The value for the predefined Phone Number field',
+			},
+			{
+				displayName: 'Session Name or ID',
+				name: 'date_id',
+				type: 'options',
+				typeOptions: {
+					loadOptionsMethod: 'getEventSessions',
+					loadOptionsDependsOn: ['eventId'],
+				},
+				default: '',
+				description:
+					'Event Session ID. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+			},
+			{
+				displayName: 'Website',
+				name: 'website',
+				type: 'string',
+				default: '',
+				description: 'The value for the predefined Website field',
+			},
+		],
+	},
+];

packages/nodes-base/nodes/Demio/GenericFunctions.ts

@@ -0,0 +1,42 @@
+import type {
+	IDataObject,
+	IExecuteFunctions,
+	IHookFunctions,
+	ILoadOptionsFunctions,
+	JsonObject,
+	IRequestOptions,
+	IHttpRequestMethods,
+} from 'n8n-workflow';
+import { NodeApiError } from 'n8n-workflow';
+
+export async function demioApiRequest(
+	this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions,
+	method: IHttpRequestMethods,
+	resource: string,
+
+	body: any = {},
+	qs: IDataObject = {},
+	uri?: string,
+	option: IDataObject = {},
+): Promise<any> {
+	try {
+		const credentials = await this.getCredentials('demioApi');
+		let options: IRequestOptions = {
+			headers: {
+				'Api-Key': credentials.apiKey,
+				'Api-Secret': credentials.apiSecret,
+			},
+			method,
+			qs,
+			body,
+			uri: uri || `https://my.demio.com/api/v1${resource}`,
+			json: true,
+		};
+
+		options = Object.assign({}, options, option);
+
+		return await this.helpers.request(options);
+	} catch (error) {
+		throw new NodeApiError(this.getNode(), error as JsonObject);
+	}
+}

packages/nodes-base/nodes/Demio/ReportDescription.ts

@@ -0,0 +1,110 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const reportOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['report'],
+			},
+		},
+		options: [
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Get an event report',
+				action: 'Get a report',
+			},
+		],
+		default: 'get',
+	},
+];
+
+export const reportFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                                   report:get                               */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Event Name or ID',
+		name: 'eventId',
+		type: 'options',
+		description:
+			'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+		typeOptions: {
+			loadOptionsMethod: 'getEvents',
+		},
+		displayOptions: {
+			show: {
+				resource: ['report'],
+				operation: ['get'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'Session Name or ID',
+		name: 'dateId',
+		type: 'options',
+		typeOptions: {
+			loadOptionsMethod: 'getEventSessions',
+			loadOptionsDependsOn: ['eventId'],
+		},
+		default: '',
+		required: true,
+		description:
+			'ID of the session. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+		displayOptions: {
+			show: {
+				resource: ['report'],
+				operation: ['get'],
+			},
+		},
+	},
+	{
+		displayName: 'Filters',
+		name: 'filters',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['report'],
+				operation: ['get'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Status',
+				name: 'status',
+				type: 'options',
+				options: [
+					{
+						name: 'Attended',
+						value: 'attended',
+					},
+					{
+						name: 'Banned',
+						value: 'banned',
+					},
+					{
+						name: 'Completed',
+						value: 'completed',
+					},
+					{
+						name: 'Did Not Attend',
+						value: 'did-not-attend',
+					},
+					{
+						name: 'Left Early',
+						value: 'left-early',
+					},
+				],
+				default: '',
+				description: 'Filter results by participation status',
+			},
+		],
+	},
+];