@dwp/govuk-casa 9.0.0 → 9.1.0

package/dist/lib/constants.d.ts

@@ -1,6 +1,4 @@
-/**
- * General-purpose references to the different request lifecycle phases.
- */
+/** General-purpose references to the different request lifecycle phases. */
 export const REQUEST_PHASE_STEER: unique symbol;
 export const REQUEST_PHASE_SANITISE: unique symbol;
 export const REQUEST_PHASE_GATHER: unique symbol;

package/dist/lib/constants.js

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONFIG_ERROR_VISIBILITY_ALWAYS = exports.CONFIG_ERROR_VISIBILITY_ONSUBMIT = exports.REQUEST_PHASE_RENDER = exports.REQUEST_PHASE_REDIRECT = exports.REQUEST_PHASE_VALIDATE = exports.REQUEST_PHASE_GATHER = exports.REQUEST_PHASE_SANITISE = exports.REQUEST_PHASE_STEER = void 0;
-/**
- * General-purpose references to the different request lifecycle phases.
- */
-exports.REQUEST_PHASE_STEER = Symbol('steer');
-exports.REQUEST_PHASE_SANITISE = Symbol('sanitise');
-exports.REQUEST_PHASE_GATHER = Symbol('gather');
-exports.REQUEST_PHASE_VALIDATE = Symbol('validate');
-exports.REQUEST_PHASE_REDIRECT = Symbol('redirect');
-exports.REQUEST_PHASE_RENDER = Symbol('render');
-exports.CONFIG_ERROR_VISIBILITY_ONSUBMIT = Symbol('onsubmit');
-exports.CONFIG_ERROR_VISIBILITY_ALWAYS = Symbol('always');
+/** General-purpose references to the different request lifecycle phases. */
+exports.REQUEST_PHASE_STEER = Symbol("steer");
+exports.REQUEST_PHASE_SANITISE = Symbol("sanitise");
+exports.REQUEST_PHASE_GATHER = Symbol("gather");
+exports.REQUEST_PHASE_VALIDATE = Symbol("validate");
+exports.REQUEST_PHASE_REDIRECT = Symbol("redirect");
+exports.REQUEST_PHASE_RENDER = Symbol("render");
+exports.CONFIG_ERROR_VISIBILITY_ONSUBMIT = Symbol("onsubmit");
+exports.CONFIG_ERROR_VISIBILITY_ALWAYS = Symbol("always");
 //# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.js"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AACtC,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,oBAAoB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,oBAAoB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,QAAA,gCAAgC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AACtD,QAAA,8BAA8B,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.js"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC/D,QAAA,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AACtC,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,oBAAoB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,QAAA,oBAAoB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,QAAA,gCAAgC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AACtD,QAAA,8BAA8B,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/lib/context-id-generators.d.ts

@@ -1,7 +1,5 @@
-export type ContextIdGenerator = import('../casa.js').ContextIdGenerator;
-/**
- * @typedef {import('../casa.js').ContextIdGenerator} ContextIdGenerator
- */
+export type ContextIdGenerator = import("../casa.js").ContextIdGenerator;
+/** @typedef {import("../casa.js").ContextIdGenerator} ContextIdGenerator */
 /**
  * Creates an instance of a UUID generator.
  *
@@ -18,7 +16,7 @@ export function uuid(): ContextIdGenerator;
  * @returns {ContextIdGenerator} Generator function
  */
 export function sequentialInteger(): ContextIdGenerator;
-export function shortGuid({ length, prefix, pool, }?: {
+export function shortGuid({ length, prefix, pool }?: {
     length?: number | undefined;
     prefix?: string | undefined;
     pool?: string | undefined;

package/dist/lib/context-id-generators.js

@@ -3,9 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.shortGuid = exports.sequentialInteger = exports.uuid = void 0;
 /* eslint-disable import/no-cycle */
 const node_crypto_1 = require("node:crypto");
-/**
- * @typedef {import('../casa.js').ContextIdGenerator} ContextIdGenerator
- */
+/** @typedef {import("../casa.js").ContextIdGenerator} ContextIdGenerator */
 /**
  * Creates an instance of a UUID generator.
  *
@@ -25,7 +23,7 @@ exports.uuid = uuid;
 const sequentialInteger = () => ({ reservedIds }) => {
     const contextIds = Array.from(reservedIds).sort();
     if (!contextIds.length) {
-        return '1';
+        return "1";
     }
     // Find the first numeric ID that we can increment
     let lastInSequence;
@@ -35,14 +33,17 @@ const sequentialInteger = () => ({ reservedIds }) => {
     return String(!Number.isNaN(lastInSequence) ? lastInSequence + 1 : 1);
 };
 exports.sequentialInteger = sequentialInteger;
-const shortGuid = ({ length = 5, prefix = '', pool = 'abcdefhkmnprtwxy346789', } = {}) => ({ reservedIds }) => {
+const shortGuid = ({ length = 5, prefix = "", pool = "abcdefhkmnprtwxy346789" } = {}) => ({ reservedIds }) => {
     // Ambiguous characters excluded
     const poolSize = pool.length;
     const maxAttempts = 10;
     let attempts = maxAttempts;
     let id;
     do {
-        id = Array(length).fill(0).map(() => pool.charAt(Math.floor(Math.random() * poolSize))).join('');
+        id = Array(length)
+            .fill(0)
+            .map(() => pool.charAt(Math.floor(Math.random() * poolSize)))
+            .join("");
         attempts--;
     } while (attempts > 0 && reservedIds.includes(id));
     if (attempts === 0) {

package/dist/lib/context-id-generators.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-id-generators.js","sourceRoot":"","sources":["../../src/lib/context-id-generators.js"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,6CAAyC;AAEzC;;GAEG;AAEH;;;;GAIG;AACH,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,IAAA,wBAAU,GAAE,CAAC;AAuDpC,oBAAI;AArDN;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kDAAkD;IAClD,IAAI,cAAc,CAAC;IACnB,GAAG,CAAC;QACF,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC,QAAQ,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE;IAE5D,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC,CAAC;AA+BA,8CAAiB;AA7BnB,MAAM,SAAS,GAAG,CAAC,EACjB,MAAM,GAAG,CAAC,EACV,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,wBAAwB,GAChC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAC7B,gCAAgC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAE7B,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,IAAI,QAAQ,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,CAAC;IAEP,GAAG,CAAC;QACF,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjG,QAAQ,EAAE,CAAC;IACb,CAAC,QAAQ,QAAQ,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;IAEnD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,aAAa,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,EAAE,EAAE,CAAC;AAC1B,CAAC,CAAA;AAQC,8BAAS"}
+{"version":3,"file":"context-id-generators.js","sourceRoot":"","sources":["../../src/lib/context-id-generators.js"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,6CAAyC;AAEzC,4EAA4E;AAE5E;;;;GAIG;AACH,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,IAAA,wBAAU,GAAE,CAAC;AAyD7B,oBAAI;AAvDb;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GACrB,GAAG,EAAE,CACL,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAClB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kDAAkD;IAClD,IAAI,cAAc,CAAC;IACnB,GAAG,CAAC;QACF,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC,QAAQ,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE;IAE5D,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC,CAAC;AA8BW,8CAAiB;AA5BhC,MAAM,SAAS,GACb,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,wBAAwB,EAAE,GAAG,EAAE,EAAE,EAAE,CACtE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAClB,gCAAgC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAE7B,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,IAAI,QAAQ,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,CAAC;IAEP,GAAG,CAAC;QACF,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;aACf,IAAI,CAAC,CAAC,CAAC;aACP,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;aAC5D,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE,CAAC;IACb,CAAC,QAAQ,QAAQ,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;IAEnD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,iCAAiC,WAAW,aAAa,CAC1D,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,EAAE,EAAE,CAAC;AAC1B,CAAC,CAAC;AAG8B,8BAAS"}

package/dist/lib/end-session.d.ts

@@ -1,14 +1,14 @@
 /**
  * A convenience for ending the current session, but retaining some data in it,
- * like the current language. It persists an empty session before regenerating
- * a new ID.
+ * like the current language. It persists an empty session before regenerating a
+ * new ID.
  *
  * Note: this will not remove the session from server-side storage, which will
  * instead be left up to the storage mechanism to clean up.
  *
  * @memberof module:@dwp/govuk-casa
- * @param {import('express').Request} req HTTP request
+ * @param {import("express").Request} req HTTP request
  * @param {Function} next Chain
  * @returns {void}
  */
-export default function endSession(req: import('express').Request, next: Function): void;
+export default function endSession(req: import("express").Request, next: Function): void;

package/dist/lib/end-session.js

@@ -4,24 +4,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const logger_js_1 = __importDefault(require("./logger.js"));
-const log = (0, logger_js_1.default)('lib:end-session');
+const log = (0, logger_js_1.default)("lib:end-session");
 /**
  * A convenience for ending the current session, but retaining some data in it,
- * like the current language. It persists an empty session before regenerating
- * a new ID.
+ * like the current language. It persists an empty session before regenerating a
+ * new ID.
  *
  * Note: this will not remove the session from server-side storage, which will
  * instead be left up to the storage mechanism to clean up.
  *
  * @memberof module:@dwp/govuk-casa
- * @param {import('express').Request} req HTTP request
+ * @param {import("express").Request} req HTTP request
  * @param {Function} next Chain
  * @returns {void}
  */
 function endSession(req, next) {
     const { language } = req.session;
     Object.entries(req.session).forEach(([k]) => {
-        if (!['cookie'].includes(k)) {
+        if (!["cookie"].includes(k)) {
             // ESLint disabled as `Object.entries()` returns "own" properties, and
             // all values are being null'd, so not assigned any user-controlled values
             /* eslint-disable-next-line security/detect-object-injection */

package/dist/lib/field.d.ts

@@ -4,8 +4,10 @@
  * @memberof module:@dwp/govuk-casa
  * @param {string} name Field name
  * @param {object} [opts] Options
- * @param {boolean} [opts.optional=false] Whether this field is optional
- * @param {boolean} [opts.persist=true] Whether this field will persist in `req.body`
+ * @param {boolean} [opts.optional=false] Whether this field is optional.
+ *   Default is `false`
+ * @param {boolean} [opts.persist=true] Whether this field will persist in
+ *   `req.body`. Default is `true`
  * @returns {PageField} A PageField
  */
 export default function field(name: string, opts?: {
@@ -24,8 +26,10 @@ export class PageField {
      *
      * @param {string} name Field name
      * @param {object} [opts] Options
-     * @param {boolean} [opts.optional=false] Whether this field is optional
-     * @param {boolean} [opts.persist=true] Whether this field will persist in `req.body`
+     * @param {boolean} [opts.optional=false] Whether this field is optional.
+     *   Default is `false`
+     * @param {boolean} [opts.persist=true] Whether this field will persist in
+     *   `req.body`. Default is `true`
      */
     constructor(name: string, { optional, persist }?: {
         optional?: boolean | undefined;
@@ -75,9 +79,8 @@ export class PageField {
      */
     getValidators(): Validator[];
     /**
-     * Add value validators
-     * Some validators will include a `sanitise()` method which will be run at the
-     * same time as other "processors".
+     * Add value validators Some validators will include a `sanitise()` method
+     * which will be run at the same time as other "processors".
      *
      * @param {Validator[]} items Validation functions
      * @returns {PageField} Chain
@@ -90,8 +93,8 @@ export class PageField {
      */
     getProcessors(): FieldProcessorFunction[];
     /**
-     * Add value pre-processors
-     * This is most often used to sanitise values to a particular data type.
+     * Add value pre-processors This is most often used to sanitise values to a
+     * particular data type.
      *
      * @param {FieldProcessorFunction[]} items Processor functions
      * @returns {PageField} Chain
@@ -104,9 +107,8 @@ export class PageField {
      */
     getConditions(): ValidatorConditionFunction[];
     /**
-     * Add conditions
-     * All conditions must be met in order for this field to be considered
-     * "actionable".
+     * Add conditions All conditions must be met in order for this field to be
+     * considered "actionable".
      *
      * @param {ValidatorConditionFunction[]} items Condition functions
      * @returns {PageField} Chain
@@ -164,9 +166,9 @@ export class PageField {
     if(...args: ValidatorConditionFunction[]): PageField;
     #private;
 }
-export type JourneyContext = import('./index').JourneyContext;
-export type Validator = import('../casa').Validator;
-export type ValidateContext = import('../casa').ValidateContext;
-export type ValidatorConditionFunction = import('../casa').ValidatorConditionFunction;
-export type FieldProcessorFunction = import('../casa').FieldProcessorFunction;
-export type ValidationError = import('./index').ValidationError;
+export type JourneyContext = import("./index").JourneyContext;
+export type Validator = import("../casa").Validator;
+export type ValidateContext = import("../casa").ValidateContext;
+export type ValidatorConditionFunction = import("../casa").ValidatorConditionFunction;
+export type FieldProcessorFunction = import("../casa").FieldProcessorFunction;
+export type ValidationError = import("./index").ValidationError;

package/dist/lib/field.js

@@ -18,32 +18,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PageField = void 0;
 const lodash_1 = __importDefault(require("lodash"));
 const utils_js_1 = require("./utils.js");
-const logger_js_1 = __importDefault(require("./logger.js"));
-const log = (0, logger_js_1.default)('lib:field');
 const { isFunction } = lodash_1.default;
 /**
+ * @typedef {import("./index").JourneyContext} JourneyContext
  * @access private
- * @typedef {import('./index').JourneyContext} JourneyContext
  */
 /**
+ * @typedef {import("../casa").Validator} Validator
  * @access private
- * @typedef {import('../casa').Validator} Validator
  */
 /**
+ * @typedef {import("../casa").ValidateContext} ValidateContext
  * @access private
- * @typedef {import('../casa').ValidateContext} ValidateContext
  */
 /**
+ * @typedef {import("../casa").ValidatorConditionFunction} ValidatorConditionFunction
  * @access private
- * @typedef {import('../casa').ValidatorConditionFunction} ValidatorConditionFunction
  */
 /**
+ * @typedef {import("../casa").FieldProcessorFunction} FieldProcessorFunction
  * @access private
- * @typedef {import('../casa').FieldProcessorFunction} FieldProcessorFunction
  */
 /**
+ * @typedef {import("./index").ValidationError} ValidationError
  * @access private
- * @typedef {import('./index').ValidationError} ValidationError
  */
 // Quick check to see if the field name corresponds to a non-primitive complex
 // type. For example, `my_field[nested]`.
@@ -61,32 +59,24 @@ class PageField {
      *
      * @param {string} name Field name
      * @param {object} [opts] Options
-     * @param {boolean} [opts.optional=false] Whether this field is optional
-     * @param {boolean} [opts.persist=true] Whether this field will persist in `req.body`
+     * @param {boolean} [opts.optional=false] Whether this field is optional.
+     *   Default is `false`
+     * @param {boolean} [opts.persist=true] Whether this field will persist in
+     *   `req.body`. Default is `true`
      */
     constructor(name, { optional = false, persist = true } = Object.create(null)) {
-        /**
-         * @type {string}
-         */
+        /** @type {string} */
         _PageField_name.set(this, void 0);
-        /**
-         * @type {FieldProcessorFunction[]}
-         */
+        /** @type {FieldProcessorFunction[]} */
         _PageField_processors.set(this, void 0);
-        /**
-         * @type {Validator[]}
-         */
+        /** @type {Validator[]} */
         _PageField_validators.set(this, void 0);
-        /**
-         * @type {ValidatorConditionFunction[]}
-         */
+        /** @type {ValidatorConditionFunction[]} */
         _PageField_conditions.set(this, void 0);
-        /**
-         * @type {object}
-         */
+        /** @type {object} */
         _PageField_meta.set(this, void 0);
         if (!name) {
-            throw new SyntaxError('A name for this field is required, i.e. "field(\'myField\')".');
+            throw new SyntaxError("A name for this field is required, i.e. \"field('myField')\".");
         }
         __classPrivateFieldSet(this, _PageField_name, undefined, "f");
         __classPrivateFieldSet(this, _PageField_validators, [], "f");
@@ -185,7 +175,7 @@ class PageField {
         // early to aid developer.
         const isComplex = reComplexType.test(name);
         if (isComplex && name.match(/\[/g).length > 1) {
-            throw new SyntaxError('Complex field names are only supported to 1 property depth. E.g. a[b] is ok, a[b][c] is not');
+            throw new SyntaxError("Complex field names are only supported to 1 property depth. E.g. a[b] is ok, a[b][c] is not");
         }
         __classPrivateFieldSet(this, _PageField_name, String(name), "f");
         __classPrivateFieldGet(this, _PageField_meta, "f").complex = isComplex;
@@ -205,18 +195,17 @@ class PageField {
         return __classPrivateFieldGet(this, _PageField_validators, "f");
     }
     /**
-     * Add value validators
-     * Some validators will include a `sanitise()` method which will be run at the
-     * same time as other "processors".
+     * Add value validators Some validators will include a `sanitise()` method
+     * which will be run at the same time as other "processors".
      *
      * @param {Validator[]} items Validation functions
      * @returns {PageField} Chain
      */
     validators(items = []) {
         if (!items.length) {
-            throw new Error('Calling validators() to get all validators is no longer supported, please use getValidators()');
+            throw new Error("Calling validators() to get all validators is no longer supported, please use getValidators()");
         }
-        __classPrivateFieldSet(this, _PageField_validators, [...__classPrivateFieldGet(this, _PageField_validators, "f"), ...(items.flat())], "f");
+        __classPrivateFieldSet(this, _PageField_validators, [...__classPrivateFieldGet(this, _PageField_validators, "f"), ...items.flat()], "f");
         return this;
     }
     /**
@@ -228,17 +217,17 @@ class PageField {
         return __classPrivateFieldGet(this, _PageField_processors, "f");
     }
     /**
-     * Add value pre-processors
-     * This is most often used to sanitise values to a particular data type.
+     * Add value pre-processors This is most often used to sanitise values to a
+     * particular data type.
      *
      * @param {FieldProcessorFunction[]} items Processor functions
      * @returns {PageField} Chain
      */
     processors(items = []) {
         if (!items.length) {
-            throw new Error('Calling processors() to get all processors is no longer supported, please use getProcessors()');
+            throw new Error("Calling processors() to get all processors is no longer supported, please use getProcessors()");
         }
-        __classPrivateFieldSet(this, _PageField_processors, [...__classPrivateFieldGet(this, _PageField_processors, "f"), ...(items.flat())], "f");
+        __classPrivateFieldSet(this, _PageField_processors, [...__classPrivateFieldGet(this, _PageField_processors, "f"), ...items.flat()], "f");
         return this;
     }
     /**
@@ -250,18 +239,17 @@ class PageField {
         return __classPrivateFieldGet(this, _PageField_conditions, "f");
     }
     /**
-     * Add conditions
-     * All conditions must be met in order for this field to be considered
-     * "actionable".
+     * Add conditions All conditions must be met in order for this field to be
+     * considered "actionable".
      *
      * @param {ValidatorConditionFunction[]} items Condition functions
      * @returns {PageField} Chain
      */
     conditions(items = []) {
         if (!items.length) {
-            throw new Error('Calling conditions() to get all conditions is no longer supported, please use getConditions()');
+            throw new Error("Calling conditions() to get all conditions is no longer supported, please use getConditions()");
         }
-        __classPrivateFieldSet(this, _PageField_conditions, [...__classPrivateFieldGet(this, _PageField_conditions, "f"), ...(items.flat())], "f");
+        __classPrivateFieldSet(this, _PageField_conditions, [...__classPrivateFieldGet(this, _PageField_conditions, "f"), ...items.flat()], "f");
         return this;
     }
     /* ---------------------------------------------------------------- execute */
@@ -289,14 +277,11 @@ class PageField {
             let fieldErrors = __classPrivateFieldGet(this, _PageField_validators, "f")[i].validate(context.fieldValue, context);
             if (!Array.isArray(fieldErrors)) {
                 // Friendly message for developer
-                throw new TypeError(`The validator at index ${i} (name: ${__classPrivateFieldGet(this, _PageField_validators, "f")[i].name || 'unknown'}) for field '${__classPrivateFieldGet(this, _PageField_name, "f")}' did not return an array`);
+                throw new TypeError(`The validator at index ${i} (name: ${__classPrivateFieldGet(this, _PageField_validators, "f")[i].name || "unknown"}) for field '${__classPrivateFieldGet(this, _PageField_name, "f")}' did not return an array`);
             }
             fieldErrors = fieldErrors.map((e) => e.withContext(Object.assign(Object.assign({}, context), { validator: __classPrivateFieldGet(this, _PageField_validators, "f")[i].name })));
             /* eslint-enable security/detect-object-injection */
-            errors = [
-                ...errors,
-                ...(fieldErrors !== null && fieldErrors !== void 0 ? fieldErrors : []),
-            ];
+            errors = [...errors, ...(fieldErrors !== null && fieldErrors !== void 0 ? fieldErrors : [])];
         }
         return errors;
     }
@@ -392,8 +377,10 @@ _PageField_name = new WeakMap(), _PageField_processors = new WeakMap(), _PageFie
  * @memberof module:@dwp/govuk-casa
  * @param {string} name Field name
  * @param {object} [opts] Options
- * @param {boolean} [opts.optional=false] Whether this field is optional
- * @param {boolean} [opts.persist=true] Whether this field will persist in `req.body`
+ * @param {boolean} [opts.optional=false] Whether this field is optional.
+ *   Default is `false`
+ * @param {boolean} [opts.persist=true] Whether this field will persist in
+ *   `req.body`. Default is `true`
  * @returns {PageField} A PageField
  */
 function field(name, opts) {

package/dist/lib/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/lib/field.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/lib/field.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,oDAA4B;AAC5B,yCAAqC;AAErC,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAM,CAAC;AAE9B;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH,8EAA8E;AAC9E,yCAAyC;AACzC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAE1C;;;;;GAKG;AACH,MAAa,SAAS;IAgBpB;;;;;;;;;OASG;IACH,YACE,IAAI,EACJ,EAAE,QAAQ,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QA3B5D,qBAAqB;QACrB,kCAAM;QAEN,uCAAuC;QACvC,wCAAY;QAEZ,0BAA0B;QAC1B,wCAAY;QAEZ,2CAA2C;QAC3C,wCAAY;QAEZ,qBAAqB;QACrB,kCAAM;QAgBJ,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,WAAW,CACnB,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,uBAAA,IAAI,mBAAS,SAAS,MAAA,CAAC;QACvB,uBAAA,IAAI,yBAAe,EAAE,MAAA,CAAC;QACtB,uBAAA,IAAI,yBAAe,EAAE,MAAA,CAAC;QACtB,uBAAA,IAAI,yBAAe,EAAE,MAAA,CAAC;QAEtB,uBAAA,IAAI,mBAAS;YACX,QAAQ;YACR,OAAO;YACP,OAAO,EAAE,SAAS;YAClB,gBAAgB,EAAE,SAAS;YAC3B,oBAAoB,EAAE,SAAS;SAChC,MAAA,CAAC;QAEF,aAAa;QACb,sEAAsE;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,uBAAA,IAAI,uBAAM,EAAE;YACtC,QAAQ,EAAE,uBAAA,IAAI,uBAAM,CAAC,QAAQ;YAC7B,OAAO,EAAE,uBAAA,IAAI,uBAAM,CAAC,OAAO;SAC5B,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;QAChC,IAAI,uBAAA,IAAI,uBAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,MAAA,GAAG,CAAC,uBAAA,IAAI,uBAAM,CAAC,gBAAgB,CAAC,0CACrC,uBAAA,IAAI,uBAAM,CAAC,oBAAoB,CAChC,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,uBAAA,IAAI,uBAAM,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS;;QACnD,IAAI,uBAAA,IAAI,uBAAM,CAAC,OAAO,EAAE,CAAC;YACvB,gDAAgD;YAChD,GAAG,CAAC,uBAAA,IAAI,uBAAM,CAAC,gBAAgB,CAAC,mCAC3B,CAAC,MAAA,GAAG,CAAC,uBAAA,IAAI,uBAAM,CAAC,gBAAgB,CAAC,mCAAI,EAAE,CAAC,KAC3C,CAAC,uBAAA,IAAI,uBAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,GACzC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,gDAAgD;YAChD,GAAG,CAAC,uBAAA,IAAI,uBAAM,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAE9E,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,uBAAM,CAAC;IACpB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,uBAAM,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI;QACT,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,WAAW,CACnB,UAAU,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAC5D,CAAC;QACJ,CAAC;QAED,mEAAmE;QACnE,0EAA0E;QAC1E,0BAA0B;QAC1B,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,WAAW,CACnB,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QAED,uBAAA,IAAI,mBAAS,MAAM,CAAC,IAAI,CAAC,MAAA,CAAC;QAC1B,uBAAA,IAAI,uBAAM,CAAC,OAAO,GAAG,SAAS,CAAC;QAE/B,wEAAwE;QACxE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACxC,CAAC,EAAE,uBAAA,IAAI,uBAAM,CAAC,gBAAgB,EAAE,uBAAA,IAAI,uBAAM,CAAC,oBAAoB,CAAC,GAAG,KAAK,CAAC;QAC3E,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,uBAAA,IAAI,6BAAY,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QACD,uBAAA,IAAI,yBAAe,CAAC,GAAG,uBAAA,IAAI,6BAAY,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,MAAA,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,uBAAA,IAAI,6BAAY,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QAED,uBAAA,IAAI,yBAAe,CAAC,GAAG,uBAAA,IAAI,6BAAY,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,MAAA,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,uBAAA,IAAI,6BAAY,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QACD,uBAAA,IAAI,yBAAe,CAAC,GAAG,uBAAA,IAAI,6BAAY,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,MAAA,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAE9E;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzC,qDAAqD;QACrD,IAAI,uBAAA,IAAI,uBAAM,CAAC,QAAQ,IAAI,IAAA,kBAAO,EAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAA,IAAI,6BAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,uCAAuC;YACvC,qDAAqD;YACrD,uDAAuD;YACvD,IAAI,WAAW,GAAG,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC5C,OAAO,CAAC,UAAU,EAClB,OAAO,CACR,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChC,iCAAiC;gBACjC,MAAM,IAAI,SAAS,CACjB,0BAA0B,CAAC,WAAW,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,gBAAgB,uBAAA,IAAI,uBAAM,2BAA2B,CACjI,CAAC;YACJ,CAAC;YAED,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,WAAW,iCACR,OAAO,KACV,SAAS,EAAE,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,IAAI,IACnC,CACH,CAAC;YACF,oDAAoD;YAEpD,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,KAAK;QACnB,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,wEAAwE;QACxE,4CAA4C;QAC5C,uCAAuC;QACvC,qDAAqD;QACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAA,IAAI,6BAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,IAAI,UAAU,CAAC,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7C,cAAc,GAAG,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QACD,oDAAoD;QAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAA,IAAI,6BAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,uCAAuC;YACvC,+DAA+D;YAC/D,cAAc,GAAG,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE;QACrD,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,uBAAA,IAAI,uBAAM;YACrB,UAAU;YACV,QAAQ;YACR,cAAc;SACf,CAAC;QAEF,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAA,IAAI,6BAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,uCAAuC;YACvC,+DAA+D;YAC/D,MAAM,GAAG,MAAM,IAAI,uBAAA,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8EAA8E;IAE9E;;;;;OAKG;IACH,SAAS,CAAC,SAAS;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAC,GAAG,IAAI;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AApYD,8BAoYC;;AAED;;;;;;;;;;;GAWG;AACH,SAAwB,KAAK,CAAC,IAAI,EAAE,IAAI;IACtC,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAFD,wBAEC"}

package/dist/lib/index.d.ts

@@ -1,14 +1,14 @@
-import CasaTemplateLoader from './CasaTemplateLoader.js';
-import configure from './configure.js';
-import configurationIngestor from './configuration-ingestor.js';
-import endSession from './end-session.js';
-import field from './field.js';
-import { PageField } from './field.js';
-import JourneyContext from './JourneyContext.js';
-import MutableRouter from './MutableRouter.js';
-import Plan from './Plan.js';
-import * as utils from './utils.js';
-import ValidationError from './ValidationError.js';
-import ValidatorFactory from './ValidatorFactory.js';
-import waypointUrl from './waypoint-url.js';
+import CasaTemplateLoader from "./CasaTemplateLoader.js";
+import configure from "./configure.js";
+import configurationIngestor from "./configuration-ingestor.js";
+import endSession from "./end-session.js";
+import field from "./field.js";
+import { PageField } from "./field.js";
+import JourneyContext from "./JourneyContext.js";
+import MutableRouter from "./MutableRouter.js";
+import Plan from "./Plan.js";
+import * as utils from "./utils.js";
+import ValidationError from "./ValidationError.js";
+import ValidatorFactory from "./ValidatorFactory.js";
+import waypointUrl from "./waypoint-url.js";
 export { CasaTemplateLoader, configure, configurationIngestor, endSession, field, PageField, JourneyContext, MutableRouter, Plan, utils, ValidationError, ValidatorFactory, waypointUrl };

package/dist/lib/logger.d.ts

@@ -1,9 +1,10 @@
 declare function _default(namespace: any): {
-    trace: any;
-    debug: any;
-    info: any;
-    warn: any;
-    error: any;
-    fatal: any;
+    trace: debug.Debugger;
+    debug: debug.Debugger;
+    info: debug.Debugger;
+    warn: debug.Debugger;
+    error: debug.Debugger;
+    fatal: debug.Debugger;
 };
 export default _default;
+import debug from "debug";

package/dist/lib/logger.js

@@ -4,16 +4,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const debug_1 = __importDefault(require("debug"));
-const casaDebugger = (0, debug_1.default)('casa');
+const casaDebugger = (0, debug_1.default)("casa");
 exports.default = (namespace) => {
     const logger = casaDebugger.extend(namespace);
     return {
-        trace: logger.extend('trace'),
-        debug: logger.extend('debug'),
-        info: logger.extend('info'),
-        warn: logger.extend('warn'),
-        error: logger.extend('error'),
-        fatal: logger.extend('fatal'),
+        trace: logger.extend("trace"),
+        debug: logger.extend("debug"),
+        info: logger.extend("info"),
+        warn: logger.extend("warn"),
+        error: logger.extend("error"),
+        fatal: logger.extend("fatal"),
     };
 };
 //# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.js"],"names":[],"mappings":";;;;;AAAA,kDAA0B;AAE1B,MAAM,YAAY,GAAG,IAAA,eAAK,EAAC,MAAM,CAAC,CAAC;AAEnC,kBAAe,CAAC,SAAS,EAAE,EAAE;IAC3B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC,CAAA"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.js"],"names":[],"mappings":";;;;;AAAA,kDAA0B;AAE1B,MAAM,YAAY,GAAG,IAAA,eAAK,EAAC,MAAM,CAAC,CAAC;AAEnC,kBAAe,CAAC,SAAS,EAAE,EAAE;IAC3B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/mount.d.ts

@@ -13,8 +13,8 @@ declare function _default({ nunjucksEnv, mountUrl, plan, staticRouter, ancillary
     postMiddleware: ExpressRequestHandler[];
 }): Mounter;
 export default _default;
-export type NunjucksEnvironment = import('nunjucks').Environment;
-export type ExpressRequestHandler = import('express').RequestHandler;
-export type Mounter = import('../casa').Mounter;
-export type Plan = import('../casa').Plan;
-export type MutableRouter = import('../casa').MutableRouter;
+export type NunjucksEnvironment = import("nunjucks").Environment;
+export type ExpressRequestHandler = import("express").RequestHandler;
+export type Mounter = import("../casa").Mounter;
+export type Plan = import("../casa").Plan;
+export type MutableRouter = import("../casa").MutableRouter;

package/dist/lib/mount.js

@@ -8,30 +8,31 @@ const path_to_regexp_1 = require("path-to-regexp");
 const strip_proxy_path_js_1 = __importDefault(require("../middleware/strip-proxy-path.js"));
 const serve_first_waypoint_js_1 = __importDefault(require("../middleware/serve-first-waypoint.js"));
 /**
+ * @typedef {import("nunjucks").Environment} NunjucksEnvironment
  * @access private
- * @typedef {import('nunjucks').Environment} NunjucksEnvironment
  */
 /**
+ * @typedef {import("express").RequestHandler} ExpressRequestHandler
  * @access private
- * @typedef {import('express').RequestHandler} ExpressRequestHandler
  */
 /**
+ * @typedef {import("../casa").Mounter} Mounter
  * @access private
- * @typedef {import('../casa').Mounter} Mounter
  */
 /**
+ * @typedef {import("../casa").Plan} Plan
  * @access private
- * @typedef {import('../casa').Plan} Plan
  */
 /**
+ * @typedef {import("../casa").MutableRouter} MutableRouter
  * @access private
- * @typedef {import('../casa').MutableRouter} MutableRouter
  */
 /**
  * Mounting function factory.
  *
  * @param {object} args Arguments
- * @param {NunjucksEnvironment} args.nunjucksEnv Pre-configured Nunjucks environment
+ * @param {NunjucksEnvironment} args.nunjucksEnv Pre-configured Nunjucks
+ *   environment
  * @param {string} [args.mountUrl] Mount URL
  * @param {Plan} [args.plan] CASA Plan
  * @param {MutableRouter} args.staticRouter Router for all static assets
@@ -43,11 +44,11 @@ const serve_first_waypoint_js_1 = __importDefault(require("../middleware/serve-f
  * @param {ExpressRequestHandler[]} args.bodyParserMiddleware Middleware
  * @param {ExpressRequestHandler[]} args.dataMiddleware Middleware
  * @param {ExpressRequestHandler[]} args.postMiddleware Middleware
- * @returns {Mounter} mount
+ * @returns {Mounter} Mount
  */
-exports.default = ({ nunjucksEnv, mountUrl, plan, staticRouter, ancillaryRouter, journeyRouter, preMiddleware, sessionMiddleware, i18nMiddleware, bodyParserMiddleware, dataMiddleware, postMiddleware, }) => (app, { route = '/', serveFirstWaypoint = false, } = {}) => {
+exports.default = ({ nunjucksEnv, mountUrl, plan, staticRouter, ancillaryRouter, journeyRouter, preMiddleware, sessionMiddleware, i18nMiddleware, bodyParserMiddleware, dataMiddleware, postMiddleware, }) => (app, { route = "/", serveFirstWaypoint = false } = {}) => {
     nunjucksEnv.express(app);
-    app.set('view engine', 'njk');
+    app.set("view engine", "njk");
     // If a `mountUrl` has been defined, then we're potentially in "proxy mode",
     // in which we strip the proxy path prefix from the incoming request URLs.
     if (mountUrl) {
@@ -56,7 +57,7 @@ exports.default = ({ nunjucksEnv, mountUrl, plan, staticRouter, ancillaryRouter,
     // Attach a handler to redirect requests for `/` to the first waypoint in
     // the plan
     if (serveFirstWaypoint && plan) {
-        const re = (0, path_to_regexp_1.pathToRegexp)(`${route}`.replace(/\/+/g, '/'));
+        const re = (0, path_to_regexp_1.pathToRegexp)(`${route}`.replace(/\/+/g, "/"));
         app.use(re, (0, serve_first_waypoint_js_1.default)({ plan }));
     }
     // Capture the mount path of this CASA app, before any parameterised path