plugin.spec.ts 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854
  1. /* tslint:disable:no-non-null-assertion */
  2. import { Test, TestingModule } from '@nestjs/testing';
  3. import { TypeOrmModule } from '@nestjs/typeorm';
  4. import { DEFAULT_CHANNEL_CODE } from '@vendure/common/lib/shared-constants';
  5. import {
  6. EventBus,
  7. LanguageCode,
  8. Logger,
  9. Order,
  10. OrderStateTransitionEvent,
  11. PluginCommonModule,
  12. RequestContext,
  13. VendureEvent,
  14. } from '@vendure/core';
  15. import { TestingLogger } from '@vendure/testing';
  16. import { createReadStream, readFileSync } from 'fs';
  17. import { readFile } from 'fs-extra';
  18. import path from 'path';
  19. import { Readable } from 'stream';
  20. import { orderConfirmationHandler } from './default-email-handlers';
  21. import { EmailEventHandler } from './event-handler';
  22. import { EmailEventListener } from './event-listener';
  23. import { EmailPlugin } from './plugin';
  24. import { EmailDetails, EmailPluginOptions, EmailSender, EmailTransportOptions } from './types';
  25. describe('EmailPlugin', () => {
  26. let eventBus: EventBus;
  27. let onSend: jest.Mock;
  28. let module: TestingModule;
  29. const testingLogger = new TestingLogger(() => jest.fn());
  30. async function initPluginWithHandlers(
  31. handlers: Array<EmailEventHandler<string, any>>,
  32. options?: Partial<EmailPluginOptions>,
  33. ) {
  34. onSend = jest.fn();
  35. module = await Test.createTestingModule({
  36. imports: [
  37. TypeOrmModule.forRoot({
  38. type: 'sqljs',
  39. retryAttempts: 0,
  40. }),
  41. PluginCommonModule,
  42. EmailPlugin.init({
  43. templatePath: path.join(__dirname, '../test-templates'),
  44. transport: {
  45. type: 'testing',
  46. onSend,
  47. },
  48. handlers,
  49. ...options,
  50. }),
  51. ],
  52. providers: [MockService],
  53. }).compile();
  54. Logger.useLogger(testingLogger);
  55. module.useLogger(new Logger());
  56. const plugin = module.get(EmailPlugin);
  57. eventBus = module.get(EventBus);
  58. await plugin.onApplicationBootstrap();
  59. return module;
  60. }
  61. afterEach(async () => {
  62. if (module) {
  63. await module.close();
  64. }
  65. });
  66. it('setting from, recipient, subject', async () => {
  67. const ctx = RequestContext.deserialize({
  68. _channel: { code: DEFAULT_CHANNEL_CODE },
  69. _languageCode: LanguageCode.en,
  70. } as any);
  71. const handler = new EmailEventListener('test')
  72. .on(MockEvent)
  73. .setFrom('"test from" <noreply@test.com>')
  74. .setRecipient(() => 'test@test.com')
  75. .setSubject('Hello')
  76. .setTemplateVars(event => ({ subjectVar: 'foo' }));
  77. await initPluginWithHandlers([handler]);
  78. eventBus.publish(new MockEvent(ctx, true));
  79. await pause();
  80. expect(onSend.mock.calls[0][0].subject).toBe('Hello');
  81. expect(onSend.mock.calls[0][0].recipient).toBe('test@test.com');
  82. expect(onSend.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
  83. });
  84. describe('event filtering', () => {
  85. const ctx = RequestContext.deserialize({
  86. _channel: { code: DEFAULT_CHANNEL_CODE },
  87. _languageCode: LanguageCode.en,
  88. } as any);
  89. it('single filter', async () => {
  90. const handler = new EmailEventListener('test')
  91. .on(MockEvent)
  92. .filter(event => event.shouldSend === true)
  93. .setRecipient(() => 'test@test.com')
  94. .setFrom('"test from" <noreply@test.com>')
  95. .setSubject('test subject');
  96. await initPluginWithHandlers([handler]);
  97. eventBus.publish(new MockEvent(ctx, false));
  98. await pause();
  99. expect(onSend).not.toHaveBeenCalled();
  100. eventBus.publish(new MockEvent(ctx, true));
  101. await pause();
  102. expect(onSend).toHaveBeenCalledTimes(1);
  103. });
  104. it('multiple filters', async () => {
  105. const handler = new EmailEventListener('test')
  106. .on(MockEvent)
  107. .filter(event => event.shouldSend === true)
  108. .filter(event => !!event.ctx.activeUserId)
  109. .setFrom('"test from" <noreply@test.com>')
  110. .setRecipient(() => 'test@test.com')
  111. .setSubject('test subject');
  112. await initPluginWithHandlers([handler]);
  113. eventBus.publish(new MockEvent(ctx, true));
  114. await pause();
  115. expect(onSend).not.toHaveBeenCalled();
  116. const ctxWithUser = RequestContext.deserialize({ ...ctx, _session: { user: { id: 42 } } } as any);
  117. eventBus.publish(new MockEvent(ctxWithUser, true));
  118. await pause();
  119. expect(onSend).toHaveBeenCalledTimes(1);
  120. });
  121. it('with .loadData() after .filter()', async () => {
  122. const handler = new EmailEventListener('test')
  123. .on(MockEvent)
  124. .filter(event => event.shouldSend === true)
  125. .loadData(context => Promise.resolve('loaded data'))
  126. .setRecipient(() => 'test@test.com')
  127. .setFrom('"test from" <noreply@test.com>')
  128. .setSubject('test subject');
  129. await initPluginWithHandlers([handler]);
  130. eventBus.publish(new MockEvent(ctx, false));
  131. await pause();
  132. expect(onSend).not.toHaveBeenCalled();
  133. eventBus.publish(new MockEvent(ctx, true));
  134. await pause();
  135. expect(onSend).toHaveBeenCalledTimes(1);
  136. });
  137. });
  138. describe('templateVars', () => {
  139. const ctx = RequestContext.deserialize({
  140. _channel: { code: DEFAULT_CHANNEL_CODE },
  141. _languageCode: LanguageCode.en,
  142. } as any);
  143. it('interpolates subject', async () => {
  144. const handler = new EmailEventListener('test')
  145. .on(MockEvent)
  146. .setFrom('"test from" <noreply@test.com>')
  147. .setRecipient(() => 'test@test.com')
  148. .setSubject('Hello {{ subjectVar }}')
  149. .setTemplateVars(event => ({ subjectVar: 'foo' }));
  150. await initPluginWithHandlers([handler]);
  151. eventBus.publish(new MockEvent(ctx, true));
  152. await pause();
  153. expect(onSend.mock.calls[0][0].subject).toBe('Hello foo');
  154. });
  155. it('interpolates body', async () => {
  156. const handler = new EmailEventListener('test')
  157. .on(MockEvent)
  158. .setFrom('"test from" <noreply@test.com>')
  159. .setRecipient(() => 'test@test.com')
  160. .setSubject('Hello')
  161. .setTemplateVars(event => ({ testVar: 'this is the test var' }));
  162. await initPluginWithHandlers([handler]);
  163. eventBus.publish(new MockEvent(ctx, true));
  164. await pause();
  165. expect(onSend.mock.calls[0][0].body).toContain('this is the test var');
  166. });
  167. /**
  168. * Intended to test the ability for Handlebars to interpolate
  169. * getters on the Order entity prototype.
  170. * See https://github.com/vendure-ecommerce/vendure/issues/259
  171. */
  172. it('interpolates body with property from entity', async () => {
  173. const handler = new EmailEventListener('test')
  174. .on(MockEvent)
  175. .setFrom('"test from" <noreply@test.com>')
  176. .setRecipient(() => 'test@test.com')
  177. .setSubject('Hello')
  178. .setTemplateVars(event => ({ order: new Order({ subTotal: 123 }) }));
  179. await initPluginWithHandlers([handler]);
  180. eventBus.publish(new MockEvent(ctx, true));
  181. await pause();
  182. expect(onSend.mock.calls[0][0].body).toContain('Total: 123');
  183. });
  184. it('interpolates globalTemplateVars', async () => {
  185. const handler = new EmailEventListener('test')
  186. .on(MockEvent)
  187. .setFrom('"test from" <noreply@test.com>')
  188. .setRecipient(() => 'test@test.com')
  189. .setSubject('Hello {{ globalVar }}');
  190. await initPluginWithHandlers([handler], {
  191. globalTemplateVars: { globalVar: 'baz' },
  192. });
  193. eventBus.publish(new MockEvent(ctx, true));
  194. await pause();
  195. expect(onSend.mock.calls[0][0].subject).toBe('Hello baz');
  196. });
  197. it('interpolates from', async () => {
  198. const handler = new EmailEventListener('test')
  199. .on(MockEvent)
  200. .setFrom('"test from {{ globalVar }}" <noreply@test.com>')
  201. .setRecipient(() => 'test@test.com')
  202. .setSubject('Hello');
  203. await initPluginWithHandlers([handler], {
  204. globalTemplateVars: { globalVar: 'baz' },
  205. });
  206. eventBus.publish(new MockEvent(ctx, true));
  207. await pause();
  208. expect(onSend.mock.calls[0][0].from).toBe('"test from baz" <noreply@test.com>');
  209. });
  210. // Test fix for https://github.com/vendure-ecommerce/vendure/issues/363
  211. it('does not escape HTML chars when interpolating "from"', async () => {
  212. const handler = new EmailEventListener('test')
  213. .on(MockEvent)
  214. .setFrom('{{ globalFrom }}')
  215. .setRecipient(() => 'Test <test@test.com>')
  216. .setSubject('Hello');
  217. await initPluginWithHandlers([handler], {
  218. globalTemplateVars: { globalFrom: 'Test <test@test.com>' },
  219. });
  220. eventBus.publish(new MockEvent(ctx, true));
  221. await pause();
  222. expect(onSend.mock.calls[0][0].from).toBe('Test <test@test.com>');
  223. });
  224. it('globalTemplateVars available in setTemplateVars method', async () => {
  225. const handler = new EmailEventListener('test')
  226. .on(MockEvent)
  227. .setFrom('"test from" <noreply@test.com>')
  228. .setRecipient(() => 'test@test.com')
  229. .setSubject('Hello {{ testVar }}')
  230. .setTemplateVars((event, globals) => ({ testVar: globals.globalVar + ' quux' }));
  231. await initPluginWithHandlers([handler], {
  232. globalTemplateVars: { globalVar: 'baz' },
  233. });
  234. eventBus.publish(new MockEvent(ctx, true));
  235. await pause();
  236. expect(onSend.mock.calls[0][0].subject).toBe('Hello baz quux');
  237. });
  238. it('setTemplateVars overrides globals', async () => {
  239. const handler = new EmailEventListener('test')
  240. .on(MockEvent)
  241. .setFrom('"test from" <noreply@test.com>')
  242. .setRecipient(() => 'test@test.com')
  243. .setSubject('Hello {{ name }}')
  244. .setTemplateVars((event, globals) => ({ name: 'quux' }));
  245. await initPluginWithHandlers([handler], { globalTemplateVars: { name: 'baz' } });
  246. eventBus.publish(new MockEvent(ctx, true));
  247. await pause();
  248. expect(onSend.mock.calls[0][0].subject).toBe('Hello quux');
  249. });
  250. });
  251. describe('handlebars helpers', () => {
  252. const ctx = RequestContext.deserialize({
  253. _channel: { code: DEFAULT_CHANNEL_CODE },
  254. _languageCode: LanguageCode.en,
  255. } as any);
  256. it('formateDate', async () => {
  257. const handler = new EmailEventListener('test-helpers')
  258. .on(MockEvent)
  259. .setFrom('"test from" <noreply@test.com>')
  260. .setRecipient(() => 'test@test.com')
  261. .setSubject('Hello')
  262. .setTemplateVars(event => ({ myDate: new Date('2020-01-01T10:00:00.000Z'), myPrice: 0 }));
  263. await initPluginWithHandlers([handler]);
  264. eventBus.publish(new MockEvent(ctx, true));
  265. await pause();
  266. expect(onSend.mock.calls[0][0].body).toContain('Date: Wed Jan 01 2020 10:00:00');
  267. });
  268. it('formatMoney', async () => {
  269. const handler = new EmailEventListener('test-helpers')
  270. .on(MockEvent)
  271. .setFrom('"test from" <noreply@test.com>')
  272. .setRecipient(() => 'test@test.com')
  273. .setSubject('Hello')
  274. .setTemplateVars(event => ({ myDate: new Date(), myPrice: 123 }));
  275. await initPluginWithHandlers([handler]);
  276. eventBus.publish(new MockEvent(ctx, true));
  277. await pause();
  278. expect(onSend.mock.calls[0][0].body).toContain('Price: 1.23');
  279. });
  280. });
  281. describe('multiple configs', () => {
  282. const ctx = RequestContext.deserialize({
  283. _channel: { code: DEFAULT_CHANNEL_CODE },
  284. _languageCode: LanguageCode.en,
  285. } as any);
  286. it('additional LanguageCode', async () => {
  287. const handler = new EmailEventListener('test')
  288. .on(MockEvent)
  289. .setFrom('"test from" <noreply@test.com>')
  290. .setSubject('Hello, {{ name }}!')
  291. .setRecipient(() => 'test@test.com')
  292. .setTemplateVars(() => ({ name: 'Test' }))
  293. .addTemplate({
  294. channelCode: 'default',
  295. languageCode: LanguageCode.de,
  296. templateFile: 'body.de.hbs',
  297. subject: 'Servus, {{ name }}!',
  298. });
  299. await initPluginWithHandlers([handler]);
  300. const ctxTa = RequestContext.deserialize({ ...ctx, _languageCode: LanguageCode.ta } as any);
  301. eventBus.publish(new MockEvent(ctxTa, true));
  302. await pause();
  303. expect(onSend.mock.calls[0][0].subject).toBe('Hello, Test!');
  304. expect(onSend.mock.calls[0][0].body).toContain('Default body.');
  305. const ctxDe = RequestContext.deserialize({ ...ctx, _languageCode: LanguageCode.de } as any);
  306. eventBus.publish(new MockEvent(ctxDe, true));
  307. await pause();
  308. expect(onSend.mock.calls[1][0].subject).toBe('Servus, Test!');
  309. expect(onSend.mock.calls[1][0].body).toContain('German body.');
  310. });
  311. });
  312. describe('loadData', () => {
  313. it('loads async data', async () => {
  314. const handler = new EmailEventListener('test')
  315. .on(MockEvent)
  316. .loadData(async ({ injector }) => {
  317. const service = injector.get(MockService);
  318. return service.someAsyncMethod();
  319. })
  320. .setFrom('"test from" <noreply@test.com>')
  321. .setSubject('Hello, {{ testData }}!')
  322. .setRecipient(() => 'test@test.com')
  323. .setTemplateVars(event => ({ testData: event.data }));
  324. await initPluginWithHandlers([handler]);
  325. eventBus.publish(
  326. new MockEvent(
  327. RequestContext.deserialize({
  328. _channel: { code: DEFAULT_CHANNEL_CODE },
  329. _languageCode: LanguageCode.en,
  330. } as any),
  331. true,
  332. ),
  333. );
  334. await pause();
  335. expect(onSend.mock.calls[0][0].subject).toBe('Hello, loaded data!');
  336. });
  337. it('works when loadData is called after other setup', async () => {
  338. const handler = new EmailEventListener('test')
  339. .on(MockEvent)
  340. .setFrom('"test from" <noreply@test.com>')
  341. .setSubject('Hello, {{ testData }}!')
  342. .setRecipient(() => 'test@test.com')
  343. .loadData(async ({ injector }) => {
  344. const service = injector.get(MockService);
  345. return service.someAsyncMethod();
  346. })
  347. .setTemplateVars(event => ({ testData: event.data }));
  348. await initPluginWithHandlers([handler]);
  349. eventBus.publish(
  350. new MockEvent(
  351. RequestContext.deserialize({
  352. _channel: { code: DEFAULT_CHANNEL_CODE },
  353. _languageCode: LanguageCode.en,
  354. } as any),
  355. true,
  356. ),
  357. );
  358. await pause();
  359. expect(onSend.mock.calls[0][0].subject).toBe('Hello, loaded data!');
  360. expect(onSend.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
  361. expect(onSend.mock.calls[0][0].recipient).toBe('test@test.com');
  362. });
  363. it('only executes for filtered events', async () => {
  364. let callCount = 0;
  365. const handler = new EmailEventListener('test')
  366. .on(MockEvent)
  367. .filter(event => event.shouldSend === true)
  368. .loadData(async ({ injector }) => {
  369. callCount++;
  370. });
  371. await initPluginWithHandlers([handler]);
  372. eventBus.publish(new MockEvent(RequestContext.empty(), false));
  373. eventBus.publish(new MockEvent(RequestContext.empty(), true));
  374. await pause();
  375. expect(callCount).toBe(1);
  376. });
  377. });
  378. describe('attachments', () => {
  379. const ctx = RequestContext.deserialize({
  380. _channel: { code: DEFAULT_CHANNEL_CODE },
  381. _languageCode: LanguageCode.en,
  382. } as any);
  383. const TEST_IMAGE_PATH = path.join(__dirname, '../test-fixtures/test.jpg');
  384. it('attachments are empty by default', async () => {
  385. const handler = new EmailEventListener('test')
  386. .on(MockEvent)
  387. .setFrom('"test from" <noreply@test.com>')
  388. .setRecipient(() => 'test@test.com')
  389. .setSubject('Hello {{ subjectVar }}');
  390. await initPluginWithHandlers([handler]);
  391. eventBus.publish(new MockEvent(ctx, true));
  392. await pause();
  393. expect(onSend.mock.calls[0][0].attachments).toEqual([]);
  394. });
  395. it('sync attachment', async () => {
  396. const handler = new EmailEventListener('test')
  397. .on(MockEvent)
  398. .setFrom('"test from" <noreply@test.com>')
  399. .setRecipient(() => 'test@test.com')
  400. .setSubject('Hello {{ subjectVar }}')
  401. .setAttachments(() => [
  402. {
  403. path: TEST_IMAGE_PATH,
  404. },
  405. ]);
  406. await initPluginWithHandlers([handler]);
  407. eventBus.publish(new MockEvent(ctx, true));
  408. await pause();
  409. expect(onSend.mock.calls[0][0].attachments).toEqual([{ path: TEST_IMAGE_PATH }]);
  410. });
  411. it('async attachment', async () => {
  412. const handler = new EmailEventListener('test')
  413. .on(MockEvent)
  414. .setFrom('"test from" <noreply@test.com>')
  415. .setRecipient(() => 'test@test.com')
  416. .setSubject('Hello {{ subjectVar }}')
  417. .setAttachments(async () => [
  418. {
  419. path: TEST_IMAGE_PATH,
  420. },
  421. ]);
  422. await initPluginWithHandlers([handler]);
  423. eventBus.publish(new MockEvent(ctx, true));
  424. await pause();
  425. expect(onSend.mock.calls[0][0].attachments).toEqual([{ path: TEST_IMAGE_PATH }]);
  426. });
  427. it('attachment content as a string buffer', async () => {
  428. const handler = new EmailEventListener('test')
  429. .on(MockEvent)
  430. .setFrom('"test from" <noreply@test.com>')
  431. .setRecipient(() => 'test@test.com')
  432. .setSubject('Hello {{ subjectVar }}')
  433. .setAttachments(() => [
  434. {
  435. content: Buffer.from('hello'),
  436. },
  437. ]);
  438. await initPluginWithHandlers([handler]);
  439. eventBus.publish(new MockEvent(ctx, true));
  440. await pause();
  441. const attachment = onSend.mock.calls[0][0].attachments[0].content;
  442. expect(Buffer.compare(attachment, Buffer.from('hello'))).toBe(0); // 0 = buffers are equal
  443. });
  444. it('attachment content as an image buffer', async () => {
  445. const imageFileBuffer = readFileSync(TEST_IMAGE_PATH);
  446. const handler = new EmailEventListener('test')
  447. .on(MockEvent)
  448. .setFrom('"test from" <noreply@test.com>')
  449. .setRecipient(() => 'test@test.com')
  450. .setSubject('Hello {{ subjectVar }}')
  451. .setAttachments(() => [
  452. {
  453. content: imageFileBuffer,
  454. },
  455. ]);
  456. await initPluginWithHandlers([handler]);
  457. eventBus.publish(new MockEvent(ctx, true));
  458. await pause();
  459. const attachment = onSend.mock.calls[0][0].attachments[0].content;
  460. expect(Buffer.compare(attachment, imageFileBuffer)).toBe(0); // 0 = buffers are equal
  461. });
  462. it('attachment content as a string', async () => {
  463. const handler = new EmailEventListener('test')
  464. .on(MockEvent)
  465. .setFrom('"test from" <noreply@test.com>')
  466. .setRecipient(() => 'test@test.com')
  467. .setSubject('Hello {{ subjectVar }}')
  468. .setAttachments(() => [
  469. {
  470. content: 'hello',
  471. },
  472. ]);
  473. await initPluginWithHandlers([handler]);
  474. eventBus.publish(new MockEvent(ctx, true));
  475. await pause();
  476. const attachment = onSend.mock.calls[0][0].attachments[0].content;
  477. expect(attachment).toBe('hello');
  478. });
  479. it('attachment content as a string stream', async () => {
  480. const handler = new EmailEventListener('test')
  481. .on(MockEvent)
  482. .setFrom('"test from" <noreply@test.com>')
  483. .setRecipient(() => 'test@test.com')
  484. .setSubject('Hello {{ subjectVar }}')
  485. .setAttachments(() => [
  486. {
  487. content: Readable.from(['hello']),
  488. },
  489. ]);
  490. await initPluginWithHandlers([handler]);
  491. eventBus.publish(new MockEvent(ctx, true));
  492. await pause();
  493. const attachment = onSend.mock.calls[0][0].attachments[0].content;
  494. expect(Buffer.compare(attachment, Buffer.from('hello'))).toBe(0); // 0 = buffers are equal
  495. });
  496. it('attachment content as an image stream', async () => {
  497. const imageFileBuffer = readFileSync(TEST_IMAGE_PATH);
  498. const imageFileStream = createReadStream(TEST_IMAGE_PATH);
  499. const handler = new EmailEventListener('test')
  500. .on(MockEvent)
  501. .setFrom('"test from" <noreply@test.com>')
  502. .setRecipient(() => 'test@test.com')
  503. .setSubject('Hello {{ subjectVar }}')
  504. .setAttachments(() => [
  505. {
  506. content: imageFileStream,
  507. },
  508. ]);
  509. await initPluginWithHandlers([handler]);
  510. eventBus.publish(new MockEvent(ctx, true));
  511. await pause();
  512. const attachment = onSend.mock.calls[0][0].attachments[0].content;
  513. expect(Buffer.compare(attachment, imageFileBuffer)).toBe(0); // 0 = buffers are equal
  514. });
  515. it('raises a warning for large content attachments', async () => {
  516. testingLogger.warnSpy.mockClear();
  517. const largeBuffer = Buffer.from(Array.from({ length: 65535, 0: 0 }));
  518. const handler = new EmailEventListener('test')
  519. .on(MockEvent)
  520. .setFrom('"test from" <noreply@test.com>')
  521. .setRecipient(() => 'test@test.com')
  522. .setSubject('Hello {{ subjectVar }}')
  523. .setAttachments(() => [
  524. {
  525. content: largeBuffer,
  526. },
  527. ]);
  528. await initPluginWithHandlers([handler]);
  529. eventBus.publish(new MockEvent(ctx, true));
  530. await pause();
  531. expect(testingLogger.warnSpy.mock.calls[0][0]).toContain(
  532. `Email has a large 'content' attachment (64k). Consider using the 'path' instead for improved performance.`,
  533. );
  534. });
  535. });
  536. describe('orderConfirmationHandler', () => {
  537. beforeEach(async () => {
  538. await initPluginWithHandlers([orderConfirmationHandler], {
  539. templatePath: path.join(__dirname, '../templates'),
  540. });
  541. });
  542. const ctx = RequestContext.deserialize({
  543. _channel: { code: DEFAULT_CHANNEL_CODE },
  544. _languageCode: LanguageCode.en,
  545. } as any);
  546. const order = ({
  547. code: 'ABCDE',
  548. customer: {
  549. emailAddress: 'test@test.com',
  550. },
  551. } as Partial<Order>) as any;
  552. it('filters events with wrong order state', async () => {
  553. eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'ArrangingPayment', ctx, order));
  554. await pause();
  555. expect(onSend).not.toHaveBeenCalled();
  556. eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'Cancelled', ctx, order));
  557. await pause();
  558. expect(onSend).not.toHaveBeenCalled();
  559. eventBus.publish(new OrderStateTransitionEvent('AddingItems', 'PaymentAuthorized', ctx, order));
  560. await pause();
  561. expect(onSend).not.toHaveBeenCalled();
  562. eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
  563. await pause();
  564. expect(onSend).toHaveBeenCalledTimes(1);
  565. });
  566. it('sets the Order Customer emailAddress as recipient', async () => {
  567. eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
  568. await pause();
  569. expect(onSend.mock.calls[0][0].recipient).toBe(order.customer!.emailAddress);
  570. });
  571. it('sets the subject', async () => {
  572. eventBus.publish(new OrderStateTransitionEvent('ArrangingPayment', 'PaymentSettled', ctx, order));
  573. await pause();
  574. expect(onSend.mock.calls[0][0].subject).toBe(`Order confirmation for #${order.code}`);
  575. });
  576. });
  577. describe('error handling', () => {
  578. it('Logs an error if the template file is not found', async () => {
  579. const ctx = RequestContext.deserialize({
  580. _channel: { code: DEFAULT_CHANNEL_CODE },
  581. _languageCode: LanguageCode.en,
  582. } as any);
  583. testingLogger.errorSpy.mockClear();
  584. const handler = new EmailEventListener('no-template')
  585. .on(MockEvent)
  586. .setFrom('"test from" <noreply@test.com>')
  587. .setRecipient(() => 'test@test.com')
  588. .setSubject('Hello {{ subjectVar }}');
  589. await initPluginWithHandlers([handler]);
  590. eventBus.publish(new MockEvent(ctx, true));
  591. await pause();
  592. expect(testingLogger.errorSpy.mock.calls[0][0]).toContain(`ENOENT: no such file or directory`);
  593. });
  594. it('Logs a Handlebars error if the template is invalid', async () => {
  595. const ctx = RequestContext.deserialize({
  596. _channel: { code: DEFAULT_CHANNEL_CODE },
  597. _languageCode: LanguageCode.en,
  598. } as any);
  599. testingLogger.errorSpy.mockClear();
  600. const handler = new EmailEventListener('bad-template')
  601. .on(MockEvent)
  602. .setFrom('"test from" <noreply@test.com>')
  603. .setRecipient(() => 'test@test.com')
  604. .setSubject('Hello {{ subjectVar }}');
  605. await initPluginWithHandlers([handler]);
  606. eventBus.publish(new MockEvent(ctx, true));
  607. await pause();
  608. expect(testingLogger.errorSpy.mock.calls[0][0]).toContain(`Parse error on line 3:`);
  609. });
  610. it('Logs an error if the loadData method throws', async () => {
  611. const ctx = RequestContext.deserialize({
  612. _channel: { code: DEFAULT_CHANNEL_CODE },
  613. _languageCode: LanguageCode.en,
  614. } as any);
  615. testingLogger.errorSpy.mockClear();
  616. const handler = new EmailEventListener('bad-template')
  617. .on(MockEvent)
  618. .setFrom('"test from" <noreply@test.com>')
  619. .setRecipient(() => 'test@test.com')
  620. .setSubject('Hello {{ subjectVar }}')
  621. .loadData(context => {
  622. throw new Error('something went horribly wrong!');
  623. });
  624. await initPluginWithHandlers([handler]);
  625. eventBus.publish(new MockEvent(ctx, true));
  626. await pause();
  627. expect(testingLogger.errorSpy.mock.calls[0][0]).toContain(`something went horribly wrong!`);
  628. });
  629. });
  630. describe('custom sender', () => {
  631. it('should allow a custom sender to be utilized', async () => {
  632. const ctx = RequestContext.deserialize({
  633. _channel: { code: DEFAULT_CHANNEL_CODE },
  634. _languageCode: LanguageCode.en,
  635. } as any);
  636. const handler = new EmailEventListener('test')
  637. .on(MockEvent)
  638. .setFrom('"test from" <noreply@test.com>')
  639. .setRecipient(() => 'test@test.com')
  640. .setSubject('Hello')
  641. .setTemplateVars(event => ({ subjectVar: 'foo' }));
  642. const fakeSender = new FakeCustomSender();
  643. const send = jest.fn();
  644. fakeSender.send = send;
  645. await initPluginWithHandlers([handler], {
  646. emailSender: fakeSender,
  647. });
  648. eventBus.publish(new MockEvent(ctx, true));
  649. await pause();
  650. expect(send.mock.calls[0][0].subject).toBe('Hello');
  651. expect(send.mock.calls[0][0].recipient).toBe('test@test.com');
  652. expect(send.mock.calls[0][0].from).toBe('"test from" <noreply@test.com>');
  653. expect(onSend).toHaveBeenCalledTimes(0);
  654. });
  655. });
  656. describe('optional address fields', () => {
  657. const ctx = RequestContext.deserialize({
  658. _channel: { code: DEFAULT_CHANNEL_CODE },
  659. _languageCode: LanguageCode.en,
  660. } as any);
  661. it('cc', async () => {
  662. const handler = new EmailEventListener('test')
  663. .on(MockEvent)
  664. .setFrom('"test from" <noreply@test.com>')
  665. .setRecipient(() => 'test@test.com')
  666. .setSubject('Hello {{ subjectVar }}')
  667. .setOptionalAddressFields(() => ({ cc: 'foo@bar.com' }));
  668. await initPluginWithHandlers([handler]);
  669. eventBus.publish(new MockEvent(ctx, true));
  670. await pause();
  671. expect(onSend.mock.calls[0][0].cc).toBe('foo@bar.com');
  672. });
  673. it('bcc', async () => {
  674. const handler = new EmailEventListener('test')
  675. .on(MockEvent)
  676. .setFrom('"test from" <noreply@test.com>')
  677. .setRecipient(() => 'test@test.com')
  678. .setSubject('Hello {{ subjectVar }}')
  679. .setOptionalAddressFields(() => ({ bcc: 'foo@bar.com' }));
  680. await initPluginWithHandlers([handler]);
  681. eventBus.publish(new MockEvent(ctx, true));
  682. await pause();
  683. expect(onSend.mock.calls[0][0].bcc).toBe('foo@bar.com');
  684. });
  685. it('replyTo', async () => {
  686. const handler = new EmailEventListener('test')
  687. .on(MockEvent)
  688. .setFrom('"test from" <noreply@test.com>')
  689. .setRecipient(() => 'test@test.com')
  690. .setSubject('Hello {{ subjectVar }}')
  691. .setOptionalAddressFields(() => ({ replyTo: 'foo@bar.com' }));
  692. await initPluginWithHandlers([handler]);
  693. eventBus.publish(new MockEvent(ctx, true));
  694. await pause();
  695. expect(onSend.mock.calls[0][0].replyTo).toBe('foo@bar.com');
  696. });
  697. });
  698. });
  699. class FakeCustomSender implements EmailSender {
  700. send: (email: EmailDetails<'unserialized'>, options: EmailTransportOptions) => void;
  701. }
  702. const pause = () => new Promise(resolve => setTimeout(resolve, 100));
  703. class MockEvent extends VendureEvent {
  704. constructor(public ctx: RequestContext, public shouldSend: boolean) {
  705. super();
  706. }
  707. }
  708. class MockService {
  709. someAsyncMethod() {
  710. return Promise.resolve('loaded data');
  711. }
  712. }