1
0
Fork 0
peertube/server/lib/emailer.ts

239 lines
6.6 KiB
TypeScript
Raw Normal View History

2020-07-01 10:05:30 -04:00
import { readFileSync } from 'fs-extra'
2021-07-30 10:51:27 -04:00
import { isArray, merge } from 'lodash'
2018-01-30 07:27:07 -05:00
import { createTransport, Transporter } from 'nodemailer'
2020-07-01 10:05:30 -04:00
import { join } from 'path'
2021-07-30 10:51:27 -04:00
import { EmailPayload } from '@shared/models'
2021-03-12 04:22:17 -05:00
import { SendEmailDefaultOptions } from '../../shared/models/server/emailer.model'
import { isTestInstance, root } from '../helpers/core-utils'
2018-03-22 06:32:43 -04:00
import { bunyanLogger, logger } from '../helpers/logger'
2020-02-17 04:27:00 -05:00
import { CONFIG, isEmailEnabled } from '../initializers/config'
2019-04-11 05:33:44 -04:00
import { WEBSERVER } from '../initializers/constants'
2021-07-30 10:51:27 -04:00
import { MUser } from '../types/models'
2020-07-01 10:05:30 -04:00
import { JobQueue } from './job-queue'
const Email = require('email-templates')
2018-01-30 07:27:07 -05:00
class Emailer {
private static instance: Emailer
private initialized = false
private transporter: Transporter
2020-01-31 10:56:52 -05:00
private constructor () {
}
2018-01-30 07:27:07 -05:00
init () {
// Already initialized
if (this.initialized === true) return
this.initialized = true
2021-01-26 03:28:28 -05:00
if (!isEmailEnabled()) {
2018-01-30 07:27:07 -05:00
if (!isTestInstance()) {
logger.error('Cannot use SMTP server because of lack of configuration. PeerTube will not be able to send mails!')
}
2021-01-26 03:28:28 -05:00
return
2019-02-13 06:16:27 -05:00
}
2021-01-26 03:28:28 -05:00
if (CONFIG.SMTP.TRANSPORT === 'smtp') this.initSMTPTransport()
else if (CONFIG.SMTP.TRANSPORT === 'sendmail') this.initSendmailTransport()
}
async checkConnection () {
2019-02-13 06:16:27 -05:00
if (!this.transporter || CONFIG.SMTP.TRANSPORT !== 'smtp') return
2018-01-30 07:27:07 -05:00
logger.info('Testing SMTP server...')
2018-01-30 07:27:07 -05:00
try {
const success = await this.transporter.verify()
if (success !== true) this.warnOnConnectionFailure()
2018-01-30 07:27:07 -05:00
logger.info('Successfully connected to SMTP server.')
} catch (err) {
this.warnOnConnectionFailure(err)
2018-01-30 07:27:07 -05:00
}
}
addPasswordResetEmailJob (username: string, to: string, resetPasswordUrl: string) {
2018-12-26 04:36:24 -05:00
const emailPayload: EmailPayload = {
template: 'password-reset',
2018-12-26 04:36:24 -05:00
to: [ to ],
subject: 'Reset your account password',
locals: {
username,
resetPasswordUrl
}
2018-12-26 04:36:24 -05:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addPasswordCreateEmailJob (username: string, to: string, createPasswordUrl: string) {
const emailPayload: EmailPayload = {
template: 'password-create',
to: [ to ],
subject: 'Create your account password',
locals: {
username,
createPasswordUrl
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addVerifyEmailJob (username: string, to: string, verifyEmailUrl: string) {
2018-12-26 04:36:24 -05:00
const emailPayload: EmailPayload = {
template: 'verify-email',
2018-12-26 04:36:24 -05:00
to: [ to ],
subject: `Verify your email on ${CONFIG.INSTANCE.NAME}`,
locals: {
username,
verifyEmailUrl
}
2018-12-26 04:36:24 -05:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addUserBlockJob (user: MUser, blocked: boolean, reason?: string) {
2018-08-08 11:36:10 -04:00
const reasonString = reason ? ` for the following reason: ${reason}` : ''
const blockedWord = blocked ? 'blocked' : 'unblocked'
const to = user.email
const emailPayload: EmailPayload = {
to: [ to ],
subject: 'Account ' + blockedWord,
text: `Your account ${user.username} on ${CONFIG.INSTANCE.NAME} has been ${blockedWord}${reasonString}.`
2018-08-08 11:36:10 -04:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addContactFormJob (fromEmail: string, fromName: string, subject: string, body: string) {
2019-01-09 09:14:29 -05:00
const emailPayload: EmailPayload = {
template: 'contact-form',
2019-01-09 09:14:29 -05:00
to: [ CONFIG.ADMIN.EMAIL ],
replyTo: `"${fromName}" <${fromEmail}>`,
subject: `(contact form) ${subject}`,
locals: {
fromName,
fromEmail,
body,
// There are not notification preferences for the contact form
hideNotificationPreferences: true
}
2019-01-09 09:14:29 -05:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-11-29 07:36:40 -05:00
async sendMail (options: EmailPayload) {
2020-02-17 04:27:00 -05:00
if (!isEmailEnabled()) {
2018-01-30 07:27:07 -05:00
throw new Error('Cannot send mail because SMTP is not configured.')
}
const fromDisplayName = options.from
? options.from
: CONFIG.INSTANCE.NAME
2019-02-14 05:56:23 -05:00
const email = new Email({
send: true,
message: {
from: `"${fromDisplayName}" <${CONFIG.SMTP.FROM_ADDRESS}>`
},
transport: this.transporter,
views: {
2020-06-02 03:21:33 -04:00
root: join(root(), 'dist', 'server', 'lib', 'emails')
},
subjectPrefix: CONFIG.EMAIL.SUBJECT.PREFIX
})
2021-07-30 10:51:27 -04:00
const toEmails = isArray(options.to)
? options.to
: [ options.to ]
for (const to of toEmails) {
2021-03-12 04:22:17 -05:00
const baseOptions: SendEmailDefaultOptions = {
template: 'common',
message: {
to,
from: options.from,
subject: options.subject,
replyTo: options.replyTo
},
locals: { // default variables available in all templates
WEBSERVER,
EMAIL: CONFIG.EMAIL,
instanceName: CONFIG.INSTANCE.NAME,
text: options.text,
subject: options.subject
}
}
// overriden/new variables given for a specific template in the payload
const sendOptions = merge(baseOptions, options)
await email.send(sendOptions)
2020-06-02 03:21:33 -04:00
.then(res => logger.debug('Sent email.', { res }))
.catch(err => logger.error('Error in email sender.', { err }))
2019-11-29 07:36:40 -05:00
}
2018-01-30 07:27:07 -05:00
}
private warnOnConnectionFailure (err?: Error) {
2018-03-26 09:54:13 -04:00
logger.error('Failed to connect to SMTP %s:%d.', CONFIG.SMTP.HOSTNAME, CONFIG.SMTP.PORT, { err })
2018-01-30 07:27:07 -05:00
}
2021-01-26 03:28:28 -05:00
private initSMTPTransport () {
logger.info('Using %s:%s as SMTP server.', CONFIG.SMTP.HOSTNAME, CONFIG.SMTP.PORT)
let tls
if (CONFIG.SMTP.CA_FILE) {
tls = {
ca: [ readFileSync(CONFIG.SMTP.CA_FILE) ]
}
}
let auth
if (CONFIG.SMTP.USERNAME && CONFIG.SMTP.PASSWORD) {
auth = {
user: CONFIG.SMTP.USERNAME,
pass: CONFIG.SMTP.PASSWORD
}
}
this.transporter = createTransport({
host: CONFIG.SMTP.HOSTNAME,
port: CONFIG.SMTP.PORT,
secure: CONFIG.SMTP.TLS,
debug: CONFIG.LOG.LEVEL === 'debug',
logger: bunyanLogger as any,
ignoreTLS: CONFIG.SMTP.DISABLE_STARTTLS,
tls,
auth
})
}
private initSendmailTransport () {
logger.info('Using sendmail to send emails')
this.transporter = createTransport({
sendmail: true,
newline: 'unix',
2021-04-21 03:16:06 -04:00
path: CONFIG.SMTP.SENDMAIL,
logger: bunyanLogger as any
2021-01-26 03:28:28 -05:00
})
}
2018-01-30 07:27:07 -05:00
static get Instance () {
return this.instance || (this.instance = new this())
}
}
// ---------------------------------------------------------------------------
export {
2020-04-23 03:32:53 -04:00
Emailer
2018-01-30 07:27:07 -05:00
}