first commit

packages/nodes-base/nodes/Google/Docs/GenericFunctions.ts

@@ -0,0 +1,90 @@
+import type {
+	IDataObject,
+	IExecuteFunctions,
+	IHttpRequestMethods,
+	ILoadOptionsFunctions,
+	IRequestOptions,
+	JsonObject,
+} from 'n8n-workflow';
+import { NodeApiError } from 'n8n-workflow';
+
+import { getGoogleAccessToken } from '../GenericFunctions';
+
+export async function googleApiRequest(
+	this: IExecuteFunctions | ILoadOptionsFunctions,
+	method: IHttpRequestMethods,
+	endpoint: string,
+	body: IDataObject = {},
+	qs?: IDataObject,
+	uri?: string,
+) {
+	const authenticationMethod = this.getNodeParameter(
+		'authentication',
+		0,
+		'serviceAccount',
+	) as string;
+
+	const options: IRequestOptions = {
+		headers: {
+			'Content-Type': 'application/json',
+		},
+		method,
+		body,
+		qs,
+		uri: uri || `https://docs.googleapis.com/v1${endpoint}`,
+		json: true,
+	};
+
+	if (!Object.keys(body).length) {
+		delete options.body;
+	}
+	try {
+		if (authenticationMethod === 'serviceAccount') {
+			const credentials = await this.getCredentials('googleApi');
+
+			const { access_token } = await getGoogleAccessToken.call(this, credentials, 'docs');
+
+			options.headers!.Authorization = `Bearer ${access_token}`;
+			return await this.helpers.request(options);
+		} else {
+			return await this.helpers.requestOAuth2.call(this, 'googleDocsOAuth2Api', options);
+		}
+	} catch (error) {
+		throw new NodeApiError(this.getNode(), error as JsonObject);
+	}
+}
+
+export async function googleApiRequestAllItems(
+	this: IExecuteFunctions | ILoadOptionsFunctions,
+	propertyName: string,
+	method: IHttpRequestMethods,
+	endpoint: string,
+	body: IDataObject = {},
+	qs?: IDataObject,
+	uri?: string,
+): Promise<any> {
+	const returnData: IDataObject[] = [];
+
+	let responseData;
+	const query: IDataObject = { ...qs };
+	query.maxResults = 100;
+	query.pageSize = 100;
+
+	do {
+		responseData = await googleApiRequest.call(this, method, endpoint, body, query, uri);
+		query.pageToken = responseData.nextPageToken;
+		returnData.push.apply(returnData, responseData[propertyName] as IDataObject[]);
+	} while (responseData.nextPageToken !== undefined && responseData.nextPageToken !== '');
+
+	return returnData;
+}
+
+export const hasKeys = (obj = {}) => Object.keys(obj).length > 0;
+export const extractID = (url: string) => {
+	const regex = new RegExp('https://docs.google.com/document/d/([a-zA-Z0-9-_]+)/');
+	const results = regex.exec(url);
+	return results ? results[1] : undefined;
+};
+export const upperFirst = (str: string) => {
+	return str[0].toUpperCase() + str.substr(1);
+};

packages/nodes-base/nodes/Google/Docs/GoogleDocs.node.json

@@ -0,0 +1,18 @@
+{
+	"node": "n8n-nodes-base.googleDocs",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Miscellaneous"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/credentials/google/oauth-single-service/"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.googledocs/"
+			}
+		]
+	}
+}

packages/nodes-base/nodes/Google/Docs/GoogleDocs.node.ts

@@ -0,0 +1,533 @@
+import type {
+	IExecuteFunctions,
+	ILoadOptionsFunctions,
+	IDataObject,
+	INodeExecutionData,
+	INodePropertyOptions,
+	INodeType,
+	INodeTypeDescription,
+	JsonObject,
+} from 'n8n-workflow';
+import { NodeApiError, NodeConnectionTypes } from 'n8n-workflow';
+
+import { documentFields, documentOperations } from './DocumentDescription';
+import {
+	extractID,
+	googleApiRequest,
+	googleApiRequestAllItems,
+	hasKeys,
+	upperFirst,
+} from './GenericFunctions';
+import type { IUpdateBody, IUpdateFields } from './interfaces';
+
+export class GoogleDocs implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Google Docs',
+		name: 'googleDocs',
+		icon: 'file:googleDocs.svg',
+		group: ['input'],
+		version: [1, 2],
+		subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+		description: 'Consume Google Docs API.',
+		schemaPath: 'Google/Docs',
+		defaults: {
+			name: 'Google Docs',
+		},
+		inputs: [NodeConnectionTypes.Main],
+		outputs: [NodeConnectionTypes.Main],
+		usableAsTool: true,
+		credentials: [
+			{
+				name: 'googleApi',
+				required: true,
+				displayOptions: {
+					show: {
+						authentication: ['serviceAccount'],
+					},
+				},
+			},
+			{
+				name: 'googleDocsOAuth2Api',
+				required: true,
+				displayOptions: {
+					show: {
+						authentication: ['oAuth2'],
+					},
+				},
+			},
+		],
+		properties: [
+			{
+				displayName: 'Authentication',
+				name: 'authentication',
+				type: 'options',
+				options: [
+					{
+						name: 'Service Account',
+						value: 'serviceAccount',
+					},
+					{
+						name: 'OAuth2',
+						value: 'oAuth2',
+					},
+				],
+				default: 'serviceAccount',
+				displayOptions: {
+					show: {
+						'@version': [1],
+					},
+				},
+			},
+			{
+				displayName: 'Authentication',
+				name: 'authentication',
+				type: 'options',
+				options: [
+					{
+						// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
+						name: 'OAuth2 (recommended)',
+						value: 'oAuth2',
+					},
+					{
+						name: 'Service Account',
+						value: 'serviceAccount',
+					},
+				],
+				default: 'oAuth2',
+				displayOptions: {
+					show: {
+						'@version': [2],
+					},
+				},
+			},
+			{
+				displayName: 'Resource',
+				name: 'resource',
+				type: 'options',
+				noDataExpression: true,
+				options: [
+					{
+						name: 'Document',
+						value: 'document',
+					},
+				],
+				default: 'document',
+			},
+			...documentOperations,
+			...documentFields,
+		],
+	};
+
+	methods = {
+		loadOptions: {
+			// Get all the drives to display them to user so that they can
+			// select them easily
+			async getDrives(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
+				const returnData: INodePropertyOptions[] = [
+					{
+						name: 'My Drive',
+						value: 'myDrive',
+					},
+					{
+						name: 'Shared with Me',
+						value: 'sharedWithMe',
+					},
+				];
+				let drives;
+				try {
+					drives = await googleApiRequestAllItems.call(
+						this,
+						'drives',
+						'GET',
+						'',
+						{},
+						{},
+						'https://www.googleapis.com/drive/v3/drives',
+					);
+				} catch (error) {
+					throw new NodeApiError(this.getNode(), error as JsonObject, {
+						message: 'Error in loading Drives',
+					});
+				}
+
+				for (const drive of drives) {
+					returnData.push({
+						name: drive.name as string,
+						value: drive.id as string,
+					});
+				}
+				return returnData;
+			},
+			async getFolders(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
+				const returnData: INodePropertyOptions[] = [
+					{
+						name: '/',
+						value: 'default',
+					},
+				];
+				const driveId = this.getNodeParameter('driveId');
+
+				const qs = {
+					q: `mimeType = \'application/vnd.google-apps.folder\' ${
+						driveId === 'sharedWithMe' ? 'and sharedWithMe = true' : " and 'root' in parents"
+					}`,
+					...(driveId && driveId !== 'myDrive' && driveId !== 'sharedWithMe' ? { driveId } : {}),
+				};
+				let folders;
+
+				try {
+					folders = await googleApiRequestAllItems.call(
+						this,
+						'files',
+						'GET',
+						'',
+						{},
+						qs,
+						'https://www.googleapis.com/drive/v3/files',
+					);
+				} catch (error) {
+					throw new NodeApiError(this.getNode(), error as JsonObject, {
+						message: 'Error in loading Folders',
+					});
+				}
+
+				for (const folder of folders) {
+					returnData.push({
+						name: folder.name as string,
+						value: folder.id as string,
+					});
+				}
+				return returnData;
+			},
+		},
+	};
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: INodeExecutionData[] = [];
+		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 === 'document') {
+					if (operation === 'create') {
+						// https://developers.google.com/docs/api/reference/rest/v1/documents/create
+
+						const folderId = this.getNodeParameter('folderId', i) as string;
+
+						const body: IDataObject = {
+							name: this.getNodeParameter('title', i) as string,
+							mimeType: 'application/vnd.google-apps.document',
+							...(folderId && folderId !== 'default' ? { parents: [folderId] } : {}),
+						};
+
+						responseData = await googleApiRequest.call(
+							this,
+							'POST',
+							'',
+							body,
+							{},
+							'https://www.googleapis.com/drive/v3/files',
+						);
+					} else if (operation === 'get') {
+						// https://developers.google.com/docs/api/reference/rest/v1/documents/get
+
+						const documentURL = this.getNodeParameter('documentURL', i) as string;
+						const simple = this.getNodeParameter('simple', i) as boolean;
+						let documentId = extractID(documentURL);
+
+						if (!documentId) {
+							documentId = documentURL;
+						}
+						responseData = await googleApiRequest.call(this, 'GET', `/documents/${documentId}`);
+						if (simple) {
+							const content = (responseData.body.content as IDataObject[])
+								.reduce((arr: string[], contentItem) => {
+									if (contentItem?.paragraph) {
+										const texts = (
+											(contentItem.paragraph as IDataObject).elements as IDataObject[]
+										).map((element) => {
+											if (element?.textRun) {
+												return (element.textRun as IDataObject).content as string;
+											}
+										}) as string[];
+										arr = [...arr, ...texts];
+									}
+									return arr;
+								}, [])
+								.join('');
+
+							responseData = {
+								documentId,
+								content,
+							};
+						}
+					} else if (operation === 'update') {
+						// https://developers.google.com/docs/api/reference/rest/v1/documents/batchUpdate
+
+						const documentURL = this.getNodeParameter('documentURL', i) as string;
+						let documentId = extractID(documentURL);
+						const simple = this.getNodeParameter('simple', i) as boolean;
+						const actionsUi = this.getNodeParameter('actionsUi', i) as {
+							actionFields: IDataObject[];
+						};
+						const { writeControlObject } = this.getNodeParameter(
+							'updateFields',
+							i,
+						) as IUpdateFields;
+
+						if (!documentId) {
+							documentId = documentURL;
+						}
+
+						const body = {
+							requests: [],
+						} as IUpdateBody;
+
+						if (hasKeys(writeControlObject)) {
+							const { control, value } = writeControlObject;
+							body.writeControl = {
+								[control]: value,
+							};
+						}
+
+						if (actionsUi) {
+							let requestBody: IDataObject;
+							actionsUi.actionFields.forEach((actionField) => {
+								const { action, object } = actionField;
+								if (object === 'positionedObject') {
+									if (action === 'delete') {
+										requestBody = {
+											objectId: actionField.objectId,
+										};
+									}
+								} else if (object === 'pageBreak') {
+									if (action === 'insert') {
+										const { insertSegment, segmentId, locationChoice, index } = actionField;
+										requestBody = {
+											[locationChoice as string]: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												...(locationChoice === 'location' ? { index } : {}),
+											},
+										};
+									}
+								} else if (object === 'table') {
+									if (action === 'insert') {
+										const { rows, columns, insertSegment, locationChoice, segmentId, index } =
+											actionField;
+										requestBody = {
+											rows,
+											columns,
+											[locationChoice as string]: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												...(locationChoice === 'location' ? { index } : {}),
+											},
+										};
+									}
+								} else if (object === 'footer') {
+									if (action === 'create') {
+										const { insertSegment, locationChoice, segmentId, index } = actionField;
+										requestBody = {
+											type: 'DEFAULT',
+											sectionBreakLocation: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												...(locationChoice === 'location' ? { index } : {}),
+											},
+										};
+									} else if (action === 'delete') {
+										requestBody = {
+											footerId: actionField.footerId,
+										};
+									}
+								} else if (object === 'header') {
+									if (action === 'create') {
+										const { insertSegment, locationChoice, segmentId, index } = actionField;
+										requestBody = {
+											type: 'DEFAULT',
+											sectionBreakLocation: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												...(locationChoice === 'location' ? { index } : {}),
+											},
+										};
+									} else if (action === 'delete') {
+										requestBody = {
+											headerId: actionField.headerId,
+										};
+									}
+								} else if (object === 'tableColumn') {
+									if (action === 'insert') {
+										const {
+											insertPosition,
+											rowIndex,
+											columnIndex,
+											insertSegment,
+											segmentId,
+											index,
+										} = actionField;
+										requestBody = {
+											insertRight: insertPosition,
+											tableCellLocation: {
+												rowIndex,
+												columnIndex,
+												tableStartLocation: {
+													segmentId: insertSegment !== 'body' ? segmentId : '',
+													index,
+												},
+											},
+										};
+									} else if (action === 'delete') {
+										const { rowIndex, columnIndex, insertSegment, segmentId, index } = actionField;
+										requestBody = {
+											tableCellLocation: {
+												rowIndex,
+												columnIndex,
+												tableStartLocation: {
+													segmentId: insertSegment !== 'body' ? segmentId : '',
+													index,
+												},
+											},
+										};
+									}
+								} else if (object === 'tableRow') {
+									if (action === 'insert') {
+										const {
+											insertPosition,
+											rowIndex,
+											columnIndex,
+											insertSegment,
+											segmentId,
+											index,
+										} = actionField;
+										requestBody = {
+											insertBelow: insertPosition,
+											tableCellLocation: {
+												rowIndex,
+												columnIndex,
+												tableStartLocation: {
+													segmentId: insertSegment !== 'body' ? segmentId : '',
+													index,
+												},
+											},
+										};
+									} else if (action === 'delete') {
+										const { rowIndex, columnIndex, insertSegment, segmentId, index } = actionField;
+										requestBody = {
+											tableCellLocation: {
+												rowIndex,
+												columnIndex,
+												tableStartLocation: {
+													segmentId: insertSegment !== 'body' ? segmentId : '',
+													index,
+												},
+											},
+										};
+									}
+								} else if (object === 'text') {
+									if (action === 'insert') {
+										const { text, locationChoice, insertSegment, segmentId, index } = actionField;
+										requestBody = {
+											text,
+											[locationChoice as string]: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												...(locationChoice === 'location' ? { index } : {}),
+											},
+										};
+									} else if (action === 'replaceAll') {
+										const { text, replaceText, matchCase } = actionField;
+										requestBody = {
+											replaceText,
+											containsText: { text, matchCase },
+										};
+									}
+								} else if (object === 'paragraphBullets') {
+									if (action === 'create') {
+										const { bulletPreset, startIndex, insertSegment, segmentId, endIndex } =
+											actionField;
+										requestBody = {
+											bulletPreset,
+											range: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												startIndex,
+												endIndex,
+											},
+										};
+									} else if (action === 'delete') {
+										const { startIndex, insertSegment, segmentId, endIndex } = actionField;
+										requestBody = {
+											range: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												startIndex,
+												endIndex,
+											},
+										};
+									}
+								} else if (object === 'namedRange') {
+									if (action === 'create') {
+										const { name, insertSegment, segmentId, startIndex, endIndex } = actionField;
+										requestBody = {
+											name,
+											range: {
+												segmentId: insertSegment !== 'body' ? segmentId : '',
+												startIndex,
+												endIndex,
+											},
+										};
+									} else if (action === 'delete') {
+										const { namedRangeReference, value } = actionField;
+										requestBody = {
+											[namedRangeReference as string]: value,
+										};
+									}
+								}
+
+								body.requests.push({
+									[`${action}${upperFirst(object as string)}`]: requestBody,
+								});
+							});
+						}
+
+						responseData = await googleApiRequest.call(
+							this,
+							'POST',
+							`/documents/${documentId}:batchUpdate`,
+							body,
+						);
+
+						if (simple) {
+							if (Object.keys(responseData.replies[0] as IDataObject).length !== 0) {
+								const key = Object.keys(responseData.replies[0] as IDataObject)[0];
+								responseData = responseData.replies[0][key];
+							} else {
+								responseData = {};
+							}
+						}
+						responseData.documentId = documentId;
+					}
+				}
+			} catch (error) {
+				if (this.continueOnFail()) {
+					const executionErrorData = this.helpers.constructExecutionMetaData(
+						this.helpers.returnJsonArray({ error: error.message }),
+						{ itemData: { item: i } },
+					);
+					returnData.push(...executionErrorData);
+					continue;
+				}
+				throw error;
+			}
+
+			const executionData = this.helpers.constructExecutionMetaData(
+				this.helpers.returnJsonArray(responseData as IDataObject[]),
+				{ itemData: { item: i } },
+			);
+			returnData.push(...executionData);
+		}
+
+		return [returnData];
+	}
+}

packages/nodes-base/nodes/Google/Docs/__schema__/v2.0.0/document/create.json

@@ -0,0 +1,18 @@
+{
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "string"
+        },
+        "kind": {
+            "type": "string"
+        },
+        "mimeType": {
+            "type": "string"
+        },
+        "name": {
+            "type": "string"
+        }
+    },
+    "version": 1
+}

packages/nodes-base/nodes/Google/Docs/__schema__/v2.0.0/document/get.json

@@ -0,0 +1,12 @@
+{
+    "type": "object",
+    "properties": {
+        "content": {
+            "type": "string"
+        },
+        "documentId": {
+            "type": "string"
+        }
+    },
+    "version": 1
+}

packages/nodes-base/nodes/Google/Docs/__schema__/v2.0.0/document/update.json

@@ -0,0 +1,9 @@
+{
+    "type": "object",
+    "properties": {
+        "documentId": {
+            "type": "string"
+        }
+    },
+    "version": 1
+}

packages/nodes-base/nodes/Google/Docs/googleDocs.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" fill="#fff" fill-rule="evenodd" stroke="#000" stroke-linecap="round" stroke-linejoin="round" viewBox="-18 0 90 80"><use xlink:href="#a" x=".5" y=".5"/><symbol id="a" overflow="visible"><g stroke="none"><path fill="#548df6" d="m36 0 22 22v53a4.99 4.99 0 0 1-5 5H5a4.99 4.99 0 0 1-5-5V5a4.99 4.99 0 0 1 5-5z"/><path d="M14 40h30v3H14zm0 7h30v3H14zm0 8h30v3H14zm0 7h21v3H14z"/><path fill="#abd0fb" d="m36 0 22 22H41c-2.77 0-5-2.48-5-5.25z"/><path fill="#3e5bb9" d="M40.75 22 58 29.125V22z"/></g></symbol></svg>

packages/nodes-base/nodes/Google/Docs/interfaces.ts

@@ -0,0 +1,13 @@
+import type { IDataObject } from 'n8n-workflow';
+
+export interface IUpdateBody extends IDataObject {
+	requests: IDataObject[];
+	writeControl?: { [key: string]: string };
+}
+
+export type IUpdateFields = IDataObject & {
+	writeControlObject: {
+		control: string;
+		value: string;
+	};
+};