✨ Add Grist node (#2158)

* Implement Grist node with List/Append/Update/Delete operations

* 🔨 Refactor Grist node

* 🔨 Make API key required

* 🔨 Complete create/upate operations

* 🔨 Fix item index in docId and tableId

* 🔨 Simplify continueOnFail item

* 👕 Nodelinter pass

* 👕 Fix lint

* 👕 Resort imports

* ⚡ Improvements

* 🔨 Simplify with optional access operator

* 🔨 Simplify row ID processing in deletion

* 🚧 Add stub for cred test

Pending change to core

* ⚡ Add workaround for cred test

* 🔥 Remove excess items check

* ✏️ Rename fields

* 🐛 Fix numeric filter

* ✏️ Add feedback from Product

* 🔥 Remove superfluous key

* ⚡ Small change

* ⚡ Fix subtitle and improve how data gets returned

Co-authored-by: Alex Hall <alex.mojaki@gmail.com>
Co-authored-by: ricardo <ricardoespinoza105@gmail.com>
Co-authored-by: Jan Oberhauser <jan.oberhauser@gmail.com>

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

@@ -0,0 +1,109 @@
+import {
+	IExecuteFunctions,
+	ILoadOptionsFunctions,
+} from 'n8n-core';
+
+import {
+	OptionsWithUri,
+} from 'request';
+
+import {
+	IDataObject,
+	NodeApiError,
+	NodeOperationError,
+} from 'n8n-workflow';
+
+import {
+	GristCredentials,
+	GristDefinedFields,
+	GristFilterProperties,
+	GristSortProperties,
+} from './types';
+
+export async function gristApiRequest(
+	this: IExecuteFunctions | ILoadOptionsFunctions,
+	method: string,
+	endpoint: string,
+	body: IDataObject | number[] = {},
+	qs: IDataObject = {},
+) {
+	const {
+		apiKey,
+		planType,
+		customSubdomain,
+	} = await this.getCredentials('gristApi') as GristCredentials;
+
+	const subdomain = planType === 'free' ? 'docs' : customSubdomain;
+
+	const options: OptionsWithUri = {
+		headers: {
+			Authorization: `Bearer ${apiKey}`,
+		},
+		method,
+		uri: `https://${subdomain}.getgrist.com/api${endpoint}`,
+		qs,
+		body,
+		json: true,
+	};
+
+	if (!Object.keys(body).length) {
+		delete options.body;
+	}
+
+	if (!Object.keys(qs).length) {
+		delete options.qs;
+	}
+
+	try {
+		return await this.helpers.request!(options);
+	} catch (error) {
+		throw new NodeApiError(this.getNode(), error);
+	}
+}
+
+export function parseSortProperties(sortProperties: GristSortProperties) {
+	return sortProperties.reduce((acc, cur, curIdx) => {
+		if (cur.direction === 'desc') acc += '-';
+		acc += cur.field;
+		if (curIdx !== sortProperties.length - 1) acc += ',';
+		return acc;
+	}, '');
+}
+
+export function parseFilterProperties(filterProperties: GristFilterProperties) {
+	return filterProperties.reduce<{ [key: string]: Array<string | number>; }>((acc, cur) => {
+		acc[cur.field] = acc[cur.field] ?? [];
+		const values = isNaN(Number(cur.values)) ? cur.values : Number(cur.values);
+		acc[cur.field].push(values);
+		return acc;
+	}, {});
+}
+
+export function parseDefinedFields(fieldsToSendProperties: GristDefinedFields) {
+	return fieldsToSendProperties.reduce<{ [key: string]: string; }>((acc, cur) => {
+		acc[cur.fieldId] = cur.fieldValue;
+		return acc;
+	}, {});
+}
+
+export function parseAutoMappedInputs(
+	incomingKeys: string[],
+	inputsToIgnore: string[],
+	item: any, // tslint:disable-line:no-any
+) {
+	return incomingKeys.reduce<{ [key: string]: any; }>((acc, curKey) => { // tslint:disable-line:no-any
+		if (inputsToIgnore.includes(curKey)) return acc;
+		acc = { ...acc, [curKey]: item[curKey] };
+		return acc;
+	}, {});
+}
+
+export function throwOnZeroDefinedFields(this: IExecuteFunctions, fields: GristDefinedFields) {
+	if (!fields?.length) {
+		throw new NodeOperationError(
+			this.getNode(),
+			'No defined data found. Please specify the data to send in \'Fields to Send\'.',
+		);
+	}
+}
+