n8n/packages/nodes-base/nodes/Signl4/Signl4.node.ts

import type {
	IDataObject,
	IExecuteFunctions,
	INodeExecutionData,
	INodeType,
	INodeTypeDescription,
} from 'n8n-workflow';
import { NodeOperationError } from 'n8n-workflow';

import { SIGNL4ApiRequest } from './GenericFunctions';

export class Signl4 implements INodeType {
	description: INodeTypeDescription = {
		displayName: 'SIGNL4',
		name: 'signl4',
		// eslint-disable-next-line n8n-nodes-base/node-class-description-icon-not-svg
		icon: 'file:signl4.png',
		group: ['transform'],
		version: 1,
		subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
		description: 'Consume SIGNL4 API',
		defaults: {
			name: 'SIGNL4',
		},
		inputs: ['main'],
		outputs: ['main'],
		credentials: [
			{
				name: 'signl4Api',
				required: true,
			},
		],
		properties: [
			{
				displayName: 'Resource',
				name: 'resource',
				type: 'options',
				noDataExpression: true,
				options: [
					{
						name: 'Alert',
						value: 'alert',
					},
				],
				default: 'alert',
			},
			{
				displayName: 'Operation',
				name: 'operation',
				type: 'options',
				noDataExpression: true,
				displayOptions: {
					show: {
						resource: ['alert'],
					},
				},
				options: [
					{
						name: 'Send',
						value: 'send',
						description: 'Send an alert',
						action: 'Send an alert',
					},
					{
						name: 'Resolve',
						value: 'resolve',
						description: 'Resolve an alert',
						action: 'Resolve an alert',
					},
				],
				default: 'send',
			},
			{
				displayName: 'Message',
				name: 'message',
				type: 'string',
				default: '',
				displayOptions: {
					show: {
						operation: ['send'],
						resource: ['alert'],
					},
				},
				description: 'A more detailed description for the alert',
			},
			{
				displayName: 'Additional Fields',
				name: 'additionalFields',
				type: 'collection',
				placeholder: 'Add Field',
				displayOptions: {
					show: {
						operation: ['send'],
						resource: ['alert'],
					},
				},
				default: {},
				options: [
					{
						displayName: 'Alerting Scenario',
						name: 'alertingScenario',
						type: 'options',
						options: [
							{
								name: 'Single ACK',
								value: 'single_ack',
								description: 'In case only one person needs to confirm this Signl',
							},
							{
								name: 'Multi ACK',
								value: 'multi_ack',
								description:
									'In case this alert must be confirmed by the number of people who are on duty at the time this Singl is raised',
							},
						],
						default: 'single_ack',
					},
					{
						displayName: 'Attachments',
						name: 'attachmentsUi',
						placeholder: 'Add Attachments',
						type: 'fixedCollection',
						typeOptions: {
							multipleValues: false,
						},
						options: [
							{
								name: 'attachmentsBinary',
								displayName: 'Attachments Binary',
								values: [
									{
										displayName: 'Property Name',
										name: 'property',
										type: 'string',
										placeholder: 'data',
										default: '',
										description:
											'Name of the binary properties which contain data which should be added as attachment',
									},
								],
							},
						],
						default: {},
					},
					{
						displayName: 'External ID',
						name: 'externalId',
						type: 'string',
						default: '',
						description:
							'If the event originates from a record in a 3rd party system, use this parameter to pass the unique ID of that record. That ID will be communicated in outbound webhook notifications from SIGNL4, which is great for correlation/synchronization of that record with the alert. If you resolve / close an alert you must use the same External ID as in the original alert.',
					},
					{
						displayName: 'Filtering',
						name: 'filtering',
						type: 'boolean',
						default: false,
						description:
							'Whether to apply event filtering for this event, or not. If set to true, the event will only trigger a notification to the team, if it contains at least one keyword from one of your services and system categories (i.e. it is whitelisted)',
					},
					{
						displayName: 'Location',
						name: 'locationFieldsUi',
						type: 'fixedCollection',
						placeholder: 'Add Location',
						default: {},
						description:
							"Transmit location information ('latitude, longitude') with your event and display a map in the mobile app",
						options: [
							{
								name: 'locationFieldsValues',
								displayName: 'Location',
								values: [
									{
										displayName: 'Latitude',
										name: 'latitude',
										type: 'string',
										required: true,
										description: 'The location latitude',
										default: '',
									},
									{
										displayName: 'Longitude',
										name: 'longitude',
										type: 'string',
										required: true,
										description: 'The location longitude',
										default: '',
									},
								],
							},
						],
					},
					{
						displayName: 'Service',
						name: 'service',
						type: 'string',
						default: '',
						description: 'Assigns the alert to the service/system category with the specified name',
					},
					{
						displayName: 'Title',
						name: 'title',
						type: 'string',
						default: '',
						description: 'The title or subject of this alert',
					},
				],
			},
			{
				displayName: 'External ID',
				name: 'externalId',
				type: 'string',
				default: '',
				displayOptions: {
					show: {
						operation: ['resolve'],
						resource: ['alert'],
					},
				},
				description:
					'If the event originates from a record in a 3rd party system, use this parameter to pass the unique ID of that record. That ID will be communicated in outbound webhook notifications from SIGNL4, which is great for correlation/synchronization of that record with the alert. If you resolve / close an alert you must use the same External ID as in the original alert.',
			},
		],
	};

	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
		const items = this.getInputData();
		const returnData: IDataObject[] = [];
		const length = items.length;
		let responseData;
		const resource = this.getNodeParameter('resource', 0);
		const operation = this.getNodeParameter('operation', 0);
		for (let i = 0; i < length; i++) {
			try {
				if (resource === 'alert') {
					//https://connect.signl4.com/webhook/docs/index.html
					// Send alert
					if (operation === 'send') {
						const message = this.getNodeParameter('message', i) as string;
						const additionalFields = this.getNodeParameter('additionalFields', i);

						const data: IDataObject = {
							message,
						};

						if (additionalFields.title) {
							data.title = additionalFields.title as string;
						}

						if (additionalFields.service) {
							data.service = additionalFields.service as string;
						}
						if (additionalFields.locationFieldsUi) {
							const locationUi = (additionalFields.locationFieldsUi as IDataObject)
								.locationFieldsValues as IDataObject;
							if (locationUi) {
								data['X-S4-Location'] = `${locationUi.latitude},${locationUi.longitude}`;
							}
						}

						if (additionalFields.alertingScenario) {
							data['X-S4-AlertingScenario'] = additionalFields.alertingScenario as string;
						}

						if (additionalFields.filtering) {
							data['X-S4-Filtering'] = (additionalFields.filtering as boolean).toString();
						}

						if (additionalFields.externalId) {
							data['X-S4-ExternalID'] = additionalFields.externalId as string;
						}

						data['X-S4-Status'] = 'new';

						data['X-S4-SourceSystem'] = 'n8n';

						// Attachments
						const attachments = additionalFields.attachmentsUi as IDataObject;
						if (attachments?.attachmentsBinary) {
							const propertyName = (attachments.attachmentsBinary as IDataObject)
								.property as string;

							const binaryData = this.helpers.assertBinaryData(i, propertyName);

							if (binaryData) {
								const supportedFileExtension = ['png', 'jpg', 'jpeg', 'bmp', 'gif', 'mp3', 'wav'];

								if (!supportedFileExtension.includes(binaryData.fileExtension as string)) {
									throw new NodeOperationError(
										this.getNode(),
										`Invalid extension, just ${supportedFileExtension.join(',')} are supported}`,
										{ itemIndex: i },
									);
								}

								const binaryDataBuffer = await this.helpers.getBinaryDataBuffer(i, propertyName);
								data.attachment = {
									value: binaryDataBuffer,
									options: {
										filename: binaryData.fileName,
										contentType: binaryData.mimeType,
									},
								};
							}
						}

						responseData = await SIGNL4ApiRequest.call(
							this,
							'POST',
							'',
							{},
							{
								formData: data,
							},
						);
					}
					// Resolve alert
					if (operation === 'resolve') {
						const data: IDataObject = {};

						data['X-S4-ExternalID'] = this.getNodeParameter('externalId', i) as string;

						data['X-S4-Status'] = 'resolved';

						data['X-S4-SourceSystem'] = 'n8n';

						responseData = await SIGNL4ApiRequest.call(
							this,
							'POST',
							'',
							{},
							{
								formData: data,
							},
						);
					}
				}
				if (Array.isArray(responseData)) {
					returnData.push.apply(returnData, responseData as IDataObject[]);
				} else if (responseData !== undefined) {
					returnData.push(responseData as IDataObject);
				}
			} catch (error) {
				if (this.continueOnFail()) {
					returnData.push({ error: error.message });
					continue;
				}
				throw error;
			}
		}
		return [this.helpers.returnJsonArray(returnData)];
	}
}