@dwp/govuk-casa 9.0.0 → 9.1.0

package/src/lib/ValidatorFactory.js

@@ -1,31 +1,31 @@
 /* eslint-disable class-methods-use-this */
-import lodash from 'lodash';
+import lodash from "lodash";
 
 const { isPlainObject } = lodash; // CommonJS
 
 /**
+ * @typedef {import("../casa").ErrorMessageConfig} ErrorMessageConfig
  * @access private
- * @typedef {import('../casa').ErrorMessageConfig} ErrorMessageConfig
  */
 
 /**
+ * @typedef {import("./index").JourneyContext} JourneyContext
  * @access private
- * @typedef {import('./index').JourneyContext} JourneyContext
  */
 
 /**
+ * @typedef {import("./index").ValidationError} ValidationError
  * @access private
- * @typedef {import('./index').ValidationError} ValidationError
  */
 
 /**
+ * @typedef {import("../casa").ValidateContext} ValidateContext
  * @access private
- * @typedef {import('../casa').ValidateContext} ValidateContext
  */
 
 /**
+ * @typedef {import("../casa").Validator} Validator
  * @access private
- * @typedef {import('../casa').Validator} Validator
  */
 
 /**
@@ -34,28 +34,29 @@ const { isPlainObject } = lodash; // CommonJS
  */
 
 /**
- * @class
  * @memberof module:@dwp/govuk-casa
+ * @class
  */
 export default class ValidatorFactory {
   /**
    * This is a convenience method that will return a consistently object
    * structure containing validation and sanitisation methods.
    *
-   * @param {ValidatorFactoryOptions} config Validator config (custom to each validator)
+   * @param {ValidatorFactoryOptions} config Validator config (custom to each
+   *   validator)
    * @returns {Validator} Validator object
    * @throws {TypeError} When configuration is invalid.
    */
   static make(config = {}) {
     if (!isPlainObject(config)) {
-      throw new TypeError('Configuration must be an object');
+      throw new TypeError("Configuration must be an object");
     }
 
     const validator = Reflect.construct(this, [config]);
 
     /* eslint-disable-next-line sonarjs/prefer-object-literal */
     const instance = {};
-    instance.name = validator.name || 'unknown';
+    instance.name = validator.name || "unknown";
     instance.config = config;
     instance.validate = validator.validate.bind(instance);
     instance.sanitise = validator.sanitise.bind(instance);
@@ -68,11 +69,14 @@ export default class ValidatorFactory {
   /**
    * NEVER CALL THIS DIRECTLY. USE `make()`.
    *
-   * @param {ValidatorFactoryOptions} config Validator config (custom to each validator)
+   * @param {ValidatorFactoryOptions} config Validator config (custom to each
+   *   validator)
    */
   constructor(config = {}) {
     if (new.target === ValidatorFactory) {
-      throw new TypeError('Cannot instantiate the abstract class, ValidatorFactory');
+      throw new TypeError(
+        "Cannot instantiate the abstract class, ValidatorFactory",
+      );
     }
     this.config = config;
   }
@@ -89,7 +93,7 @@ export default class ValidatorFactory {
    * @throws {Error}
    */
   validate(fieldValue, context) {
-    throw new Error('validate() method has not been implemented');
+    throw new Error("validate() method has not been implemented");
   }
 
   /* eslint-disable-next-line jsdoc/require-returns-check */

package/src/lib/configuration-ingestor.js

@@ -1,43 +1,46 @@
 /* eslint-disable sonarjs/no-duplicate-string */
-import bytes from 'bytes';
-import { PageField } from './field.js';
-import Plan from './Plan.js';
-import logger from './logger.js';
+import bytes from "bytes";
+import { PageField } from "./field.js";
+import Plan from "./Plan.js";
+import logger from "./logger.js";
 import {
   validateWaypoint,
   validateHookName,
   validateHookPath,
   validateView,
-} from './utils.js';
-import * as contextIdGenerators from './context-id-generators.js';
-import { CONFIG_ERROR_VISIBILITY_ALWAYS, CONFIG_ERROR_VISIBILITY_ONSUBMIT } from './constants.js';
+} from "./utils.js";
+import * as contextIdGenerators from "./context-id-generators.js";
+import {
+  CONFIG_ERROR_VISIBILITY_ALWAYS,
+  CONFIG_ERROR_VISIBILITY_ONSUBMIT,
+} from "./constants.js";
 
 /**
+ * @typedef {import("../casa").ConfigurationOptions} ConfigurationOptions
  * @access private
- * @typedef {import('../casa').ConfigurationOptions} ConfigurationOptions
  */
 
 /**
+ * @typedef {import("../casa").HelmetConfigurator} HelmetConfigurator
  * @access private
- * @typedef {import('../casa').HelmetConfigurator} HelmetConfigurator
  */
 
-const log = logger('lib:configuration-ingestor');
+const log = logger("lib:configuration-ingestor");
 
-const echo = (a) => (a);
+const echo = (a) => a;
 
 /**
  * Validates and sanitises i18n object.
  *
- * @access private
  * @param {object} i18n Object to validate.
  * @param {Function} cb Callback function that receives the validated value.
- * @throws {TypeError} For invalid object.
  * @returns {object} Sanitised i18n object.
+ * @throws {TypeError} For invalid object.
+ * @access private
  */
 export function validateI18nObject(i18n = Object.create(null), cb = echo) {
-  if (Object.prototype.toString.call(i18n) !== '[object Object]') {
-    throw new TypeError('I18n must be an object');
+  if (Object.prototype.toString.call(i18n) !== "[object Object]") {
+    throw new TypeError("I18n must be an object");
   }
   return cb(i18n);
 }
@@ -45,19 +48,21 @@ export function validateI18nObject(i18n = Object.create(null), cb = echo) {
 /**
  * Validates and sanitises i18n directory.
  *
- * @access private
  * @param {Array} dirs Array of directories.
+ * @returns {Array} Array of directories.
  * @throws {SyntaxError} For invalid directories.
  * @throws {TypeError} For invalid type.
- * @returns {Array} Array of directories.
+ * @access private
  */
 export function validateI18nDirs(dirs = []) {
   if (!Array.isArray(dirs)) {
-    throw new TypeError('I18n directories must be an array (i18n.dirs)');
+    throw new TypeError("I18n directories must be an array (i18n.dirs)");
   }
   dirs.forEach((dir, i) => {
-    if (typeof dir !== 'string') {
-      throw new TypeError(`I18n directory must be a string, got ${typeof dir} (i18n.dirs[${i}])`);
+    if (typeof dir !== "string") {
+      throw new TypeError(
+        `I18n directory must be a string, got ${typeof dir} (i18n.dirs[${i}])`,
+      );
     }
   });
   return dirs;
@@ -66,19 +71,21 @@ export function validateI18nDirs(dirs = []) {
 /**
  * Validates and sanitises i18n locales.
  *
- * @access private
  * @param {Array} locales Array of locales.
+ * @returns {Array} Array of locales.
  * @throws {SyntaxError} For invalid locales.
  * @throws {TypeError} For invalid type.
- * @returns {Array} Array of locales.
+ * @access private
  */
-export function validateI18nLocales(locales = ['en', 'cy']) {
+export function validateI18nLocales(locales = ["en", "cy"]) {
   if (!Array.isArray(locales)) {
-    throw new TypeError('I18n locales must be an array (i18n.locales)');
+    throw new TypeError("I18n locales must be an array (i18n.locales)");
   }
   locales.forEach((locale, i) => {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`I18n locale must be a string, got ${typeof locale} (i18n.locales[${i}])`);
+    if (typeof locale !== "string") {
+      throw new TypeError(
+        `I18n locale must be a string, got ${typeof locale} (i18n.locales[${i}])`,
+      );
     }
   });
   return locales;
@@ -87,17 +94,17 @@ export function validateI18nLocales(locales = ['en', 'cy']) {
 /**
  * Validates and sanitises mount url.
  *
- * @access private
  * @param {string} mountUrl Prefix for all URLs in the browser address bar
+ * @returns {string | undefined} Sanitised URL.
  * @throws {SyntaxError} For invalid URL.
- * @returns {string|undefined} Sanitised URL.
+ * @access private
  */
 export function validateMountUrl(mountUrl) {
-  if (typeof mountUrl === 'undefined') {
+  if (typeof mountUrl === "undefined") {
     return undefined;
   }
   if (!mountUrl.match(/\/$/)) {
-    throw new SyntaxError('mountUrl must include a trailing slash (/)');
+    throw new SyntaxError("mountUrl must include a trailing slash (/)");
   }
   return mountUrl;
 }
@@ -105,19 +112,22 @@ export function validateMountUrl(mountUrl) {
 /**
  * Validates and sanitises sessions object.
  *
- * @access private
  * @param {object} session Object to validate.
  * @param {Function} cb Callback function that receives the validated value.
- * @throws {TypeError} For invalid object.
  * @returns {object} Sanitised sessions object.
+ * @throws {TypeError} For invalid object.
+ * @access private
  */
-export function validateSessionObject(session = Object.create(null), cb = echo) {
+export function validateSessionObject(
+  session = Object.create(null),
+  cb = echo,
+) {
   if (session === undefined) {
     return cb(session);
   }
 
-  if (typeof session !== 'object') {
-    throw new TypeError('Session config has not been specified');
+  if (typeof session !== "object") {
+    throw new TypeError("Session config has not been specified");
   }
 
   return cb(session);
@@ -126,19 +136,21 @@ export function validateSessionObject(session = Object.create(null), cb = echo)
 /**
  * Validates and sanitises view directory.
  *
- * @access private
  * @param {Array} dirs Array of directories.
+ * @returns {Array} Array of directories.
  * @throws {SyntaxError} For invalid directories.
  * @throws {TypeError} For invalid type.
- * @returns {Array} Array of directories.
+ * @access private
  */
 export function validateViews(dirs = []) {
   if (!Array.isArray(dirs)) {
-    throw new TypeError('View directories must be an array (views)');
+    throw new TypeError("View directories must be an array (views)");
   }
   dirs.forEach((dir, i) => {
-    if (typeof dir !== 'string') {
-      throw new TypeError(`View directory must be a string, got ${typeof dir} (views[${i}])`);
+    if (typeof dir !== "string") {
+      throw new TypeError(
+        `View directory must be a string, got ${typeof dir} (views[${i}])`,
+      );
     }
   });
   return dirs;
@@ -147,17 +159,17 @@ export function validateViews(dirs = []) {
 /**
  * Validates and sanitises sessions secret.
  *
- * @access private
  * @param {string} secret Session secret.
+ * @returns {string} Secret.
  * @throws {ReferenceError} For missing value type.
  * @throws {TypeError} For invalid value.
- * @returns {string} Secret.
+ * @access private
  */
 export function validateSessionSecret(secret) {
-  if (typeof secret === 'undefined') {
-    throw ReferenceError('Session secret is missing (session.secret)')
-  } else if (typeof secret !== 'string') {
-    throw new TypeError('Session secret must be a string (session.secret)');
+  if (typeof secret === "undefined") {
+    throw ReferenceError("Session secret is missing (session.secret)");
+  } else if (typeof secret !== "string") {
+    throw new TypeError("Session secret must be a string (session.secret)");
   }
   return secret;
 }
@@ -165,15 +177,15 @@ export function validateSessionSecret(secret) {
 /**
  * Validates and sanitises sessions ttl.
  *
- * @access private
  * @param {number} ttl Session ttl (seconds).
+ * @returns {number} Ttl.
  * @throws {ReferenceError} For missing value type.
  * @throws {TypeError} For invalid value.
- * @returns {number} Ttl.
+ * @access private
  */
 export function validateSessionTtl(ttl = 3600) {
-  if (typeof ttl !== 'number') {
-    throw new TypeError('Session ttl must be an integer (session.ttl)');
+  if (typeof ttl !== "number") {
+    throw new TypeError("Session ttl must be an integer (session.ttl)");
   }
   return ttl;
 }
@@ -181,15 +193,15 @@ export function validateSessionTtl(ttl = 3600) {
 /**
  * Validates and sanitises sessions name.
  *
- * @access private
- * @param {string} [name=casa-session] Session name.
+ * @param {string} [name=casa-session] Session name. Default is `casa-session`
+ * @returns {string} Name.
  * @throws {ReferenceError} For missing value type.
  * @throws {TypeError} For invalid value.
- * @returns {string} Name.
+ * @access private
  */
-export function validateSessionName(name = 'casa-session') {
-  if (typeof name !== 'string') {
-    throw new TypeError('Session name must be a string (session.name)');
+export function validateSessionName(name = "casa-session") {
+  if (typeof name !== "string") {
+    throw new TypeError("Session name must be a string (session.name)");
   }
   return name;
 }
@@ -197,18 +209,20 @@ export function validateSessionName(name = 'casa-session') {
 /**
  * Validates and sanitises sessions secure flag.
  *
- * @access private
  * @param {boolean} [secure] Session secure flag.
+ * @returns {string} Name.
  * @throws {ReferenceError} For missing value type.
  * @throws {TypeError} For invalid or missing value.
- * @returns {string} Name.
+ * @access private
  */
 export function validateSessionSecure(secure) {
   if (secure === undefined) {
-    throw new Error('Session secure flag must be explicitly defined (session.secure)');
+    throw new Error(
+      "Session secure flag must be explicitly defined (session.secure)",
+    );
   }
-  if (typeof secure !== 'boolean') {
-    throw new TypeError('Session secure flag must be boolean (session.secure)');
+  if (typeof secure !== "boolean") {
+    throw new TypeError("Session secure flag must be boolean (session.secure)");
   }
   return secure;
 }
@@ -216,13 +230,15 @@ export function validateSessionSecure(secure) {
 /**
  * Validates and sanitises sessions store.
  *
- * @access private
  * @param {Function} store Session store.
  * @returns {Function} Store.
+ * @access private
  */
 export function validateSessionStore(store) {
-  if (typeof store === 'undefined') {
-    log.warn('Using MemoryStore session storage, which is not suitable for production');
+  if (typeof store === "undefined") {
+    log.warn(
+      "Using MemoryStore session storage, which is not suitable for production",
+    );
     return null;
   }
   return store;
@@ -231,63 +247,74 @@ export function validateSessionStore(store) {
 /**
  * Validates and sanitises sessions cookie url path.
  *
- * @access private
  * @param {string} cookiePath Session cookie url path.
  * @param {string} defaultPath Default path if none specified.
  * @returns {string} Cookie path.
+ * @access private
  */
-export function validateSessionCookiePath(cookiePath, defaultPath = '/') {
-  if (typeof cookiePath === 'undefined') {
+export function validateSessionCookiePath(cookiePath, defaultPath = "/") {
+  if (typeof cookiePath === "undefined") {
     return defaultPath;
   }
   return cookiePath;
 }
 
 /**
- * Validates and sanitises sessions cookie "sameSite" flag. One of:
- * true (Strict)
- * false (will not set the flag at all)
- * Strict
- * Lax
- * None
+ * Validates and sanitises sessions cookie "sameSite" flag. One of: true
+ * (Strict) false (will not set the flag at all) Strict Lax None
  *
- * @access private
  * @param {any} cookieSameSite Session cookie "sameSite" flag
  * @param {any} defaultFlag Default path if none specified
- * @returns {boolean} cookie path
+ * @returns {boolean} Cookie path
  * @throws {TypeError} When invalid arguments are provided
+ * @access private
  */
 
 /**
  * Validates errorVisibility.
  *
- * @access private
- * @param {string} errorVisibility sets visibility flag for page validation error
+ * @param {string} errorVisibility Sets visibility flag for page validation
+ *   error
+ * @returns {symbol | Function} Flag for error visibility.
  * @throws {SyntaxError} For invalid errorVisibility flag.
- * @returns {symbol | Function} flag for error visibility.
+ * @access private
  */
-export function validateErrorVisibility(errorVisibility = CONFIG_ERROR_VISIBILITY_ONSUBMIT) {
+export function validateErrorVisibility(
+  errorVisibility = CONFIG_ERROR_VISIBILITY_ONSUBMIT,
+) {
   if (errorVisibility === undefined) {
     return undefined;
   }
-  if (errorVisibility === CONFIG_ERROR_VISIBILITY_ALWAYS || errorVisibility === CONFIG_ERROR_VISIBILITY_ONSUBMIT || typeof errorVisibility === 'function') {
+  if (
+    errorVisibility === CONFIG_ERROR_VISIBILITY_ALWAYS ||
+    errorVisibility === CONFIG_ERROR_VISIBILITY_ONSUBMIT ||
+    typeof errorVisibility === "function"
+  ) {
     return errorVisibility;
   }
-  throw new TypeError('errorVisibility must be casa constant CONFIG_ERROR_VISIBILITY_ALWAYS | CONFIG_ERROR_VISIBILITY_ONSUBMIT or function');
+  throw new TypeError(
+    "errorVisibility must be casa constant CONFIG_ERROR_VISIBILITY_ALWAYS | CONFIG_ERROR_VISIBILITY_ONSUBMIT or function",
+  );
 }
 
 export function validateSessionCookieSameSite(cookieSameSite, defaultFlag) {
-  const validValues = [true, false, 'Strict', 'Lax', 'None'];
+  const validValues = [true, false, "Strict", "Lax", "None"];
 
   if (defaultFlag === undefined) {
-    throw new TypeError('validateSessionCookieSameSite() requires an explicit default flag');
+    throw new TypeError(
+      "validateSessionCookieSameSite() requires an explicit default flag",
+    );
   } else if (!validValues.includes(defaultFlag)) {
-    throw new TypeError('validateSessionCookieSameSite() default flag must be set to one of true, false, Strict, Lax or None (session.cookieSameSite)');
+    throw new TypeError(
+      "validateSessionCookieSameSite() default flag must be set to one of true, false, Strict, Lax or None (session.cookieSameSite)",
+    );
   }
 
   const value = cookieSameSite !== undefined ? cookieSameSite : defaultFlag;
   if (!validValues.includes(value)) {
-    throw new TypeError('SameSite flag must be set to one of true, false, Strict, Lax or None (session.cookieSameSite)');
+    throw new TypeError(
+      "SameSite flag must be set to one of true, false, Strict, Lax or None (session.cookieSameSite)",
+    );
   }
 
   return value;
@@ -296,18 +323,18 @@ export function validateSessionCookieSameSite(cookieSameSite, defaultFlag) {
 const validatePageHook = (hook, index) => {
   try {
     validateHookName(hook.hook);
-    if (typeof hook.middleware !== 'function') {
-      throw new TypeError('Hook middleware must be a function');
+    if (typeof hook.middleware !== "function") {
+      throw new TypeError("Hook middleware must be a function");
     }
   } catch (err) {
     err.message = `Page hook at index ${index} is invalid: ${err.message}`;
     throw err;
   }
-}
+};
 
 export function validatePageHooks(hooks) {
   if (!Array.isArray(hooks)) {
-    throw new TypeError('Hooks must be an array');
+    throw new TypeError("Hooks must be an array");
   }
   hooks.forEach((hook, index) => validatePageHook(hook, index));
   return hooks;
@@ -316,7 +343,9 @@ export function validatePageHooks(hooks) {
 const validateField = (field, index) => {
   try {
     if (!(field instanceof PageField)) {
-      throw new TypeError('Page field must be an instance of PageField (created via the "field()" function)');
+      throw new TypeError(
+        'Page field must be an instance of PageField (created via the "field()" function)',
+      );
     }
   } catch (err) {
     err.message = `Page field at index ${index} is invalid: ${err.message}`;
@@ -326,7 +355,7 @@ const validateField = (field, index) => {
 
 export function validateFields(fields) {
   if (!Array.isArray(fields)) {
-    throw new TypeError('Page fields must be an array (page[].fields)');
+    throw new TypeError("Page fields must be an array (page[].fields)");
   }
   fields.forEach((hook, index) => validateField(hook, index));
   return fields;
@@ -343,17 +372,17 @@ const validatePage = (page, index) => {
       validatePageHooks(page.hooks);
     }
     if (page.errorVisibility !== undefined) {
-      validateErrorVisibility(page.errorVisibility)
+      validateErrorVisibility(page.errorVisibility);
     }
   } catch (err) {
     err.message = `Page at index ${index} is invalid: ${err.message}`;
     throw err;
   }
-}
+};
 
 export function validatePages(pages = []) {
   if (!Array.isArray(pages)) {
-    throw new TypeError('Pages must be an array (pages)');
+    throw new TypeError("Pages must be an array (pages)");
   }
   pages.forEach((page, index) => validatePage(page, index));
   return pages;
@@ -365,7 +394,7 @@ export function validatePlan(plan) {
   }
 
   if (!(plan instanceof Plan)) {
-    throw new TypeError('Plan must be an instance the Plan class (plan)');
+    throw new TypeError("Plan must be an instance the Plan class (plan)");
   }
 
   return plan;
@@ -374,8 +403,8 @@ export function validatePlan(plan) {
 const validateGlobalHook = (hook, index) => {
   try {
     validateHookName(hook.hook);
-    if (typeof hook.middleware !== 'function') {
-      throw new TypeError('Hook middleware must be a function');
+    if (typeof hook.middleware !== "function") {
+      throw new TypeError("Hook middleware must be a function");
     }
     if (hook.path !== undefined) {
       validateHookPath(hook.path);
@@ -392,7 +421,7 @@ export function validateGlobalHooks(hooks) {
   }
 
   if (!Array.isArray(hooks)) {
-    throw new TypeError('Hooks must be an array');
+    throw new TypeError("Hooks must be an array");
   }
 
   hooks.forEach((hook, index) => validateGlobalHook(hook, index));
@@ -410,14 +439,17 @@ export function validateEvents(events) {
 /**
  * Validates helmet configuration function.
  *
- * @access private
  * @param {HelmetConfigurator} helmetConfigurator Configuration function
  * @returns {HelmetConfigurator} Validated configuration function
- * @throws {TypeError} when passed a non-function
+ * @throws {TypeError} When passed a non-function
+ * @access private
  */
 export function validateHelmetConfigurator(helmetConfigurator) {
-  if (helmetConfigurator !== undefined && !(helmetConfigurator instanceof Function)) {
-    throw new TypeError('Helmet configurator must be a function');
+  if (
+    helmetConfigurator !== undefined &&
+    !(helmetConfigurator instanceof Function)
+  ) {
+    throw new TypeError("Helmet configurator must be a function");
   }
 
   return helmetConfigurator;
@@ -432,7 +464,7 @@ export function validateFormMaxParams(value, defaultValue = 25) {
     return defaultValue;
   }
   if (!Number.isInteger(value)) {
-    throw new TypeError('formMaxParams must be an integer');
+    throw new TypeError("formMaxParams must be an integer");
   }
   if (value < MIN_PARAMS) {
     throw new RangeError(`formMaxParams must be at least ${MIN_PARAMS}`);
@@ -450,10 +482,12 @@ export function validateFormMaxBytes(value, defaultValue = 1024 * 50) {
 
   const parsedValue = bytes.parse(value);
   if (!Number.isInteger(parsedValue)) {
-    throw new TypeError('formMaxParams must be a string or an integer');
+    throw new TypeError("formMaxParams must be a string or an integer");
   }
   if (parsedValue < MIN_BYTES) {
-    throw new RangeError(`formMaxBytes must be at least ${MIN_BYTES} bytes (${bytes.format(MIN_BYTES)})`);
+    throw new RangeError(
+      `formMaxBytes must be at least ${MIN_BYTES} bytes (${bytes.format(MIN_BYTES)})`,
+    );
   }
 
   return parsedValue;
@@ -465,7 +499,7 @@ export function validateContextIdGenerator(generator) {
   }
 
   if (!(generator instanceof Function)) {
-    throw new TypeError('contextIdGenerator must be a function');
+    throw new TypeError("contextIdGenerator must be a function");
   }
 
   return generator;
@@ -474,10 +508,10 @@ export function validateContextIdGenerator(generator) {
 /**
  * Ingest, validate, sanitise and manipulate configuration parameters.
  *
- * @access private
  * @param {ConfigurationOptions} config Config to ingest.
- * @throws {Error|SyntaxError|TypeError} For invalid config values.
  * @returns {object} Immutable config object.
+ * @throws {Error | SyntaxError | TypeError} For invalid config values.
+ * @access private
  */
 export default function ingest(config = {}) {
   const parsed = {
@@ -500,8 +534,11 @@ export default function ingest(config = {}) {
       secure: validateSessionSecure(session.secure),
       ttl: validateSessionTtl(session.ttl),
       store: validateSessionStore(session.store),
-      cookiePath: validateSessionCookiePath(session.cookiePath, '/'),
-      cookieSameSite: validateSessionCookieSameSite(session.cookieSameSite, 'Strict'),
+      cookiePath: validateSessionCookiePath(session.cookiePath, "/"),
+      cookieSameSite: validateSessionCookieSameSite(
+        session.cookieSameSite,
+        "Strict",
+      ),
     })),
 
     // Views configuration