gscan 4.23.0 → 4.25.0

package/README.md

@@ -16,7 +16,7 @@ GScan works on a system of rules. Each rule has a way to check whether it passes
 
 In addition, an **error** can be marked as **fatal**. A **fatal error** means, left unchecked a Ghost publication would throw 500 errors on certain pages because of the detected out-of-date or erroneous code.
 
-In Ghost, we call GScan on boot. If any fatal errors are detected, the blog will not boot. In Ghost(Pro) and in Ghost-CLI we call GScan as part of major upgrades. The upgrade will not be allowed to continue if any fatal errors are detected.
+In Ghost, we call GScan on boot. If any fatal errors are detected in Ghost(Pro) and in Ghost-CLI we call GScan as part of major upgrades. The upgrade will not be allowed to continue if any fatal errors are detected.
 
 Errors are only marked as **fatal errors** if they would cause errors, and therefore should block a boot or an upgrade.
 
@@ -51,8 +51,8 @@ By default, GScan scans themes for the latest Ghost version compatibility. You c
 `--v1` or `-1`  
 `--v2` or `-2`  
 `--v3` or `-3`  
-`--v4` or `-4`
-`--v5` or `-5` or `--canary`
+`--v4` or `-4` or `--canary`
+`--v5` or `-5`  
 
 Use the `--canary` parameter to check for the upcoming Ghost version.
 

package/app/tpl/index.hbs

@@ -22,8 +22,8 @@
                 <span class="gh-input-icon select-arrow">{{> icon-arrow-up}}</span>
                 <span class="gh-input-icon select-arrow active">{{> icon-arrow-down}}</span>
                 <select class="gh-input gh-select" name="version" id="version">
-                    <option value="canary" selected>{{ghostVersions.canary.major}}</option>
-                    <option value="v4">{{ghostVersions.v4.major}}</option>
+                    <option value="v5">{{ghostVersions.v5.major}}</option>
+                    <option value="v4" selected>{{ghostVersions.v4.major}}</option>
                     <option value="v3">{{ghostVersions.v3.major}}</option>
                     <option value="v2">{{ghostVersions.v2.major}}</option>
                     <option value="v1">{{ghostVersions.v1.major}}</option>

package/lib/ast-linter/rules/index.js

@@ -3,6 +3,9 @@ module.exports = {
     'GS090-NO-UNKNOWN-CUSTOM-THEME-SETTINGS': require('./lint-no-unknown-custom-theme-settings'),
     'GS090-NO-UNKNOWN-CUSTOM-THEME-SELECT-VALUE-IN-MATCH': require('./lint-no-unknown-custom-theme-select-value-in-match'),
     'GS090-NO-AUTHOR-HELPER-IN-POST-CONTEXT': require('./lint-no-author-helper-in-post-page-context'),
+    'GS090-NO-PRODUCTS-HELPER': require('./lint-no-products-helper'),
+    'GS090-NO-PRODUCT-DATA-HELPER': require('./lint-no-product-data-helper'),
+    'GS090-NO-PRODUCTS-DATA-HELPER': require('./lint-no-products-data-helper'),
     'no-multi-param-conditionals': require('./lint-no-multi-param-conditionals'),
     'no-nested-async-helpers': require('./lint-no-nested-async-helpers'),
     'no-prev-next-post-outside-post-context': require('./lint-no-prev-next-post-outside-post-context'),

package/lib/ast-linter/rules/lint-no-product-data-helper.js

@@ -0,0 +1,24 @@
+const Rule = require('./base');
+const {getNodeName, logNode} = require('../helpers');
+
+module.exports = class NoProductsHelper extends Rule {
+    _checkForHelerInPostContext(node) {
+        const nodeName = getNodeName(node);
+        const isProductsHelper = (nodeName === '@product');
+
+        if (isProductsHelper) {
+            this.log({
+                message: `${logNode(node)} should not be used`,
+                line: node.loc && node.loc.start.line,
+                column: node.loc && node.loc.start.column,
+                source: this.sourceForNode(node)
+            });
+        }
+    }
+
+    visitor() {
+        return {
+            MustacheStatement: this._checkForHelerInPostContext.bind(this)
+        };
+    }
+};

package/lib/ast-linter/rules/lint-no-products-data-helper.js

@@ -0,0 +1,24 @@
+const Rule = require('./base');
+const {getNodeName, logNode} = require('../helpers');
+
+module.exports = class NoProductsHelper extends Rule {
+    _checkForHelerInPostContext(node) {
+        const nodeName = getNodeName(node);
+        const isProductsHelper = (nodeName === '@products');
+
+        if (isProductsHelper) {
+            this.log({
+                message: `${logNode(node)} should not be used`,
+                line: node.loc && node.loc.start.line,
+                column: node.loc && node.loc.start.column,
+                source: this.sourceForNode(node)
+            });
+        }
+    }
+
+    visitor() {
+        return {
+            MustacheStatement: this._checkForHelerInPostContext.bind(this)
+        };
+    }
+};

package/lib/ast-linter/rules/lint-no-products-helper.js

@@ -0,0 +1,24 @@
+const Rule = require('./base');
+const {getNodeName, logNode} = require('../helpers');
+
+module.exports = class NoProductsHelper extends Rule {
+    _checkForHelerInPostContext(node) {
+        const nodeName = getNodeName(node);
+        const isProductsHelper = (nodeName === 'products');
+
+        if (isProductsHelper) {
+            this.log({
+                message: `${logNode(node)} should not be used`,
+                line: node.loc && node.loc.start.line,
+                column: node.loc && node.loc.start.column,
+                source: this.sourceForNode(node)
+            });
+        }
+    }
+
+    visitor() {
+        return {
+            MustacheStatement: this._checkForHelerInPostContext.bind(this)
+        };
+    }
+};

package/lib/checker.js

@@ -27,8 +27,9 @@ const check = function checkAll(themePath, options = {}) {
     const passedVersion = _.get(options, 'checkVersion', versions.default);
     let version = passedVersion;
 
-    if (passedVersion === 'v5') {
-        version = 'canary';
+    if (passedVersion === 'canary') {
+        version = 'v4';
+        options.checkVersion = 'v4';
     }
 
     _.each(labsEnabledHelpers, (flag, helper) => {

package/lib/specs/canary.js

@@ -3,7 +3,7 @@ const oneLineTrim = require('common-tags/lib/oneLineTrim');
 const previousSpec = require('./v4');
 const ghostVersions = require('../utils').versions;
 const docsBaseUrl = `https://ghost.org/docs/api/handlebars-themes/`;
-const prevDocsBaseUrl = `https://themes.ghost.org/v${ghostVersions.canary.docs}/docs/`;
+const prevDocsBaseUrl = `https://themes.ghost.org/v${ghostVersions.v5.docs}/docs/`;
 const prevDocsBaseUrlRegEx = new RegExp(prevDocsBaseUrl, 'g');
 
 const previousKnownHelpers = previousSpec.knownHelpers;
@@ -22,6 +22,44 @@ let rules = {
         The <code>ghost-api</code> is not supported starting Ghost v5 and should not be used.
         Check the <a href="${docsBaseUrl}packagejson/" target=_blank><code>package.json</code> documentation</a> for further information.`
     },
+    'GS090-NO-AUTHOR-HELPER-IN-POST-CONTEXT': {
+        level: 'error',
+        fatal: true,
+        rule: 'The <code>{{author}}</code> helper should be replaces with <code>{{authors}}</code>',
+        details: oneLineTrim`The <code>{{author}}</code> helper has been deprecated since Ghost 1.22.0 in favor of <code>{{<authors>}}</code><br>
+        The <code>{{author}}</code> helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{authors}}</code> property <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        helper: '{{author}}'
+    },
+    'GS090-NO-PRODUCTS-HELPER': {
+        level: 'error',
+        fatal: true,
+        rule: 'The <code>{{products}}</code> helper should be replaces with <code>{{tiers}}</code>',
+        details: oneLineTrim`The <code>{{products}}</code> helper has been deprecated in favor of <code>{{tiers}}</code><br>
+        The <code>{{products}}</code> helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{tiers}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{products}}'
+    },
+    'GS090-NO-PRODUCT-DATA-HELPER': {
+        level: 'error',
+        fatal: true,
+        rule: 'The <code>{{@product}}</code> data helper should be replaces with <code>{{#get "tiers"}}</code>',
+        details: oneLineTrim`The <code>{{@product}}</code> data helper has been deprecated in favor of <code>{{#get "tiers"}}</code><br>
+        The <code>{{@product}}</code> data helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{#get "tiers"}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{@product}}'
+    },
+    'GS090-NO-PRODUCTS-DATA-HELPER': {
+        level: 'error',
+        fatal: true,
+        rule: 'The <code>{{@products}}</code> data helper should be replaces with <code>{{#get "tiers"}}</code>',
+        details: oneLineTrim`The <code>{{@products}}</code> data helper has been deprecated in favor of <code>{{#get "tiers"}}</code><br>
+        The <code>{{@products}}</code> data helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{#get "tiers"}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{@products}}'
+    },
+
+    // Updated v1 & v2 rules
     'GS001-DEPR-BLOG': {
         level: 'error',
         fatal: true,
@@ -32,14 +70,413 @@ let rules = {
         regex: /{{\s*?@blog\.[a-zA-Z0-9_]+\s*?}}/g,
         helper: '{{@blog}}'
     },
-    'GS090-NO-AUTHOR-HELPER-IN-POST-CONTEXT': {
+    'GS001-DEPR-AUTH-ID': {
         level: 'error',
         fatal: true,
-        rule: 'The <code>{{author}}</code> helper should be replaces with <code>{{authors}}</code>',
-        details: oneLineTrim`The <code>{{author}}</code> helper has been deprecated since Ghost 1.22.0 in favor of <code>{{<authors>}}</code><br>
-        The <code>{{author}}</code> helper was removed in Ghost v5 and should not be used.
-        Find more information about the <code>@site</code> property <a href="${docsBaseUrl}helpers/site/" target=_blank>here</a>.`,
-        helper: '{{author}}'
+        rule: 'Replace the <code>{{author.id}}</code> helper with <code>{{primary_author.id}}</code> or <code>{{authors.[#].id}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.id}}</code> is deprecated and should be replaced with either <code>{{primary_author.id}}</code>
+        or <code>{{authors.[#].id}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.id\s*?}}/g,
+        helper: '{{author.id}}'
+    },
+    'GS001-DEPR-AUTH-SLUG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.slug}}</code> helper with <code>{{primary_author.slug}}</code> or <code>{{authors.[#].slug}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.slug}}</code> is deprecated and should be replaced with either <code>{{primary_author.slug}}</code>
+        or <code>{{authors.[#].slug}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.slug\s*?}}/g,
+        helper: '{{author.slug}}'
+    },
+    'GS001-DEPR-AUTH-MAIL': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.email}}</code> helper with <code>{{primary_author.email}}</code> or <code>{{authors.[#].email}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.email}}</code> is deprecated and should be replaced with either <code>{{primary_author.email}}</code>
+        or <code>{{authors.[#].email}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.email\s*?}}/g,
+        helper: '{{author.email}}'
+    },
+    'GS001-DEPR-AUTH-MT': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.meta_title}}</code> helper with <code>{{primary_author.meta_title}}</code> or <code>{{authors.[#].meta_title}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.meta_title}}</code> is deprecated and should be replaced with either <code>{{primary_author.meta_title}}</code>
+        or <code>{{authors.[#].meta_title}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.meta_title\s*?}}/g,
+        helper: '{{author.meta_title}}'
+    },
+    'GS001-DEPR-AUTH-MD': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.meta_description}}</code> helper with <code>{{primary_author.meta_description}}</code> or <code>{{authors.[#].meta_description}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.meta_description}}</code> is deprecated and should be replaced with either <code>{{primary_author.meta_description}}</code>
+        or <code>{{authors.[#].meta_description}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.meta_description\s*?}}/g,
+        helper: '{{author.meta_description}}'
+    },
+    'GS001-DEPR-AUTH-NAME': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.name}}</code> helper with <code>{{primary_author.name}}</code> or <code>{{authors.[#].name}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.name}}</code> is deprecated and should be replaced with either <code>{{primary_author.name}}</code>
+        or <code>{{authors.[#].name}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.name\s*?}}/g,
+        helper: '{{author.name}}'
+    },
+    'GS001-DEPR-AUTH-BIO': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.bio}}</code> helper with <code>{{primary_author.bio}}</code> or <code>{{authors.[#].bio}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.bio}}</code> is deprecated and should be replaced with either <code>{{primary_author.bio}}</code>
+        or <code>{{authors.[#].bio}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.bio\s*?}}/g,
+        helper: '{{author.bio}}'
+    },
+    'GS001-DEPR-AUTH-LOC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.location}}</code> helper with <code>{{primary_author.location}}</code> or <code>{{authors.[#].location}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.location}}</code> is deprecated and should be replaced with either <code>{{primary_author.location}}</code>
+        or <code>{{authors.[#].location}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.location\s*?}}/g,
+        helper: '{{author.location}}'
+    },
+    'GS001-DEPR-AUTH-WEB': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.website}}</code> helper with <code>{{primary_author.website}}</code> or <code>{{authors.[#].website}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.website}}</code> is deprecated and should be replaced with either <code>{{primary_author.website}}</code>
+        or <code>{{authors.[#].website}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.website\s*?}}/g,
+        helper: '{{author.website}}'
+    },
+    'GS001-DEPR-AUTH-TW': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.twitter}}</code> helper with <code>{{primary_author.twitter}}</code> or <code>{{authors.[#].twitter}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.twitter}}</code> is deprecated and should be replaced with either <code>{{primary_author.twitter}}</code>
+        or <code>{{authors.[#].twitter}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.twitter\s*?}}/g,
+        helper: '{{author.twitter}}'
+    },
+    'GS001-DEPR-AUTH-FB': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.facebook}}</code> helper with <code>{{primary_author.facebook}}</code> or <code>{{authors.[#].facebook}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.facebook}}</code> is deprecated and should be replaced with either <code>{{primary_author.facebook}}</code>
+        or <code>{{authors.[#].facebook}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.facebook\s*?}}/g,
+        helper: '{{author.facebook}}'
+    },
+    'GS001-DEPR-AUTH-PIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.profile_image}}</code> helper with <code>{{primary_author.profile_image}}</code> or <code>{{authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.profile_image}}</code> is deprecated and should be replaced with either <code>{{primary_author.profile_image}}</code>
+        or <code>{{authors.[#].profile_image}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.profile_image\s*?}}/g,
+        helper: '{{author.profile_image}}'
+    },
+    'GS001-DEPR-AUTH-CIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.cover_image}}</code> helper with <code>{{primary_author.cover_image}}</code> or <code>{{authors.[#].cover_image}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.cover_image}}</code> is deprecated and should be replaced with either <code>{{primary_author.cover_image}}</code>
+        or <code>{{authors.[#].cover_image}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.cover_image\s*?}}/g,
+        helper: '{{author.cover_image}}'
+    },
+    'GS001-DEPR-AUTH-URL': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.url}}</code> helper with <code>{{primary_author.url}}</code> or <code>{{authors.[#].url}}</code>',
+        details: oneLineTrim`The usage of <code>{{author.url}}</code> is deprecated and should be replaced with either <code>{{primary_author.url}}</code>
+        or <code>{{authors.[#].url}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.url\s*?}}/g,
+        helper: '{{author.url}}'
+    },
+    'GS001-DEPR-PAUTH': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author}}</code> helper with <code>{{post.primary_author}}</code> or <code>{{authors.[#]}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author}}</code> is deprecated and should be replaced with either <code>{{post.primary_author}}</code>
+        or <code>{{post.authors.[#]}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\s*?}}/g,
+        helper: '{{post.author}}'
+    },
+    'GS001-DEPR-PAUTH-ID': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.id}}</code> helper with <code>{{post.primary_author.id}}</code> or <code>{{authors.[#].id}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.id}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.id}}</code>
+        or <code>{{post.authors.[#].id}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.id\s*?}}/g,
+        helper: '{{post.author.id}}'
+    },
+    'GS001-DEPR-PAUTH-SLUG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.slug}}</code> helper with <code>{{post.primary_author.slug}}</code> or <code>{{post.authors.[#].slug}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.slug}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.slug}}</code>
+        or <code>{{post.authors.[#].slug}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.slug\s*?}}/g,
+        helper: '{{post.author.slug}}'
+    },
+    'GS001-DEPR-PAUTH-MAIL': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.email}}</code> helper with <code>{{post.primary_author.email}}</code> or <code>{{post.authors.[#].email}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.email}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.email}}</code>
+        or <code>{{post.authors.[#].email}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.email\s*?}}/g,
+        helper: '{{post.author.email}}'
+    },
+    'GS001-DEPR-PAUTH-MT': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.meta_title}}</code> helper with <code>{{post.primary_author.meta_title}}</code> or <code>{{post.authors.[#].meta_title}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.meta_title}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.meta_title}}</code>
+        or <code>{{post.authors.[#].meta_title}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.meta_title\s*?}}/g,
+        helper: '{{post.author.meta_title}}'
+    },
+    'GS001-DEPR-PAUTH-MD': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.meta_description}}</code> helper with <code>{{post.primary_author.meta_description}}</code> or <code>{{post.authors.[#].meta_description}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.meta_description}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.meta_description}}</code>
+        or <code>{{post.authors.[#].meta_description}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.meta_description\s*?}}/g,
+        helper: '{{post.author.meta_description}}'
+    },
+    'GS001-DEPR-PAUTH-NAME': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.name}}</code> helper with <code>{{post.primary_author.name}}</code> or <code>{{post.authors.[#].name}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.name}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.name}}</code>
+        or <code>{{post.authors.[#].name}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.name\s*?}}/g,
+        helper: '{{post.author.name}}'
+    },
+    'GS001-DEPR-PAUTH-BIO': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.bio}}</code> helper with <code>{{post.primary_author.bio}}</code> or <code>{{post.authors.[#].bio}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.bio}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.bio}}</code>
+        or <code>{{post.authors.[#].bio}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.bio\s*?}}/g,
+        helper: '{{post.author.bio}}'
+    },
+    'GS001-DEPR-PAUTH-LOC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.location}}</code> helper with <code>{{post.primary_author.location}}</code> or <code>{{post.authors.[#].location}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.location}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.location}}</code>
+        or <code>{{post.authors.[#].location}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.location\s*?}}/g,
+        helper: '{{post.author.location}}'
+    },
+    'GS001-DEPR-PAUTH-WEB': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.website}}</code> helper with <code>{{post.primary_author.website}}</code> or <code>{{post.authors.[#].website}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.website}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.website}}</code>
+        or <code>{{post.authors.[#].website}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.website\s*?}}/g,
+        helper: '{{post.author.website}}'
+    },
+    'GS001-DEPR-PAUTH-TW': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.twitter}}</code> helper with <code>{{post.primary_author.twitter}}</code> or <code>{{post.authors.[#].twitter}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.twitter}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.twitter}}</code>
+        or <code>{{post.authors.[#].twitter}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.twitter\s*?}}/g,
+        helper: '{{post.author.twitter}}'
+    },
+    'GS001-DEPR-PAUTH-FB': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.facebook}}</code> helper with <code>{{post.primary_author.facebook}}</code> or <code>{{post.authors.[#].facebook}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.facebook}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.facebook}}</code>
+        or <code>{{post.authors.[#].facebook}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.facebook\s*?}}/g,
+        helper: '{{post.author.facebook}}'
+    },
+    'GS001-DEPR-PAUTH-PIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.profile_image}}</code> helper with <code>{{post.primary_author.profile_image}}</code> or <code>{{post.authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.profile_image}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.profile_image}}</code>
+        or <code>{{post.authors.[#].profile_image}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.profile_image\s*?}}/g,
+        helper: '{{post.author.profile_image}}'
+    },
+    'GS001-DEPR-PAUTH-CIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.cover_image}}</code> helper with <code>{{post.primary_author.cover_image}}</code> or <code>{{post.authors.[#].cover_image}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.cover_image}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.cover_image}}</code>
+        or <code>{{post.authors.[#].cover_image}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.cover_image\s*?}}/g,
+        helper: '{{post.author.cover_image}}'
+    },
+    'GS001-DEPR-PAUTH-URL': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.url}}</code> helper with <code>{{post.primary_author.url}}</code> or <code>{{post.authors.[#].url}}</code>',
+        details: oneLineTrim`The usage of <code>{{post.author.url}}</code> is deprecated and should be replaced with either <code>{{post.primary_author.url}}</code>
+        or <code>{{post.authors.[#].url}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.url\s*?}}/g,
+        helper: '{{post.author.url}}'
+    },
+    'GS001-DEPR-PAID': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace <code>{{post.author_id}}</code> code with <code>{{post.primary_author.id}}</code>',
+        details: oneLineTrim`The <code>{{post.author_id}}</code> attribute in post context was removed<br>
+        Instead of <code>{{post.author_id}}</code> you need to use <code>{{post.primary_author.id}}</code>.<br>
+        See the object attributes of <code>post</code> <a href="${docsBaseUrl}context/post/#post-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author_id\s*?}}/g,
+        helper: '{{post.author_id}}'
+    },
+    'GS001-DEPR-NAUTH': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace <code>../author</code> with <code>../primary_author</code> or <code>../authors.[#]</code>',
+        details: oneLineTrim`The usage of <code>../author</code> is deprecated and should be replaced with either <code>../primary_author</code>
+        or <code>../authors.[#]</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?(?:#|#if)?\s*?\.\.\/author(?:\.\S*?)?\s*?}}/g,
+        helper: '{{../author}}'
+    },
+    'GS001-DEPR-IUA': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace <code>{{img_url author.*}}</code> with <code>{{img_url primary_author.*}}</code> or <code>.{img_url author.[#].*}}</code>',
+        details: oneLineTrim`The usage of <code>{{img_url author.*}}</code> is deprecated and should be replaced with either <code>{{img_url primary_author.*}}</code>
+        or <code>{{img_url author.[#].*}}</code>.<br>
+        Find more information about the <code>{{authors}}</code> helper <a href="${docsBaseUrl}helpers/authors/" target=_blank>here</a>.`,
+        regex: /{{\s*?img_url\s*?(author.).*}}/g,
+        helper: '{{img_url author.*}}'
+    },
+    'GS001-DEPR-AC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.cover}}</code> helper with <code>{{primary_author.cover_image}}</code>',
+        details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
+        Instead of <code>{{author.cover}}</code> you need to use
+        <code>{{primary_author.cover_image}}</code> or <code>{{authors.[#].cover_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.cover\s*?}}/g,
+        helper: '{{author.cover}}'
+    },
+    'GS001-DEPR-AIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{author.image}}</code> helper with <code>{{primary_author.profile_image}}</code> or <code>{{authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
+        Instead of <code>{{author.image}}</code>, you need to use
+        <code>{{primary_author.profile_image}}</code> or <code>{{authors.[#].profile_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?author\.image\s*?}}/g,
+        helper: '{{author.image}}'
+    },
+    'GS001-DEPR-PAC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.cover}}</code> helper with <code>{{post.primary_author.cover_image}}</code> or <code>{{post.authors.[#].cover_image}}</code>',
+        details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
+        Instead of <code>{{post.author.cover}}</code>, you need to use
+        <code>{{post.primary_author.cover_image}}</code> or <code>{{post.authors.[#].cover_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.cover\s*?}}/g,
+        helper: '{{post.author.cover}}'
+    },
+    'GS001-DEPR-PAIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{post.author.image}}</code> helper with <code>{{post.primary_author.profile_image}}</code> or <code>{{post.authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
+        Instead of <code>{{post.author.image}}</code>, you need to use
+        <code>{{post.primary_author.profile_image}}</code> or <code>{{post.authors.[#].profile_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?post\.author\.image\s*?}}/g,
+        helper: '{{post.author.image}}'
+    },
+    'GS001-DEPR-CON-AC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{#if author.cover}}</code> helper with <code>{{#if primary_author.cover_image}}</code> or <code>{{#if authors.[#].cover_image}}</code>',
+        details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
+        Instead of <code>{{#if author.cover}}</code>, you need to use
+        <code>{{#if primary_author.cover_image}}</code> or <code>{{#if authors.[#].cover_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?#if\s*?author\.cover\s*?}}/g,
+        helper: '{{#if author.cover}}'
+    },
+    'GS001-DEPR-CON-AIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{#if author.image}}</code> helper with <code>{{#if primary_author.profile_image}}</code> or <code>{{#if authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
+        Instead of <code>{{#if author.image}}</code>, you need to use
+        <code>{{#if primary_author.profile_image}}</code> or <code>{{#if authors.[#].profile_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?#if\s*?author\.image\s*?}}/g,
+        helper: '{{#if author.image}}'
+    },
+    'GS001-DEPR-CON-PAC': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{#if post.author.cover}}</code> helper with <code>{{#if post.primary_author.cover_image}}</code> or <code>{{#if post.authors.[#].cover_image}}</code>',
+        details: oneLineTrim`The <code>cover</code> attribute was replaced with <code>cover_image</code>.<br>
+        Instead of <code>{{#if post.author.cover}}</code>, you need to use
+        <code>{{#if post.primary_author.cover_image}}</code> or <code>{{#if post.authors.[#].cover_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?#if\s*?post\.author\.cover\s*?}}/g,
+        helper: '{{#if post.author.cover}}'
+    },
+    'GS001-DEPR-CON-PAIMG': {
+        level: 'error',
+        fatal: true,
+        rule: 'Replace the <code>{{#if post.author.image}}</code> helper with <code>{{#if post.primary_author.profile_image}}</code> or <code>{{#if post.authors.[#].profile_image}}</code>',
+        details: oneLineTrim`The <code>image</code> attribute was replaced with <code>profile_image</code>.<br>
+        Instead of <code>{{#if post.author.image}}</code>, you need to use
+        <code>{{#if post.primary_author.profile_image}}</code> or <code>{{#if post.authors.[#].profile_image}}</code>.<br>
+        See the object attributes of <code>author</code> <a href="${docsBaseUrl}context/author/#author-object-attributes" target=_blank>here</a>.`,
+        regex: /{{\s*?#if\s*?post\.author\.image\s*?}}/g,
+        helper: '{{#if post.author.image}}'
     }
 };
 

package/lib/specs/v4.js

@@ -180,6 +180,31 @@ let rules = {
         fatal: false,
         details: oneLineTrim`Custom theme settings of type <code>select</code> can only be compared to their defined <code>options</code> when used in a <code>match</code> block.`
     },
+    'GS090-NO-PRODUCTS-HELPER': {
+        level: 'warning',
+        rule: 'The <code>{{products}}</code> helper should be replaces with <code>{{tiers}}</code>',
+        details: oneLineTrim`The <code>{{products}}</code> helper has been deprecated in favor of <code>{{tiers}}</code><br>
+        The <code>{{products}}</code> helper will be removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{tiers}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{products}}'
+    },
+    'GS090-NO-PRODUCT-DATA-HELPER': {
+        level: 'warning',
+        rule: 'The <code>{{@product}}</code> data helper should be replaces with <code>{{#get "tiers"}}</code>',
+        details: oneLineTrim`The <code>{{@product}}</code> data helper has been deprecated in favor of <code>{{#get "tiers"}}</code><br>
+        The <code>{{@product}}</code> data helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{#get "tiers"}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{@product}}'
+    },
+    'GS090-NO-PRODUCTS-DATA-HELPER': {
+        level: 'warning',
+        rule: 'The <code>{{@products}}</code> data helper should be replaces with <code>{{#get "tiers"}}</code>',
+        details: oneLineTrim`The <code>{{@products}}</code> data helper has been deprecated in favor of <code>{{#get "tiers"}}</code><br>
+        The <code>{{@products}}</code> data helper was removed in Ghost v5 and should not be used.
+        Find more information about the <code>{{#get "tiers"}}</code> property <a href="${docsBaseUrl}helpers/tiers/" target=_blank>here</a>.`,
+        helper: '{{@products}}'
+    },
+
     'GS100-NO-UNUSED-CUSTOM-THEME-SETTING': {
         level: 'error',
         rule: 'A custom theme setting defined in <code>package.json</code> hasn\'t been used in any theme file.',

package/lib/utils/versions.json

@@ -15,7 +15,7 @@
     "major": "4.x",
     "docs": "4.0.0"
   },
-  "canary": {
+  "v5": {
     "major": "5.x",
     "docs": "5.0.0"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gscan",
-  "version": "4.23.0",
+  "version": "4.25.0",
   "description": "Scans Ghost themes looking for errors, deprecations, features and compatibility",
   "keywords": [
     "ghost",
@@ -29,22 +29,22 @@
   "scripts": {
     "start": "node app/index.js",
     "dev": "NODE_ENV=development DEBUG=gscan:* nodemon",
-    "lint": "eslint ./app --ext .js --cache",
+    "lint": "eslint . --ext .js --cache",
     "test": "NODE_ENV=testing mocha -- $(find test -name '*.test.js')",
     "posttest": "yarn lint",
     "coverage": "NODE_ENV=testing istanbul cover --dir test/coverage _mocha -- $(find test -name '*.test.js')",
     "preship": "yarn test",
-    "ship": "yarn publish && git push ${GHOST_UPSTREAM:-upstream} main --follow-tags"
+    "ship": "STATUS=$(git status --porcelain); echo $STATUS; if [ -z \"$STATUS\" ]; then yarn publish && git push ${GHOST_UPSTREAM:-upstream} main --follow-tags; fi"
   },
   "bin": {
     "gscan": "./bin/cli.js"
   },
   "dependencies": {
-    "@sentry/node": "6.18.2",
+    "@sentry/node": "6.19.2",
     "@tryghost/config": "0.2.2",
     "@tryghost/debug": "0.1.11",
     "@tryghost/ignition-errors": "0.1.8",
-    "@tryghost/logging": "2.0.4",
+    "@tryghost/logging": "2.1.0",
     "@tryghost/pretty-cli": "1.2.24",
     "@tryghost/server": "0.1.4",
     "@tryghost/zip": "1.1.20",