n8n/packages/nodes-base/nodes/Files/ReadWriteFile/helpers/utils.ts

import type { IDataObject, IExecuteFunctions } from 'n8n-workflow';
import { NodeOperationError } from 'n8n-workflow';

export function errorMapper(
	this: IExecuteFunctions,
	error: Error,
	itemIndex: number,
	context?: IDataObject,
) {
	let message;
	let description;

	if (error.message.includes('Cannot create a string longer than')) {
		message = 'The file is too large';
		description =
			'The binary file you are attempting to read exceeds 512MB, which is limit when using default binary data mode, try using the filesystem binary mode. More information <a href="https://docs.n8n.io/hosting/scaling/binary-data/" target="_blank">here</a>.';
	} else if (error.message.includes('EACCES') && context?.operation === 'read') {
		const path =
			((error as unknown as IDataObject).path as string) || (context?.filePath as string);
		message = `You don't have the permissions to access ${path}`;
		description =
			"Verify that the path specified in 'File(s) Selector' is correct, or change the file(s) permissions if needed";
	} else if (error.message.includes('EACCES') && context?.operation === 'write') {
		const path =
			((error as unknown as IDataObject).path as string) || (context?.filePath as string);
		message = `You don't have the permissions to write the file ${path}`;
		description =
			"Specify another destination folder in 'File Path and Name', or change the permissions of the parent folder";
	}

	return new NodeOperationError(this.getNode(), error, { itemIndex, message, description });
}

export function escapeSpecialCharacters(str: string) {
	// Escape parentheses
	str = str.replace(/[()]/g, '\\$&');

	return str;
}