ghost 5.13.0 → 5.14.0

package/core/server/services/mega/post-email-serializer.js

@@ -17,427 +17,430 @@ const urlService = require('../../services/url');
 
 const ALLOWED_REPLACEMENTS = ['first_name'];
 
-// Format a full html document ready for email by inlining CSS, adjusting links,
-// and performing any client-specific fixes
-const formatHtmlForEmail = function formatHtmlForEmail(html) {
-    const juiceOptions = {inlinePseudoElements: true};
+const PostEmailSerializer = {
+    
+    // Format a full html document ready for email by inlining CSS, adjusting links,
+    // and performing any client-specific fixes
+    formatHtmlForEmail(html) {
+        const juiceOptions = {inlinePseudoElements: true};
 
-    const juice = require('juice');
-    let juicedHtml = juice(html, juiceOptions);
+        const juice = require('juice');
+        let juicedHtml = juice(html, juiceOptions);
 
-    // convert juiced HTML to a DOM-like interface for further manipulation
-    // happens after inlining of CSS so we can change element types without worrying about styling
+        // convert juiced HTML to a DOM-like interface for further manipulation
+        // happens after inlining of CSS so we can change element types without worrying about styling
 
-    const cheerio = require('cheerio');
-    const _cheerio = cheerio.load(juicedHtml);
+        const cheerio = require('cheerio');
+        const _cheerio = cheerio.load(juicedHtml);
 
-    // force all links to open in new tab
-    _cheerio('a').attr('target', '_blank');
-    // convert figure and figcaption to div so that Outlook applies margins
-    _cheerio('figure, figcaption').each((i, elem) => !!(elem.tagName = 'div'));
+        // force all links to open in new tab
+        _cheerio('a').attr('target', '_blank');
+        // convert figure and figcaption to div so that Outlook applies margins
+        _cheerio('figure, figcaption').each((i, elem) => !!(elem.tagName = 'div'));
 
-    juicedHtml = _cheerio.html();
+        juicedHtml = _cheerio.html();
 
-    // Fix any unsupported chars in Outlook
-    juicedHtml = juicedHtml.replace(/'/g, ''');
+        // Fix any unsupported chars in Outlook
+        juicedHtml = juicedHtml.replace(/'/g, ''');
 
-    return juicedHtml;
-};
+        return juicedHtml;
+    },
 
-const getSite = () => {
-    const publicSettings = settingsCache.getPublic();
-    return Object.assign({}, publicSettings, {
-        url: urlUtils.urlFor('home', true),
-        iconUrl: publicSettings.icon ? urlUtils.urlFor('image', {image: publicSettings.icon}, true) : null
-    });
-};
+    getSite() {
+        const publicSettings = settingsCache.getPublic();
+        return Object.assign({}, publicSettings, {
+            url: urlUtils.urlFor('home', true),
+            iconUrl: publicSettings.icon ? urlUtils.urlFor('image', {image: publicSettings.icon}, true) : null
+        });
+    },
+
+    /**
+     * createUnsubscribeUrl
+     *
+     * Takes a member and newsletter uuid. Returns the url that should be used to unsubscribe
+     * In case of no member uuid, generates the preview unsubscribe url - `?preview=1`
+     *
+     * @param {string} uuid post uuid
+     * @param {Object} [options]
+     * @param {string} [options.newsletterUuid] newsletter uuid
+     * @param {boolean} [options.comments] Unsubscribe from comment emails
+     */
+    createUnsubscribeUrl(uuid, options = {}) {
+        const siteUrl = urlUtils.getSiteUrl();
+        const unsubscribeUrl = new URL(siteUrl);
+        unsubscribeUrl.pathname = `${unsubscribeUrl.pathname}/unsubscribe/`.replace('//', '/');
+        if (uuid) {
+            unsubscribeUrl.searchParams.set('uuid', uuid);
+        } else {
+            unsubscribeUrl.searchParams.set('preview', '1');
+        }
+        if (options.newsletterUuid) {
+            unsubscribeUrl.searchParams.set('newsletter', options.newsletterUuid);
+        }
+        if (options.comments) {
+            unsubscribeUrl.searchParams.set('comments', '1');
+        }
 
-/**
- * createUnsubscribeUrl
- *
- * Takes a member and newsletter uuid. Returns the url that should be used to unsubscribe
- * In case of no member uuid, generates the preview unsubscribe url - `?preview=1`
- *
- * @param {string} uuid post uuid
- * @param {Object} [options]
- * @param {string} [options.newsletterUuid] newsletter uuid
- * @param {boolean} [options.comments] Unsubscribe from comment emails
- */
-const createUnsubscribeUrl = (uuid, options = {}) => {
-    const siteUrl = urlUtils.getSiteUrl();
-    const unsubscribeUrl = new URL(siteUrl);
-    unsubscribeUrl.pathname = `${unsubscribeUrl.pathname}/unsubscribe/`.replace('//', '/');
-    if (uuid) {
-        unsubscribeUrl.searchParams.set('uuid', uuid);
-    } else {
-        unsubscribeUrl.searchParams.set('preview', '1');
-    }
-    if (options.newsletterUuid) {
-        unsubscribeUrl.searchParams.set('newsletter', options.newsletterUuid);
-    }
-    if (options.comments) {
-        unsubscribeUrl.searchParams.set('comments', '1');
-    }
+        return unsubscribeUrl.href;
+    },
+
+    /**
+     * createPostSignupUrl
+     *
+     * Takes a post object. Returns the url that should be used to signup from newsletter
+     *
+     * @param {Object} post post object
+     */
+    createPostSignupUrl(post) {
+        let url = urlService.getUrlByResourceId(post.id, {absolute: true});
+
+        // For email-only posts, use site url as base
+        if (post.status !== 'published' && url.match(/\/404\//)) {
+            url = urlUtils.getSiteUrl();
+        }
 
-    return unsubscribeUrl.href;
-};
+        const signupUrl = new URL(url);
+        signupUrl.hash = `/portal/signup`;
 
-/**
- * createPostSignupUrl
- *
- * Takes a post object. Returns the url that should be used to signup from newsletter
- *
- * @param {Object} post post object
- */
-const createPostSignupUrl = (post) => {
-    let url = urlService.getUrlByResourceId(post.id, {absolute: true});
-
-    // For email-only posts, use site url as base
-    if (post.status !== 'published' && url.match(/\/404\//)) {
-        url = urlUtils.getSiteUrl();
-    }
+        return signupUrl.href;
+    },
 
-    const signupUrl = new URL(url);
-    signupUrl.hash = `/portal/signup`;
+    // NOTE: serialization is needed to make sure we do post transformations such as image URL transformation from relative to absolute
+    async serializePostModel(model) {
+        // fetch mobiledoc rather than html and plaintext so we can render email-specific contents
+        const frame = {options: {context: {user: true}, formats: 'mobiledoc'}};
+        const docName = 'posts';
 
-    return signupUrl.href;
-};
+        await apiFramework
+            .serializers
+            .handle
+            .output(model, {docName: docName, method: 'read'}, api.serializers.output, frame);
 
-// NOTE: serialization is needed to make sure we do post transformations such as image URL transformation from relative to absolute
-const serializePostModel = async (model) => {
-    // fetch mobiledoc rather than html and plaintext so we can render email-specific contents
-    const frame = {options: {context: {user: true}, formats: 'mobiledoc'}};
-    const docName = 'posts';
+        return frame.response[docName][0];
+    },
 
-    await apiFramework
-        .serializers
-        .handle
-        .output(model, {docName: docName, method: 'read'}, api.serializers.output, frame);
+    // removes %% wrappers from unknown replacement strings in email content
+    normalizeReplacementStrings(email) {
+        // we don't want to modify the email object in-place
+        const emailContent = _.pick(email, ['html', 'plaintext']);
 
-    return frame.response[docName][0];
-};
+        const EMAIL_REPLACEMENT_REGEX = /%%(\{.*?\})%%/g;
+        const REPLACEMENT_STRING_REGEX = /\{(?<recipientProperty>\w*?)(?:,? *(?:"|&quot;)(?<fallback>.*?)(?:"|&quot;))?\}/;
 
-// removes %% wrappers from unknown replacement strings in email content
-const normalizeReplacementStrings = (email) => {
-    // we don't want to modify the email object in-place
-    const emailContent = _.pick(email, ['html', 'plaintext']);
+        ['html', 'plaintext'].forEach((format) => {
+            emailContent[format] = emailContent[format].replace(EMAIL_REPLACEMENT_REGEX, (replacementMatch, replacementStr) => {
+                const match = replacementStr.match(REPLACEMENT_STRING_REGEX);
 
-    const EMAIL_REPLACEMENT_REGEX = /%%(\{.*?\})%%/g;
-    const REPLACEMENT_STRING_REGEX = /\{(?<recipientProperty>\w*?)(?:,? *(?:"|&quot;)(?<fallback>.*?)(?:"|&quot;))?\}/;
+                if (match) {
+                    const {recipientProperty} = match.groups;
 
-    ['html', 'plaintext'].forEach((format) => {
-        emailContent[format] = emailContent[format].replace(EMAIL_REPLACEMENT_REGEX, (replacementMatch, replacementStr) => {
-            const match = replacementStr.match(REPLACEMENT_STRING_REGEX);
+                    if (ALLOWED_REPLACEMENTS.includes(recipientProperty)) {
+                        // keeps wrapping %% for later replacement with real data
+                        return replacementMatch;
+                    }
+                }
 
-            if (match) {
-                const {recipientProperty} = match.groups;
+                // removes %% so output matches user supplied content
+                return replacementStr;
+            });
+        });
 
-                if (ALLOWED_REPLACEMENTS.includes(recipientProperty)) {
-                    // keeps wrapping %% for later replacement with real data
-                    return replacementMatch;
+        return emailContent;
+    },
+
+    /**
+     * Parses email content and extracts an array of replacements with desired fallbacks
+     *
+     * @param {Object} email
+     * @param {string} email.html
+     * @param {string} email.plaintext
+     *
+     * @returns {Object[]} replacements
+     */
+    parseReplacements(email) {
+        const EMAIL_REPLACEMENT_REGEX = /%%(\{.*?\})%%/g;
+        const REPLACEMENT_STRING_REGEX = /\{(?<recipientProperty>\w*?)(?:,? *(?:"|&quot;)(?<fallback>.*?)(?:"|&quot;))?\}/;
+
+        const replacements = [];
+
+        ['html', 'plaintext'].forEach((format) => {
+            let result;
+            while ((result = EMAIL_REPLACEMENT_REGEX.exec(email[format])) !== null) {
+                const [replacementMatch, replacementStr] = result;
+                const match = replacementStr.match(REPLACEMENT_STRING_REGEX);
+
+                if (match) {
+                    const {recipientProperty, fallback} = match.groups;
+
+                    if (ALLOWED_REPLACEMENTS.includes(recipientProperty)) {
+                        const id = `replacement_${replacements.length + 1}`;
+
+                        replacements.push({
+                            format,
+                            id,
+                            match: replacementMatch,
+                            recipientProperty: `member_${recipientProperty}`,
+                            fallback
+                        });
+                    }
                 }
             }
-
-            // removes %% so output matches user supplied content
-            return replacementStr;
         });
-    });
 
-    return emailContent;
-};
-
-/**
- * Parses email content and extracts an array of replacements with desired fallbacks
- *
- * @param {Object} email
- * @param {string} email.html
- * @param {string} email.plaintext
- *
- * @returns {Object[]} replacements
- */
-const parseReplacements = (email) => {
-    const EMAIL_REPLACEMENT_REGEX = /%%(\{.*?\})%%/g;
-    const REPLACEMENT_STRING_REGEX = /\{(?<recipientProperty>\w*?)(?:,? *(?:"|&quot;)(?<fallback>.*?)(?:"|&quot;))?\}/;
-
-    const replacements = [];
-
-    ['html', 'plaintext'].forEach((format) => {
-        let result;
-        while ((result = EMAIL_REPLACEMENT_REGEX.exec(email[format])) !== null) {
-            const [replacementMatch, replacementStr] = result;
-            const match = replacementStr.match(REPLACEMENT_STRING_REGEX);
-
-            if (match) {
-                const {recipientProperty, fallback} = match.groups;
-
-                if (ALLOWED_REPLACEMENTS.includes(recipientProperty)) {
-                    const id = `replacement_${replacements.length + 1}`;
-
-                    replacements.push({
-                        format,
-                        id,
-                        match: replacementMatch,
-                        recipientProperty: `member_${recipientProperty}`,
-                        fallback
-                    });
+        return replacements;
+    },
+
+    async getTemplateSettings(newsletter) {
+        const accentColor = settingsCache.get('accent_color');
+        const adjustedAccentColor = accentColor && darkenToContrastThreshold(accentColor, '#ffffff', 2).hex();
+        const adjustedAccentContrastColor = accentColor && textColorForBackgroundColor(adjustedAccentColor).hex();
+
+        const templateSettings = {
+            headerImage: newsletter.get('header_image'),
+            showHeaderIcon: newsletter.get('show_header_icon') && settingsCache.get('icon'),
+            showHeaderTitle: newsletter.get('show_header_title'),
+            showFeatureImage: newsletter.get('show_feature_image'),
+            titleFontCategory: newsletter.get('title_font_category'),
+            titleAlignment: newsletter.get('title_alignment'),
+            bodyFontCategory: newsletter.get('body_font_category'),
+            showBadge: newsletter.get('show_badge'),
+            footerContent: newsletter.get('footer_content'),
+            showHeaderName: newsletter.get('show_header_name'),
+            accentColor,
+            adjustedAccentColor,
+            adjustedAccentContrastColor
+        };
+
+        if (templateSettings.headerImage) {
+            if (isUnsplashImage(templateSettings.headerImage)) {
+                // Unsplash images have a minimum size so assuming 1200px is safe
+                const unsplashUrl = new URL(templateSettings.headerImage);
+                unsplashUrl.searchParams.set('w', '1200');
+
+                templateSettings.headerImage = unsplashUrl.href;
+                templateSettings.headerImageWidth = 600;
+            } else {
+                const {imageSize} = require('../../lib/image');
+                try {
+                    const size = await imageSize.getImageSizeFromUrl(templateSettings.headerImage);
+
+                    if (size.width >= 600) {
+                        // keep original image, just set a fixed width
+                        templateSettings.headerImageWidth = 600;
+                    }
+
+                    if (isLocalContentImage(templateSettings.headerImage, urlUtils.getSiteUrl())) {
+                        // we can safely request a 1200px image - Ghost will serve the original if it's smaller
+                        templateSettings.headerImage = templateSettings.headerImage.replace(/\/content\/images\//, '/content/images/size/w1200/');
+                    }
+                } catch (err) {
+                    // log and proceed. Using original header image without fixed width isn't fatal.
+                    logging.error(err);
                 }
             }
         }
-    });
 
-    return replacements;
-};
+        return templateSettings;
+    },
 
-const getTemplateSettings = async (newsletter) => {
-    const accentColor = settingsCache.get('accent_color');
-    const adjustedAccentColor = accentColor && darkenToContrastThreshold(accentColor, '#ffffff', 2).hex();
-    const adjustedAccentContrastColor = accentColor && textColorForBackgroundColor(adjustedAccentColor).hex();
-
-    const templateSettings = {
-        headerImage: newsletter.get('header_image'),
-        showHeaderIcon: newsletter.get('show_header_icon') && settingsCache.get('icon'),
-        showHeaderTitle: newsletter.get('show_header_title'),
-        showFeatureImage: newsletter.get('show_feature_image'),
-        titleFontCategory: newsletter.get('title_font_category'),
-        titleAlignment: newsletter.get('title_alignment'),
-        bodyFontCategory: newsletter.get('body_font_category'),
-        showBadge: newsletter.get('show_badge'),
-        footerContent: newsletter.get('footer_content'),
-        showHeaderName: newsletter.get('show_header_name'),
-        accentColor,
-        adjustedAccentColor,
-        adjustedAccentContrastColor
-    };
-
-    if (templateSettings.headerImage) {
-        if (isUnsplashImage(templateSettings.headerImage)) {
-            // Unsplash images have a minimum size so assuming 1200px is safe
-            const unsplashUrl = new URL(templateSettings.headerImage);
-            unsplashUrl.searchParams.set('w', '1200');
-
-            templateSettings.headerImage = unsplashUrl.href;
-            templateSettings.headerImageWidth = 600;
-        } else {
-            const {imageSize} = require('../../lib/image');
-            try {
-                const size = await imageSize.getImageSizeFromUrl(templateSettings.headerImage);
+    async serialize(postModel, newsletter, options = {isBrowserPreview: false}) {
+        const post = await this.serializePostModel(postModel);
 
-                if (size.width >= 600) {
-                    // keep original image, just set a fixed width
-                    templateSettings.headerImageWidth = 600;
-                }
+        const timezone = settingsCache.get('timezone');
+        const momentDate = post.published_at ? moment(post.published_at) : moment();
+        post.published_at = momentDate.tz(timezone).format('DD MMM YYYY');
 
-                if (isLocalContentImage(templateSettings.headerImage, urlUtils.getSiteUrl())) {
-                    // we can safely request a 1200px image - Ghost will serve the original if it's smaller
-                    templateSettings.headerImage = templateSettings.headerImage.replace(/\/content\/images\//, '/content/images/size/w1200/');
-                }
-            } catch (err) {
-                // log and proceed. Using original header image without fixed width isn't fatal.
-                logging.error(err);
+        if (post.authors) {
+            if (post.authors.length <= 2) {
+                post.authors = post.authors.map(author => author.name).join(' & ');
+            } else if (post.authors.length > 2) {
+                post.authors = `${post.authors[0].name} & ${post.authors.length - 1} others`;
             }
         }
-    }
-
-    return templateSettings;
-};
 
-const serialize = async (postModel, newsletter, options = {isBrowserPreview: false}) => {
-    const post = await serializePostModel(postModel);
-
-    const timezone = settingsCache.get('timezone');
-    const momentDate = post.published_at ? moment(post.published_at) : moment();
-    post.published_at = momentDate.tz(timezone).format('DD MMM YYYY');
-
-    if (post.authors) {
-        if (post.authors.length <= 2) {
-            post.authors = post.authors.map(author => author.name).join(' & ');
-        } else if (post.authors.length > 2) {
-            post.authors = `${post.authors[0].name} & ${post.authors.length - 1} others`;
+        if (post.posts_meta) {
+            post.email_subject = post.posts_meta.email_subject;
         }
-    }
-
-    if (post.posts_meta) {
-        post.email_subject = post.posts_meta.email_subject;
-    }
-
-    // we use post.excerpt as a hidden piece of text that is picked up by some email
-    // clients as a "preview" when listing emails. Our current plaintext/excerpt
-    // generation outputs links as "Link [https://url/]" which isn't desired in the preview
-    if (!post.custom_excerpt && post.excerpt) {
-        post.excerpt = post.excerpt.replace(/\s\[http(.*?)\]/g, '');
-    }
 
-    post.html = mobiledocLib.mobiledocHtmlRenderer.render(
-        JSON.parse(post.mobiledoc), {target: 'email', postUrl: post.url}
-    );
-
-    // perform any email specific adjustments to the mobiledoc->HTML render output
-    // body wrapper is required so we can get proper top-level selections
-    const cheerio = require('cheerio');
-    let _cheerio = cheerio.load(`<body>${post.html}</body>`);
-    // remove leading/trailing HRs
-    _cheerio(`
-        body > hr:first-child,
-        body > hr:last-child,
-        body > div:first-child > hr:first-child,
-        body > div:last-child > hr:last-child
-    `).remove();
-    post.html = _cheerio('body').html();
-
-    post.plaintext = htmlToPlaintext.email(post.html);
-
-    // Outlook will render feature images at full-size breaking the layout.
-    // Content images fix this by rendering max 600px images - do the same for feature image here
-    if (post.feature_image) {
-        if (isUnsplashImage(post.feature_image)) {
-            // Unsplash images have a minimum size so assuming 1200px is safe
-            const unsplashUrl = new URL(post.feature_image);
-            unsplashUrl.searchParams.set('w', '1200');
-
-            post.feature_image = unsplashUrl.href;
-            post.feature_image_width = 600;
-        } else {
-            const {imageSize} = require('../../lib/image');
-            try {
-                const size = await imageSize.getImageSizeFromUrl(post.feature_image);
-
-                if (size.width >= 600) {
-                    // keep original image, just set a fixed width
-                    post.feature_image_width = 600;
-                }
+        // we use post.excerpt as a hidden piece of text that is picked up by some email
+        // clients as a "preview" when listing emails. Our current plaintext/excerpt
+        // generation outputs links as "Link [https://url/]" which isn't desired in the preview
+        if (!post.custom_excerpt && post.excerpt) {
+            post.excerpt = post.excerpt.replace(/\s\[http(.*?)\]/g, '');
+        }
 
-                if (isLocalContentImage(post.feature_image, urlUtils.getSiteUrl())) {
-                    // we can safely request a 1200px image - Ghost will serve the original if it's smaller
-                    post.feature_image = post.feature_image.replace(/\/content\/images\//, '/content/images/size/w1200/');
+        post.html = mobiledocLib.mobiledocHtmlRenderer.render(
+            JSON.parse(post.mobiledoc), {target: 'email', postUrl: post.url}
+        );
+
+        // perform any email specific adjustments to the mobiledoc->HTML render output
+        // body wrapper is required so we can get proper top-level selections
+        const cheerio = require('cheerio');
+        let _cheerio = cheerio.load(`<body>${post.html}</body>`);
+        // remove leading/trailing HRs
+        _cheerio(`
+            body > hr:first-child,
+            body > hr:last-child,
+            body > div:first-child > hr:first-child,
+            body > div:last-child > hr:last-child
+        `).remove();
+        post.html = _cheerio('body').html();
+
+        post.plaintext = htmlToPlaintext.email(post.html);
+
+        // Outlook will render feature images at full-size breaking the layout.
+        // Content images fix this by rendering max 600px images - do the same for feature image here
+        if (post.feature_image) {
+            if (isUnsplashImage(post.feature_image)) {
+                // Unsplash images have a minimum size so assuming 1200px is safe
+                const unsplashUrl = new URL(post.feature_image);
+                unsplashUrl.searchParams.set('w', '1200');
+
+                post.feature_image = unsplashUrl.href;
+                post.feature_image_width = 600;
+            } else {
+                const {imageSize} = require('../../lib/image');
+                try {
+                    const size = await imageSize.getImageSizeFromUrl(post.feature_image);
+
+                    if (size.width >= 600) {
+                        // keep original image, just set a fixed width
+                        post.feature_image_width = 600;
+                    }
+
+                    if (isLocalContentImage(post.feature_image, urlUtils.getSiteUrl())) {
+                        // we can safely request a 1200px image - Ghost will serve the original if it's smaller
+                        post.feature_image = post.feature_image.replace(/\/content\/images\//, '/content/images/size/w1200/');
+                    }
+                } catch (err) {
+                    // log and proceed. Using original feature_image without fixed width isn't fatal.
+                    logging.error(err);
                 }
-            } catch (err) {
-                // log and proceed. Using original feature_image without fixed width isn't fatal.
-                logging.error(err);
             }
         }
-    }
-
-    const templateSettings = await getTemplateSettings(newsletter);
 
-    const render = template;
+        const templateSettings = await this.getTemplateSettings(newsletter);
 
-    let htmlTemplate = render({post, site: getSite(), templateSettings, newsletter: newsletter.toJSON()});
+        const render = template;
 
-    if (options.isBrowserPreview) {
-        const previewUnsubscribeUrl = createUnsubscribeUrl(null);
-        htmlTemplate = htmlTemplate.replace('%recipient.unsubscribe_url%', previewUnsubscribeUrl);
-    }
+        let htmlTemplate = render({post, site: this.getSite(), templateSettings, newsletter: newsletter.toJSON()});
 
-    // Clean up any unknown replacements strings to get our final content
-    const {html, plaintext} = normalizeReplacementStrings({
-        html: formatHtmlForEmail(htmlTemplate),
-        plaintext: post.plaintext
-    });
-    const data = {
-        subject: post.email_subject || post.title,
-        html,
-        plaintext
-    };
-    if (labs.isSet('newsletterPaywall')) {
-        data.post = post;
-    }
-    return data;
-};
+        if (options.isBrowserPreview) {
+            const previewUnsubscribeUrl = this.createUnsubscribeUrl(null);
+            htmlTemplate = htmlTemplate.replace('%recipient.unsubscribe_url%', previewUnsubscribeUrl);
+        }
 
-/**
- * renderPaywallCTA
- *
- * outputs html for rendering paywall CTA in newsletter
- *
- * @param {Object} post Post Object
- */
-
-function renderPaywallCTA(post) {
-    const accentColor = settingsCache.get('accent_color');
-    const siteTitle = settingsCache.get('title') || 'Ghost';
-    const signupUrl = createPostSignupUrl(post);
-
-    return `<div class="align-center" style="text-align: center;">
-    <hr
-        style="position: relative; display: block; width: 100%; margin: 3em 0; padding: 0; height: 1px; border: 0; border-top: 1px solid #e5eff5;">
-    <h2
-        style="margin-top: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; line-height: 1.11em; font-weight: 700; text-rendering: optimizeLegibility; margin: 1.5em 0 0.5em 0; font-size: 26px;">
-        Subscribe to <span style="white-space: nowrap; font-size: 26px !important;">continue reading.</span></h2>
-    <p style="margin: 0 auto 1.5em auto; line-height: 1.6em; max-width: 440px;">Become a paid member of ${siteTitle} to get access to all 
-    <span style="white-space: nowrap;">subscriber-only content.</span></p>
-    <div class="btn btn-accent" style="box-sizing: border-box; width: 100%; display: table;">
-        <table border="0" cellspacing="0" cellpadding="0" align="center"
-            style="border-collapse: separate; mso-table-lspace: 0pt; mso-table-rspace: 0pt; width: auto;">
-            <tbody>
-                <tr>
-                    <td align="center"
-                        style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; vertical-align: top; text-align: center; border-radius: 5px;"
-                        valign="top" bgcolor="${accentColor}">
-                        <a href="${signupUrl}"
-                            style="overflow-wrap: anywhere; border: solid 1px #3498db; border-radius: 5px; box-sizing: border-box; cursor: pointer; display: inline-block; font-size: 14px; font-weight: bold; margin: 0; padding: 12px 25px; text-decoration: none; background-color: ${accentColor}; border-color: ${accentColor}; color: #FFFFFF;"
-                            target="_blank">Subscribe
-                        </a>
-                    </td>
-                </tr>
-            </tbody>
-        </table>
-    </div>
-    <p style="margin: 0 0 1.5em 0; line-height: 1.6em;"></p>
-</div>`;
-}
-
-function renderEmailForSegment(email, memberSegment) {
-    const cheerio = require('cheerio');
-
-    const result = {...email};
-
-    /** Checks and hides content for newsletter behind paywall card
-     *  based on member's status and post access
-     *  Adds CTA in case content is hidden.
-    */
-    if (labs.isSet('newsletterPaywall')) {
-        const paywallIndex = (result.html || '').indexOf('<!--members-only-->');
-        if (paywallIndex !== -1 && memberSegment && result.post) {
-            let statusFilter = memberSegment === 'status:free' ? {status: 'free'} : {status: 'paid'};
-            const postVisiblity = result.post.visibility;
-
-            // For newsletter paywall, specific tiers visibility is considered on par to paid tiers
-            result.post.visibility = postVisiblity === 'tiers' ? 'paid' : postVisiblity;
-
-            const memberHasAccess = membersService.contentGating.checkPostAccess(result.post, statusFilter);
-
-            if (!memberHasAccess) {
-                const postContentEndIdx = result.html.search(/[\s\n\r]+?<!-- POST CONTENT END -->/);
-                result.html = result.html.slice(0, paywallIndex) + renderPaywallCTA(result.post) + result.html.slice(postContentEndIdx);
-                result.plaintext = htmlToPlaintext.excerpt(result.html);
+        // Clean up any unknown replacements strings to get our final content
+        const {html, plaintext} = this.normalizeReplacementStrings({
+            html: this.formatHtmlForEmail(htmlTemplate),
+            plaintext: post.plaintext
+        });
+        const data = {
+            subject: post.email_subject || post.title,
+            html,
+            plaintext
+        };
+        if (labs.isSet('newsletterPaywall')) {
+            data.post = post;
+        }
+        return data;
+    },
+
+    /**
+     * renderPaywallCTA
+     *
+     * outputs html for rendering paywall CTA in newsletter
+     *
+     * @param {Object} post Post Object
+     */
+    renderPaywallCTA(post) {
+        const accentColor = settingsCache.get('accent_color');
+        const siteTitle = settingsCache.get('title') || 'Ghost';
+        const signupUrl = this.createPostSignupUrl(post);
+
+        return `<div class="align-center" style="text-align: center;">
+        <hr
+            style="position: relative; display: block; width: 100%; margin: 3em 0; padding: 0; height: 1px; border: 0; border-top: 1px solid #e5eff5;">
+        <h2
+            style="margin-top: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; line-height: 1.11em; font-weight: 700; text-rendering: optimizeLegibility; margin: 1.5em 0 0.5em 0; font-size: 26px;">
+            Subscribe to <span style="white-space: nowrap; font-size: 26px !important;">continue reading.</span></h2>
+        <p style="margin: 0 auto 1.5em auto; line-height: 1.6em; max-width: 440px;">Become a paid member of ${siteTitle} to get access to all 
+        <span style="white-space: nowrap;">subscriber-only content.</span></p>
+        <div class="btn btn-accent" style="box-sizing: border-box; width: 100%; display: table;">
+            <table border="0" cellspacing="0" cellpadding="0" align="center"
+                style="border-collapse: separate; mso-table-lspace: 0pt; mso-table-rspace: 0pt; width: auto;">
+                <tbody>
+                    <tr>
+                        <td align="center"
+                            style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; vertical-align: top; text-align: center; border-radius: 5px;"
+                            valign="top" bgcolor="${accentColor}">
+                            <a href="${signupUrl}"
+                                style="overflow-wrap: anywhere; border: solid 1px #3498db; border-radius: 5px; box-sizing: border-box; cursor: pointer; display: inline-block; font-size: 14px; font-weight: bold; margin: 0; padding: 12px 25px; text-decoration: none; background-color: ${accentColor}; border-color: ${accentColor}; color: #FFFFFF;"
+                                target="_blank">Subscribe
+                            </a>
+                        </td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+        <p style="margin: 0 0 1.5em 0; line-height: 1.6em;"></p>
+    </div>`;
+    },
+
+    renderEmailForSegment(email, memberSegment) {
+        const cheerio = require('cheerio');
+
+        const result = {...email};
+
+        /** Checks and hides content for newsletter behind paywall card
+         *  based on member's status and post access
+         *  Adds CTA in case content is hidden.
+        */
+        if (labs.isSet('newsletterPaywall')) {
+            const paywallIndex = (result.html || '').indexOf('<!--members-only-->');
+            if (paywallIndex !== -1 && memberSegment && result.post) {
+                let statusFilter = memberSegment === 'status:free' ? {status: 'free'} : {status: 'paid'};
+                const postVisiblity = result.post.visibility;
+
+                // For newsletter paywall, specific tiers visibility is considered on par to paid tiers
+                result.post.visibility = postVisiblity === 'tiers' ? 'paid' : postVisiblity;
+
+                const memberHasAccess = membersService.contentGating.checkPostAccess(result.post, statusFilter);
+
+                if (!memberHasAccess) {
+                    const postContentEndIdx = result.html.search(/[\s\n\r]+?<!-- POST CONTENT END -->/);
+                    result.html = result.html.slice(0, paywallIndex) + this.renderPaywallCTA(result.post) + result.html.slice(postContentEndIdx);
+                    result.plaintext = htmlToPlaintext.excerpt(result.html);
+                }
             }
         }
-    }
 
-    const $ = cheerio.load(result.html);
+        const $ = cheerio.load(result.html);
 
-    $('[data-gh-segment]').get().forEach((node) => {
-        if (node.attribs['data-gh-segment'] !== memberSegment) { //TODO: replace with NQL interpretation
-            $(node).remove();
-        } else {
-            // Getting rid of the attribute for a cleaner html output
-            $(node).removeAttr('data-gh-segment');
-        }
-    });
+        $('[data-gh-segment]').get().forEach((node) => {
+            if (node.attribs['data-gh-segment'] !== memberSegment) { //TODO: replace with NQL interpretation
+                $(node).remove();
+            } else {
+                // Getting rid of the attribute for a cleaner html output
+                $(node).removeAttr('data-gh-segment');
+            }
+        });
 
-    result.html = formatHtmlForEmail($.html());
-    result.plaintext = htmlToPlaintext.email(result.html);
-    delete result.post;
+        result.html = this.formatHtmlForEmail($.html());
+        result.plaintext = htmlToPlaintext.email(result.html);
+        delete result.post;
 
-    return result;
-}
+        return result;
+    }
+};
 
 module.exports = {
-    serialize,
-    createUnsubscribeUrl,
-    createPostSignupUrl,
-    renderEmailForSegment,
-    parseReplacements,
+    serialize: PostEmailSerializer.serialize.bind(PostEmailSerializer),
+    createUnsubscribeUrl: PostEmailSerializer.createUnsubscribeUrl.bind(PostEmailSerializer),
+    createPostSignupUrl: PostEmailSerializer.createPostSignupUrl.bind(PostEmailSerializer),
+    renderEmailForSegment: PostEmailSerializer.renderEmailForSegment.bind(PostEmailSerializer),
+    parseReplacements: PostEmailSerializer.parseReplacements.bind(PostEmailSerializer),
     // Export for tests
-    _getTemplateSettings: getTemplateSettings
+    _getTemplateSettings: PostEmailSerializer.getTemplateSettings.bind(PostEmailSerializer),
+    _PostEmailSerializer: PostEmailSerializer
 };