plugin.spec.ts 36 KB

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