| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931 |
- /* eslint-disable @typescript-eslint/no-non-null-assertion */
- import { Test, TestingModule } from '@nestjs/testing';
- import { TypeOrmModule } from '@nestjs/typeorm';
- import { DEFAULT_CHANNEL_CODE } from '@vendure/common/lib/shared-constants';
- import {
- DefaultLogger,
- EventBus,
- Injector,
- LanguageCode,
- Logger,
- LogLevel,
- Order,
- OrderStateTransitionEvent,
- PluginCommonModule,
- RequestContext,
- VendureEvent,
- } from '@vendure/core';
- import { ensureConfigLoaded } from '@vendure/core/dist/config/config-helpers';
- import { TestingLogger } from '@vendure/testing';
- import { createReadStream, readFileSync } from 'fs';
- import path from 'path';
- import { Readable } from 'stream';
- import { afterEach, beforeEach, describe, expect, it, Mock, vi } from 'vitest';
- import { orderConfirmationHandler } from './default-email-handlers';
- import { EmailProcessor } from './email-processor';
- import { EmailSender } from './email-sender';
- import { EmailEventHandler } from './event-handler';
- import { EmailEventListener } from './event-listener';
- import { EmailPlugin } from './plugin';
- import { EmailDetails, EmailPluginOptions, EmailTransportOptions } from './types';
- describe('EmailPlugin', () => {
- let eventBus: EventBus;
- let onSend: Mock;
- let module: TestingModule;
- const testingLogger = new TestingLogger((...args) => vi.fn(...args));
- async function initPluginWithHandlers(
- handlers: Array<EmailEventHandler<string, any>>,
- options?: Partial<EmailPluginOptions>,
- ) {
- await ensureConfigLoaded();
- onSend = vi.fn();
- module = await Test.createTestingModule({
- imports: [
- TypeOrmModule.forRoot({
- type: 'sqljs',
- retryAttempts: 0,
- }),
- PluginCommonModule,
- EmailPlugin.init({
- templatePath: path.join(__dirname, '../test-templates'),
- transport: {
- type: 'testing',
- onSend,
- },
- handlers,
- ...options,
- }),
- ],
- providers: [MockService],
- }).compile();
- Logger.useLogger(testingLogger);
- module.useLogger(new Logger());
- const plugin = module.get(EmailPlugin);
- eventBus = module.get(EventBus);
- await plugin.onApplicationBootstrap();
- return module;
- }
- afterEach(async () => {
- if (module) {
- await module.close();
- }
- });
- it('setting from, recipient, subject', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ subjectVar: 'foo' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello');
- expect(onSend.mock.calls[0][0].recipient).toBe('test@test.com');
- expect(onSend.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
- });
- describe('event filtering', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- it('single filter', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .filter(event => event.shouldSend === true)
- .setRecipient(() => 'test@test.com')
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('test subject');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, false));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend).toHaveBeenCalledTimes(1);
- });
- it('multiple filters', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .filter(event => event.shouldSend === true)
- .filter(event => !!event.ctx.activeUserId)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('test subject');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- const ctxWithUser = RequestContext.deserialize({ ...ctx, _session: { user: { id: 42 } } } as any);
- eventBus.publish(new MockEvent(ctxWithUser, true));
- await pause();
- expect(onSend).toHaveBeenCalledTimes(1);
- });
- it('with .loadData() after .filter()', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .filter(event => event.shouldSend === true)
- .loadData(context => Promise.resolve('loaded data'))
- .setRecipient(() => 'test@test.com')
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('test subject');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, false));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend).toHaveBeenCalledTimes(1);
- });
- });
- describe('templateVars', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- it('interpolates subject', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setTemplateVars(event => ({ subjectVar: 'foo' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello foo');
- });
- it('interpolates body', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ testVar: 'this is the test var' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].body).toContain('this is the test var');
- });
- /**
- * Intended to test the ability for Handlebars to interpolate
- * getters on the Order entity prototype.
- * See https://github.com/vendure-ecommerce/vendure/issues/259
- */
- it('interpolates body with property from entity', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ order: new Order({ subTotal: 123 }) }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].body).toContain('Total: 123');
- });
- it('interpolates globalTemplateVars', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ globalVar }}');
- await initPluginWithHandlers([handler], {
- globalTemplateVars: { globalVar: 'baz' },
- });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello baz');
- });
- it('interpolates from', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from {{ globalVar }}" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello');
- await initPluginWithHandlers([handler], {
- globalTemplateVars: { globalVar: 'baz' },
- });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].from).toBe('"test from baz" <noreply@test.com>');
- });
- // Test fix for https://github.com/vendure-ecommerce/vendure/issues/363
- it('does not escape HTML chars when interpolating "from"', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('{{ globalFrom }}')
- .setRecipient(() => 'Test <test@test.com>')
- .setSubject('Hello');
- await initPluginWithHandlers([handler], {
- globalTemplateVars: { globalFrom: 'Test <test@test.com>' },
- });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].from).toBe('Test <test@test.com>');
- });
- it('globalTemplateVars available in setTemplateVars method', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ testVar }}')
- .setTemplateVars((event, globals) => ({ testVar: (globals.globalVar as string) + ' quux' }));
- await initPluginWithHandlers([handler], {
- globalTemplateVars: { globalVar: 'baz' },
- });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello baz quux');
- });
- it('setTemplateVars overrides globals', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ name }}')
- .setTemplateVars((event, globals) => ({ name: 'quux' }));
- await initPluginWithHandlers([handler], { globalTemplateVars: { name: 'baz' } });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello quux');
- });
- });
- describe('handlebars helpers', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- it('formateDate', async () => {
- const handler = new EmailEventListener('test-helpers')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ myDate: new Date('2020-01-01T10:00:00.000Z'), myPrice: 0 }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].body).toContain('Date: Wed Jan 01 2020 10:00:00');
- });
- it('formatMoney', async () => {
- const handler = new EmailEventListener('test-helpers')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ myDate: new Date(), myPrice: 123 }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].body).toContain('Price: 1.23');
- });
- });
- describe('multiple configs', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- it('additional LanguageCode', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('Hello, {{ name }}!')
- .setRecipient(() => 'test@test.com')
- .setTemplateVars(() => ({ name: 'Test' }))
- .addTemplate({
- channelCode: 'default',
- languageCode: LanguageCode.de,
- templateFile: 'body.de.hbs',
- subject: 'Servus, {{ name }}!',
- });
- await initPluginWithHandlers([handler]);
- const ctxTa = RequestContext.deserialize({ ...ctx, _languageCode: LanguageCode.ta } as any);
- eventBus.publish(new MockEvent(ctxTa, true));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello, Test!');
- expect(onSend.mock.calls[0][0].body).toContain('Default body.');
- const ctxDe = RequestContext.deserialize({ ...ctx, _languageCode: LanguageCode.de } as any);
- eventBus.publish(new MockEvent(ctxDe, true));
- await pause();
- expect(onSend.mock.calls[1][0].subject).toBe('Servus, Test!');
- expect(onSend.mock.calls[1][0].body).toContain('German body.');
- });
- it('set LanguageCode', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('Hello, {{ name }}!')
- .setRecipient(() => 'test@test.com')
- .setLanguageCode(() => LanguageCode.de)
- .setTemplateVars(() => ({ name: 'Test' }))
- .addTemplate({
- channelCode: 'default',
- languageCode: LanguageCode.de,
- templateFile: 'body.de.hbs',
- subject: 'Servus, {{ name }}!',
- });
- const ctxEn = RequestContext.deserialize({ ...ctx, _languageCode: LanguageCode.en } as any);
- eventBus.publish(new MockEvent(ctxEn, true));
- await pause();
- expect(onSend.mock.calls[1][0].subject).toBe('Servus, Test!');
- expect(onSend.mock.calls[1][0].body).toContain('German body.');
- });
- });
- describe('loadData', () => {
- it('loads async data', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .loadData(async ({ injector }) => {
- const service = injector.get(MockService);
- return service.someAsyncMethod();
- })
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('Hello, {{ testData }}!')
- .setRecipient(() => 'test@test.com')
- .setTemplateVars(event => ({ testData: event.data }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(
- new MockEvent(
- RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any),
- true,
- ),
- );
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello, loaded data!');
- });
- it('works when loadData is called after other setup', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setSubject('Hello, {{ testData }}!')
- .setRecipient(() => 'test@test.com')
- .loadData(async ({ injector }) => {
- const service = injector.get(MockService);
- return service.someAsyncMethod();
- })
- .setTemplateVars(event => ({ testData: event.data }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(
- new MockEvent(
- RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any),
- true,
- ),
- );
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe('Hello, loaded data!');
- expect(onSend.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
- expect(onSend.mock.calls[0][0].recipient).toBe('test@test.com');
- });
- it('only executes for filtered events', async () => {
- let callCount = 0;
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .filter(event => event.shouldSend === true)
- .loadData(async ({ injector }) => {
- callCount++;
- });
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(RequestContext.empty(), false));
- eventBus.publish(new MockEvent(RequestContext.empty(), true));
- await pause();
- expect(callCount).toBe(1);
- });
- });
- describe('attachments', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- const TEST_IMAGE_PATH = path.join(__dirname, '../test-fixtures/test.jpg');
- it('attachments are empty by default', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].attachments).toEqual([]);
- });
- it('sync attachment', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- path: TEST_IMAGE_PATH,
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].attachments).toEqual([{ path: TEST_IMAGE_PATH }]);
- });
- it('async attachment', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(async () => [
- {
- path: TEST_IMAGE_PATH,
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].attachments).toEqual([{ path: TEST_IMAGE_PATH }]);
- });
- it('attachment content as a string buffer', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: Buffer.from('hello'),
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- const attachment = onSend.mock.calls[0][0].attachments[0].content;
- expect(Buffer.compare(attachment, Buffer.from('hello'))).toBe(0); // 0 = buffers are equal
- });
- it('attachment content as an image buffer', async () => {
- const imageFileBuffer = readFileSync(TEST_IMAGE_PATH);
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: imageFileBuffer,
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- const attachment = onSend.mock.calls[0][0].attachments[0].content;
- expect(Buffer.compare(attachment, imageFileBuffer)).toBe(0); // 0 = buffers are equal
- });
- it('attachment content as a string', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: 'hello',
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- const attachment = onSend.mock.calls[0][0].attachments[0].content;
- expect(attachment).toBe('hello');
- });
- it('attachment content as a string stream', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: Readable.from(['hello']),
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- const attachment = onSend.mock.calls[0][0].attachments[0].content;
- expect(Buffer.compare(attachment, Buffer.from('hello'))).toBe(0); // 0 = buffers are equal
- });
- it('attachment content as an image stream', async () => {
- const imageFileBuffer = readFileSync(TEST_IMAGE_PATH);
- const imageFileStream = createReadStream(TEST_IMAGE_PATH);
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: imageFileStream,
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- const attachment = onSend.mock.calls[0][0].attachments[0].content;
- expect(Buffer.compare(attachment, imageFileBuffer)).toBe(0); // 0 = buffers are equal
- });
- it('raises a warning for large content attachments', async () => {
- testingLogger.warnSpy.mockClear();
- const largeBuffer = Buffer.from(Array.from({ length: 65535, 0: 0 }));
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setAttachments(() => [
- {
- content: largeBuffer,
- },
- ]);
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(testingLogger.warnSpy.mock.calls[0][0]).toContain(
- 'Email has a large \'content\' attachment (64k). Consider using the \'path\' instead for improved performance.',
- );
- });
- });
- describe('orderConfirmationHandler', () => {
- beforeEach(async () => {
- await initPluginWithHandlers([orderConfirmationHandler], {
- templatePath: path.join(__dirname, '../templates'),
- });
- });
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- const order = {
- code: 'ABCDE',
- customer: {
- emailAddress: 'test@test.com',
- },
- lines: [],
- } as any;
- it('filters events with wrong order state', async () => {
- eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'ArrangingPayment', ctx, order));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'Cancelled', ctx, order));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'PaymentAuthorized', ctx, order));
- await pause();
- expect(onSend).not.toHaveBeenCalled();
- eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
- await pause();
- expect(onSend).toHaveBeenCalledTimes(1);
- });
- it('sets the Order Customer emailAddress as recipient', async () => {
- eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
- await pause();
- expect(onSend.mock.calls[0][0].recipient).toBe(order.customer!.emailAddress);
- });
- it('sets the subject', async () => {
- eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
- await pause();
- expect(onSend.mock.calls[0][0].subject).toBe(`Order confirmation for #${order.code as string}`);
- });
- });
- describe('error handling', () => {
- it('Logs an error if the template file is not found', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- testingLogger.errorSpy.mockClear();
- const handler = new EmailEventListener('no-template')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(testingLogger.errorSpy.mock.calls[0][0]).toContain('ENOENT: no such file or directory');
- });
- it('Logs a Handlebars error if the template is invalid', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- testingLogger.errorSpy.mockClear();
- const handler = new EmailEventListener('bad-template')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}');
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(testingLogger.errorSpy.mock.calls[0][0]).toContain('Parse error on line 3:');
- });
- it('Logs an error if the loadData method throws', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- testingLogger.errorSpy.mockClear();
- const handler = new EmailEventListener('bad-template')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .loadData(context => {
- throw new Error('something went horribly wrong!');
- });
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(testingLogger.errorSpy.mock.calls[0][0]).toContain('something went horribly wrong!');
- });
- });
- describe('custom sender', () => {
- it('should allow a custom sender to be utilized', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ subjectVar: 'foo' }));
- const fakeSender = new FakeCustomSender();
- const send = vi.fn();
- fakeSender.send = send;
- await initPluginWithHandlers([handler], {
- emailSender: fakeSender,
- });
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(send.mock.calls[0][0].subject).toBe('Hello');
- expect(send.mock.calls[0][0].recipient).toBe('test@test.com');
- expect(send.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
- expect(onSend).toHaveBeenCalledTimes(0);
- });
- });
- describe('optional address fields', () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- it('cc', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setOptionalAddressFields(() => ({ cc: 'foo@bar.com' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].cc).toBe('foo@bar.com');
- });
- it('bcc', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setOptionalAddressFields(() => ({ bcc: 'foo@bar.com' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].bcc).toBe('foo@bar.com');
- });
- it('replyTo', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello {{ subjectVar }}')
- .setOptionalAddressFields(() => ({ replyTo: 'foo@bar.com' }));
- await initPluginWithHandlers([handler]);
- eventBus.publish(new MockEvent(ctx, true));
- await pause();
- expect(onSend.mock.calls[0][0].replyTo).toBe('foo@bar.com');
- });
- });
- describe('Dynamic transport settings', () => {
- let injectorArg: Injector | undefined;
- let ctxArg: RequestContext | undefined;
- it('Initializes with async transport settings', async () => {
- const handler = new EmailEventListener('test')
- .on(MockEvent)
- .setFrom('"test from" <noreply@test.com>')
- .setRecipient(() => 'test@test.com')
- .setSubject('Hello')
- .setTemplateVars(event => ({ subjectVar: 'foo' }));
- module = await initPluginWithHandlers([handler], {
- transport: async (injector, ctx) => {
- injectorArg = injector;
- ctxArg = ctx;
- return {
- type: 'testing',
- onSend: () => {},
- }
- }
- });
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- module!.get(EventBus).publish(new MockEvent(ctx, true));
- await pause();
- expect(module).toBeDefined();
- expect(typeof (module.get(EmailPlugin) as any).options.transport).toBe('function');
- });
- it('Passes injector and context to transport function', async () => {
- const ctx = RequestContext.deserialize({
- _channel: { code: DEFAULT_CHANNEL_CODE },
- _languageCode: LanguageCode.en,
- } as any);
- module!.get(EventBus).publish(new MockEvent(ctx, true));
- await pause();
- expect(injectorArg?.constructor.name).toBe('Injector');
- expect(ctxArg?.constructor.name).toBe('RequestContext');
- });
- it('Resolves async transport settings', async () => {
- const transport = await module!.get(EmailProcessor).getTransportSettings();
- expect(transport.type).toBe('testing');
- });
- });
- });
- class FakeCustomSender implements EmailSender {
- send: (email: EmailDetails<'unserialized'>, options: EmailTransportOptions) => void;
- }
- const pause = () => new Promise(resolve => setTimeout(resolve, 100));
- class MockEvent extends VendureEvent {
- constructor(public ctx: RequestContext, public shouldSend: boolean) {
- super();
- }
- }
- class MockService {
- someAsyncMethod() {
- return Promise.resolve('loaded data');
- }
- }
|