Initial commit to release

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

@@ -0,0 +1,62 @@
+import {
+	IExecuteFunctions,
+	IHookFunctions,
+} from 'n8n-core';
+
+import {
+	IDataObject,
+} from 'n8n-workflow';
+
+/**
+ * Make an API request to Twilio
+ *
+ * @param {IHookFunctions} this
+ * @param {string} method
+ * @param {string} url
+ * @param {object} body
+ * @returns {Promise<any>}
+ */
+export async function twilioApiRequest(this: IHookFunctions | IExecuteFunctions, method: string, endpoint: string, body: IDataObject, query?: IDataObject): Promise<any> { // tslint:disable-line:no-any
+	const credentials = this.getCredentials('twilioApi');
+	if (credentials === undefined) {
+		throw new Error('No credentials got returned!');
+	}
+
+	if (query === undefined) {
+		query = {};
+	}
+
+	const options = {
+		method,
+		form: body,
+		qs: query,
+		uri: `https://api.twilio.com/2010-04-01/Accounts/${credentials.accountSid}${endpoint}`,
+		auth: {
+			user: credentials.accountSid as string,
+			pass: credentials.authToken as string,
+		},
+		json: true
+	};
+
+	try {
+		return this.helpers.request(options);
+	} catch (error) {
+		if (error.statusCode === 401) {
+			// Return a clear error
+			throw new Error('The Twilio credentials are not valid!');
+		}
+
+		if (error.response && error.response.body && error.response.body.message) {
+			// Try to return the error prettier
+			let errorMessage = `Twilio error response [${error.statusCode}]: ${error.response.body.message}`;
+			if (error.response.body.more_info) {
+				errorMessage = `errorMessage (${error.response.body.more_info})`;
+			}
+
+			throw new Error(errorMessage);
+		}
+
+		// If that data does not exist for some reason return the actual error
+		throw error;
+	}
+}

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

@@ -0,0 +1,171 @@
+import {
+	IExecuteFunctions,
+} from 'n8n-core';
+import {
+	IDataObject,
+	INodeTypeDescription,
+	INodeExecutionData,
+	INodeType,
+} from 'n8n-workflow';
+
+import {
+	twilioApiRequest,
+} from './GenericFunctions';
+
+import { OptionsWithUri } from 'request';
+
+export class Twilio implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Twilio',
+		name: 'twilio',
+		icon: 'file:twilio.png',
+		group: ['transform'],
+		version: 1,
+		description: 'Send SMS and WhatsApp messages or make phone calls',
+		defaults: {
+			name: 'Twilio',
+			color: '#cf272d',
+		},
+		inputs: ['main'],
+		outputs: ['main'],
+		credentials: [
+			{
+				name: 'twilioApi',
+				required: true,
+			}
+		],
+		properties: [
+			{
+				displayName: 'Operation',
+				name: 'operation',
+				type: 'options',
+				options: [
+					{
+						name: 'Send Message',
+						value: 'sendMessage',
+						description: 'Send SMS/MMS/WhatsApp message',
+					},
+				],
+				default: 'sendMessage',
+				description: 'The operation to perform.',
+			},
+
+
+			// ----------------------------------
+			//         sendMessage
+			// ----------------------------------
+			{
+				displayName: 'From',
+				name: 'from',
+				type: 'string',
+				default: '',
+				placeholder: '+14155238886',
+				required: true,
+				displayOptions: {
+					show: {
+						operation: [
+							'sendMessage',
+						],
+					},
+				},
+				description: 'The number from which to send the message',
+			},
+			{
+				displayName: 'To',
+				name: 'to',
+				type: 'string',
+				default: '',
+				placeholder: '+14155238886',
+				required: true,
+				displayOptions: {
+					show: {
+						operation: [
+							'sendMessage',
+						],
+					},
+				},
+				description: 'The number to which to send the message',
+			},
+			{
+				displayName: 'To Whatsapp',
+				name: 'toWhatsapp',
+				type: 'boolean',
+				default: false,
+				displayOptions: {
+					show: {
+						operation: [
+							'sendMessage',
+						],
+					},
+				},
+				description: 'If the message should be send to WhatsApp',
+			},
+			{
+				displayName: 'Message',
+				name: 'message',
+				type: 'string',
+				default: '',
+				required: true,
+				displayOptions: {
+					show: {
+						operation: [
+							'sendMessage',
+						],
+					},
+				},
+				description: 'The message to send',
+			},
+		],
+	};
+
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: IDataObject[] = [];
+
+		const operation = this.getNodeParameter('operation', 0) as string;
+
+		// For Post
+		let body: IDataObject;
+		// For Query string
+		let qs: IDataObject;
+
+		let requestMethod: string;
+		let endpoint: string;
+
+		for (let i = 0; i < items.length; i++) {
+			requestMethod = 'GET';
+			endpoint = '';
+			body = {};
+			qs = {};
+
+			if (operation === 'sendMessage') {
+				// ----------------------------------
+				//         sendMessage
+				// ----------------------------------
+
+				requestMethod = 'POST';
+				endpoint = '/Messages.json';
+
+				body.From = this.getNodeParameter('from', i) as string;
+				body.To = this.getNodeParameter('to', i) as string;
+				body.Body = this.getNodeParameter('message', i) as string;
+
+				const toWhatsapp = this.getNodeParameter('toWhatsapp', i) as boolean;
+
+				if (toWhatsapp === true) {
+					body.From = `whatsapp:${body.From}`;
+					body.To = `whatsapp:${body.To}`;
+				}
+			} else {
+				throw new Error(`The operation "${operation}" is not known!`);
+			}
+
+			const responseData = await twilioApiRequest.call(this, requestMethod, endpoint, body, qs);
+
+			returnData.push(responseData as IDataObject);
+		}
+
+		return [this.helpers.returnJsonArray(returnData)];
+	}
+}