first commit
Security: Sync from Public / sync-from-public (push) Has been cancelled
Test: Benchmark Nightly / build (push) Has been cancelled
Test: Benchmark Nightly / Notify Cats on failure (push) Has been cancelled
CI: Python / Checks (push) Has been cancelled
Test: Evals Python / Workflow Comparison Python (push) Has been cancelled
Util: Check Docs URLs / check-docs-urls (push) Has been cancelled
Test: Visual Storybook / Cloudflare Pages (push) Has been cancelled
Test: E2E Performance / build-and-test-performance (push) Has been cancelled
Test: Workflows Nightly / Run Workflow Tests (push) Has been cancelled
Util: Cleanup CI Docker Images / Delete stale CI images (push) Has been cancelled
Test: Benchmark Destroy Env / build (push) Has been cancelled
Util: Update Node Popularity / update-popularity (push) Has been cancelled
Test: E2E Coverage Weekly / Coverage Tests (push) Has been cancelled

This commit is contained in:
2026-03-17 16:22:57 +03:30
commit 3d5eaf9445
15349 changed files with 2847338 additions and 0 deletions
@@ -0,0 +1,520 @@
import type { IExecuteFunctions, IBinaryData } from 'n8n-workflow';
import { EmailSendV1 } from '../../v1/EmailSendV1.node';
import { prepareBinariesDataList } from '../../../../utils/binary';
const transporter = { sendMail: jest.fn() };
jest.mock('nodemailer', () => ({
createTransport: jest.fn(() => transporter),
}));
describe('Test EmailSendV1', () => {
let emailSendV1: EmailSendV1;
let mockExecuteFunctions: jest.Mocked<IExecuteFunctions>;
beforeEach(() => {
emailSendV1 = new EmailSendV1({
description: {
displayName: 'Send Email',
name: 'emailSend',
icon: 'fa:envelope',
group: ['output'],
description: 'Sends an Email',
version: 1,
defaults: {
name: 'Send Email',
color: '#00bb88',
},
},
} as any);
mockExecuteFunctions = {
getInputData: jest.fn(),
getCredentials: jest.fn(),
getNodeParameter: jest.fn(),
helpers: {
assertBinaryData: jest.fn(),
getBinaryDataBuffer: jest.fn(),
},
continueOnFail: jest.fn(() => false),
} as unknown as jest.Mocked<IExecuteFunctions>;
jest.clearAllMocks();
});
describe('comma-separated attachment strings', () => {
it('should process comma-separated attachment names with spaces', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
file3: { data: 'data3', mimeType: 'text/plain', fileName: 'file3.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce('file1, file2, file3')
.mockReturnValueOnce({});
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.txt' }),
expect.objectContaining({ filename: 'file3.txt' }),
],
}),
);
});
it('should process comma-separated attachment names without spaces', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce('file1,file2')
.mockReturnValueOnce({});
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.txt' }),
],
}),
);
});
it('should trim extra spaces from attachment names', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce(' file1 , file2 ')
.mockReturnValueOnce({});
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.txt' }),
],
}),
);
});
it('should process single attachment name', async () => {
const items = [
{
json: { data: 'test' },
binary: {
singleFile: {
data: 'data1',
mimeType: 'text/plain',
fileName: 'single.txt',
} as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce('singleFile')
.mockReturnValueOnce({});
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [expect.objectContaining({ filename: 'single.txt' })],
}),
);
});
});
describe('prepareBinariesDataList helper function', () => {
it('should process string attachment names correctly', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce('file1, file2')
.mockReturnValueOnce({});
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
const result = prepareBinariesDataList('file1, file2');
expect(result).toEqual(['file1', 'file2']);
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: expect.arrayContaining([
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.txt' }),
]),
}),
);
});
it('should wrap IBinaryData object in array', () => {
const input = { data: 'data1', mimeType: 'text/plain', fileName: 'file.txt' };
const result = prepareBinariesDataList(input);
expect(result).toEqual([input]);
expect(result).toHaveLength(1);
});
it('should return IBinaryData array unchanged', () => {
const input = [
{ data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' },
{ data: 'data2', mimeType: 'image/png', fileName: 'file2.png' },
];
const result = prepareBinariesDataList(input);
expect(result).toEqual(input);
expect(result).toHaveLength(2);
});
it('should return string array unchanged', () => {
const input = ['file1', 'file2', 'file3'];
const result = prepareBinariesDataList(input);
expect(result).toEqual(['file1', 'file2', 'file3']);
});
it('should process IBinaryData object as attachment', async () => {
const binaryDataObject = { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' };
const items = [
{
json: { data: 'test' },
binary: {} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce(binaryDataObject)
.mockReturnValueOnce({});
// Mock helpers to handle IBinaryData objects directly
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string | IBinaryData) => {
// If propertyName is already an IBinaryData object, return it
if (typeof propertyName === 'object') {
return propertyName;
}
// Otherwise look it up in binary data
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string | IBinaryData) => {
// If propertyName is already an IBinaryData object, use it directly
const binaryData =
typeof propertyName === 'object'
? propertyName
: items[itemIndex].binary![propertyName];
return Buffer.from(binaryData.data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
const result = prepareBinariesDataList(binaryDataObject);
expect(result).toEqual([binaryDataObject]);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [expect.objectContaining({ filename: 'file1.txt' })],
}),
);
});
it('should process IBinaryData array as attachments', async () => {
const binaryDataArray = [
{ data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' },
{ data: 'data2', mimeType: 'image/png', fileName: 'file2.png' },
];
const items = [
{
json: { data: 'test' },
binary: {} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce(binaryDataArray)
.mockReturnValueOnce({});
// Mock helpers to handle IBinaryData objects directly
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string | IBinaryData) => {
// If propertyName is already an IBinaryData object, return it
if (typeof propertyName === 'object') {
return propertyName;
}
// Otherwise look it up in binary data
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string | IBinaryData) => {
// If propertyName is already an IBinaryData object, use it directly
const binaryData =
typeof propertyName === 'object'
? propertyName
: items[itemIndex].binary![propertyName];
return Buffer.from(binaryData.data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
const result = prepareBinariesDataList(binaryDataArray);
expect(result).toEqual(binaryDataArray);
expect(result).toHaveLength(2);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.png' }),
],
}),
);
});
});
describe('emails without attachments', () => {
it('should send email when attachment string is empty', async () => {
const items = [{ json: { data: 'test' } }];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
secure: false,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('')
.mockReturnValueOnce('')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('Test text')
.mockReturnValueOnce('<p>Test HTML</p>')
.mockReturnValueOnce('')
.mockReturnValueOnce({});
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await emailSendV1.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.not.objectContaining({
attachments: expect.anything(),
}),
);
});
});
});
@@ -0,0 +1,485 @@
import type { IExecuteFunctions, IBinaryData } from 'n8n-workflow';
import * as sendOperation from '../../v2/send.operation';
import { prepareBinariesDataList } from '../../../../utils/binary';
const transporter = { sendMail: jest.fn() };
jest.mock('../../v2/utils', () => {
const originalModule = jest.requireActual('../../v2/utils');
return {
...originalModule,
configureTransport: jest.fn(() => transporter),
};
});
describe('Test EmailSendV2, send operation', () => {
let mockExecuteFunctions: jest.Mocked<IExecuteFunctions>;
beforeEach(() => {
mockExecuteFunctions = {
getInputData: jest.fn(),
getNode: jest.fn(),
getInstanceId: jest.fn(),
getCredentials: jest.fn(),
getNodeParameter: jest.fn(),
helpers: {
assertBinaryData: jest.fn(),
getBinaryDataBuffer: jest.fn(),
},
} as unknown as jest.Mocked<IExecuteFunctions>;
jest.clearAllMocks();
});
describe('comma-separated attachment strings', () => {
it('should process comma-separated attachment names with spaces', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
file3: { data: 'data3', mimeType: 'text/plain', fileName: 'file3.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: 'file1, file2, file3', appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt', cid: 'file1' }),
expect.objectContaining({ filename: 'file2.txt', cid: 'file2' }),
expect.objectContaining({ filename: 'file3.txt', cid: 'file3' }),
],
}),
);
});
it('should process comma-separated attachment names without spaces', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: 'file1,file2', appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt', cid: 'file1' }),
expect.objectContaining({ filename: 'file2.txt', cid: 'file2' }),
],
}),
);
});
it('should trim extra spaces from attachment names', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: ' file1 , file2 ', appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt', cid: 'file1' }),
expect.objectContaining({ filename: 'file2.txt', cid: 'file2' }),
],
}),
);
});
it('should process single attachment name', async () => {
const items = [
{
json: { data: 'test' },
binary: {
singleFile: {
data: 'data1',
mimeType: 'text/plain',
fileName: 'single.txt',
} as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: 'singleFile', appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [expect.objectContaining({ filename: 'single.txt', cid: 'singleFile' })],
}),
);
});
});
describe('prepareBinariesDataList helper function', () => {
it('should process string attachment names correctly', async () => {
const items = [
{
json: { data: 'test' },
binary: {
file1: { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' } as IBinaryData,
file2: { data: 'data2', mimeType: 'text/plain', fileName: 'file2.txt' } as IBinaryData,
} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: 'file1, file2', appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string) => {
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string) => {
return Buffer.from(items[itemIndex].binary![propertyName].data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
const result = prepareBinariesDataList('file1, file2');
expect(result).toEqual(['file1', 'file2']);
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: expect.arrayContaining([
expect.objectContaining({ cid: 'file1' }),
expect.objectContaining({ cid: 'file2' }),
]),
}),
);
});
it('should wrap IBinaryData object in array', () => {
const input = { data: 'data1', mimeType: 'text/plain', fileName: 'file.txt' };
const result = prepareBinariesDataList(input);
expect(result).toEqual([input]);
expect(result).toHaveLength(1);
});
it('should return IBinaryData array unchanged', () => {
const input = [
{ data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' },
{ data: 'data2', mimeType: 'image/png', fileName: 'file2.png' },
];
const result = prepareBinariesDataList(input);
expect(result).toEqual(input);
expect(result).toHaveLength(2);
});
it('should return string array unchanged', () => {
const input = ['file1', 'file2', 'file3'];
const result = prepareBinariesDataList(input);
expect(result).toEqual(['file1', 'file2', 'file3']);
});
it('should process IBinaryData object as attachment', async () => {
const binaryDataObject = { data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' };
const items = [
{
json: { data: 'test' },
binary: {} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: binaryDataObject, appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string | IBinaryData) => {
if (typeof propertyName === 'object') {
return propertyName;
}
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string | IBinaryData) => {
const binaryData =
typeof propertyName === 'object'
? propertyName
: items[itemIndex].binary![propertyName];
return Buffer.from(binaryData.data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
const result = prepareBinariesDataList(binaryDataObject);
expect(result).toEqual([binaryDataObject]);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [expect.objectContaining({ filename: 'file1.txt', cid: binaryDataObject })],
}),
);
});
it('should process IBinaryData array as attachments', async () => {
const binaryDataArray = [
{ data: 'data1', mimeType: 'text/plain', fileName: 'file1.txt' },
{ data: 'data2', mimeType: 'image/png', fileName: 'file2.png' },
];
const items = [
{
json: { data: 'test' },
binary: {} as Record<string, IBinaryData>,
},
];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ attachments: binaryDataArray, appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
(mockExecuteFunctions.helpers.assertBinaryData as jest.Mock).mockImplementation(
(itemIndex: number, propertyName: string | IBinaryData) => {
if (typeof propertyName === 'object') {
return propertyName;
}
return items[itemIndex].binary![propertyName];
},
);
(mockExecuteFunctions.helpers.getBinaryDataBuffer as jest.Mock).mockImplementation(
async (itemIndex: number, propertyName: string | IBinaryData) => {
const binaryData =
typeof propertyName === 'object'
? propertyName
: items[itemIndex].binary![propertyName];
return Buffer.from(binaryData.data);
},
);
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
const result = prepareBinariesDataList(binaryDataArray);
expect(result).toEqual(binaryDataArray);
expect(result).toHaveLength(2);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.objectContaining({
attachments: [
expect.objectContaining({ filename: 'file1.txt' }),
expect.objectContaining({ filename: 'file2.png' }),
],
}),
);
});
});
describe('emails without attachments', () => {
it('should send email when no attachments specified', async () => {
const items = [{ json: { data: 'test' } }];
mockExecuteFunctions.getInputData.mockReturnValue(items);
mockExecuteFunctions.getNode.mockReturnValue({ typeVersion: 2.0 } as any);
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({
host: 'smtp.example.com',
port: 587,
});
mockExecuteFunctions.getNodeParameter
.mockReturnValueOnce('from@example.com')
.mockReturnValueOnce('to@example.com')
.mockReturnValueOnce('Test Subject')
.mockReturnValueOnce('html')
.mockReturnValueOnce({ appendAttribution: false })
.mockReturnValueOnce('<p>Test HTML</p>');
transporter.sendMail.mockResolvedValue({ messageId: 'test-id' });
await sendOperation.execute.call(mockExecuteFunctions);
expect(transporter.sendMail).toHaveBeenCalledWith(
expect.not.objectContaining({
attachments: expect.anything(),
}),
);
});
});
});
@@ -0,0 +1,72 @@
import type { MockProxy } from 'jest-mock-extended';
import { mock } from 'jest-mock-extended';
import { SEND_AND_WAIT_OPERATION, type IExecuteFunctions } from 'n8n-workflow';
import { EmailSendV2, versionDescription } from '../../v2/EmailSendV2.node';
import * as utils from '../../v2/utils';
const transporter = { sendMail: jest.fn() };
jest.mock('../../v2/utils', () => {
const originalModule = jest.requireActual('../../v2/utils');
return {
...originalModule,
configureTransport: jest.fn(() => transporter),
};
});
describe('Test EmailSendV2, email => sendAndWait', () => {
let emailSendV2: EmailSendV2;
let mockExecuteFunctions: MockProxy<IExecuteFunctions>;
beforeEach(() => {
emailSendV2 = new EmailSendV2(versionDescription);
mockExecuteFunctions = mock<IExecuteFunctions>();
});
afterEach(() => {
jest.clearAllMocks();
});
it('should send message and put execution to wait', async () => {
const items = [{ json: { data: 'test' } }];
//node
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce(SEND_AND_WAIT_OPERATION);
//operation
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce('from@mail.com');
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce('to@mail.com');
mockExecuteFunctions.getInstanceId.mockReturnValue('instanceId');
mockExecuteFunctions.getCredentials.mockResolvedValue({});
mockExecuteFunctions.putExecutionToWait.mockImplementation();
mockExecuteFunctions.getInputData.mockReturnValue(items);
//getSendAndWaitConfig
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce('my message');
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce('my subject');
mockExecuteFunctions.getSignedResumeUrl.mockReturnValue(
'http://localhost/waiting-webhook/nodeID?approved=true&signature=abc',
);
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce({}); // approvalOptions
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce({}); // options
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce('approval');
// configureWaitTillDate
mockExecuteFunctions.getNodeParameter.mockReturnValueOnce({}); //options.limitWaitTime.values
const result = await emailSendV2.execute.call(mockExecuteFunctions);
expect(result).toEqual([items]);
expect(utils.configureTransport).toHaveBeenCalledTimes(1);
expect(mockExecuteFunctions.putExecutionToWait).toHaveBeenCalledTimes(1);
expect(transporter.sendMail).toHaveBeenCalledWith({
from: 'from@mail.com',
html: expect.stringContaining(
'href="http://localhost/waiting-webhook/nodeID?approved=true&signature=abc"',
),
subject: 'my subject',
to: 'to@mail.com',
});
});
});