@dwp/govuk-casa 8.0.0-alpha2 → 8.0.0-beta1

package/dist/lib/configure.d.ts

@@ -1,30 +1,11 @@
 /**
- *
- * @typedef {object} SessionOptions
- * @property {string} [name=casasession] Session name
- * @property {string} [secret=secret] Encryption secret
- * @property {number} [ttl=3600] Session ttl (seconds)
- * @property {boolean} [secure=false] Whether to use secure session cookies
- * @property {boolean|string} [cookieSameSite=true] SameSite (true = Strict)
- * @property {object} [store] Session store (default MemoryStore)
- */
-/**
- * @typedef {object} GlobalHook Hook configuration
- * @property {string} hook Hook name in format `<router>.<hook>`
- * @property {Function} middleware Middleware function to insert at the hook point
- * @property {string|RegExp} [path=undefined] Only run if route path matches this string/regexp
+ * @typedef {import('express').RequestHandler} ExpressRequestHandler
  */
 /**
- * @typedef {object} PageHook (extends GlobalHook)
- * @property {string} hook Hook name (without a scope prefix)
- * @property {Function} middleware Middleware function to insert at the hook point
+ * @typedef {import('./index').MutableRouter} MutableRouter
  */
 /**
- * @typedef {object} Page Page configuration. A Page is the interactive representation of a waypoint
- * @property {string} waypoint The waypoint with which this page is associated
- * @property {string} view Template path
- * @property {PageHook[]} [hooks=[]] Page-specific hooks (optional, default [])
- * @property {PageField[]} [fields=[]] Fields to be managed on this page (optional, default [])
+ * @typedef {import('./configuration-ingestor').ConfigurationOptions} ConfigurationOptions
  */
 /**
  * @typedef {object} ConfigureResult Result of a call to configure() function
@@ -32,13 +13,13 @@
  * @property {MutableRouter} staticRouter Router handling all static assets
  * @property {MutableRouter} ancillaryRouter Router handling ancillary routes
  * @property {MutableRouter} journeyRouter Router handling all waypoint requests
- * @property {express.RequestHandler[]} preMiddleware Middleware mounted before anything else
- * @property {express.RequestHandler[]} postMiddleware Middleware mounted after everything else
- * @property {express.RequestHandler[]} csrfMiddleware CSRF get/set middleware (useful for forms)
- * @property {express.RequestHandler} sessionMiddleware Session middleware
- * @property {express.RequestHandler[]} cookieParserMiddleware Cookie-parsing middleware
- * @property {express.RequestHandler[]} i18nMiddleware I18n preparation middleware
- * @property {express.RequestHandler} bodyParserMiddleware Body parsing middleware
+ * @property {ExpressRequestHandler[]} preMiddleware Middleware mounted before anything else
+ * @property {ExpressRequestHandler[]} postMiddleware Middleware mounted after everything else
+ * @property {ExpressRequestHandler[]} csrfMiddleware CSRF get/set middleware (useful for forms)
+ * @property {ExpressRequestHandler} sessionMiddleware Session middleware
+ * @property {ExpressRequestHandler[]} cookieParserMiddleware Cookie-parsing middleware
+ * @property {ExpressRequestHandler[]} i18nMiddleware I18n preparation middleware
+ * @property {ExpressRequestHandler} bodyParserMiddleware Body parsing middleware
  * @property {Function} mount Function used to mount all CASA artifacts onto an ExpressJS app
  */
 /**
@@ -47,108 +28,13 @@
  * `mountUrl` is used to ensure the CSS content uses the correct reference to
  * static assets in the `govuk-frontend` module.
  *
- * @param {object} config Configuration options
- * @param {string} [config.mountUrl=/] URL path to root of CASA app
- * @param {string} [config.serviceName=common.serviceName] Service name (i18n key)
- * @param {string[]} [config.views=[]] Template directories
- * @param {SessionOptions} [config.session] Session configuration
- * @param {Page[]} [config.pages=[]] Pages the represent waypoints
- * @param {GlobalHook[]} [config.hooks=[]] Hooks to apply
- * @param {object[]} [config.plugins=[]] Plugins
- * @param {I18nOptions[]} [config.i18n] I18n configuration
- * @param {Plan} config.plan CASA Plan
- * @param {ContextEvent[]} [config.events=[]] Handlers for JourneyContext events
+ * @param {ConfigurationOptions} config Configuration options
  * @returns {ConfigureResult} Result
  */
-export default function configure(config?: {
-    mountUrl?: string | undefined;
-    serviceName?: string | undefined;
-    views?: string[] | undefined;
-    session?: SessionOptions | undefined;
-    pages?: Page[] | undefined;
-    hooks?: GlobalHook[] | undefined;
-    plugins?: object[] | undefined;
-    i18n?: any[] | undefined;
-    plan: any;
-    events?: any[] | undefined;
-}): ConfigureResult;
-export type SessionOptions = {
-    /**
-     * Session name
-     */
-    name?: string | undefined;
-    /**
-     * Encryption secret
-     */
-    secret?: string | undefined;
-    /**
-     * Session ttl (seconds)
-     */
-    ttl?: number | undefined;
-    /**
-     * Whether to use secure session cookies
-     */
-    secure?: boolean | undefined;
-    /**
-     * SameSite (true = Strict)
-     */
-    cookieSameSite?: string | boolean | undefined;
-    /**
-     * Session store (default MemoryStore)
-     */
-    store?: object | undefined;
-};
-/**
- * Hook configuration
- */
-export type GlobalHook = {
-    /**
-     * Hook name in format `<router>.<hook>`
-     */
-    hook: string;
-    /**
-     * Middleware function to insert at the hook point
-     */
-    middleware: Function;
-    /**
-     * Only run if route path matches this string/regexp
-     */
-    path?: string | RegExp | undefined;
-};
-/**
- * (extends GlobalHook)
- */
-export type PageHook = {
-    /**
-     * Hook name (without a scope prefix)
-     */
-    hook: string;
-    /**
-     * Middleware function to insert at the hook point
-     */
-    middleware: Function;
-};
-/**
- * Page configuration. A Page is the interactive representation of a waypoint
- */
-export type Page = {
-    /**
-     * The waypoint with which this page is associated
-     */
-    waypoint: string;
-    /**
-     * Template path
-     */
-    view: string;
-    /**
-     * Page-specific hooks (optional, default [])
-     */
-    hooks?: PageHook[] | undefined;
-    /**
-     * Fields to be managed on this page (optional, default [])
-     */
-    fields?: any[] | undefined;
-};
+export default function configure(config?: ConfigurationOptions): ConfigureResult;
+export type ExpressRequestHandler = import('express').RequestHandler;
+export type MutableRouter = import('./index').MutableRouter;
+export type ConfigurationOptions = import('./configuration-ingestor').ConfigurationOptions;
 /**
  * Result of a call to configure() function
  */
@@ -156,47 +42,47 @@ export type ConfigureResult = {
     /**
      * Nunjucks environment
      */
-    nunjucksEnv: any;
+    nunjucksEnv: nunjucks.Environment;
     /**
      * Router handling all static assets
      */
-    staticRouter: any;
+    staticRouter: MutableRouter;
     /**
      * Router handling ancillary routes
      */
-    ancillaryRouter: any;
+    ancillaryRouter: MutableRouter;
     /**
      * Router handling all waypoint requests
      */
-    journeyRouter: any;
+    journeyRouter: MutableRouter;
     /**
      * Middleware mounted before anything else
      */
-    preMiddleware: any[];
+    preMiddleware: ExpressRequestHandler[];
     /**
      * Middleware mounted after everything else
      */
-    postMiddleware: any[];
+    postMiddleware: ExpressRequestHandler[];
     /**
      * CSRF get/set middleware (useful for forms)
      */
-    csrfMiddleware: any[];
+    csrfMiddleware: ExpressRequestHandler[];
     /**
      * Session middleware
      */
-    sessionMiddleware: any;
+    sessionMiddleware: ExpressRequestHandler;
     /**
      * Cookie-parsing middleware
      */
-    cookieParserMiddleware: any[];
+    cookieParserMiddleware: ExpressRequestHandler[];
     /**
      * I18n preparation middleware
      */
-    i18nMiddleware: any[];
+    i18nMiddleware: ExpressRequestHandler[];
     /**
      * Body parsing middleware
      */
-    bodyParserMiddleware: any;
+    bodyParserMiddleware: ExpressRequestHandler;
     /**
      * Function used to mount all CASA artifacts onto an ExpressJS app
      */

package/dist/lib/configure.js

@@ -8,6 +8,7 @@ const path_1 = require("path");
 const module_1 = require("module");
 const cookie_parser_1 = __importDefault(require("cookie-parser"));
 const dirname_cjs_1 = __importDefault(require("./dirname.cjs"));
+const configuration_ingestor_js_1 = __importDefault(require("./configuration-ingestor.js"));
 const nunjucks_js_1 = __importDefault(require("./nunjucks.js"));
 const static_js_1 = __importDefault(require("../routes/static.js"));
 const ancillary_js_1 = __importDefault(require("../routes/ancillary.js"));
@@ -20,32 +21,13 @@ const data_js_1 = __importDefault(require("../middleware/data.js"));
 const body_parser_js_1 = __importDefault(require("../middleware/body-parser.js"));
 const csrf_js_1 = __importDefault(require("../middleware/csrf.js"));
 /**
- *
- * @typedef {object} SessionOptions
- * @property {string} [name=casasession] Session name
- * @property {string} [secret=secret] Encryption secret
- * @property {number} [ttl=3600] Session ttl (seconds)
- * @property {boolean} [secure=false] Whether to use secure session cookies
- * @property {boolean|string} [cookieSameSite=true] SameSite (true = Strict)
- * @property {object} [store] Session store (default MemoryStore)
- */
-/**
- * @typedef {object} GlobalHook Hook configuration
- * @property {string} hook Hook name in format `<router>.<hook>`
- * @property {Function} middleware Middleware function to insert at the hook point
- * @property {string|RegExp} [path=undefined] Only run if route path matches this string/regexp
+ * @typedef {import('express').RequestHandler} ExpressRequestHandler
  */
 /**
- * @typedef {object} PageHook (extends GlobalHook)
- * @property {string} hook Hook name (without a scope prefix)
- * @property {Function} middleware Middleware function to insert at the hook point
+ * @typedef {import('./index').MutableRouter} MutableRouter
  */
 /**
- * @typedef {object} Page Page configuration. A Page is the interactive representation of a waypoint
- * @property {string} waypoint The waypoint with which this page is associated
- * @property {string} view Template path
- * @property {PageHook[]} [hooks=[]] Page-specific hooks (optional, default [])
- * @property {PageField[]} [fields=[]] Fields to be managed on this page (optional, default [])
+ * @typedef {import('./configuration-ingestor').ConfigurationOptions} ConfigurationOptions
  */
 /**
  * @typedef {object} ConfigureResult Result of a call to configure() function
@@ -53,13 +35,13 @@ const csrf_js_1 = __importDefault(require("../middleware/csrf.js"));
  * @property {MutableRouter} staticRouter Router handling all static assets
  * @property {MutableRouter} ancillaryRouter Router handling ancillary routes
  * @property {MutableRouter} journeyRouter Router handling all waypoint requests
- * @property {express.RequestHandler[]} preMiddleware Middleware mounted before anything else
- * @property {express.RequestHandler[]} postMiddleware Middleware mounted after everything else
- * @property {express.RequestHandler[]} csrfMiddleware CSRF get/set middleware (useful for forms)
- * @property {express.RequestHandler} sessionMiddleware Session middleware
- * @property {express.RequestHandler[]} cookieParserMiddleware Cookie-parsing middleware
- * @property {express.RequestHandler[]} i18nMiddleware I18n preparation middleware
- * @property {express.RequestHandler} bodyParserMiddleware Body parsing middleware
+ * @property {ExpressRequestHandler[]} preMiddleware Middleware mounted before anything else
+ * @property {ExpressRequestHandler[]} postMiddleware Middleware mounted after everything else
+ * @property {ExpressRequestHandler[]} csrfMiddleware CSRF get/set middleware (useful for forms)
+ * @property {ExpressRequestHandler} sessionMiddleware Session middleware
+ * @property {ExpressRequestHandler[]} cookieParserMiddleware Cookie-parsing middleware
+ * @property {ExpressRequestHandler[]} i18nMiddleware I18n preparation middleware
+ * @property {ExpressRequestHandler} bodyParserMiddleware Body parsing middleware
  * @property {Function} mount Function used to mount all CASA artifacts onto an ExpressJS app
  */
 /**
@@ -68,17 +50,7 @@ const csrf_js_1 = __importDefault(require("../middleware/csrf.js"));
  * `mountUrl` is used to ensure the CSS content uses the correct reference to
  * static assets in the `govuk-frontend` module.
  *
- * @param {object} config Configuration options
- * @param {string} [config.mountUrl=/] URL path to root of CASA app
- * @param {string} [config.serviceName=common.serviceName] Service name (i18n key)
- * @param {string[]} [config.views=[]] Template directories
- * @param {SessionOptions} [config.session] Session configuration
- * @param {Page[]} [config.pages=[]] Pages the represent waypoints
- * @param {GlobalHook[]} [config.hooks=[]] Hooks to apply
- * @param {object[]} [config.plugins=[]] Plugins
- * @param {I18nOptions[]} [config.i18n] I18n configuration
- * @param {Plan} config.plan CASA Plan
- * @param {ContextEvent[]} [config.events=[]] Handlers for JourneyContext events
+ * @param {ConfigurationOptions} config Configuration options
  * @returns {ConfigureResult} Result
  */
 function configure(config = {}) {
@@ -90,17 +62,18 @@ function configure(config = {}) {
     });
     // Extract config
     // TODO: Validate/sanitise and deep-freeze object
-    const { mountUrl = '/', serviceName = 'common:serviceName', views = [], session = {
+    const { mountUrl = '/', views = [], session = {
         secret: 'secret',
         name: 'casasession',
         secure: false,
         ttl: 60 * 60,
         cookieSameSite: true,
+        cookiePath: '/',
         store: undefined,
     }, pages = [], plan = null, hooks = [], plugins = [], events = [], i18n = {
         dirs: [],
         locales: ['en', 'cy'],
-    }, } = config;
+    }, } = (0, configuration_ingestor_js_1.default)(config);
     // Prepare all page hooks so they are prefixed with the `journey.` scope.
     pages.forEach((page) => {
         var _a;
@@ -131,6 +104,7 @@ function configure(config = {}) {
         name: session.name,
         ttl: session.ttl,
         cookieSameSite: session.cookieSameSite,
+        cookiePath: session.cookiePath,
         mountUrl,
         store: (_b = session.store) !== null && _b !== void 0 ? _b : new express_session_1.MemoryStore(),
     });
@@ -145,7 +119,6 @@ function configure(config = {}) {
     const dataMiddleware = (0, data_js_1.default)({
         plan,
         mountUrl,
-        serviceName,
         events,
     });
     // Prepare form middleware and its constiuent parts

package/dist/lib/dirname.d.cts

@@ -0,0 +1,2 @@
+declare const _exports: string;
+export = _exports;

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

@@ -1,6 +1,7 @@
 /**
  * A convenience for ending the current session, but retaining some data in it,
- * like the current language.
+ * 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.

package/dist/lib/end-session.js

@@ -1,8 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const logger_js_1 = __importDefault(require("./logger.js"));
+const log = (0, logger_js_1.default)('function:end-session');
 /**
  * A convenience for ending the current session, but retaining some data in it,
- * like the current language.
+ * 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.
@@ -13,14 +19,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 function endSession(req, next) {
     const { language } = req.session;
-    req.session.regenerate((err) => {
-        if (err) {
-            next(err);
+    Object.entries(req.session).forEach(([k]) => {
+        if (!['cookie'].includes(k)) {
+            req.session[k] = null;
         }
-        else {
-            req.session.language = language;
-            req.session.save(next);
+    });
+    req.session.save((saveErr) => {
+        if (saveErr) {
+            log.error(saveErr);
         }
+        req.session.regenerate((err) => {
+            if (err) {
+                log.error(err);
+                next(err);
+            }
+            else {
+                req.session.language = language;
+                req.session.save(next);
+            }
+        });
     });
 }
 exports.default = endSession;

package/dist/lib/field.d.ts

@@ -13,9 +13,32 @@ export class PageField {
     putValue(obj: any, value: any): PageField;
     get name(): string;
     get meta(): object;
-    validators(...items: any[]): PageField | Validator[];
-    processors(...items: any[]): Function[] | PageField;
-    conditions(...items: any[]): Function[] | PageField;
+    /**
+     * Add/get value validators
+     * Some validators will include a `sanitise()` method which will be run at the
+     * same time as other "processors".
+     *
+     * @param {ValidateFunction[]} items Validation functions
+     * @returns {PageField | ValidateFunction[]} Chain or return all validators
+     */
+    validators(items?: ValidateFunction[]): PageField | ValidateFunction[];
+    /**
+     * Add/get value pre-processors
+     * This is most often used to sanitise values to a particular data type.
+     *
+     * @param {ProcessorFunction[]} items Processor functions
+     * @returns {PageField | ProcessorFunction[]} Chain or return all processors
+     */
+    processors(items?: ProcessorFunction[]): PageField | ProcessorFunction[];
+    /**
+     * Add/get conditions
+     * All conditions must be met in order for this field to be considered
+     * "actionable".
+     *
+     * @param {ConditionFunction[]} items Condition functions
+     * @returns {PageField | ConditionFunction[]} Chain or return all conditions
+     */
+    conditions(items?: ConditionFunction[]): PageField | ConditionFunction[];
     /**
      * Run all validators and return array of errors, if applicable.
      *
@@ -23,7 +46,7 @@ export class PageField {
      * @param {ValidateContext} context Contextual information
      * @returns {ValidationError[]} Errors, or an empty array if all valid
      */
-    runValidators(value: any, context: ValidateContext): any[];
+    runValidators(value: any, context: any): ValidationError[];
     applyProcessors(value: any): any;
     /**
      * Apply all conditions to get the resulting boolean
@@ -39,46 +62,16 @@ export class PageField {
         waypoint: string;
         journeyContext: object;
     }): boolean;
-    validator(...args: any[]): PageField | Validator[];
-    processor(...args: any[]): Function[] | PageField;
-    condition(...args: any[]): Function[] | PageField;
-    if(...args: any[]): Function[] | PageField;
+    validator(validator: any): any[] | PageField;
+    processor(processor: any): PageField | ProcessorFunction[];
+    condition(condition: any): PageField | ConditionFunction[];
+    if(...args: any[]): PageField | ConditionFunction[];
     #private;
 }
-export type Validator = {
-    /**
-     * Validation function
-     */
-    validate: ValidateFunction;
-    /**
-     * Sanitise a given value prior to validation
-     */
-    sanitise: SanitiseFunction;
-    /**
-     * Configuration
-     */
-    config: object;
-    /**
-     * Validator name
-     */
-    name: string;
-};
-export type ValidateFunction = (value: any, context: ValidateContext) => any[];
-export type SanitiseFunction = (value: any) => any;
-/**
- * Context passed to validate function
- */
-export type ValidateContext = {
-    /**
-     * Journey context
-     */
-    journeyContext: any;
-    /**
-     * Waypoint
-     */
-    waypoint: string;
-    /**
-     * Name of field being processed
-     */
-    fieldName: string;
-};
+export type JourneyContext = import('./index').JourneyContext;
+export type Validator = import('./index').Validator;
+export type ValidateFunction = import('./index').ValidateFunction;
+export type ValidateContext = import('./index').ValidateContext;
+export type ValidationError = import('./index').ValidationError;
+export type ProcessorFunction = (value: any) => any;
+export type ConditionFunction = (context: Object, fieldName: string, fieldValue: any, waypoint: string, waypointId: string, journeyContext: JourneyContext) => boolean;

package/dist/lib/field.js

@@ -20,28 +20,34 @@ const lodash_1 = __importDefault(require("lodash"));
 const utils_js_1 = require("./utils.js");
 const { isFunction } = lodash_1.default;
 /**
- * @typedef {object} Validator
- * @property {ValidateFunction} validate Validation function
- * @property {SanitiseFunction} sanitise Sanitise a given value prior to validation
- * @property {object} config Configuration
- * @property {string} name Validator name
+ * @typedef {import('./index').JourneyContext} JourneyContext
  */
 /**
- * @callback ValidateFunction
- * @param {any} value
- * @param {ValidateContext} context
- * @returns {ValidationError[]}
+ * @typedef {import('./index').Validator} Validator
  */
 /**
- * @callback SanitiseFunction
- * @param {any} value
+ * @typedef {import('./index').ValidateFunction} ValidateFunction
+ */
+/**
+ * @typedef {import('./index').ValidateContext} ValidateContext
+ */
+/**
+ * @typedef {import('./index').ValidationError} ValidationError
+ */
+/**
+ * @callback ProcessorFunction
+ * @param {any} value Value to be processed
  * @returns {any}
  */
 /**
- * @typedef {object} ValidateContext Context passed to validate function
- * @property {JourneyContext} journeyContext Journey context
- * @property {string} waypoint Waypoint
- * @property {string} fieldName Name of field being processed
+ * @callback ConditionFunction
+ * @param {Object} context Value to be processed
+ * @param {string} context.fieldName Field name
+ * @param {any} context.fieldValue Field value
+ * @param {string} context.waypoint Waypoint
+ * @param {string} context.waypointId [DEPRECATED] Waypoint (for backwards compatibility with v7)
+ * @param {JourneyContext} journeyContext Journey Context
+ * @returns {boolean} True if the validators should be run
  */
 // Quick check to see if the field name corresponds to a non-primitive complex
 // type. For example, `my_field[nested]`.
@@ -56,15 +62,15 @@ class PageField {
          */
         _PageField_name.set(this, void 0);
         /**
-         * @type {Function[]}
+         * @type {ProcessorFunction[]}
          */
         _PageField_processors.set(this, void 0);
         /**
-         * @type {Validator[]}
+         * @type {ValidateFunction[]}
          */
         _PageField_validators.set(this, void 0);
         /**
-         * @type {Function[]}
+         * @type {ConditionFunction[]}
          */
         _PageField_conditions.set(this, void 0);
         /**
@@ -116,28 +122,44 @@ class PageField {
     get meta() {
         return __classPrivateFieldGet(this, _PageField_meta, "f");
     }
-    // Add/get value validators
-    // Some validators might include their own processors on
-    validators(...items) {
-        // TODO: prepend any sanitisers these validators may have onto the #processors array
+    /**
+     * Add/get value validators
+     * Some validators will include a `sanitise()` method which will be run at the
+     * same time as other "processors".
+     *
+     * @param {ValidateFunction[]} items Validation functions
+     * @returns {PageField | ValidateFunction[]} Chain or return all validators
+     */
+    validators(items = []) {
         if (!items.length) {
             return __classPrivateFieldGet(this, _PageField_validators, "f");
         }
         __classPrivateFieldSet(this, _PageField_validators, [...__classPrivateFieldGet(this, _PageField_validators, "f"), ...(items.flat())], "f");
         return this;
     }
-    // Add/get value pre-processors
-    // This is most often used to sanitise values to a particular data type
-    processors(...items) {
+    /**
+     * Add/get value pre-processors
+     * This is most often used to sanitise values to a particular data type.
+     *
+     * @param {ProcessorFunction[]} items Processor functions
+     * @returns {PageField | ProcessorFunction[]} Chain or return all processors
+     */
+    processors(items = []) {
         if (!items.length) {
             return __classPrivateFieldGet(this, _PageField_processors, "f");
         }
         __classPrivateFieldSet(this, _PageField_processors, [...__classPrivateFieldGet(this, _PageField_processors, "f"), ...(items.flat())], "f");
         return this;
     }
-    // Add/get conditions
-    // All conditions must be met in order for this field to be considered "actionable"
-    conditions(...items) {
+    /**
+     * Add/get conditions
+     * All conditions must be met in order for this field to be considered
+     * "actionable".
+     *
+     * @param {ConditionFunction[]} items Condition functions
+     * @returns {PageField | ConditionFunction[]} Chain or return all conditions
+     */
+    conditions(items = []) {
         if (!items.length) {
             return __classPrivateFieldGet(this, _PageField_conditions, "f");
         }
@@ -211,14 +233,14 @@ class PageField {
         return result;
     }
     /* ---------------------------------------------------------------- aliases */
-    validator(...args) {
-        return this.validators(...args);
+    validator(validator) {
+        return this.validators([validator]);
     }
-    processor(...args) {
-        return this.processors(...args);
+    processor(processor) {
+        return this.processors([processor]);
     }
-    condition(...args) {
-        return this.conditions(...args);
+    condition(condition) {
+        return this.conditions([condition]);
     }
     if(...args) {
         return this.conditions(...args);

package/dist/lib/index.d.ts

@@ -0,0 +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";
+export { CasaTemplateLoader, configure, configurationIngestor, endSession, field, PageField, JourneyContext, MutableRouter, Plan, utils, ValidationError, ValidatorFactory, waypointUrl };