/* eslint-disable @typescript-eslint/no-explicit-any */ // eslint-disable-next-line max-classes-per-file import type * as express from 'express'; import type * as FormData from 'form-data'; import type { IncomingHttpHeaders } from 'http'; import type { Readable } from 'stream'; import type { URLSearchParams } from 'url'; import type { OptionsWithUri, OptionsWithUrl } from 'request'; import type { RequestPromiseOptions, RequestPromiseAPI } from 'request-promise-native'; import type { IDeferredPromise } from './DeferredPromise'; import type { Workflow } from './Workflow'; import type { WorkflowHooks } from './WorkflowHooks'; import type { WorkflowActivationError } from './WorkflowActivationError'; import type { WorkflowOperationError } from './WorkflowErrors'; import type { NodeApiError, NodeOperationError } from './NodeErrors'; import type { ExpressionError } from './ExpressionError'; import type { PathLike } from 'fs'; import type { ExecutionStatus } from './ExecutionStatus'; export interface IAdditionalCredentialOptions { oauth2?: IOAuth2Options; credentialsDecrypted?: ICredentialsDecrypted; } export type IAllExecuteFunctions = | IExecuteFunctions | IExecutePaginationFunctions | IExecuteSingleFunctions | IHookFunctions | ILoadOptionsFunctions | IPollFunctions | ITriggerFunctions | IWebhookFunctions; export type BinaryFileType = 'text' | 'json' | 'image' | 'video'; export interface IBinaryData { [key: string]: string | undefined; data: string; mimeType: string; fileType?: BinaryFileType; fileName?: string; directory?: string; fileExtension?: string; fileSize?: string; // TODO: change this to number and store the actual value id?: string; } export interface BinaryMetadata { fileName?: string; mimeType?: string; fileSize: number; } // All properties in this interface except for // "includeCredentialsOnRefreshOnBody" will get // removed once we add the OAuth2 hooks to the // credentials file. export interface IOAuth2Options { includeCredentialsOnRefreshOnBody?: boolean; property?: string; tokenType?: string; keepBearer?: boolean; tokenExpiredStatusCode?: number; keyToIncludeInAccessTokenHeader?: string; } export interface IConnection { // The node the connection is to node: string; // The type of the input on destination node (for example "main") type: string; // The output/input-index of destination node (if node has multiple inputs/outputs of the same type) index: number; } export type ExecutionError = | ExpressionError | WorkflowActivationError | WorkflowOperationError | NodeOperationError | NodeApiError; // Get used to gives nodes access to credentials export interface IGetCredentials { get(type: string, id: string | null): Promise; } export abstract class ICredentials { id?: string; name: string; type: string; data: string | undefined; nodesAccess: ICredentialNodeAccess[]; constructor( nodeCredentials: INodeCredentialsDetails, type: string, nodesAccess: ICredentialNodeAccess[], data?: string, ) { this.id = nodeCredentials.id ?? undefined; this.name = nodeCredentials.name; this.type = type; this.nodesAccess = nodesAccess; this.data = data; } abstract getData(encryptionKey: string, nodeType?: string): ICredentialDataDecryptedObject; abstract getDataKey(key: string, encryptionKey: string, nodeType?: string): CredentialInformation; abstract getDataToSave(): ICredentialsEncrypted; abstract hasNodeAccess(nodeType: string): boolean; abstract setData(data: ICredentialDataDecryptedObject, encryptionKey: string): void; abstract setDataKey(key: string, data: CredentialInformation, encryptionKey: string): void; } export interface IUser { id: string; email: string; firstName: string; lastName: string; } // Defines which nodes are allowed to access the credentials and // when that access got granted from which user export interface ICredentialNodeAccess { nodeType: string; user?: string; date?: Date; } export interface ICredentialsDecrypted { id: string; name: string; type: string; nodesAccess: ICredentialNodeAccess[]; data?: ICredentialDataDecryptedObject; ownedBy?: IUser; sharedWith?: IUser[]; } export interface ICredentialsEncrypted { id?: string; name: string; type: string; nodesAccess: ICredentialNodeAccess[]; data?: string; } export interface ICredentialsExpressionResolveValues { connectionInputData: INodeExecutionData[]; itemIndex: number; node: INode; runExecutionData: IRunExecutionData | null; runIndex: number; workflow: Workflow; } // Simplified options of request library export interface IRequestOptionsSimplified { auth?: { username: string; password: string; }; body: IDataObject; headers: IDataObject; qs: IDataObject; } export interface IRequestOptionsSimplifiedAuth { auth?: { username: string; password: string; }; body?: IDataObject; headers?: IDataObject; qs?: IDataObject; url?: string; skipSslCertificateValidation?: boolean | string; } export interface IHttpRequestHelper { helpers: { httpRequest: IAllExecuteFunctions['helpers']['httpRequest'] }; } export abstract class ICredentialsHelper { constructor(readonly encryptionKey: string) {} abstract getParentTypes(name: string): string[]; abstract authenticate( credentials: ICredentialDataDecryptedObject, typeName: string, requestOptions: IHttpRequestOptions | IRequestOptionsSimplified, workflow: Workflow, node: INode, defaultTimezone: string, ): Promise; abstract preAuthentication( helpers: IHttpRequestHelper, credentials: ICredentialDataDecryptedObject, typeName: string, node: INode, credentialsExpired: boolean, ): Promise; abstract getCredentials( nodeCredentials: INodeCredentialsDetails, type: string, ): Promise; abstract getDecrypted( nodeCredentials: INodeCredentialsDetails, type: string, mode: WorkflowExecuteMode, defaultTimezone: string, raw?: boolean, expressionResolveValues?: ICredentialsExpressionResolveValues, ): Promise; abstract updateCredentials( nodeCredentials: INodeCredentialsDetails, type: string, data: ICredentialDataDecryptedObject, ): Promise; } export interface IAuthenticateBase { type: string; properties: | { [key: string]: string; } | IRequestOptionsSimplifiedAuth; } export interface IAuthenticateGeneric extends IAuthenticateBase { type: 'generic'; properties: IRequestOptionsSimplifiedAuth; } export type IAuthenticate = | (( credentials: ICredentialDataDecryptedObject, requestOptions: IHttpRequestOptions, ) => Promise) | IAuthenticateGeneric; export interface IAuthenticateRuleBase { type: string; properties: { [key: string]: string | number; }; errorMessage?: string; } export interface IAuthenticateRuleResponseCode extends IAuthenticateRuleBase { type: 'responseCode'; properties: { value: number; message: string; }; } export interface IAuthenticateRuleResponseSuccessBody extends IAuthenticateRuleBase { type: 'responseSuccessBody'; properties: { message: string; key: string; value: any; }; } type Override = Omit & B; export namespace DeclarativeRestApiSettings { // The type below might be extended // with new options that need to be parsed as expressions export type HttpRequestOptions = Override< IHttpRequestOptions, { skipSslCertificateValidation?: string | boolean; url?: string } >; export type ResultOptions = { maxResults?: number | string; options: HttpRequestOptions; paginate?: boolean | string; preSend: PreSendAction[]; postReceive: Array<{ data: { parameterValue: string | IDataObject | undefined; }; actions: PostReceiveAction[]; }>; requestOperations?: IN8nRequestOperations; }; } export interface ICredentialTestRequest { request: DeclarativeRestApiSettings.HttpRequestOptions; rules?: IAuthenticateRuleResponseCode[] | IAuthenticateRuleResponseSuccessBody[]; } export interface ICredentialTestRequestData { nodeType?: INodeType; testRequest: ICredentialTestRequest; } export interface ICredentialType { name: string; displayName: string; icon?: string; iconUrl?: string; extends?: string[]; properties: INodeProperties[]; documentationUrl?: string; __overwrittenProperties?: string[]; authenticate?: IAuthenticate; preAuthentication?: ( this: IHttpRequestHelper, credentials: ICredentialDataDecryptedObject, ) => Promise; test?: ICredentialTestRequest; genericAuth?: boolean; } export interface ICredentialTypes { recognizes(credentialType: string): boolean; getByName(credentialType: string): ICredentialType; getNodeTypesToTestWith(type: string): string[]; getParentTypes(typeName: string): string[]; } // The way the credentials get saved in the database (data encrypted) export interface ICredentialData { id?: string; name: string; data: string; // Contains the access data as encrypted JSON string nodesAccess: ICredentialNodeAccess[]; } // The encrypted credentials which the nodes can access export type CredentialInformation = string | number | boolean | IDataObject | IDataObject[]; // The encrypted credentials which the nodes can access export interface ICredentialDataDecryptedObject { [key: string]: CredentialInformation; } // First array index: The output/input-index (if node has multiple inputs/outputs of the same type) // Second array index: The different connections (if one node is connected to multiple nodes) export type NodeInputConnections = IConnection[][]; export interface INodeConnection { sourceIndex: number; destinationIndex: number; } export interface INodeConnections { // Input name [key: string]: NodeInputConnections; } export interface IConnections { // Node name [key: string]: INodeConnections; } export type GenericValue = string | object | number | boolean | undefined | null; export interface IDataObject { [key: string]: GenericValue | IDataObject | GenericValue[] | IDataObject[]; } // export type IExecuteResponsePromiseData = IDataObject; export type IExecuteResponsePromiseData = IDataObject | IN8nHttpFullResponse; export interface INodeTypeNameVersion { name: string; version: number; } export interface IGetExecutePollFunctions { ( workflow: Workflow, node: INode, additionalData: IWorkflowExecuteAdditionalData, mode: WorkflowExecuteMode, activation: WorkflowActivateMode, ): IPollFunctions; } export interface IGetExecuteTriggerFunctions { ( workflow: Workflow, node: INode, additionalData: IWorkflowExecuteAdditionalData, mode: WorkflowExecuteMode, activation: WorkflowActivateMode, ): ITriggerFunctions; } export interface IRunNodeResponse { data: INodeExecutionData[][] | null | undefined; closeFunction?: () => Promise; } export interface IGetExecuteFunctions { ( workflow: Workflow, runExecutionData: IRunExecutionData, runIndex: number, connectionInputData: INodeExecutionData[], inputData: ITaskDataConnections, node: INode, additionalData: IWorkflowExecuteAdditionalData, executeData: IExecuteData, mode: WorkflowExecuteMode, ): IExecuteFunctions; } export interface IGetExecuteSingleFunctions { ( workflow: Workflow, runExecutionData: IRunExecutionData, runIndex: number, connectionInputData: INodeExecutionData[], inputData: ITaskDataConnections, node: INode, itemIndex: number, additionalData: IWorkflowExecuteAdditionalData, executeData: IExecuteData, mode: WorkflowExecuteMode, ): IExecuteSingleFunctions; } export interface IGetExecuteHookFunctions { ( workflow: Workflow, node: INode, additionalData: IWorkflowExecuteAdditionalData, mode: WorkflowExecuteMode, activation: WorkflowActivateMode, isTest?: boolean, webhookData?: IWebhookData, ): IHookFunctions; } export interface IGetExecuteWebhookFunctions { ( workflow: Workflow, node: INode, additionalData: IWorkflowExecuteAdditionalData, mode: WorkflowExecuteMode, webhookData: IWebhookData, ): IWebhookFunctions; } export interface ISourceDataConnections { // Key for each input type and because there can be multiple inputs of the same type it is an array // null is also allowed because if we still need data for a later while executing the workflow set temporary to null // the nodes get as input TaskDataConnections which is identical to this one except that no null is allowed. [key: string]: Array; } export interface IExecuteData { data: ITaskDataConnections; node: INode; source: ITaskDataConnectionsSource | null; } export type IContextObject = { [key: string]: any; }; export interface IExecuteContextData { // Keys are: "flow" | "node:" [key: string]: IContextObject; } export type IHttpRequestMethods = 'DELETE' | 'GET' | 'HEAD' | 'PATCH' | 'POST' | 'PUT'; export interface IHttpRequestOptions { url: string; baseURL?: string; headers?: IDataObject; method?: IHttpRequestMethods; body?: FormData | GenericValue | GenericValue[] | Buffer | URLSearchParams; qs?: IDataObject; arrayFormat?: 'indices' | 'brackets' | 'repeat' | 'comma'; auth?: { username: string; password: string; }; disableFollowRedirect?: boolean; encoding?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'; skipSslCertificateValidation?: boolean; returnFullResponse?: boolean; ignoreHttpStatusErrors?: boolean; proxy?: { host: string; port: number; auth?: { username: string; password: string; }; protocol?: string; }; timeout?: number; json?: boolean; } export type IN8nHttpResponse = IDataObject | Buffer | GenericValue | GenericValue[] | null; export interface IN8nHttpFullResponse { body: IN8nHttpResponse; headers: IDataObject; statusCode: number; statusMessage?: string; } export interface IN8nRequestOperations { pagination?: | IN8nRequestOperationPaginationGeneric | IN8nRequestOperationPaginationOffset | (( this: IExecutePaginationFunctions, requestOptions: DeclarativeRestApiSettings.ResultOptions, ) => Promise); } export interface IN8nRequestOperationPaginationBase { type: string; properties: { [key: string]: unknown; }; } export interface IN8nRequestOperationPaginationGeneric extends IN8nRequestOperationPaginationBase { type: 'generic'; properties: { continue: boolean | string; request: IRequestOptionsSimplifiedAuth; }; } export interface IN8nRequestOperationPaginationOffset extends IN8nRequestOperationPaginationBase { type: 'offset'; properties: { limitParameter: string; offsetParameter: string; pageSize: number; rootProperty?: string; // Optional Path to option array type: 'body' | 'query'; }; } export interface IGetNodeParameterOptions { extractValue?: boolean; } namespace ExecuteFunctions { namespace StringReturning { export type NodeParameter = | 'binaryProperty' | 'binaryPropertyName' | 'binaryPropertyOutput' | 'dataPropertyName' | 'dataBinaryProperty' | 'resource' | 'operation' | 'filePath' | 'encodingType'; } namespace NumberReturning { export type NodeParameter = 'limit'; } namespace BooleanReturning { export type NodeParameter = | 'binaryData' | 'download' | 'jsonParameters' | 'returnAll' | 'rawData' | 'resolveData'; } namespace RecordReturning { export type NodeParameter = 'additionalFields' | 'filters' | 'options' | 'updateFields'; } export type GetNodeParameterFn = { // @TECH_DEBT: Refactor to remove this barely used overload - N8N-5632 getNodeParameter( parameterName: 'resource', itemIndex?: number, ): T['resource']; getNodeParameter( parameterName: StringReturning.NodeParameter, itemIndex: number, fallbackValue?: string, options?: IGetNodeParameterOptions, ): string; getNodeParameter( parameterName: RecordReturning.NodeParameter, itemIndex: number, fallbackValue?: IDataObject, options?: IGetNodeParameterOptions, ): IDataObject; getNodeParameter( parameterName: BooleanReturning.NodeParameter, itemIndex: number, fallbackValue?: boolean, options?: IGetNodeParameterOptions, ): boolean; getNodeParameter( parameterName: NumberReturning.NodeParameter, itemIndex: number, fallbackValue?: number, options?: IGetNodeParameterOptions, ): number; getNodeParameter( parameterName: string, itemIndex: number, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; }; } export interface IExecuteWorkflowInfo { code?: IWorkflowBase; id?: string; } export type ICredentialTestFunction = ( this: ICredentialTestFunctions, credential: ICredentialsDecrypted, ) => Promise; export interface ICredentialTestFunctions { helpers: { request: RequestPromiseAPI; }; } interface BaseHelperFunctions { createDeferredPromise: () => Promise>; } interface JsonHelperFunctions { returnJsonArray(jsonData: IDataObject | IDataObject[]): INodeExecutionData[]; } export interface FileSystemHelperFunctions { createReadStream(path: PathLike): Promise; } export interface BinaryHelperFunctions { prepareBinaryData( binaryData: Buffer | Readable, filePath?: string, mimeType?: string, ): Promise; setBinaryDataBuffer(data: IBinaryData, binaryData: Buffer): Promise; copyBinaryFile(): Promise; binaryToBuffer(body: Buffer | Readable): Promise; getBinaryStream(binaryDataId: string, chunkSize?: number): Readable; getBinaryMetadata(binaryDataId: string): Promise; } export interface NodeHelperFunctions { copyBinaryFile(filePath: string, fileName: string, mimeType?: string): Promise; } export interface RequestHelperFunctions { request(uriOrObject: string | IDataObject | any, options?: IDataObject): Promise; requestWithAuthentication( this: IAllExecuteFunctions, credentialsType: string, requestOptions: OptionsWithUri | RequestPromiseOptions, additionalCredentialOptions?: IAdditionalCredentialOptions, ): Promise; httpRequest(requestOptions: IHttpRequestOptions): Promise; httpRequestWithAuthentication( this: IAllExecuteFunctions, credentialsType: string, requestOptions: IHttpRequestOptions, additionalCredentialOptions?: IAdditionalCredentialOptions, ): Promise; requestOAuth1( this: IAllExecuteFunctions, credentialsType: string, requestOptions: OptionsWithUrl | RequestPromiseOptions, ): Promise; requestOAuth2( this: IAllExecuteFunctions, credentialsType: string, requestOptions: OptionsWithUri | RequestPromiseOptions, oAuth2Options?: IOAuth2Options, ): Promise; } export interface FunctionsBase { logger: ILogger; getCredentials(type: string, itemIndex?: number): Promise; getNode(): INode; getWorkflow(): IWorkflowMetadata; getWorkflowStaticData(type: string): IDataObject; getTimezone(): string; getRestApiUrl(): string; getMode?: () => WorkflowExecuteMode; getActivationMode?: () => WorkflowActivateMode; } type FunctionsBaseWithRequiredKeys = FunctionsBase & { [K in Keys]: NonNullable; }; type BaseExecutionFunctions = FunctionsBaseWithRequiredKeys<'getMode'> & { continueOnFail(): boolean; evaluateExpression(expression: string, itemIndex: number): NodeParameterValueType; getContext(type: string): IContextObject; getExecuteData(): IExecuteData; getWorkflowDataProxy(itemIndex: number): IWorkflowDataProxyData; getInputSourceData(inputIndex?: number, inputName?: string): ISourceData; }; export type IExecuteFunctions = ExecuteFunctions.GetNodeParameterFn & BaseExecutionFunctions & { executeWorkflow( workflowInfo: IExecuteWorkflowInfo, inputData?: INodeExecutionData[], ): Promise; getInputData(inputIndex?: number, inputName?: string): INodeExecutionData[]; prepareOutputData( outputData: INodeExecutionData[], outputIndex?: number, ): Promise; putExecutionToWait(waitTill: Date): Promise; sendMessageToUI(message: any): void; sendResponse(response: IExecuteResponsePromiseData): void; nodeHelpers: NodeHelperFunctions; helpers: RequestHelperFunctions & BaseHelperFunctions & BinaryHelperFunctions & FileSystemHelperFunctions & JsonHelperFunctions & { normalizeItems(items: INodeExecutionData | INodeExecutionData[]): INodeExecutionData[]; constructExecutionMetaData( inputData: INodeExecutionData[], options: { itemData: IPairedItemData | IPairedItemData[] }, ): NodeExecutionWithMetadata[]; assertBinaryData(itemIndex: number, propertyName: string): IBinaryData; getBinaryDataBuffer(itemIndex: number, propertyName: string): Promise; }; }; export interface IExecuteSingleFunctions extends BaseExecutionFunctions { getInputData(inputIndex?: number, inputName?: string): INodeExecutionData; getItemIndex(): number; getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; helpers: RequestHelperFunctions & BaseHelperFunctions & BinaryHelperFunctions & { assertBinaryData(propertyName: string, inputIndex?: number): IBinaryData; getBinaryDataBuffer(propertyName: string, inputIndex?: number): Promise; }; } export interface IExecutePaginationFunctions extends IExecuteSingleFunctions { makeRoutingRequest( this: IAllExecuteFunctions, requestOptions: DeclarativeRestApiSettings.ResultOptions, ): Promise; } export interface ILoadOptionsFunctions extends FunctionsBase { getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; getCurrentNodeParameter( parameterName: string, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object | undefined; getCurrentNodeParameters(): INodeParameters | undefined; helpers: RequestHelperFunctions; } export interface IPollFunctions extends FunctionsBaseWithRequiredKeys<'getMode' | 'getActivationMode'> { __emit( data: INodeExecutionData[][], responsePromise?: IDeferredPromise, donePromise?: IDeferredPromise, ): void; __emitError(error: Error, responsePromise?: IDeferredPromise): void; getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; helpers: RequestHelperFunctions & BaseHelperFunctions & BinaryHelperFunctions & JsonHelperFunctions; } export interface ITriggerFunctions extends FunctionsBaseWithRequiredKeys<'getMode' | 'getActivationMode'> { emit( data: INodeExecutionData[][], responsePromise?: IDeferredPromise, donePromise?: IDeferredPromise, ): void; emitError(error: Error, responsePromise?: IDeferredPromise): void; getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; helpers: RequestHelperFunctions & BaseHelperFunctions & BinaryHelperFunctions & JsonHelperFunctions; } export interface IHookFunctions extends FunctionsBaseWithRequiredKeys<'getMode' | 'getActivationMode'> { getWebhookName(): string; getWebhookDescription(name: string): IWebhookDescription | undefined; getNodeWebhookUrl: (name: string) => string | undefined; getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; helpers: RequestHelperFunctions; } export interface IWebhookFunctions extends FunctionsBaseWithRequiredKeys<'getMode'> { getBodyData(): IDataObject; getHeaderData(): IncomingHttpHeaders; getNodeParameter( parameterName: string, fallbackValue?: any, options?: IGetNodeParameterOptions, ): NodeParameterValueType | object; getNodeWebhookUrl: (name: string) => string | undefined; getParamsData(): object; getQueryData(): object; getRequestObject(): express.Request; getResponseObject(): express.Response; getWebhookName(): string; prepareOutputData( outputData: INodeExecutionData[], outputIndex?: number, ): Promise; nodeHelpers: NodeHelperFunctions; helpers: RequestHelperFunctions & BaseHelperFunctions & BinaryHelperFunctions & JsonHelperFunctions; } export interface INodeCredentialsDetails { id: string | null; name: string; } export interface INodeCredentials { [key: string]: INodeCredentialsDetails; } export interface INode { id: string; name: string; typeVersion: number; type: string; position: [number, number]; disabled?: boolean; notes?: string; notesInFlow?: boolean; retryOnFail?: boolean; maxTries?: number; waitBetweenTries?: number; alwaysOutputData?: boolean; executeOnce?: boolean; continueOnFail?: boolean; parameters: INodeParameters; credentials?: INodeCredentials; webhookId?: string; } export interface IPinData { [nodeName: string]: INodeExecutionData[]; } export interface INodes { [key: string]: INode; } export interface IObservableObject { [key: string]: any; __dataChanged: boolean; } export interface IBinaryKeyData { [key: string]: IBinaryData; } export interface IPairedItemData { item: number; input?: number; // If undefined "0" gets used sourceOverwrite?: ISourceData; } export interface INodeExecutionData { [key: string]: | IDataObject | IBinaryKeyData | IPairedItemData | IPairedItemData[] | NodeApiError | NodeOperationError | number | undefined; json: IDataObject; binary?: IBinaryKeyData; error?: NodeApiError | NodeOperationError; pairedItem?: IPairedItemData | IPairedItemData[] | number; index?: number; } export interface INodeExecuteFunctions { getExecutePollFunctions: IGetExecutePollFunctions; getExecuteTriggerFunctions: IGetExecuteTriggerFunctions; getExecuteFunctions: IGetExecuteFunctions; getExecuteSingleFunctions: IGetExecuteSingleFunctions; getExecuteHookFunctions: IGetExecuteHookFunctions; getExecuteWebhookFunctions: IGetExecuteWebhookFunctions; } export type NodeParameterValue = string | number | boolean | undefined | null; export type ResourceLocatorModes = 'id' | 'url' | 'list' | string; export interface IResourceLocatorResult { name: string; value: string; url?: string; } export interface INodeParameterResourceLocator { __rl: true; mode: ResourceLocatorModes; value: NodeParameterValue; cachedResultName?: string; cachedResultUrl?: string; __regex?: string; } export type NodeParameterValueType = // TODO: Later also has to be possible to add multiple ones with the name name. So array has to be possible | NodeParameterValue | INodeParameters | INodeParameterResourceLocator | NodeParameterValue[] | INodeParameters[] | INodeParameterResourceLocator[]; export interface INodeParameters { [key: string]: NodeParameterValueType; } export type NodePropertyTypes = | 'boolean' | 'collection' | 'color' | 'dateTime' | 'fixedCollection' | 'hidden' | 'json' | 'notice' | 'multiOptions' | 'number' | 'options' | 'string' | 'credentialsSelect' | 'resourceLocator' | 'curlImport'; export type CodeAutocompleteTypes = 'function' | 'functionItem'; export type EditorTypes = 'code' | 'codeNodeEditor' | 'htmlEditor' | 'json'; export interface ILoadOptions { routing?: { operations?: IN8nRequestOperations; output?: INodeRequestOutput; request?: DeclarativeRestApiSettings.HttpRequestOptions; }; } export interface INodePropertyTypeOptions { alwaysOpenEditWindow?: boolean; // Supported by: json codeAutocomplete?: CodeAutocompleteTypes; // Supported by: string editor?: EditorTypes; // Supported by: string loadOptionsDependsOn?: string[]; // Supported by: options loadOptionsMethod?: string; // Supported by: options loadOptions?: ILoadOptions; // Supported by: options maxValue?: number; // Supported by: number minValue?: number; // Supported by: number multipleValues?: boolean; // Supported by: multipleValueButtonText?: string; // Supported when "multipleValues" set to true numberPrecision?: number; // Supported by: number password?: boolean; // Supported by: string rows?: number; // Supported by: string showAlpha?: boolean; // Supported by: color sortable?: boolean; // Supported when "multipleValues" set to true expirable?: boolean; // Supported by: hidden (only in the credentials) [key: string]: any; } export interface IDisplayOptions { hide?: { [key: string]: NodeParameterValue[] | undefined; }; show?: { [key: string]: NodeParameterValue[] | undefined; }; } export interface INodeProperties { displayName: string; name: string; type: NodePropertyTypes; typeOptions?: INodePropertyTypeOptions; default: NodeParameterValueType; description?: string; hint?: string; displayOptions?: IDisplayOptions; options?: Array; placeholder?: string; isNodeSetting?: boolean; noDataExpression?: boolean; required?: boolean; routing?: INodePropertyRouting; credentialTypes?: Array< 'extends:oAuth2Api' | 'extends:oAuth1Api' | 'has:authenticate' | 'has:genericAuth' >; extractValue?: INodePropertyValueExtractor; modes?: INodePropertyMode[]; requiresDataPath?: 'single' | 'multiple'; } export interface INodePropertyModeTypeOptions { searchListMethod?: string; // Supported by: options searchFilterRequired?: boolean; searchable?: boolean; } export interface INodePropertyMode { displayName: string; name: string; type: 'string' | 'list'; hint?: string; validation?: Array< INodePropertyModeValidation | { (this: IExecuteSingleFunctions, value: string): void } >; placeholder?: string; url?: string; extractValue?: INodePropertyValueExtractor; initType?: string; entryTypes?: { [name: string]: { selectable?: boolean; hidden?: boolean; queryable?: boolean; data?: { request?: IHttpRequestOptions; output?: INodeRequestOutput; }; }; }; search?: INodePropertyRouting; typeOptions?: INodePropertyModeTypeOptions; } export interface INodePropertyModeValidation { type: string; properties: {}; } export interface INodePropertyRegexValidation extends INodePropertyModeValidation { type: 'regex'; properties: { regex: string; errorMessage: string; }; } export interface INodePropertyOptions { name: string; value: string | number | boolean; action?: string; description?: string; routing?: INodePropertyRouting; } export interface INodeListSearchItems extends INodePropertyOptions { icon?: string; url?: string; } export interface INodeListSearchResult { results: INodeListSearchItems[]; paginationToken?: unknown; } export interface INodePropertyCollection { displayName: string; name: string; values: INodeProperties[]; } export interface INodePropertyValueExtractorBase { type: string; } export interface INodePropertyValueExtractorRegex extends INodePropertyValueExtractorBase { type: 'regex'; regex: string | RegExp; } export interface INodePropertyValueExtractorFunction { (this: IExecuteSingleFunctions, value: string | NodeParameterValue): | Promise | (string | NodeParameterValue); } export type INodePropertyValueExtractor = INodePropertyValueExtractorRegex; export interface IParameterDependencies { [key: string]: string[]; } export type IParameterLabel = { size?: 'small' | 'medium'; }; export interface IPollResponse { closeFunction?: () => Promise; } export interface ITriggerResponse { closeFunction?: () => Promise; // To manually trigger the run manualTriggerFunction?: () => Promise; // Gets added automatically at manual workflow runs resolves with // the first emitted data manualTriggerResponse?: Promise; } export type WebhookSetupMethodNames = 'checkExists' | 'create' | 'delete'; export interface INodeType { description: INodeTypeDescription; execute?( this: IExecuteFunctions, ): Promise; executeSingle?(this: IExecuteSingleFunctions): Promise; poll?(this: IPollFunctions): Promise; trigger?(this: ITriggerFunctions): Promise; webhook?(this: IWebhookFunctions): Promise; methods?: { loadOptions?: { [key: string]: (this: ILoadOptionsFunctions) => Promise; }; listSearch?: { [key: string]: ( this: ILoadOptionsFunctions, filter?: string, paginationToken?: string, ) => Promise; }; credentialTest?: { // Contains a group of functions that test credentials. [functionName: string]: ICredentialTestFunction; }; }; webhookMethods?: { [name in IWebhookDescription['name']]?: { [method in WebhookSetupMethodNames]: (this: IHookFunctions) => Promise; }; }; } export interface IVersionedNodeType { nodeVersions: { [key: number]: INodeType; }; currentVersion: number; description: INodeTypeBaseDescription; getNodeType: (version?: number) => INodeType; } export interface INodeCredentialTestResult { status: 'OK' | 'Error'; message: string; } export interface INodeCredentialTestRequest { credentials: ICredentialsDecrypted; } export interface INodeCredentialDescription { name: string; required?: boolean; displayOptions?: IDisplayOptions; testedBy?: ICredentialTestRequest | string; // Name of a function inside `loadOptions.credentialTest` } export type INodeIssueTypes = 'credentials' | 'execution' | 'parameters' | 'typeUnknown'; export interface INodeIssueObjectProperty { [key: string]: string[]; } export interface INodeIssueData { node: string; type: INodeIssueTypes; value: boolean | string | string[] | INodeIssueObjectProperty; } export interface INodeIssues { execution?: boolean; credentials?: INodeIssueObjectProperty; parameters?: INodeIssueObjectProperty; typeUnknown?: boolean; [key: string]: undefined | boolean | INodeIssueObjectProperty; } export interface IWorkflowIssues { [key: string]: INodeIssues; } export interface INodeTypeBaseDescription { displayName: string; name: string; icon?: string; iconUrl?: string; group: string[]; description: string; documentationUrl?: string; subtitle?: string; defaultVersion?: number; codex?: CodexData; parameterPane?: 'wide'; /** * Whether the node must be hidden in the node creator panel, * due to deprecation or as a special case (e.g. Start node) */ hidden?: true; } export interface INodePropertyRouting { operations?: IN8nRequestOperations; // Should be changed, does not sound right output?: INodeRequestOutput; request?: DeclarativeRestApiSettings.HttpRequestOptions; send?: INodeRequestSend; } export type PostReceiveAction = | (( this: IExecuteSingleFunctions, items: INodeExecutionData[], response: IN8nHttpFullResponse, ) => Promise) | IPostReceiveBinaryData | IPostReceiveFilter | IPostReceiveLimit | IPostReceiveRootProperty | IPostReceiveSet | IPostReceiveSetKeyValue | IPostReceiveSort; export type PreSendAction = ( this: IExecuteSingleFunctions, requestOptions: IHttpRequestOptions, ) => Promise; export interface INodeRequestOutput { maxResults?: number | string; postReceive?: PostReceiveAction[]; } export interface INodeRequestSend { preSend?: PreSendAction[]; paginate?: boolean | string; // Where should this life? property?: string; // Maybe: propertyName, destinationProperty? propertyInDotNotation?: boolean; // Enabled by default type?: 'body' | 'query'; value?: string; } export interface IPostReceiveBase { type: string; enabled?: boolean | string; properties: { [key: string]: string | number | boolean | IDataObject; }; errorMessage?: string; } export interface IPostReceiveBinaryData extends IPostReceiveBase { type: 'binaryData'; properties: { destinationProperty: string; }; } export interface IPostReceiveFilter extends IPostReceiveBase { type: 'filter'; properties: { pass: boolean | string; }; } export interface IPostReceiveLimit extends IPostReceiveBase { type: 'limit'; properties: { maxResults: number | string; }; } export interface IPostReceiveRootProperty extends IPostReceiveBase { type: 'rootProperty'; properties: { property: string; }; } export interface IPostReceiveSet extends IPostReceiveBase { type: 'set'; properties: { value: string; }; } export interface IPostReceiveSetKeyValue extends IPostReceiveBase { type: 'setKeyValue'; properties: { [key: string]: string | number; }; } export interface IPostReceiveSort extends IPostReceiveBase { type: 'sort'; properties: { key: string; }; } export interface INodeActionTypeDescription extends INodeTypeDescription { displayOptions?: IDisplayOptions; values?: IDataObject; actionKey: string; } export interface INodeTypeDescription extends INodeTypeBaseDescription { version: number | number[]; defaults: INodeParameters; eventTriggerDescription?: string; activationMessage?: string; inputs: string[]; inputNames?: string[]; outputs: string[]; outputNames?: string[]; properties: INodeProperties[]; credentials?: INodeCredentialDescription[]; maxNodes?: number; // How many nodes of that type can be created in a workflow polling?: boolean; requestDefaults?: DeclarativeRestApiSettings.HttpRequestOptions; requestOperations?: IN8nRequestOperations; hooks?: { [key: string]: INodeHookDescription[] | undefined; activate?: INodeHookDescription[]; deactivate?: INodeHookDescription[]; }; webhooks?: IWebhookDescription[]; translation?: { [key: string]: object }; mockManualExecution?: true; triggerPanel?: { header?: string; executionsHelp?: | string | { active: string; inactive: string; }; activationHint?: | string | { active: string; inactive: string; }; }; actions?: INodeActionTypeDescription[]; } export interface INodeHookDescription { method: string; } export interface IWebhookData { httpMethod: WebhookHttpMethod; node: string; path: string; webhookDescription: IWebhookDescription; workflowId: string; workflowExecuteAdditionalData: IWorkflowExecuteAdditionalData; webhookId?: string; } export interface IWebhookDescription { [key: string]: WebhookHttpMethod | WebhookResponseMode | boolean | string | undefined; httpMethod: WebhookHttpMethod | string; isFullPath?: boolean; name: 'default' | 'setup'; path: string; responseBinaryPropertyName?: string; responseContentType?: string; responsePropertyName?: string; responseMode?: WebhookResponseMode | string; responseData?: WebhookResponseData | string; restartWebhook?: boolean; } export interface IWorkflowDataProxyData { [key: string]: any; $binary: any; $data: any; $env: any; $evaluateExpression: any; $item: any; $items: any; $json: any; $node: any; $parameter: any; $position: any; $workflow: any; $: any; $input: any; $thisItem: any; $thisRunIndex: number; $thisItemIndex: number; $now: any; $today: any; constructor: any; } export type IWorkflowDataProxyAdditionalKeys = IDataObject; export interface IWorkflowMetadata { id?: string; name?: string; active: boolean; } export type WebhookHttpMethod = 'DELETE' | 'GET' | 'HEAD' | 'PATCH' | 'POST' | 'PUT' | 'OPTIONS'; export interface IWebhookResponseData { workflowData?: INodeExecutionData[][]; webhookResponse?: any; noWebhookResponse?: boolean; } export type WebhookResponseData = 'allEntries' | 'firstEntryJson' | 'firstEntryBinary' | 'noData'; export type WebhookResponseMode = 'onReceived' | 'lastNode'; export interface INodeTypes { getByName(nodeType: string): INodeType | IVersionedNodeType; getByNameAndVersion(nodeType: string, version?: number): INodeType; } export type LoadingDetails = { className: string; sourcePath: string; }; export type CredentialLoadingDetails = LoadingDetails & { nodesToTestWith?: string[]; }; export type NodeLoadingDetails = LoadingDetails; export type KnownNodesAndCredentials = { nodes: Record; credentials: Record; }; export interface LoadedClass { sourcePath: string; type: T; } type LoadedData = Record>; export type ICredentialTypeData = LoadedData; export type INodeTypeData = LoadedData; export type LoadedNodesAndCredentials = { nodes: INodeTypeData; credentials: ICredentialTypeData; }; export interface INodesAndCredentials { known: KnownNodesAndCredentials; loaded: LoadedNodesAndCredentials; credentialTypes: ICredentialTypes; } export interface IRun { data: IRunExecutionData; finished?: boolean; mode: WorkflowExecuteMode; waitTill?: Date; startedAt: Date; stoppedAt?: Date; status: ExecutionStatus; } // Contains all the data which is needed to execute a workflow and so also to // start restart it again after it did fail. // The RunData, ExecuteData and WaitForExecution contain often the same data. export interface IRunExecutionData { startData?: { destinationNode?: string; runNodeFilter?: string[]; }; resultData: { error?: ExecutionError; runData: IRunData; pinData?: IPinData; lastNodeExecuted?: string; }; executionData?: { contextData: IExecuteContextData; nodeExecutionStack: IExecuteData[]; waitingExecution: IWaitingForExecution; waitingExecutionSource: IWaitingForExecutionSource | null; }; waitTill?: Date; } export interface IRunData { // node-name: result-data [key: string]: ITaskData[]; } // The data that gets returned when a node runs export interface ITaskData { startTime: number; executionTime: number; executionStatus?: ExecutionStatus; data?: ITaskDataConnections; error?: ExecutionError; source: Array; // Is an array as nodes have multiple inputs } export interface ISourceData { previousNode: string; previousNodeOutput?: number; // If undefined "0" gets used previousNodeRun?: number; // If undefined "0" gets used } // The data for all the different kind of connections (like main) and all the indexes export interface ITaskDataConnections { // Key for each input type and because there can be multiple inputs of the same type it is an array // null is also allowed because if we still need data for a later while executing the workflow set temporary to null // the nodes get as input TaskDataConnections which is identical to this one except that no null is allowed. [key: string]: Array; } // Keeps data while workflow gets executed and allows when provided to restart execution export interface IWaitingForExecution { // Node name [key: string]: { // Run index [key: number]: ITaskDataConnections; }; } export interface ITaskDataConnectionsSource { // Key for each input type and because there can be multiple inputs of the same type it is an array // null is also allowed because if we still need data for a later while executing the workflow set temporary to null // the nodes get as input TaskDataConnections which is identical to this one except that no null is allowed. [key: string]: Array; } export interface IWaitingForExecutionSource { // Node name [key: string]: { // Run index [key: number]: ITaskDataConnectionsSource; }; } export interface IWorkflowBase { id?: string; name: string; active: boolean; createdAt: Date; updatedAt: Date; nodes: INode[]; connections: IConnections; settings?: IWorkflowSettings; staticData?: IDataObject; pinData?: IPinData; } export interface IWorkflowCredentials { [credentialType: string]: { [id: string]: ICredentialsEncrypted; }; } export interface IWorkflowExecuteHooks { [key: string]: Array<(...args: any[]) => Promise> | undefined; nodeExecuteAfter?: Array< (nodeName: string, data: ITaskData, executionData: IRunExecutionData) => Promise >; nodeExecuteBefore?: Array<(nodeName: string) => Promise>; workflowExecuteAfter?: Array<(data: IRun, newStaticData: IDataObject) => Promise>; workflowExecuteBefore?: Array<(workflow: Workflow, data: IRunExecutionData) => Promise>; sendResponse?: Array<(response: IExecuteResponsePromiseData) => Promise>; } export interface IWorkflowExecuteAdditionalData { credentialsHelper: ICredentialsHelper; encryptionKey: string; executeWorkflow: ( workflowInfo: IExecuteWorkflowInfo, additionalData: IWorkflowExecuteAdditionalData, options: { parentWorkflowId?: string; inputData?: INodeExecutionData[]; parentExecutionId?: string; loadedWorkflowData?: IWorkflowBase; loadedRunData?: any; parentWorkflowSettings?: IWorkflowSettings; }, ) => Promise; // hooks?: IWorkflowExecuteHooks; executionId?: string; hooks?: WorkflowHooks; httpResponse?: express.Response; httpRequest?: express.Request; restApiUrl: string; setExecutionStatus?: (status: ExecutionStatus) => void; sendMessageToUI?: (source: string, message: any) => void; timezone: string; webhookBaseUrl: string; webhookWaitingBaseUrl: string; webhookTestBaseUrl: string; currentNodeParameters?: INodeParameters; executionTimeoutTimestamp?: number; userId: string; } export type WorkflowExecuteMode = | 'cli' | 'error' | 'integrated' | 'internal' | 'manual' | 'retry' | 'trigger' | 'webhook'; export type WorkflowActivateMode = 'init' | 'create' | 'update' | 'activate' | 'manual'; export interface IWorkflowHooksOptionalParameters { parentProcessMode?: string; retryOf?: string; sessionId?: string; } export interface IWorkflowSettings { [key: string]: IDataObject | string | number | boolean | undefined; } export type LogTypes = 'debug' | 'verbose' | 'info' | 'warn' | 'error'; export interface ILogger { log: (type: LogTypes, message: string, meta?: object) => void; debug: (message: string, meta?: object) => void; verbose: (message: string, meta?: object) => void; info: (message: string, meta?: object) => void; warn: (message: string, meta?: object) => void; error: (message: string, meta?: object) => void; } export interface IStatusCodeMessages { [key: string]: string; } export type DocumentationLink = { url: string; }; export type CodexData = { categories?: string[]; subcategories?: { [category: string]: string[] }; resources?: { credentialDocumentation?: DocumentationLink[]; primaryDocumentation?: DocumentationLink[]; }; alias?: string[]; }; export type JsonValue = string | number | boolean | null | JsonObject | JsonValue[]; export type JsonObject = { [key: string]: JsonValue }; export type AllEntities = M extends { [key: string]: string } ? Entity : never; export type Entity = K extends keyof M ? { resource: K; operation: M[K] } : never; export type PropertiesOf = Array< Omit & { displayOptions?: { [key in 'show' | 'hide']?: { resource?: Array; operation?: Array; [otherKey: string]: NodeParameterValue[] | undefined; }; }; } >; // Telemetry export interface ITelemetryTrackProperties { user_id?: string; [key: string]: GenericValue; } export interface INodesGraph { node_types: string[]; node_connections: IDataObject[]; nodes: INodesGraphNode; notes: INotesGraphNode; is_pinned: boolean; } export interface INodesGraphNode { [key: string]: INodeGraphItem; } export interface INotesGraphNode { [key: string]: INoteGraphItem; } export interface INoteGraphItem { overlapping: boolean; position: [number, number]; height: number; width: number; } export interface INodeGraphItem { id: string; type: string; resource?: string; operation?: string; domain?: string; // HTTP Request node v1 domain_base?: string; // HTTP Request node v2 domain_path?: string; // HTTP Request node v2 position: [number, number]; mode?: string; credential_type?: string; // HTTP Request node v2 credential_set?: boolean; // HTTP Request node v2 method?: string; // HTTP Request node v2 src_node_id?: string; src_instance_id?: string; } export interface INodeNameIndex { [name: string]: string; } export interface INodesGraphResult { nodeGraph: INodesGraph; nameIndices: INodeNameIndex; webhookNodeNames: string[]; } export interface ITelemetryClientConfig { url: string; key: string; } export interface ITelemetrySettings { enabled: boolean; config?: ITelemetryClientConfig; } export interface FeatureFlags { [featureFlag: string]: string | boolean | undefined; } export interface IConnectedNode { name: string; indicies: number[]; depth: number; } export enum OAuth2GrantType { authorizationCode = 'authorizationCode', clientCredentials = 'clientCredentials', } export interface IOAuth2Credentials { grantType: 'authorizationCode' | 'clientCredentials'; clientId: string; clientSecret: string; accessTokenUrl: string; authUrl: string; authQueryParameters: string; authentication: 'body' | 'header'; scope: string; oauthTokenData?: IDataObject; } export type PublicInstalledPackage = { packageName: string; installedVersion: string; authorName?: string; authorEmail?: string; installedNodes: PublicInstalledNode[]; createdAt: Date; updatedAt: Date; updateAvailable?: string; failedLoading?: boolean; }; export type PublicInstalledNode = { name: string; type: string; latestVersion: string; package: PublicInstalledPackage; }; export interface NodeExecutionWithMetadata extends INodeExecutionData { pairedItem: IPairedItemData | IPairedItemData[]; } export interface IExecutionsSummary { id: string; finished?: boolean; mode: WorkflowExecuteMode; retryOf?: string; retrySuccessId?: string; waitTill?: Date; startedAt: Date; stoppedAt?: Date; workflowId: string; workflowName?: string; status?: ExecutionStatus; lastNodeExecuted?: string; executionError?: ExecutionError; nodeExecutionStatus?: { [key: string]: IExceutionSummaryNodeExecutionResult; }; } export interface IExceutionSummaryNodeExecutionResult { executionStatus: ExecutionStatus; errors?: Array<{ name?: string; message?: string; description?: string; }>; }