ident

3.1 KB

1. // mail.hl — THE MAILER. One hl:smtp Mailer, configured from `.env` beside project.hl
2. // (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM; the real environment
3. // outranks the file). A send is non-blocking: the SMTP conversation runs on the
4. // mailer's thread and its outcome arrives on the event loop (logged below).
5. //
6. // IDENT_MAIL_SINK names a file that receives the mail INSTEAD of the SMTP server: one
7. // line `<address> <code>` is APPENDED per code. The dev server and the gate use it, so
8. // no real mail is sent until SMTP is configured for mail.byrod.in (see README).
9. //
10. // Handlers belong to instances: project.hl constructs this file once (`mail = new Mail()`).
11. import { Mailer } from 'hl:smtp'
12. import { env } from 'hl:proc'
13. import { writeFile, readFile, exists } from 'hl:fs'
15. static NL = '
16. '
17. static setting = (name, fallback) => { return env(name) != null && env(name) != '' ? env(name) : fallback }
18. // An unconfigured dev setup gets the placeholder host 127.0.0.1 (the Mailer must exist:
19. // `mailer.deliver()` and the `on mailer.…` handlers below); with the sink set nothing is ever
20. // sent through it. SMTP_FROM's default is a real sender, not a placeholder — kept (mission 035).
21. static smtpHost = setting('SMTP_HOST', null)
22. static mailer = new Mailer(smtpHost != null ? smtpHost : '127.0.0.1', toNumber(setting('SMTP_PORT', '587')), {
23. user = setting('SMTP_USER', null)
24. pass = setting('SMTP_PASSWORD', null)
25. sender = setting('SMTP_FROM', '[email protected]')
26. })
27. static sink = env('IDENT_MAIL_SINK') != null && env('IDENT_MAIL_SINK') != '' ? env('IDENT_MAIL_SINK') : null
29. static sendCode = (email, code) => {
30. if (sink != null) {
31. let before = exists(sink) ? readFile(sink) : ''
32. writeFile(sink, before + email + ' ' + code + NL)
33. return 0
34. }
35. if (smtpHost == null) {
36. console.warn('mail: NOT SENT to ' + email + ' — neither IDENT_MAIL_SINK nor SMTP_HOST is set')
37. return 0
38. }
39. return mailer.send({
40. to = email
41. subject = 'Your ident login code: ' + code
42. text = 'Hi,
44. your one-time login code for worldapi is ' + code + '
46. It is valid for 10 minutes and works once. If you did not ask for it, ignore this mail.
47. '
48. })
49. }
51. // AN INVITATION MAIL (ident#22). With the sink set, the line `<address> <link>` goes to
52. // `<sink>.invites` (a second file: the code reader of the gates keeps its own format).
53. static sendInvite = (email, link, appName, project, role, days) => {
54. if (sink != null) {
55. let f = sink + '.invites'
56. let before = exists(f) ? readFile(f) : ''
57. writeFile(f, before + email + ' ' + link + NL)
58. return 0
59. }
60. if (smtpHost == null) {
61. console.warn('mail: invitation NOT SENT to ' + email + ' — neither IDENT_MAIL_SINK nor SMTP_HOST is set')
62. return 0
63. }
64. return mailer.send({
65. to = email
66. subject = 'You are invited to ' + project + ' (' + appName + ')'
67. text = 'Hi,
69. you are invited to ' + project + ' in ' + appName + ' (role: ' + role + ').
71. Open this link to join with ident:
72. ' + link + '
74. The link works for ' + days + ' days. If you were not expecting it, ignore this mail.
75. '
76. })
77. }
79. mailer.deliver()
81. on mailer.sent(r) { console.log('mail: sent', r.id, r.to, r.message) }
82. on mailer.failed(r) { console.warn('mail: FAILED', r.id, r.to, r.stage, r.code, r.message) }