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

680 lines
20 KiB
TypeScript
Raw Normal View History

2020-07-01 10:05:30 -04:00
import { readFileSync } from 'fs-extra'
import { 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'
import { VideoChannelModel } from '@server/models/video/video-channel'
import { MVideoBlacklistLightVideo, MVideoBlacklistVideo } from '@server/types/models/video/video-blacklist'
import { MVideoImport, MVideoImportVideo } from '@server/types/models/video/video-import'
import { AbuseState, EmailPayload, UserAbuse } from '@shared/models'
2020-07-01 10:05:30 -04:00
import { SendEmailOptions } 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'
2020-07-28 03:57:16 -04:00
import { MAbuseFull, MAbuseMessage, MAccountDefault, MActorFollowActors, MActorFollowFull, MUser } from '../types/models'
2020-07-01 10:05:30 -04:00
import { MCommentOwnerVideo, MVideo, MVideoAccountLight } from '../types/models/video'
import { JobQueue } from './job-queue'
const sanitizeHtml = require('sanitize-html')
const markdownItEmoji = require('markdown-it-emoji/light')
const MarkdownItClass = require('markdown-it')
const markdownIt = new MarkdownItClass('default', { linkify: true, breaks: true, html: true })
markdownIt.enable([
'linkify',
'autolink',
'emphasis',
'link',
'newline',
'list'
])
markdownIt.use(markdownItEmoji)
const toSafeHtml = text => {
// Restore line feed
const textWithLineFeed = text.replace(/<br.?\/?>/g, '\r\n')
// Convert possible markdown (emojis, emphasis and lists) to html
const html = markdownIt.render(textWithLineFeed)
// Convert to safe Html
return sanitizeHtml(html, {
allowedTags: [ 'a', 'p', 'span', 'br', 'strong', 'em', 'ul', 'ol', 'li' ],
allowedSchemes: [ 'http', 'https' ],
allowedAttributes: {
a: [ 'href', 'class', 'target', 'rel' ]
},
transformTags: {
a: (tagName, attribs) => {
let rel = 'noopener noreferrer'
if (attribs.rel === 'me') rel += ' me'
return {
tagName,
attribs: Object.assign(attribs, {
target: '_blank',
rel
})
}
}
}
})
}
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
2020-02-18 02:29:23 -05:00
if (isEmailEnabled()) {
2019-02-13 06:16:27 -05:00
if (CONFIG.SMTP.TRANSPORT === 'smtp') {
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) ]
}
2018-01-30 07:27:07 -05:00
}
2019-02-13 06:16:27 -05:00
let auth
if (CONFIG.SMTP.USERNAME && CONFIG.SMTP.PASSWORD) {
auth = {
user: CONFIG.SMTP.USERNAME,
pass: CONFIG.SMTP.PASSWORD
}
2018-01-30 09:16:24 -05:00
}
2019-02-13 06:16:27 -05:00
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
})
} else { // sendmail
logger.info('Using sendmail to send emails')
this.transporter = createTransport({
sendmail: true,
newline: 'unix',
2020-04-10 08:26:42 -04:00
path: CONFIG.SMTP.SENDMAIL
2019-02-13 06:16:27 -05:00
})
}
2018-01-30 07:27:07 -05:00
} else {
if (!isTestInstance()) {
logger.error('Cannot use SMTP server because of lack of configuration. PeerTube will not be able to send mails!')
}
}
}
2019-01-10 05:12:41 -05:00
static isEnabled () {
2019-02-13 06:16:27 -05:00
if (CONFIG.SMTP.TRANSPORT === 'sendmail') {
return !!CONFIG.SMTP.SENDMAIL
} else if (CONFIG.SMTP.TRANSPORT === 'smtp') {
return !!CONFIG.SMTP.HOSTNAME && !!CONFIG.SMTP.PORT
} else {
return false
}
}
2018-01-30 07:27:07 -05:00
async checkConnectionOrDie () {
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.dieOnConnectionFailure()
logger.info('Successfully connected to SMTP server.')
} catch (err) {
this.dieOnConnectionFailure(err)
}
}
2019-08-15 05:53:26 -04:00
addNewVideoFromSubscriberNotification (to: string[], video: MVideoAccountLight) {
2018-12-26 04:36:24 -05:00
const channelName = video.VideoChannel.getDisplayName()
2019-04-11 05:33:44 -04:00
const videoUrl = WEBSERVER.URL + video.getWatchStaticPath()
2018-12-26 04:36:24 -05:00
2018-01-30 07:27:07 -05:00
const emailPayload: EmailPayload = {
2018-12-26 04:36:24 -05:00
to,
subject: channelName + ' just published a new video',
text: `Your subscription ${channelName} just published a new video: "${video.name}".`,
locals: {
title: 'New content ',
action: {
text: 'View video',
url: videoUrl
}
}
2018-01-30 07:27:07 -05:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addNewFollowNotification (to: string[], actorFollow: MActorFollowFull, followType: 'account' | 'channel') {
const followingName = (actorFollow.ActorFollowing.VideoChannel || actorFollow.ActorFollowing.Account).getDisplayName()
const emailPayload: EmailPayload = {
template: 'follower-on-channel',
to,
subject: `New follower on your channel ${followingName}`,
locals: {
followerName: actorFollow.ActorFollower.Account.getDisplayName(),
followerUrl: actorFollow.ActorFollower.url,
followingName,
followingUrl: actorFollow.ActorFollowing.url,
followType
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addNewInstanceFollowerNotification (to: string[], actorFollow: MActorFollowActors) {
const awaitingApproval = actorFollow.state === 'pending' ? ' awaiting manual approval.' : ''
const emailPayload: EmailPayload = {
to,
subject: 'New instance follower',
text: `Your instance has a new follower: ${actorFollow.ActorFollower.url}${awaitingApproval}.`,
locals: {
title: 'New instance follower',
action: {
text: 'Review followers',
url: WEBSERVER.URL + '/admin/follows/followers-list'
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addAutoInstanceFollowingNotification (to: string[], actorFollow: MActorFollowActors) {
const instanceUrl = actorFollow.ActorFollowing.url
const emailPayload: EmailPayload = {
to,
subject: 'Auto instance following',
text: `Your instance automatically followed a new instance: <a href="${instanceUrl}">${instanceUrl}</a>.`
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
myVideoPublishedNotification (to: string[], video: MVideo) {
2019-04-11 05:33:44 -04:00
const videoUrl = WEBSERVER.URL + video.getWatchStaticPath()
const emailPayload: EmailPayload = {
to,
subject: `Your video ${video.name} has been published`,
text: `Your video "${video.name}" has been published.`,
locals: {
title: 'You video is live',
action: {
text: 'View video',
url: videoUrl
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
myVideoImportSuccessNotification (to: string[], videoImport: MVideoImportVideo) {
2019-04-11 05:33:44 -04:00
const videoUrl = WEBSERVER.URL + videoImport.Video.getWatchStaticPath()
const emailPayload: EmailPayload = {
to,
subject: `Your video import ${videoImport.getTargetIdentifier()} is complete`,
text: `Your video "${videoImport.getTargetIdentifier()}" just finished importing.`,
locals: {
title: 'Import complete',
action: {
text: 'View video',
url: videoUrl
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
myVideoImportErrorNotification (to: string[], videoImport: MVideoImport) {
const importUrl = WEBSERVER.URL + '/my-library/video-imports'
const text =
`Your video import "${videoImport.getTargetIdentifier()}" encountered an error.` +
2020-01-31 10:56:52 -05:00
'\n\n' +
`See your videos import dashboard for more information: <a href="${importUrl}">${importUrl}</a>.`
const emailPayload: EmailPayload = {
to,
subject: `Your video import "${videoImport.getTargetIdentifier()}" encountered an error`,
text,
locals: {
title: 'Import failed',
action: {
text: 'Review imports',
url: importUrl
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addNewCommentOnMyVideoNotification (to: string[], comment: MCommentOwnerVideo) {
2018-12-26 04:36:24 -05:00
const video = comment.Video
const videoUrl = WEBSERVER.URL + comment.Video.getWatchStaticPath()
2019-04-11 05:33:44 -04:00
const commentUrl = WEBSERVER.URL + comment.getCommentStaticPath()
const commentHtml = toSafeHtml(comment.text)
2018-12-26 04:36:24 -05:00
const emailPayload: EmailPayload = {
template: 'video-comment-new',
2018-12-26 04:36:24 -05:00
to,
subject: 'New comment on your video ' + video.name,
locals: {
accountName: comment.Account.getDisplayName(),
accountUrl: comment.Account.Actor.url,
comment,
commentHtml,
video,
videoUrl,
action: {
text: 'View comment',
url: commentUrl
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addNewCommentMentionNotification (to: string[], comment: MCommentOwnerVideo) {
const accountName = comment.Account.getDisplayName()
const video = comment.Video
const videoUrl = WEBSERVER.URL + comment.Video.getWatchStaticPath()
2019-04-11 05:33:44 -04:00
const commentUrl = WEBSERVER.URL + comment.getCommentStaticPath()
const commentHtml = toSafeHtml(comment.text)
const emailPayload: EmailPayload = {
template: 'video-comment-mention',
to,
subject: 'Mention on video ' + video.name,
locals: {
comment,
commentHtml,
video,
videoUrl,
accountName,
action: {
text: 'View comment',
url: commentUrl
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2020-07-01 10:05:30 -04:00
addAbuseModeratorsNotification (to: string[], parameters: {
2020-07-24 09:05:51 -04:00
abuse: UserAbuse
2020-07-01 10:05:30 -04:00
abuseInstance: MAbuseFull
reporter: string
}) {
2020-07-01 10:05:30 -04:00
const { abuse, abuseInstance, reporter } = parameters
2018-02-01 05:08:10 -05:00
2020-07-01 10:05:30 -04:00
const action = {
text: 'View report #' + abuse.id,
url: WEBSERVER.URL + '/admin/moderation/abuses/list?search=%23' + abuse.id
}
let emailPayload: EmailPayload
if (abuseInstance.VideoAbuse) {
const video = abuseInstance.VideoAbuse.Video
const videoUrl = WEBSERVER.URL + video.getWatchStaticPath()
emailPayload = {
template: 'video-abuse-new',
to,
subject: `New video abuse report from ${reporter}`,
locals: {
videoUrl,
isLocal: video.remote === false,
videoCreatedAt: new Date(video.createdAt).toLocaleString(),
videoPublishedAt: new Date(video.publishedAt).toLocaleString(),
videoName: video.name,
reason: abuse.reason,
2020-07-09 09:54:24 -04:00
videoChannel: abuse.video.channel,
reporter,
2020-07-01 10:05:30 -04:00
action
}
}
} else if (abuseInstance.VideoCommentAbuse) {
const comment = abuseInstance.VideoCommentAbuse.VideoComment
const commentUrl = WEBSERVER.URL + comment.Video.getWatchStaticPath() + ';threadId=' + comment.getThreadId()
emailPayload = {
2020-07-07 08:34:16 -04:00
template: 'video-comment-abuse-new',
2020-07-01 10:05:30 -04:00
to,
subject: `New comment abuse report from ${reporter}`,
locals: {
commentUrl,
2020-07-08 09:51:46 -04:00
videoName: comment.Video.name,
2020-07-01 10:05:30 -04:00
isLocal: comment.isOwned(),
commentCreatedAt: new Date(comment.createdAt).toLocaleString(),
reason: abuse.reason,
flaggedAccount: abuseInstance.FlaggedAccount.getDisplayName(),
2020-07-09 09:54:24 -04:00
reporter,
2020-07-01 10:05:30 -04:00
action
}
}
} else {
const account = abuseInstance.FlaggedAccount
const accountUrl = account.getClientUrl()
emailPayload = {
template: 'account-abuse-new',
to,
subject: `New account abuse report from ${reporter}`,
locals: {
accountUrl,
accountDisplayName: account.getDisplayName(),
isLocal: account.isOwned(),
reason: abuse.reason,
2020-07-09 09:54:24 -04:00
reporter,
2020-07-01 10:05:30 -04:00
action
}
}
2018-02-01 05:08:10 -05:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
addAbuseStateChangeNotification (to: string[], abuse: MAbuseFull) {
const text = abuse.state === AbuseState.ACCEPTED
? 'Report #' + abuse.id + ' has been accepted'
: 'Report #' + abuse.id + ' has been rejected'
2020-07-28 03:57:16 -04:00
const abuseUrl = WEBSERVER.URL + '/my-account/abuses?search=%23' + abuse.id
const action = {
text,
2020-07-28 03:57:16 -04:00
url: abuseUrl
}
const emailPayload: EmailPayload = {
template: 'abuse-state-change',
to,
subject: text,
locals: {
action,
abuseId: abuse.id,
2020-07-28 03:57:16 -04:00
abuseUrl,
isAccepted: abuse.state === AbuseState.ACCEPTED
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2020-07-28 03:57:16 -04:00
addAbuseNewMessageNotification (
to: string[],
options: {
target: 'moderator' | 'reporter'
abuse: MAbuseFull
message: MAbuseMessage
accountMessage: MAccountDefault
}) {
const { abuse, target, message, accountMessage } = options
const text = 'New message on report #' + abuse.id
const abuseUrl = target === 'moderator'
? WEBSERVER.URL + '/admin/moderation/abuses/list?search=%23' + abuse.id
: WEBSERVER.URL + '/my-account/abuses?search=%23' + abuse.id
const action = {
text,
2020-07-28 03:57:16 -04:00
url: abuseUrl
}
const emailPayload: EmailPayload = {
template: 'abuse-new-message',
to,
subject: text,
locals: {
2020-07-28 03:57:16 -04:00
abuseId: abuse.id,
abuseUrl: action.url,
2020-07-28 03:57:16 -04:00
messageAccountName: accountMessage.getDisplayName(),
messageText: message.message,
action
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
async addVideoAutoBlacklistModeratorsNotification (to: string[], videoBlacklist: MVideoBlacklistLightVideo) {
2019-04-11 05:33:44 -04:00
const VIDEO_AUTO_BLACKLIST_URL = WEBSERVER.URL + '/admin/moderation/video-auto-blacklist/list'
const videoUrl = WEBSERVER.URL + videoBlacklist.Video.getWatchStaticPath()
const channel = (await VideoChannelModel.loadByIdAndPopulateAccount(videoBlacklist.Video.channelId)).toFormattedSummaryJSON()
const emailPayload: EmailPayload = {
template: 'video-auto-blacklist-new',
to,
subject: 'A new video is pending moderation',
locals: {
channel,
videoUrl,
videoName: videoBlacklist.Video.name,
action: {
text: 'Review autoblacklist',
url: VIDEO_AUTO_BLACKLIST_URL
}
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addNewUserRegistrationNotification (to: string[], user: MUser) {
const emailPayload: EmailPayload = {
template: 'user-registered',
to,
subject: `a new user registered on ${WEBSERVER.HOST}: ${user.username}`,
locals: {
user
}
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addVideoBlacklistNotification (to: string[], videoBlacklist: MVideoBlacklistVideo) {
2018-12-26 04:36:24 -05:00
const videoName = videoBlacklist.Video.name
2019-04-11 05:33:44 -04:00
const videoUrl = WEBSERVER.URL + videoBlacklist.Video.getWatchStaticPath()
2018-08-13 10:57:13 -04:00
2018-12-26 04:36:24 -05:00
const reasonString = videoBlacklist.reason ? ` for the following reason: ${videoBlacklist.reason}` : ''
2019-04-11 05:33:44 -04:00
const blockedString = `Your video ${videoName} (${videoUrl} on ${WEBSERVER.HOST} has been blacklisted${reasonString}.`
2018-08-13 10:57:13 -04:00
const emailPayload: EmailPayload = {
2018-12-26 04:36:24 -05:00
to,
subject: `Video ${videoName} blacklisted`,
text: blockedString,
locals: {
title: 'Your video was blacklisted'
}
2018-08-13 10:57:13 -04:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
2019-08-15 05:53:26 -04:00
addVideoUnblacklistNotification (to: string[], video: MVideo) {
2019-04-11 05:33:44 -04:00
const videoUrl = WEBSERVER.URL + video.getWatchStaticPath()
2018-08-13 10:57:13 -04:00
const emailPayload: EmailPayload = {
2018-12-26 04:36:24 -05:00
to,
subject: `Video ${video.name} unblacklisted`,
text: `Your video "${video.name}" (${videoUrl}) on ${WEBSERVER.HOST} has been unblacklisted.`,
locals: {
title: 'Your video was unblacklisted'
}
2018-08-13 10:57:13 -04:00
}
return JobQueue.Instance.createJob({ type: 'email', payload: emailPayload })
}
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 ${WEBSERVER.HOST}`,
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 ${WEBSERVER.HOST} 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
2019-04-11 05:33:44 -04:00
: WEBSERVER.HOST
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
})
2019-11-29 07:36:40 -05:00
for (const to of options.to) {
await email
.send(merge(
{
template: 'common',
message: {
to,
from: options.from,
subject: options.subject,
replyTo: options.replyTo
},
locals: { // default variables available in all templates
WEBSERVER,
EMAIL: CONFIG.EMAIL,
text: options.text,
subject: options.subject
}
},
options // overriden/new variables given for a specific template in the payload
) as SendEmailOptions)
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 dieOnConnectionFailure (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
process.exit(-1)
}
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
}