first commit

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/create.operation.ts

@@ -0,0 +1,64 @@
+import type { IDataObject, IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { contactFields } from '../../descriptions';
+import { prepareContactFields } from '../../helpers/utils';
+import { microsoftApiRequest } from '../../transport';
+
+export const properties: INodeProperties[] = [
+	{
+		displayName: 'First Name',
+		name: 'givenName',
+		type: 'string',
+		default: '',
+		required: true,
+	},
+	{
+		displayName: 'Last Name',
+		name: 'surname',
+		type: 'string',
+		default: '',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		options: contactFields,
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['contact'],
+		operation: ['create'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, index: number) {
+	const additionalFields = this.getNodeParameter('additionalFields', index);
+	const givenName = this.getNodeParameter('givenName', index) as string;
+	const surname = this.getNodeParameter('surname', index) as string;
+
+	const body: IDataObject = {
+		givenName,
+		...prepareContactFields(additionalFields),
+	};
+
+	if (surname) {
+		body.surname = surname;
+	}
+
+	const responseData = await microsoftApiRequest.call(this, 'POST', '/contacts', body);
+
+	const executionData = this.helpers.constructExecutionMetaData(
+		this.helpers.returnJsonArray(responseData as IDataObject),
+		{ itemData: { item: index } },
+	);
+
+	return executionData;
+}

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/delete.operation.ts

@@ -0,0 +1,31 @@
+import type { IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { contactRLC } from '../../descriptions';
+import { microsoftApiRequest } from '../../transport';
+
+export const properties: INodeProperties[] = [contactRLC];
+
+const displayOptions = {
+	show: {
+		resource: ['contact'],
+		operation: ['delete'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, index: number) {
+	const contactId = this.getNodeParameter('contactId', index, undefined, {
+		extractValue: true,
+	}) as string;
+	await microsoftApiRequest.call(this, 'DELETE', `/contacts/${contactId}`);
+
+	const executionData = this.helpers.constructExecutionMetaData(
+		this.helpers.returnJsonArray({ success: true }),
+		{ itemData: { item: index } },
+	);
+
+	return executionData;
+}

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/get.operation.ts

@@ -0,0 +1,87 @@
+import type { IDataObject, IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { contactRLC } from '../../descriptions';
+import { contactFields } from '../../helpers/utils';
+import { microsoftApiRequest } from '../../transport';
+
+export const properties: INodeProperties[] = [
+	contactRLC,
+	{
+		displayName: 'Output',
+		name: 'output',
+		type: 'options',
+		default: 'simple',
+		options: [
+			{
+				name: 'Simplified',
+				value: 'simple',
+			},
+			{
+				name: 'Raw',
+				value: 'raw',
+			},
+			{
+				name: 'Select Included Fields',
+				value: 'fields',
+			},
+		],
+	},
+	{
+		displayName: 'Fields',
+		name: 'fields',
+		type: 'multiOptions',
+		description: 'The fields to add to the output',
+		displayOptions: {
+			show: {
+				output: ['fields'],
+			},
+		},
+		options: contactFields,
+		default: [],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['contact'],
+		operation: ['get'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, index: number) {
+	const qs: IDataObject = {};
+
+	const contactId = this.getNodeParameter('contactId', index, undefined, {
+		extractValue: true,
+	}) as string;
+
+	const output = this.getNodeParameter('output', index) as string;
+
+	if (output === 'fields') {
+		const fields = this.getNodeParameter('fields', index) as string[];
+		qs.$select = fields.join(',');
+	}
+
+	if (output === 'simple') {
+		qs.$select = 'id,displayName,emailAddresses,businessPhones,mobilePhone';
+	}
+
+	const responseData = await microsoftApiRequest.call(
+		this,
+		'GET',
+		`/contacts/${contactId}`,
+		undefined,
+		qs,
+	);
+
+	const executionData = this.helpers.constructExecutionMetaData(
+		this.helpers.returnJsonArray(responseData as IDataObject),
+		{ itemData: { item: index } },
+	);
+
+	return executionData;
+}

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/getAll.operation.ts

@@ -0,0 +1,139 @@
+import type { IDataObject, IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { returnAllOrLimit } from '../../descriptions';
+import { contactFields } from '../../helpers/utils';
+import { microsoftApiRequest, microsoftApiRequestAllItems } from '../../transport';
+
+export const properties: INodeProperties[] = [
+	...returnAllOrLimit,
+	{
+		displayName: 'Output',
+		name: 'output',
+		type: 'options',
+		default: 'simple',
+		options: [
+			{
+				name: 'Simplified',
+				value: 'simple',
+			},
+			{
+				name: 'Raw',
+				value: 'raw',
+			},
+			{
+				name: 'Select Included Fields',
+				value: 'fields',
+			},
+		],
+	},
+	{
+		displayName: 'Fields',
+		name: 'fields',
+		type: 'multiOptions',
+		description: 'The fields to add to the output',
+		displayOptions: {
+			show: {
+				output: ['fields'],
+			},
+		},
+		options: contactFields,
+		default: [],
+	},
+	{
+		displayName: 'Filters',
+		name: 'filters',
+		type: 'collection',
+		placeholder: 'Add Filter',
+		default: {},
+		options: [
+			{
+				displayName: 'Filter Query',
+				name: 'custom',
+				type: 'string',
+				default: '',
+				placeholder: "e.g. displayName eq 'John Doe'",
+				hint: 'Search query to filter contacts. <a href="https://learn.microsoft.com/en-us/graph/filter-query-parameter">More info</a>.',
+			},
+			{
+				displayName: 'Email Address',
+				name: 'emailAddress',
+				type: 'string',
+				default: '',
+				description:
+					'If contacts that you want to retrieve have multiple email addresses, you can enter them separated by commas',
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['contact'],
+		operation: ['getAll'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, index: number) {
+	let responseData;
+	const qs = {} as IDataObject;
+
+	const returnAll = this.getNodeParameter('returnAll', index);
+	const filters = this.getNodeParameter('filters', index, {});
+	const output = this.getNodeParameter('output', index) as string;
+
+	if (output === 'fields') {
+		const fields = this.getNodeParameter('fields', index) as string[];
+		qs.$select = fields.join(',');
+	}
+
+	if (output === 'simple') {
+		qs.$select = 'id,displayName,emailAddresses,businessPhones,mobilePhone';
+	}
+
+	if (Object.keys(filters).length) {
+		const filterString: string[] = [];
+
+		if (filters.emailAddress) {
+			const emails = (filters.emailAddress as string)
+				.split(',')
+				.map((email) => `emailAddresses/any(a:a/address eq '${email.trim()}')`);
+			filterString.push(emails.join(' and '));
+		}
+
+		if (filters.custom) {
+			filterString.push(filters.custom as string);
+		}
+
+		if (filterString.length) {
+			qs.$filter = filterString.join(' and ');
+		}
+	}
+
+	const endpoint = '/contacts';
+
+	if (returnAll) {
+		responseData = await microsoftApiRequestAllItems.call(
+			this,
+			'value',
+			'GET',
+			endpoint,
+			undefined,
+			qs,
+		);
+	} else {
+		qs.$top = this.getNodeParameter('limit', index);
+		responseData = await microsoftApiRequest.call(this, 'GET', endpoint, undefined, qs);
+		responseData = responseData.value;
+	}
+
+	const executionData = this.helpers.constructExecutionMetaData(
+		this.helpers.returnJsonArray(responseData as IDataObject[]),
+		{ itemData: { item: index } },
+	);
+
+	return executionData;
+}

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/index.ts

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

packages/nodes-base/nodes/Microsoft/Outlook/v2/actions/contact/update.operation.ts

@@ -0,0 +1,51 @@
+import type { IDataObject, IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+
+import { updateDisplayOptions } from '@utils/utilities';
+
+import { contactFields, contactRLC } from '../../descriptions';
+import { prepareContactFields } from '../../helpers/utils';
+import { microsoftApiRequest } from '../../transport';
+
+export const properties: INodeProperties[] = [
+	contactRLC,
+	{
+		displayName: 'Update Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		options: contactFields,
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['contact'],
+		operation: ['update'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);
+
+export async function execute(this: IExecuteFunctions, index: number) {
+	const additionalFields = this.getNodeParameter('additionalFields', index);
+	const contactId = this.getNodeParameter('contactId', index, undefined, {
+		extractValue: true,
+	}) as string;
+
+	const body: IDataObject = prepareContactFields(additionalFields);
+
+	const responseData = await microsoftApiRequest.call(
+		this,
+		'PATCH',
+		`/contacts/${contactId}`,
+		body,
+	);
+
+	const executionData = this.helpers.constructExecutionMetaData(
+		this.helpers.returnJsonArray(responseData as IDataObject),
+		{ itemData: { item: index } },
+	);
+
+	return executionData;
+}