Add Jambo build validation hook

src/commands/build/pagewriter.js

@@ -7,6 +7,7 @@ const UserError = require('../../errors/usererror');
 const { NO_LOCALE } = require('../../constants');
 const LocalizationConfig = require('../../models/localizationconfig');
 const TemplateArgsBuilder = require('./templateargsbuilder');
+const TemplateDataValidator = require('./templatedatavalidator');
 const { info } = require('../../utils/logger');
 
 /**
@@ -30,6 +31,12 @@ module.exports = class PageWriter {
      */
     this._templateArgsBuilder =
       new TemplateArgsBuilder(config.templateDataFormatterHook);
+
+    /**
+     * @type {TemplateDataValidator}
+     */
+     this._templateDataValidator =
+      new TemplateDataValidator(config.templateDataValidationHook);
   }
 
   /**
@@ -51,7 +58,6 @@ module.exports = class PageWriter {
         throw new UserError(`Error: No config found for page: ${page.getName()}`);
       }
 
-      info(`Writing output file for the '${page.getName()}' page`);
       const templateArguments = this._templateArgsBuilder.buildArgs({
         relativePath: this._calculateRelativePath(page.getOutputPath()),
         pageName: page.getName(),
@@ -61,7 +67,13 @@ module.exports = class PageWriter {
         locale: pageSet.getLocale(),
         env: this._env
       });
+
+      this._templateDataValidator.validate({
+        pageName: page.getName(),
+        pageData: templateArguments
+      });
 
+      info(`Writing output file for the '${page.getName()}' page`);
       const template = hbs.compile(page.getTemplateContents());
       const outputHTML = template(templateArguments);
 

src/commands/build/sitesgenerator.js

@@ -178,10 +178,13 @@ class SitesGenerator {
 
       const templateDataFormatterHook = path.resolve(
         config.dirs.themes, config.defaultTheme, 'hooks', 'templatedataformatter.js');
+      const templateDataValidationHook = path.resolve(
+        config.dirs.themes, config.defaultTheme, 'hooks', 'templatedatavalidator.js');
       // Write pages
       new PageWriter({
         outputDirectory: config.dirs.output,
         templateDataFormatterHook: templateDataFormatterHook,
+        templateDataValidationHook: templateDataValidationHook,
         env: env,
       }).writePages(pageSet);
     }

src/commands/build/templatedatavalidator.js

@@ -0,0 +1,41 @@
+const fs = require('file-system');
+const UserError = require('../../errors/usererror');
+const { isCustomError } = require('../../utils/errorutils');
+const { info } = require('../../utils/logger');
+
+/**
+ * TemplateDataValidator is reponsible for checking data supplied to a page
+ * using Theme's custom validation steps (if any).
+ */
+module.exports = class TemplateDataValidator {
+  constructor(templateDataValidationHook) {
+    /**
+     *  The path to template data validation hook.
+     * @type {string}
+     */
+    this._templateDataValidationHook = templateDataValidationHook;
+  }
+
+  /**
+   *  Execute validation hook's function if file exists
+   * @param {string} pageName name of the current page
+   * @param {Object} pageData template arguments for the current page
+   */
+  validate({ pageName, pageData }) {
+    if (!fs.existsSync(this._templateDataValidationHook)) {
+        return;
+    }
+    try {
+        info(`Validating configuration for page "${pageName}".`);
+        const validatorFunction = require(this._templateDataValidationHook);
+        validatorFunction(pageData);
+    } catch (err) {
+        if(isCustomError(err)) {
+            throw err;
+        }
+        const msg = 
+            `Error executing validation hook from ${this._templateDataValidationHook}: `;
+        throw new UserError(msg, err.stack);
+    }
+  }
+}

tests/commands/build/templatedatavalidator.js

@@ -0,0 +1,83 @@
+const TemplateDataValidator = require('../../../src/commands/build/templatedatavalidator');
+const path = require('path');
+const UserError = require('../../../src/errors/usererror');
+
+describe('TemplateDataValidator validates config data using hook properly', () => {
+  const currentPageConfig = {
+    url: 'examplePage.html',
+    verticalKey: 'examplePage',
+    pageTitle: 'Example Page',
+    pageSettings: { search: { verticalKey: 'examplePage', defaultInitialSearch: '' } },
+    componentSettings: {
+      prop: 'example1',
+    }, 
+    verticalsToConfig: {
+      examplePage: {
+        prop: 'example2'
+      }
+    }
+  };
+  const verticalConfigs = {
+    page1: {
+      config: {
+        prop: 'example'
+      }
+    },
+    page2: {
+      config: {
+        prop: 'example2'
+      }
+    }
+  };
+  const global_config = {
+    sdkVersion: 'X.X',
+    apiKey: 'exampleKey',
+    experienceKey: 'slanswers',
+    locale: 'en'
+  };
+  const params = {
+    example: 'param'
+  };
+  const relativePath = '..';
+  const env = {
+    envVar: 'envVar',
+  };
+
+  it('does not throw an error with a correct config', () => {
+    const templateDataValidationHook = path.resolve(
+        __dirname, '../../fixtures/hooks/templatedatavalidator.js');
+    const templateData = {
+        currentPageConfig,
+        verticalConfigs,
+        global_config,
+        params,
+        relativePath,
+        env
+    };
+
+    expect(() => new TemplateDataValidator(templateDataValidationHook).validate({
+        pageName: 'examplePage',
+        pageData: templateData
+    })).not.toThrow(UserError);
+  });
+
+  it('throws an error when a field in config is missing', () => {
+    const templateDataValidationHook = path.resolve(
+        __dirname, '../../fixtures/hooks/templatedatavalidator.js');
+    const global_config_missing_key = {};
+    const templateData = {
+        currentPageConfig,
+        verticalConfigs,
+        global_config_missing_key,
+        params,
+        relativePath,
+        env
+    };  
+
+    expect(() => new TemplateDataValidator(templateDataValidationHook).validate({
+        pageName: 'examplePage',
+        pageData: templateData
+    })).toThrow(UserError);
+
+  });
+});

tests/fixtures/hooks/templatedatavalidator.js

@@ -0,0 +1,12 @@
+const UserError = require('../../../src/errors/usererror');
+
+/**
+ * A test data validator hook.
+ *
+ * @param {Object} pageData configuration(s) of a page template
+ */
+ module.exports = function (pageData) {
+    if(!pageData["global_config"]["experienceKey"]) {
+        throw new UserError('Missing Info: experienceKey in config file(s)');
+    }
+}