n8n/packages/nodes-base/nodes/Formstack/GenericFunctions.ts
Michael Kret 0ecbb4a19d
refactor: Format nodes-base package (A-F) (#3800)
* 🔨 prettier formated nodes - A

* 🔨 prettier formated nodes - B

*  prettier formated nodes - C

*  prettier formated nodes - D

*  prettier formated nodes - E-F

* 🎨 Adjust nodes-base formatting command (#3805)

* Format additional files in nodes A-F (#3811)

*  fixes

* 🎨 Add Mindee to ignored dirs

Co-authored-by: Iván Ovejero <ivov.src@gmail.com>
2022-08-01 22:47:55 +02:00

215 lines
5 KiB
TypeScript

import {
IExecuteFunctions,
IHookFunctions,
ILoadOptionsFunctions,
IWebhookFunctions,
} from 'n8n-core';
import { IDataObject, INodePropertyOptions, NodeApiError } from 'n8n-workflow';
import { OptionsWithUri } from 'request';
export interface IFormstackFieldDefinitionType {
id: string;
label: string;
description: string;
name: string;
type: string;
options: unknown;
required: string;
uniq: string;
hidden: string;
readonly: string;
colspan: string;
label_position: string;
num_columns: string;
date_format: string;
time_format: string;
}
export interface IFormstackWebhookResponseBody {
FormID: string;
UniqueID: string;
}
export interface IFormstackSubmissionFieldContainer {
field: string;
value: string;
}
export enum FormstackFieldFormat {
ID = 'id',
Label = 'label',
Name = 'name',
}
/**
* Make an API request to Formstack
*
* @param {IHookFunctions} this
* @param {string} method
* @param {string} url
* @param {object} body
* @returns {Promise<any>}
*/
export async function apiRequest(
this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions | IWebhookFunctions,
method: string,
endpoint: string,
body: IDataObject = {},
query: IDataObject = {},
// tslint:disable-next-line:no-any
): Promise<any> {
const authenticationMethod = this.getNodeParameter('authentication', 0);
const options: OptionsWithUri = {
headers: {},
method,
body,
qs: query || {},
uri: `https://www.formstack.com/api/v2/${endpoint}`,
json: true,
};
if (!Object.keys(body).length) {
delete options.body;
}
try {
if (authenticationMethod === 'accessToken') {
const credentials = (await this.getCredentials('formstackApi')) as IDataObject;
options.headers!['Authorization'] = `Bearer ${credentials.accessToken}`;
return await this.helpers.request!(options);
} else {
return await this.helpers.requestOAuth2!.call(this, 'formstackOAuth2Api', options);
}
} catch (error) {
throw new NodeApiError(this.getNode(), error);
}
}
/**
* Make an API request to paginated Formstack endpoint
* and return all results
*
* @export
* @param {(IHookFunctions | IExecuteFunctions)} this
* @param {string} method
* @param {string} endpoint
* @param {IDataObject} body
* @param {IDataObject} [query]
* @returns {Promise<any>}
*/
export async function apiRequestAllItems(
this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions | IWebhookFunctions,
method: string,
endpoint: string,
body: IDataObject,
dataKey: string,
query?: IDataObject,
// tslint:disable-next-line:no-any
): Promise<any> {
if (query === undefined) {
query = {};
}
query.per_page = 200;
query.page = 0;
const returnData = {
items: [] as IDataObject[],
};
let responseData;
do {
query.page += 1;
responseData = await apiRequest.call(this, method, endpoint, body, query);
returnData.items.push.apply(returnData.items, responseData[dataKey]);
} while (
responseData.total !== undefined &&
Math.ceil(responseData.total / query.per_page) > query.page
);
return returnData;
}
/**
* Returns all the available forms
*
* @export
* @param {ILoadOptionsFunctions} this
* @returns {Promise<INodePropertyOptions[]>}
*/
export async function getForms(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
const endpoint = 'form.json';
const responseData = await apiRequestAllItems.call(this, 'GET', endpoint, {}, 'forms', {
folders: false,
});
if (responseData.items === undefined) {
throw new Error('No data got returned');
}
const returnData: INodePropertyOptions[] = [];
for (const baseData of responseData.items) {
returnData.push({
name: baseData.name,
value: baseData.id,
});
}
return returnData;
}
/**
* Returns all the fields of a form
*
* @export
* @param {ILoadOptionsFunctions} this
* @param {string} formID
* @returns {Promise<IFormstackFieldDefinitionType[]>}
*/
export async function getFields(
this: IWebhookFunctions,
formID: string,
): Promise<Record<string, IFormstackFieldDefinitionType>> {
const endpoint = `form/${formID}.json`;
const responseData = await apiRequestAllItems.call(this, 'GET', endpoint, {}, 'fields');
if (responseData.items === undefined) {
throw new Error('No form fields meta data got returned');
}
const fields = responseData.items as IFormstackFieldDefinitionType[];
const fieldMap: Record<string, IFormstackFieldDefinitionType> = {};
fields.forEach((field) => {
fieldMap[field.id] = field;
});
return fieldMap;
}
/**
* Returns all the fields of a form
*
* @export
* @param {ILoadOptionsFunctions} this
* @param {string} uniqueId
* @returns {Promise<IFormstackFieldDefinitionType[]>}
*/
export async function getSubmission(
this: ILoadOptionsFunctions | IWebhookFunctions,
uniqueId: string,
): Promise<IFormstackSubmissionFieldContainer[]> {
const endpoint = `submission/${uniqueId}.json`;
const responseData = await apiRequestAllItems.call(this, 'GET', endpoint, {}, 'data');
if (responseData.items === undefined) {
throw new Error('No form fields meta data got returned');
}
return responseData.items as IFormstackSubmissionFieldContainer[];
}