@tellescope/validation 1.4.0 → 1.4.3

package/lib/esm/validation.js

@@ -9,6 +9,17 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { WEBHOOK_MODELS, TIMEZONES, } from "@tellescope/types-models";
 import v from 'validator';
 export var isDate = v.isDate, isEmail = v.isEmail, isMobilePhone = v.isMobilePhone, isMongoId = v.isMongoId, isMimeType = v.isMimeType, isURL = v.isURL;
@@ -16,6 +27,11 @@ export var isDate = v.isDate, isEmail = v.isEmail, isMobilePhone = v.isMobilePho
 //   BUSINESS_TYPE,
 // } from "@tellescope/constants"
 import { filter_object, is_defined, is_object, is_whitespace, object_is_empty, to_object_id, } from "@tellescope/utilities";
+var EXAMPLE_OBJECT_ID = '60398b0231a295e64f084fd9';
+var getTypeString = function () { return "string"; };
+var getTypeNumber = function () { return "number"; };
+var getExampleString = function () { return 'example string'; };
+var getExampleObjectId = function () { return EXAMPLE_OBJECT_ID; };
 export var MAX_FILE_SIZE = 25000000; // 25 megabytes in bytes
 var DEFAULT_MAX_LENGTH = 5000;
 export var build_validator = function (escapeFunction, options) {
@@ -100,10 +116,10 @@ export var build_validator = function (escapeFunction, options) {
         return listOf ? escapedValues : escapedValues[0];
     };
 };
-export var fieldsToValidation = function (fs) {
+export var fieldsToValidationOld = function (fs) {
     var validation = {};
     for (var f in fs) {
-        validation[f] = fs[f].validator({ isOptional: !fs[f].required });
+        validation[f] = fs[f].validator.validate({ isOptional: !fs[f].required });
     }
     return validation;
 };
@@ -135,21 +151,25 @@ export var binaryOrValidator = function (f1, f2) { return function (o) {
         }
     }, __assign(__assign({}, o), { listOf: false }));
 }; };
-export var orValidator = function (escapeFunctions) { return function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(function (value) {
-        for (var field in escapeFunctions) {
-            var escape_1 = escapeFunctions[field];
-            try {
-                return escape_1(value);
-            }
-            catch (err) {
-                continue;
+export var orValidator = function (validators) { return ({
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(function (value) {
+            for (var field in validators) {
+                var escape_1 = validators[field];
+                try {
+                    return escape_1.validate()(value);
+                }
+                catch (err) {
+                    continue;
+                }
             }
-        }
-        throw "Value does not match any of the expected options";
-    }, __assign(__assign({}, o), { listOf: false }));
-}; };
+            throw "Value does not match any of the expected options";
+        }, __assign(__assign({}, o), { listOf: false }));
+    },
+    getExample: function () { return Object.values(validators)[0].getExample(); },
+    getType: function () { return [Object.values(validators).map(function (v) { return v.getType(); })]; }
+}); };
 export var filterCommandsValidator = function (o) {
     if (o === void 0) { o = {}; }
     return build_validator(function (value) {
@@ -207,7 +227,7 @@ export var convertCommands = function (operators) {
     }
     return filterOperators;
 };
-export var objectValidator = function (i, objectOptions) {
+export var objectValidatorOld = function (i, objectOptions) {
     if (objectOptions === void 0) { objectOptions = { emptyOk: true }; }
     return function (o) {
         if (o === void 0) { o = {}; }
@@ -244,70 +264,134 @@ export var objectValidator = function (i, objectOptions) {
         }, __assign(__assign({}, o), { isObject: true, listOf: false }));
     };
 };
+export var listValidatorOld = function (b) { return function (o) { return build_validator(b, __assign(__assign({}, o), { listOf: true })); }; };
+var exampleObject = function (fields) {
+    var examples = {};
+    for (var field in fields) {
+        examples[field] = fields[field].getExample();
+    }
+    return examples;
+};
+var typeObject = function (fields) {
+    var types = {};
+    for (var field in fields) {
+        types[field] = fields[field].getType();
+    }
+    return types;
+};
+export var objectValidator = function (i, objectOptions) {
+    if (objectOptions === void 0) { objectOptions = { emptyOk: true }; }
+    return ({
+        validate: function (o) {
+            if (o === void 0) { o = {}; }
+            return build_validator(function (object) {
+                var _a;
+                var emptyOk = (_a = objectOptions.emptyOk) !== null && _a !== void 0 ? _a : true;
+                var validated = {};
+                if (!is_object(object)) {
+                    throw new Error("Expected a non-null object by got ".concat(object));
+                }
+                if (!emptyOk && object_is_empty(object)) {
+                    throw new Error("Expected a non-empty object");
+                }
+                // don't throw on unrecognized fields, just ignore/don't validate them
+                if (objectOptions.throwOnUnrecognizedField) {
+                    var unrecognizedFields = [];
+                    for (var field in object) {
+                        if (!i[field]) {
+                            unrecognizedFields.push(field);
+                        }
+                    }
+                    if (unrecognizedFields.length > 0) {
+                        throw new Error("Got unexpected field(s) [".concat(unrecognizedFields.join(', '), "]"));
+                    }
+                }
+                for (var field in i) {
+                    var value = object[field];
+                    var escaped = i[field].validate()(value); // may be required
+                    if (escaped === undefined)
+                        continue;
+                    validated[field] = escaped;
+                }
+                return validated;
+            }, __assign(__assign({}, o), { isObject: true, listOf: false, isOptional: !!objectOptions.isOptional || o.isOptional }));
+        },
+        getExample: function () { return exampleObject(i); },
+        getType: function () { return typeObject(i); },
+    });
+};
 export var listOfObjectsValidator = function (i, objectOptions) {
     if (objectOptions === void 0) { objectOptions = { emptyOk: true }; }
-    return function (o) {
+    return ({
+        validate: function (o) {
+            if (o === void 0) { o = {}; }
+            return build_validator(function (object) {
+                var emptyOk = !!objectOptions.emptyOk || o.emptyListOk;
+                var validated = {};
+                if (!is_object(object)) {
+                    throw new Error("Expected a non-null object by got ".concat(object));
+                }
+                if (!emptyOk && object_is_empty(object)) {
+                    throw new Error("Expected a non-empty object");
+                }
+                // don't throw on unrecognized fields, just ignore/don't validate them
+                // const unrecognizedFields = []
+                // for (const field in object) {
+                //   if (!(i as Indexable)[field]) {
+                //     unrecognizedFields.push(field)
+                //   } 
+                // }
+                // if (unrecognizedFields.length > 0) {
+                //   throw new Error(`Got unexpected field(s) [${unrecognizedFields.join(', ')}]`)
+                // }
+                for (var field in i) {
+                    var value = object[field];
+                    var escaped = i[field].validate()(value); // may be required
+                    if (escaped === undefined)
+                        continue;
+                    validated[field] = escaped;
+                }
+                return validated;
+            }, __assign(__assign({}, o), { isObject: true, listOf: true, emptyListOk: !!objectOptions.emptyOk || o.emptyListOk }));
+        },
+        getExample: function () { return [exampleObject(i)]; },
+        getType: function () { return [typeObject(i)]; } // don't forget list
+    });
+};
+export var objectAnyFieldsValidator = function (valueValidator) { return ({
+    validate: function (o) {
         if (o === void 0) { o = {}; }
         return build_validator(function (object) {
-            var emptyOk = !!objectOptions.emptyOk || o.emptyListOk;
-            var validated = {};
             if (!is_object(object)) {
-                throw new Error("Expected a non-null object by got ".concat(object));
-            }
-            if (!emptyOk && object_is_empty(object)) {
-                throw new Error("Expected a non-empty object");
-            }
-            // don't throw on unrecognized fields, just ignore/don't validate them
-            // const unrecognizedFields = []
-            // for (const field in object) {
-            //   if (!(i as Indexable)[field]) {
-            //     unrecognizedFields.push(field)
-            //   } 
-            // }
-            // if (unrecognizedFields.length > 0) {
-            //   throw new Error(`Got unexpected field(s) [${unrecognizedFields.join(', ')}]`)
-            // }
-            for (var field in i) {
-                var value = object[field];
-                var escaped = i[field](value); // may be required
-                if (escaped === undefined)
-                    continue;
-                validated[field] = escaped;
-            }
-            return validated;
-        }, __assign(__assign({}, o), { isObject: true, listOf: true, emptyListOk: !!objectOptions.emptyOk || o.emptyListOk }));
-    };
-};
-export var objectAnyFieldsValidator = function (valueValidator) { return function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(function (object) {
-        if (!is_object(object)) {
-            throw new Error("Expected a non-null object by got ${object}");
-        }
-        var validated = {};
-        for (var field in object) {
-            if (valueValidator) {
-                validated[field] = valueValidator(object[field]);
-            }
-            else if (typeof object[field] === 'number') {
-                validated[field] = numberValidator(object[field]);
+                throw new Error("Expected a non-null object by got ${object}");
             }
-            else if (typeof object[field] === 'string') {
-                validated[field] = stringValidator(object[field]);
-            }
-            else if (object[field] === null) {
-                validated[field] = null;
-            }
-            else {
+            var validated = {};
+            for (var field in object) {
                 if (valueValidator) {
-                    throw new Error("Field ".concat(field, " is not a string or number"));
+                    validated[field] = valueValidator.validate()(object[field]);
+                }
+                else if (typeof object[field] === 'number') {
+                    validated[field] = numberValidator.validate()(object[field]);
+                }
+                else if (typeof object[field] === 'string') {
+                    validated[field] = stringValidator.validate()(object[field]);
+                }
+                else if (object[field] === null) {
+                    validated[field] = null;
+                }
+                else {
+                    if (valueValidator) {
+                        throw new Error("Field ".concat(field, " is not a string or number"));
+                    }
+                    validated[field] = object[field];
                 }
-                validated[field] = object[field];
             }
-        }
-        return validated;
-    }, __assign(__assign({}, o), { isObject: true, listOf: false }));
-}; };
+            return validated;
+        }, __assign(__assign({}, o), { isObject: true, listOf: false }));
+    },
+    getExample: function () { var _a, _b; return "{ \"key\": ".concat((_b = (_a = valueValidator === null || valueValidator === void 0 ? void 0 : valueValidator.getExample) === null || _a === void 0 ? void 0 : _a.call(valueValidator)) !== null && _b !== void 0 ? _b : '"value"', " }"); },
+    getType: function () { var _a, _b; return "{ \"key\": ".concat((_b = (_a = valueValidator === null || valueValidator === void 0 ? void 0 : valueValidator.getType) === null || _a === void 0 ? void 0 : _a.call(valueValidator)) !== null && _b !== void 0 ? _b : 'string', " }"); },
+}); };
 export var objectAnyFieldsAnyValuesValidator = objectAnyFieldsValidator();
 export var escapeString = function (o) {
     if (o === void 0) { o = {}; }
@@ -323,53 +407,134 @@ export var escapeString = function (o) {
         return string;
     };
 };
-export var stringValidator = function (o) {
-    var _a;
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: (_a = o.maxLength) !== null && _a !== void 0 ? _a : 1000, listOf: false }));
+export var stringValidator = {
+    validate: function (o) {
+        var _a;
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: (_a = o.maxLength) !== null && _a !== void 0 ? _a : 1000, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
-export var stringValidator100 = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 100, listOf: false }));
+export var stringValidatorOptional = {
+    validate: function (o) {
+        var _a;
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: (_a = o.maxLength) !== null && _a !== void 0 ? _a : 1000, listOf: false, isOptional: true }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
-export var stringValidator250 = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 250, listOf: false }));
+export var stringValidator100 = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 100, listOf: false }));
+    },
+    getExample: function () { return getExampleString; },
+    getType: function () { return getTypeString; }
 };
-export var stringValidator1000 = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 1000, listOf: false }));
+export var stringValidator250 = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 250, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
-export var stringValidator5000 = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 5000, listOf: false }));
+export var stringValidator1000 = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 1000, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
-export var stringValidator25000 = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 25000, listOf: false }));
+export var stringValidator5000 = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 5000, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
-export var SMSMessageValidator = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 630, listOf: false }));
-};
-export var listValidator = function (b) { return function (o) { return build_validator(b, __assign(__assign({}, o), { listOf: true })); }; };
-export var listValidatorEmptyOk = function (b) { return function (o) { return build_validator(b, __assign(__assign({}, o), { listOf: true, emptyListOk: true })); }; };
-export var listOfStringsValidator = listValidator(stringValidator());
-export var listOfStringsValidatorEmptyOk = listValidatorEmptyOk(stringValidator());
-export var listOfObjectAnyFieldsAnyValuesValidator = listValidator(objectAnyFieldsAnyValuesValidator());
-export var booleanValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (boolean) {
-        if (boolean === 'true')
-            return true;
-        if (boolean === 'false')
-            return false;
-        if (typeof boolean !== 'boolean') {
-            throw new Error(options.errorMessage || "Invalid boolean");
-        }
-        return boolean;
-    }, __assign(__assign({}, options), { isBoolean: true, listOf: false }));
+export var stringValidator5000EmptyOkay = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 5000, listOf: false, emptyStringOk: true }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
+};
+export var stringValidator5000Optional = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 5000, listOf: false, isOptional: true, emptyStringOk: true }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
 };
+export var stringValidator25000 = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 25000, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
+};
+export var stringValidator25000EmptyOkay = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 25000, listOf: false, emptyStringOk: true }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
+};
+export var SMSMessageValidator = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeString(o), __assign(__assign({}, o), { maxLength: 630, listOf: false }));
+    },
+    getExample: getExampleString,
+    getType: getTypeString,
+};
+export var listValidator = function (b, o) { return ({
+    validate: function (o) { return build_validator(b.validate(o), __assign(__assign({}, o), { listOf: true })); },
+    getExample: function () { return [b.getExample()]; },
+    getType: function () { return [b.getExample()]; },
+}); };
+export var listValidatorEmptyOk = function (b, o) { return ({
+    validate: function (o) { return build_validator(b.validate(o), __assign(__assign({}, o), { listOf: true, emptyListOk: true })); },
+    getExample: function () { return [b.getExample()]; },
+    getType: function () { return [b.getExample()]; },
+}); };
+export var listValidatorOptionalOrEmptyOk = function (b, o) { return ({
+    validate: function (o) { return build_validator(b.validate(o), __assign(__assign({}, o), { listOf: true, emptyListOk: true, isOptional: true })); },
+    getExample: function () { return [b.getExample()]; },
+    getType: function () { return [b.getExample()]; },
+}); };
+export var listOfStringsValidator = listValidator(stringValidator);
+export var listOfStringsValidatorOptionalOrEmptyOk = listValidatorOptionalOrEmptyOk(stringValidator);
+export var listOfStringsValidatorEmptyOk = listValidatorEmptyOk(stringValidator);
+export var listOfObjectAnyFieldsAnyValuesValidator = listValidator(objectAnyFieldsAnyValuesValidator);
+export var booleanValidatorBuilder = function (defaults) { return ({
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (boolean) {
+            if (boolean === 'true')
+                return true;
+            if (boolean === 'false')
+                return false;
+            if (typeof boolean !== 'boolean') {
+                throw new Error(options.errorMessage || "Invalid boolean");
+            }
+            return boolean;
+        }, __assign(__assign(__assign({}, defaults), options), { isBoolean: true, listOf: false }));
+    },
+    getExample: function () { return true; },
+    getType: function () { return "boolean"; },
+}); };
+export var booleanValidator = booleanValidatorBuilder({});
+export var booleanValidatorOptional = booleanValidatorBuilder({ isOptional: true });
 export var escapeMongoId = function (mongoId) {
     if (typeof mongoId !== 'string')
         throw new Error('Expecting string id');
@@ -378,14 +543,22 @@ export var escapeMongoId = function (mongoId) {
     }
     return mongoId;
 };
-export var mongoIdValidator = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(function (s) { return to_object_id(escapeMongoId(s)); }, __assign(__assign({}, optionsWithDefaults(o)), { maxLength: 100, listOf: false }));
-};
-export var mongoIdStringValidator = function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(escapeMongoId, __assign(__assign({}, optionsWithDefaults(o)), { maxLength: 100, listOf: false }));
+export var mongoIdValidator = {
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(function (s) { return to_object_id(escapeMongoId(s)); }, __assign(__assign({}, optionsWithDefaults(o)), { maxLength: 100, listOf: false }));
+    },
+    getType: getTypeString,
+    getExample: getExampleObjectId,
 };
+export var buildMongoIdStringValidator = function (options) { return ({
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(escapeMongoId, __assign(__assign({}, optionsWithDefaults(__assign(__assign({}, options), o))), { maxLength: 100, listOf: false }));
+    },
+    getType: getTypeString,
+    getExample: getExampleObjectId,
+}); };
 export var nullValidator = function (o) {
     if (o === void 0) { o = {}; }
     return build_validator(function (v) {
@@ -394,198 +567,289 @@ export var nullValidator = function (o) {
         return v;
     }, __assign(__assign({}, o), { listOf: false }));
 };
-export var mongoIdRequired = mongoIdValidator();
-export var mongoIdOptional = mongoIdValidator({ isOptional: true });
-export var mongoIdStringRequired = mongoIdStringValidator();
-export var mongoIdStringOptional = mongoIdStringValidator({ isOptional: true });
-export var listOfMongoIdValidator = listValidator(mongoIdValidator());
-export var listOfMongoIdStringValidator = listValidator(mongoIdStringValidator());
-export var listOfMongoIdStringValidatorEmptyOk = listValidatorEmptyOk(mongoIdStringValidator());
+export var mongoIdRequired = mongoIdValidator.validate();
+export var mongoIdOptional = mongoIdValidator.validate({ isOptional: true });
+export var listOfMongoIdValidator = listValidator(mongoIdValidator);
+export var mongoIdStringRequired = buildMongoIdStringValidator({ isOptional: false });
+export var mongoIdStringOptional = buildMongoIdStringValidator({ isOptional: true });
+export var listOfMongoIdStringValidator = listValidator(mongoIdStringRequired);
+export var listOfMongoIdStringValidatorEmptyOk = listValidatorEmptyOk(mongoIdStringRequired);
 export var first_letter_capitalized = function (s) {
     if (s === void 0) { s = ''; }
     return s.charAt(0).toUpperCase() + s.slice(1);
 };
 export var escape_name = function (namestring) { return namestring.replace(/[^a-zA-Z0-9-_ /.]/, '').substring(0, 100); };
 // enforces first-letter capitalization
-export var nameValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (name) {
-        if (typeof name !== 'string')
-            throw new Error('Expecting string value');
-        name = escape_name(name);
-        if (!name)
-            throw new Error("Invalid name");
-        return first_letter_capitalized(name);
-    }, __assign(__assign({}, options), { maxLength: 100, trim: true, listOf: false }));
+export var nameValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (name) {
+            if (typeof name !== 'string')
+                throw new Error('Expecting string value');
+            name = escape_name(name);
+            if (!name)
+                throw new Error("Invalid name");
+            return first_letter_capitalized(name);
+        }, __assign(__assign({}, options), { maxLength: 100, trim: true, listOf: false }));
+    },
+    getExample: function () { return 'John'; },
+    getType: getTypeString,
 };
-export var emailValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (email) {
-        if (typeof email !== 'string')
-            throw new Error('Expecting string value');
-        if (!isEmail(email)) {
-            throw new Error(options.errorMessage || "Invalid email");
-        }
-        return email.toLowerCase();
-    }, __assign(__assign({}, options), { maxLength: 250, listOf: false }));
+export var emailValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (email) {
+            if (typeof email !== 'string')
+                throw new Error('Expecting string value');
+            if (!isEmail(email)) {
+                throw new Error(options.errorMessage || "Invalid email");
+            }
+            return email.toLowerCase();
+        }, __assign(__assign({}, options), { maxLength: 250, listOf: false }));
+    },
+    getExample: function () { return "example@tellescope.com"; },
+    getType: getTypeString,
 };
-export var emailValidatorEmptyOkay = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (email) {
-        if (typeof email !== 'string')
-            throw new Error('Expecting string value');
-        if (!isEmail(email)) {
-            throw new Error(options.errorMessage || "Invalid email");
-        }
-        return email.toLowerCase();
-    }, __assign(__assign({}, options), { maxLength: 250, emptyStringOk: true, listOf: false }));
+export var emailValidatorOptional = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (email) {
+            if (typeof email !== 'string')
+                throw new Error('Expecting string value');
+            if (!isEmail(email)) {
+                throw new Error(options.errorMessage || "Invalid email");
+            }
+            return email.toLowerCase();
+        }, __assign(__assign({}, options), { maxLength: 250, listOf: false, isOptional: true, emptyStringOk: true }));
+    },
+    getExample: function () { return "example@tellescope.com"; },
+    getType: getTypeString,
+};
+export var emailValidatorEmptyOkay = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (email) {
+            if (typeof email !== 'string')
+                throw new Error('Expecting string value');
+            if (!isEmail(email)) {
+                throw new Error(options.errorMessage || "Invalid email");
+            }
+            return email.toLowerCase();
+        }, __assign(__assign({}, options), { maxLength: 250, emptyStringOk: true, listOf: false }));
+    },
+    getExample: function () { return "example@tellescope.com"; },
+    getType: getTypeString,
+};
+export var numberValidatorBuilder = function (_a) {
+    var lower = _a.lower, upper = _a.upper, higherOptions = __rest(_a, ["lower", "upper"]);
+    return ({
+        validate: function (options) {
+            if (options === void 0) { options = {}; }
+            options.isNumber = true;
+            return build_validator(function (number) {
+                number = Number(number); // ok to throw error!
+                if (typeof number !== "number" || isNaN(number)) {
+                    throw new Error(options.errorMessage || "Not a valid number");
+                }
+                if (!(lower || upper))
+                    return number;
+                if (!(number >= lower && number <= upper)) {
+                    throw new Error(options.errorMessage || "Not a valid number for [".concat(lower, "-").concat(upper, "]"));
+                }
+                return number;
+            }, __assign(__assign({}, optionsWithDefaults(__assign(__assign({}, higherOptions), options))), { listOf: false }));
+        },
+        getExample: function () { return lower; },
+        getType: getTypeNumber,
+    });
 };
-export var numberValidatorBuilder = function (r) { return function (options) {
-    if (options === void 0) { options = {}; }
-    options.isNumber = true;
-    return build_validator(function (number) {
-        number = Number(number); // ok to throw error!
-        if (typeof number !== "number" || isNaN(number)) {
-            throw new Error(options.errorMessage || "Not a valid number");
-        }
-        if (!r)
-            return number;
-        if (!(number >= r.lower && number <= r.upper)) {
-            throw new Error(options.errorMessage || "Not a valid number for [".concat(r.lower, "-").concat(r.upper, "]"));
-        }
-        return number;
-    }, __assign(__assign({}, options), { listOf: false }));
-}; };
 export var nonNegNumberValidator = numberValidatorBuilder({ lower: 0, upper: 10000000000000 }); // max is 2286 in UTC MS
 export var numberValidator = numberValidatorBuilder({ lower: -100000000, upper: 10000000000000 }); // max is 2286 in UTC MS
+export var numberValidatorOptional = numberValidatorBuilder({ lower: -100000000, upper: 10000000000000, isOptional: true, emptyStringOk: true }); // max is 2286 in UTC MS
 export var fileSizeValidator = numberValidatorBuilder({ lower: 0, upper: MAX_FILE_SIZE });
-export var dateValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (date) {
-        if (isDate(date))
-            throw new Error(options.errorMessage || "Invalid date");
-        return new Date(date);
-    }, __assign(__assign({}, options), { maxLength: 250, listOf: false }));
+export var dateValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (date) {
+            if (isDate(date))
+                throw new Error(options.errorMessage || "Invalid date");
+            return new Date(date);
+        }, __assign(__assign({}, options), { maxLength: 250, listOf: false }));
+    },
+    getExample: function () { return new Date().toISOString(); },
+    getType: function () { return "Date"; },
 };
-export var exactMatchValidator = function (matches) { return function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(function (match) {
-        if (matches.filter(function (m) { return m === match; }).length === 0) {
-            throw new Error("Value must match one of ".concat(matches));
-        }
-        return match;
-    }, __assign(__assign({}, o), { listOf: false }));
-}; };
-export var exactMatchListValidator = function (matches) { return function (o) {
-    if (o === void 0) { o = {}; }
-    return build_validator(function (match) {
-        if (matches.filter(function (m) { return m === match; }).length === 0) {
-            throw new Error("Value must match one of ".concat(matches));
-        }
-        return match;
-    }, __assign(__assign({}, o), { listOf: true }));
-}; };
-export var journeysValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (journeys) {
-        if (typeof journeys !== 'object') {
-            throw new Error('Expecting an object');
-        }
-        var mIdValidator = mongoIdValidator();
-        var stateValidator = stringValidator({ isOptional: true, maxLength: 75, errorMessage: "Journey state names may not exceed 75 characters" });
-        for (var j in journeys) {
-            mIdValidator(j);
-            journeys[j] = stateValidator(journeys[j]);
-        }
-        return journeys;
-    }, __assign(__assign({}, options), { isObject: true, listOf: false }));
+export var dateValidatorOptional = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (date) {
+            if (isDate(date))
+                throw new Error(options.errorMessage || "Invalid date");
+            return new Date(date);
+        }, __assign(__assign({}, options), { maxLength: 250, listOf: false, isOptional: true, emptyStringOk: true }));
+    },
+    getExample: function () { return new Date().toISOString(); },
+    getType: function () { return "Date"; },
+};
+export var exactMatchValidator = function (matches) { return ({
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(function (match) {
+            if (matches.filter(function (m) { return m === match; }).length === 0) {
+                throw new Error("Value must match one of ".concat(matches));
+            }
+            return match;
+        }, __assign(__assign({}, o), { listOf: false }));
+    },
+    getExample: function () { return matches[0]; },
+    getType: getTypeString,
+}); };
+export var exactMatchValidatorOptional = function (matches) { return ({
+    validate: function (o) {
+        if (o === void 0) { o = {}; }
+        return build_validator(function (match) {
+            if (matches.filter(function (m) { return m === match; }).length === 0) {
+                throw new Error("Value must match one of ".concat(matches));
+            }
+            return match;
+        }, __assign(__assign({}, o), { listOf: false, isOptional: true }));
+    },
+    getExample: function () { return matches[0]; },
+    getType: getTypeString,
+}); };
+export var exactMatchListValidator = function (matches) { return listValidator(exactMatchValidator(matches)); };
+export var journeysValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (journeys) {
+            if (typeof journeys !== 'object') {
+                throw new Error('Expecting an object');
+            }
+            var mIdValidator = mongoIdValidator.validate();
+            var stateValidator = stringValidator.validate({ isOptional: true, maxLength: 75, errorMessage: "Journey state names may not exceed 75 characters" });
+            for (var j in journeys) {
+                mIdValidator(j);
+                journeys[j] = stateValidator(journeys[j]);
+            }
+            return journeys;
+        }, __assign(__assign({}, options), { isObject: true, listOf: false }));
+    },
+    getExample: function () {
+        var _a;
+        return (_a = {}, _a[EXAMPLE_OBJECT_ID] = "status", _a);
+    },
+    getType: function () { return ({ string: "string" }); },
 };
 export var escape_phone_number = function (p) {
     if (p === void 0) { p = ''; }
     return p.replace(/[^\d+]/g, '');
 };
-export var phoneValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (phone) {
-        if (typeof phone !== "string")
-            throw new Error("Expecting phone to be string but got ".concat(phone));
-        var escaped = escape_phone_number(phone);
-        if (escaped.length < 10)
-            throw new Error("Phone number must be at least 10 digits");
-        escaped = escaped.startsWith('+') ? escaped
-            : escaped.length === 10 ? '+1' + escaped // assume US country code for now
-                : "+" + escaped; // assume country code provided, but missing leading +
-        if (!isMobilePhone(escaped, 'any', { strictMode: true })) {
-            throw "Invalid phone number";
-        }
-        return escaped;
-    }, __assign(__assign({}, options), { maxLength: 25, listOf: false }));
+export var phoneValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (phone) {
+            if (typeof phone !== "string")
+                throw new Error("Expecting phone to be string but got ".concat(phone));
+            var escaped = escape_phone_number(phone);
+            if (escaped.length < 10)
+                throw new Error("Phone number must be at least 10 digits");
+            escaped = escaped.startsWith('+') ? escaped
+                : escaped.length === 10 ? '+1' + escaped // assume US country code for now
+                    : "+" + escaped; // assume country code provided, but missing leading +
+            if (!isMobilePhone(escaped, 'any', { strictMode: true })) {
+                throw "Invalid phone number";
+            }
+            return escaped;
+        }, __assign(__assign({}, options), { maxLength: 25, listOf: false }));
+    },
+    getExample: function () { return "+15555555555"; },
+    getType: getTypeString,
 };
-export var phoneValidatorEmptyOkay = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (phone) {
-        if (typeof phone !== "string")
-            throw new Error("Expecting phone to be string but got ".concat(phone));
-        var escaped = escape_phone_number(phone);
-        if (escaped.length < 10)
-            throw new Error("Phone number must be at least 10 digits");
-        escaped = escaped.startsWith('+') ? escaped
-            : escaped.length === 10 ? '+1' + escaped // assume US country code for now
-                : "+" + escaped; // assume country code provided, but missing leading +
-        if (!isMobilePhone(escaped, 'any', { strictMode: true })) {
-            throw "Invalid phone number";
-        }
-        return escaped;
-    }, __assign(__assign({}, options), { maxLength: 25, listOf: false, emptyStringOk: true }));
+export var phoneValidatorOptional = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (phone) {
+            if (typeof phone !== "string")
+                throw new Error("Expecting phone to be string but got ".concat(phone));
+            var escaped = escape_phone_number(phone);
+            if (escaped.length < 10)
+                throw new Error("Phone number must be at least 10 digits");
+            escaped = escaped.startsWith('+') ? escaped
+                : escaped.length === 10 ? '+1' + escaped // assume US country code for now
+                    : "+" + escaped; // assume country code provided, but missing leading +
+            if (!isMobilePhone(escaped, 'any', { strictMode: true })) {
+                throw "Invalid phone number";
+            }
+            return escaped;
+        }, __assign(__assign({}, options), { maxLength: 25, listOf: false, isOptional: true, emptyStringOk: true }));
+    },
+    getExample: function () { return "+15555555555"; },
+    getType: getTypeString,
 };
-export var fileTypeValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (s) {
-        if (typeof s !== 'string')
-            throw new Error("fileType must be a string");
-        if (!isMimeType(s))
-            throw new Error("".concat(s, " is not a valid file type"));
-        return s;
-    }, __assign(__assign({}, options), { listOf: false }));
-};
-export var urlValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (s) {
-        if (typeof s !== 'string')
-            throw new Error("URL must be a string");
-        if (!isURL(s))
-            throw new Error("".concat(s, " is not a valid URL"));
-        return s;
-    }, __assign(__assign({}, options), { listOf: false }));
-};
-export var safeBase64Validator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (sb64) {
-        if (typeof sb64 !== 'string')
-            throw new Error("Expecting string");
-        // https://stackoverflow.com/questions/12930007/how-to-validate-base64-string-using-regex-in-javascript
-        // regex with = + and / replaced as get_random_base64_URL_safe 
-        if (!/^(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-]{2}..|[A-Za-z0-9_-]{3}.)?$/.test(sb64)) {
-            throw "Invalid safe base64";
-        }
-        return sb64;
-    }, __assign(__assign({}, options), { listOf: false }));
+export var fileTypeValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (s) {
+            if (typeof s !== 'string')
+                throw new Error("fileType must be a string");
+            if (!isMimeType(s))
+                throw new Error("".concat(s, " is not a valid file type"));
+            return s;
+        }, __assign(__assign({}, options), { listOf: false }));
+    },
+    getExample: function () { return 'text/plain'; },
+    getType: getTypeString,
 };
-export var subdomainValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (subdomain) {
-        if (typeof subdomain !== 'string')
-            throw new Error("Expecting string value");
-        subdomain = subdomain.toLowerCase();
-        if (subdomain.startsWith('-')) {
-            subdomain = subdomain.substring(1);
-        }
-        while (subdomain.endsWith('-')) {
-            subdomain = subdomain.substring(0, subdomain.length - 1);
-        }
-        subdomain = subdomain.replace(/[^a-zA-Z\d-]/g, '');
-        return subdomain;
-    }, __assign(__assign({}, options), { maxLength: 50, listOf: false }));
+export var urlValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (s) {
+            if (typeof s !== 'string')
+                throw new Error("URL must be a string");
+            if (!isURL(s))
+                throw new Error("".concat(s, " is not a valid URL"));
+            return s;
+        }, __assign(__assign({}, options), { listOf: false }));
+    },
+    getExample: function () { return '"https://www.tellescope.com"'; },
+    getType: getTypeString,
+};
+export var safeBase64Validator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (sb64) {
+            if (typeof sb64 !== 'string')
+                throw new Error("Expecting string");
+            // https://stackoverflow.com/questions/12930007/how-to-validate-base64-string-using-regex-in-javascript
+            // regex with = + and / replaced as get_random_base64_URL_safe 
+            if (!/^(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-]{2}..|[A-Za-z0-9_-]{3}.)?$/.test(sb64)) {
+                throw "Invalid safe base64";
+            }
+            return sb64;
+        }, __assign(__assign({}, options), { listOf: false }));
+    },
+    getExample: function () { return '129vjas0fkj1234jgfmnaef'; },
+    getType: getTypeString,
+};
+export var subdomainValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (subdomain) {
+            if (typeof subdomain !== 'string')
+                throw new Error("Expecting string value");
+            subdomain = subdomain.toLowerCase();
+            if (subdomain.startsWith('-')) {
+                subdomain = subdomain.substring(1);
+            }
+            while (subdomain.endsWith('-')) {
+                subdomain = subdomain.substring(0, subdomain.length - 1);
+            }
+            subdomain = subdomain.replace(/[^a-zA-Z\d-]/g, '');
+            return subdomain;
+        }, __assign(__assign({}, options), { maxLength: 50, listOf: false }));
+    },
+    getExample: function () { return 'example'; },
+    getType: getTypeString,
 };
 // export const fileResponseValidator: EscapeBuilder<FileResponse> = (options={}) => build_validator(
 //   (file: any) => {
@@ -599,14 +863,14 @@ export var subdomainValidator = function (options) {
 //   { ...options, isObject: true, listOf: false }
 // )
 export var fileResponseValidator = objectValidator({
-    type: exactMatchValidator(['file'])(),
-    name: stringValidator({ shouldTruncate: true, maxLength: 250 }),
-    secureName: stringValidator250(),
+    type: exactMatchValidator(['file']),
+    name: stringValidator1000,
+    secureName: stringValidator250,
 });
 export var signatureResponseValidator = objectValidator({
-    type: exactMatchValidator(['signature'])(),
-    fullName: stringValidator({ maxLength: 100 }),
-    signed: booleanValidator(),
+    type: exactMatchValidator(['signature']),
+    fullName: stringValidator100,
+    signed: booleanValidator,
 });
 var DEFAULT_ENDUSER_FIELDS = [
     '_id', 'email', 'phone', 'fname', 'lname', 'journeys', 'tags', 'preference'
@@ -636,26 +900,28 @@ var _FORM_FIELD_TYPES = {
 export var FORM_FIELD_TYPES = Object.keys(_FORM_FIELD_TYPES);
 export var formFieldTypeValidator = exactMatchValidator(FORM_FIELD_TYPES);
 export var FORM_FIELD_VALIDATORS_BY_TYPE = {
-    'string': stringValidator({ maxLength: 5000, emptyStringOk: true, errorMessage: "Response must not exceed 5000 characters" }),
-    'number': numberValidator({ errorMessage: "Response must be a number" }),
-    'email': emailValidator(),
-    // @ts-ignore -- backwards compatibility with old field name for email
-    'userEmail': emailValidator(),
-    'phone': phoneValidator(),
-    'phoneNumber': phoneValidator(),
+    'string': stringValidator.validate({ maxLength: 5000, emptyStringOk: true, errorMessage: "Response must not exceed 5000 characters" }),
+    'number': numberValidator.validate({ errorMessage: "Response must be a number" }),
+    'email': emailValidator.validate(),
+    'userEmail': emailValidator.validate(),
+    'phone': phoneValidator.validate(),
+    'phoneNumber': phoneValidator.validate(),
+    "date": dateValidator.validate(),
+    "ranking": listOfStringsValidator.validate(),
+    "rating": numberValidator.validate(),
     // fileInfo: FileResponse
     'file': function (fileInfo, _, isOptional) {
         if (isOptional && (!fileInfo || object_is_empty(fileInfo))) {
             return { type: 'file', secureName: null };
         }
-        return fileResponseValidator()(fileInfo);
+        return fileResponseValidator.validate()(fileInfo);
     },
     // sigInfo: SignatureResponse
     'signature': function (sigInfo, _, isOptional) {
         if (isOptional && (!sigInfo || object_is_empty(sigInfo))) {
             return { type: 'signature', signed: null };
         }
-        return signatureResponseValidator()(sigInfo);
+        return signatureResponseValidator.validate()(sigInfo);
     },
     // choiceInfo: { indexes: [], otherText?: string }  
     'multiple_choice': function (choiceInfo, fieldOptions, isOptional) {
@@ -684,81 +950,86 @@ export var FORM_FIELD_VALIDATORS_BY_TYPE = {
         return parsed;
     },
 };
-export var fieldsValidator = function (options) {
-    if (options === void 0) { options = {}; }
-    return build_validator(function (fields) {
-        if (!is_object(fields))
-            throw new Error("Expecting an object");
-        for (var k in fields) {
-            if (DEFAULT_ENDUSER_FIELDS.includes(k))
-                throw new Error("key ".concat(k, " conflicts with a built-in field."));
-            if (k.startsWith('_'))
-                throw new Error("Fields that start with '_' are not allowed");
-            if (is_whitespace(k)) {
-                delete fields[k];
-                continue;
-            }
-            if (k.length > 32)
-                throw new Error("key ".concat(k, " is greater than 32 characters"));
-            var val = fields[k];
-            if (typeof val === 'string') {
-                if (val.length > 512)
-                    fields[k] = val.substring(0, 512);
-                continue;
-            }
-            else if (typeof val === 'number' || val === null || typeof val === 'boolean') {
-                continue; // nothing to restrict on number type yet
-            }
-            else if (typeof val === 'object') {
-                if (JSON.stringify(val).length > 1024)
-                    throw new Error("object value for key ".concat(k, " exceeds the maximum length of 1024 characters in string representation"));
-                // previous restricted structure for fields object
-                // try {
-                //   if (val.type && typeof val.type === 'string') { // form responses can be stored as custom fields (form responses is simple array)
-                //     FORM_FIELD_VALIDATORS_BY_TYPE[val.type as keyof typeof FORM_FIELD_VALIDATORS_BY_TYPE](val, undefined as never, undefined as never)
-                //     continue
-                //   }
-                //   if (val.length && typeof val.length === 'number') { // array of strings is ok too, (inclusive of multiple-choice responses)
-                //     if (val.find((s: any) => typeof s !== 'string') !== undefined) {
-                //       throw new Error('List must contain only strings')
-                //     }
-                //     continue 
-                //   }
-                //   if (val.value === undefined) throw new Error(`value field is undefined for key ${k}`)
-                //   if (JSON.stringify(val).length > 1024) throw new Error(`object value for key ${k} exceeds the maximum length of 1024 characters in string representation`)
-                //   const escaped = { value: val.value } as Indexable // create new object to omit unrecognized fields
-                //   escaped.title = val.title // optional
-                //   escaped.description = val.description // optional
-                //   fields[k] = escaped
-                // } catch(err) {
-                //   throw new Error(`object value is invalid JSON for key ${k}`)
-                // }
-            }
-            else {
-                throw new Error("Expecting value to be a string or object but got ".concat(typeof val, " for key {k}"));
+export var fieldsValidator = {
+    validate: function (options) {
+        if (options === void 0) { options = {}; }
+        return build_validator(function (fields) {
+            if (!is_object(fields))
+                throw new Error("Expecting an object");
+            for (var k in fields) {
+                if (DEFAULT_ENDUSER_FIELDS.includes(k))
+                    throw new Error("key ".concat(k, " conflicts with a built-in field."));
+                if (k.startsWith('_'))
+                    throw new Error("Fields that start with '_' are not allowed");
+                if (is_whitespace(k)) {
+                    delete fields[k];
+                    continue;
+                }
+                if (k.length > 32)
+                    throw new Error("key ".concat(k, " is greater than 32 characters"));
+                var val = fields[k];
+                if (typeof val === 'string') {
+                    if (val.length > 512)
+                        fields[k] = val.substring(0, 512);
+                    continue;
+                }
+                else if (typeof val === 'number' || val === null || typeof val === 'boolean') {
+                    continue; // nothing to restrict on number type yet
+                }
+                else if (typeof val === 'object') {
+                    if (JSON.stringify(val).length > 1024)
+                        throw new Error("object value for key ".concat(k, " exceeds the maximum length of 1024 characters in string representation"));
+                    // previous restricted structure for fields object
+                    // try {
+                    //   if (val.type && typeof val.type === 'string') { // form responses can be stored as custom fields (form responses is simple array)
+                    //     FORM_FIELD_VALIDATORS_BY_TYPE[val.type as keyof typeof FORM_FIELD_VALIDATORS_BY_TYPE](val, undefined as never, undefined as never)
+                    //     continue
+                    //   }
+                    //   if (val.length && typeof val.length === 'number') { // array of strings is ok too, (inclusive of multiple-choice responses)
+                    //     if (val.find((s: any) => typeof s !== 'string') !== undefined) {
+                    //       throw new Error('List must contain only strings')
+                    //     }
+                    //     continue 
+                    //   }
+                    //   if (val.value === undefined) throw new Error(`value field is undefined for key ${k}`)
+                    //   if (JSON.stringify(val).length > 1024) throw new Error(`object value for key ${k} exceeds the maximum length of 1024 characters in string representation`)
+                    //   const escaped = { value: val.value } as Indexable // create new object to omit unrecognized fields
+                    //   escaped.title = val.title // optional
+                    //   escaped.description = val.description // optional
+                    //   fields[k] = escaped
+                    // } catch(err) {
+                    //   throw new Error(`object value is invalid JSON for key ${k}`)
+                    // }
+                }
+                else {
+                    throw new Error("Expecting value to be a string or object but got ".concat(typeof val, " for key {k}"));
+                }
             }
-        }
-        return fields;
-    }, __assign(__assign({}, options), { isObject: true, listOf: false }));
+            return fields;
+        }, __assign(__assign({}, options), { isObject: true, listOf: false }));
+    },
+    getExample: function () { return "{}"; },
+    getType: function () { return "{}"; },
 };
 export var preferenceValidator = exactMatchValidator(['email', 'sms', 'call', 'chat']);
 export var updateOptionsValidator = objectValidator({
-    replaceObjectFields: booleanValidator({ isOptional: true }),
-});
+    replaceObjectFields: booleanValidatorOptional,
+}, { isOptional: true });
 export var journeyStatePriorityValidator = exactMatchValidator(["Disengaged", "N/A", "Engaged"]);
 export var journeyStateValidator = objectValidator({
-    name: stringValidator100(),
-    priority: journeyStatePriorityValidator(),
-    description: stringValidator({ isOptional: true }),
-    requiresFollowup: booleanValidator({ isOptional: true }),
+    name: stringValidator100,
+    priority: journeyStatePriorityValidator,
+    description: stringValidatorOptional,
+    requiresFollowup: booleanValidatorOptional, // deprecated
 });
-export var journeyStateUpdateValidator = objectValidator({
-    name: stringValidator100({ isOptional: true }),
-    priority: journeyStatePriorityValidator({ isOptional: true }),
-    description: stringValidator({ isOptional: true }),
-    requiresFollowup: booleanValidator({ isOptional: true }),
-});
-export var journeyStatesValidator = listValidator(journeyStateValidator());
+// deprecated
+// export const journeyStateUpdateValidator = objectValidator<JourneyState>({
+//   name: stringValidator100({ isOptional: true }),
+//   priority: journeyStatePriorityValidator({ isOptional: true }),
+//   description: stringValidator({ isOptional: true }),
+//   requiresFollowup: booleanValidator({ isOptional: true }),
+// })
+export var journeyStatesValidator = listValidator(journeyStateValidator);
 export var emailEncodingValidator = exactMatchValidator(['', 'base64']);
 export var validateIndexable = function (keyValidator, valueValidator) { return function (o) { return build_validator(function (v) {
     if (!is_object(v))
@@ -769,18 +1040,26 @@ export var validateIndexable = function (keyValidator, valueValidator) { return
     }
     return validated;
 }, __assign(__assign({}, o), { isObject: true, listOf: false })); }; };
-export var indexableValidator = function (keyValidator, valueValidator) { return (validateIndexable(keyValidator, valueValidator)); };
-export var indexableNumberValidator = function (keyValidator, valueValidator) { return (validateIndexable(keyValidator, valueValidator)); };
+export var indexableValidator = function (keyValidator, valueValidator) { return ({
+    validate: validateIndexable(keyValidator.validate(), valueValidator.validate()),
+    getExample: function () { return "{ ".concat(keyValidator.getExample(), ": ").concat(valueValidator.getExample(), " }"); },
+    getType: function () { return "{ ".concat(keyValidator.getType(), ": ").concat(valueValidator.getType(), " }"); },
+}); };
+export var indexableNumberValidator = function (keyValidator, valueValidator) { return ({
+    validate: validateIndexable(keyValidator.validate(), valueValidator.validate()),
+    getExample: function () { return "{ ".concat(keyValidator.getExample(), ": ").concat(valueValidator.getExample(), " }"); },
+    getType: function () { return "{ ".concat(keyValidator.getType(), ": ").concat(valueValidator.getType(), " }"); },
+}); };
 export var rejectionWithMessage = function (o) { return build_validator(function (v) { throw new Error((o === null || o === void 0 ? void 0 : o.errorMessage) || 'This field is not valid'); }, __assign(__assign({}, o), { isOptional: true, listOf: false })); };
-export var numberToDateValidator = indexableNumberValidator(numberValidator(), dateValidator());
-export var idStringToDateValidator = indexableValidator(mongoIdStringValidator(), dateValidator());
+export var numberToDateValidator = indexableNumberValidator(numberValidator, dateValidator);
+export var idStringToDateValidator = indexableValidator(mongoIdStringRequired, dateValidator);
 // todo: move preference to FIELD_TYPES with drop-down option in user-facing forms
 var FIELD_TYPES = ['string', 'number', 'email', 'phone', 'multiple_choice', 'file', 'signature'];
 var VALIDATE_OPTIONS_FOR_FIELD_TYPES = {
     'multiple_choice': {
-        choices: listOfStringsValidator({ maxLength: 100, errorMessage: "Multiple choice options must be under 100 characters, and you must have at least one option." }),
-        radio: booleanValidator({ errorMessage: "radio must be a boolean" }),
-        other: booleanValidator({ isOptional: true, errorMessage: "other must be a boolean" }),
+        choices: listOfStringsValidator,
+        radio: booleanValidator,
+        other: booleanValidatorOptional,
         REQUIRED: ['choices', 'radio'],
     }
 };
@@ -823,17 +1102,17 @@ var isFormField = function (f, fieldOptions) {
     if (!forUpdate && !field.type)
         throw "field.type is required"; // fieldName otherwise given as 'field' in validation for every subfield
     if (field.type)
-        exactMatchValidator(FIELD_TYPES)(field.type);
+        exactMatchValidator(FIELD_TYPES).validate(field.type);
     if (!forUpdate && !field.title)
         throw "field.title is required"; // fieldName otherwise given as 'field' in validation for every subfield
     if (field.title) {
-        field.title = stringValidator({
+        field.title = stringValidator.validate({
             maxLength: 100,
             errorMessage: "field title is required and must not exceed 100 characters"
         })(field.title);
     }
     if (!forUpdate || field.description !== undefined) { // don't overwrite description on update with ''
-        field.description = stringValidator({
+        field.description = stringValidator.validate({
             isOptional: true,
             maxLength: 500,
             errorMessage: "field description must be under 500 characters"
@@ -857,7 +1136,7 @@ var isFormField = function (f, fieldOptions) {
             if (validators[k] === undefined) {
                 throw new Error("Got unexpected option ".concat(k, " for field of type ").concat(INTERNAL_NAME_TO_DISPLAY_FIELD[field.type] || 'Text'));
             }
-            field.options[k] = validators[k](field.options[k]);
+            field.options[k] = validators[k].validate(field.options[k]);
         }
     }
     if (field.intakeField !== undefined) { // allow null to unset intake
@@ -874,58 +1153,59 @@ var isFormField = function (f, fieldOptions) {
 // validate optional vs not at endpoint-level
 export var formResponseAnswerValidator = orValidator({
     email: objectValidator({
-        type: exactMatchValidator(['email'])(),
-        value: emailValidator({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['email']),
+        value: emailValidatorOptional,
+    }),
     number: objectValidator({
-        type: exactMatchValidator(['number'])(),
-        value: numberValidator({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['number']),
+        value: numberValidatorOptional,
+    }),
     rating: objectValidator({
-        type: exactMatchValidator(['rating'])(),
-        value: numberValidator({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['rating']),
+        value: numberValidatorOptional,
+    }),
     phone: objectValidator({
-        type: exactMatchValidator(['phone'])(),
-        value: phoneValidator({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['phone']),
+        value: phoneValidatorOptional,
+    }),
     string: objectValidator({
-        type: exactMatchValidator(['string'])(),
-        value: stringValidator5000({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['string']),
+        value: stringValidator5000Optional,
+    }),
     date: objectValidator({
-        type: exactMatchValidator(['date'])(),
-        value: dateValidator({ isOptional: true, emptyStringOk: true }),
-    })(),
+        type: exactMatchValidator(['date']),
+        value: dateValidatorOptional,
+    }),
     file: objectValidator({
-        type: exactMatchValidator(['file'])(),
+        type: exactMatchValidator(['file']),
         value: objectValidator({
-            name: stringValidator5000(),
-            secureName: stringValidator250(),
-        }, { emptyOk: false })({ isOptional: true }),
-    })(),
+            name: stringValidator5000,
+            secureName: stringValidator250,
+        }, { emptyOk: false, isOptional: true }),
+    }),
     multiple_choice: objectValidator({
-        type: exactMatchValidator(['multiple_choice'])(),
-        value: listOfStringsValidator({ isOptional: true, emptyListOk: true }),
-    })(),
+        type: exactMatchValidator(['multiple_choice']),
+        value: listOfStringsValidatorEmptyOk,
+    }),
     ranking: objectValidator({
-        type: exactMatchValidator(['ranking'])(),
-        value: listOfStringsValidator({ isOptional: true, emptyListOk: true }),
-    })(),
+        type: exactMatchValidator(['ranking']),
+        value: listOfStringsValidatorOptionalOrEmptyOk,
+    }),
     signature: objectValidator({
-        type: exactMatchValidator(['signature'])(),
+        type: exactMatchValidator(['signature']),
         value: objectValidator({
-            fullName: stringValidator250(),
-            signed: booleanValidator(),
-        }, { emptyOk: false })({ isOptional: true }),
-    })(),
+            fullName: stringValidator250,
+            signed: booleanValidator,
+        }, { emptyOk: false, isOptional: true }),
+    }),
 });
 export var formResponseValidator = objectValidator({
     fieldId: mongoIdStringRequired,
-    fieldTitle: stringValidator5000(),
-    answer: formResponseAnswerValidator(),
+    fieldTitle: stringValidator5000,
+    fieldDescription: stringValidator5000Optional,
+    answer: formResponseAnswerValidator,
 });
-export var formResponsesValidator = listValidator(formResponseValidator());
+export var formResponsesValidator = listValidator(formResponseValidator);
 export var intakePhoneValidator = exactMatchValidator(['optional', 'required']);
 export var formFieldValidator = function (options, fieldOptions) {
     if (options === void 0) { options = {}; }
@@ -977,10 +1257,10 @@ var _CUD = {
 export var CUD = Object.keys(_CUD);
 export var CUDStringValidator = exactMatchValidator(CUD);
 export var CUDValidator = objectValidator({
-    create: booleanValidator({ isOptional: true }),
-    update: booleanValidator({ isOptional: true }),
-    delete: booleanValidator({ isOptional: true }),
-});
+    create: booleanValidatorOptional,
+    update: booleanValidatorOptional,
+    delete: booleanValidatorOptional,
+}, { isOptional: true });
 var _UNIT_OF_TIME = {
     Days: '',
     Hours: '',
@@ -991,58 +1271,58 @@ export var UNITS_OF_TIME = Object.keys(_UNIT_OF_TIME);
 export var UnitOfTimeValidator = exactMatchValidator(UNITS_OF_TIME);
 var WebhookSubscriptionValidatorObject = {};
 for (var model in WEBHOOK_MODELS) {
-    WebhookSubscriptionValidatorObject[model] = CUDValidator({ listOf: false, isOptional: true });
+    WebhookSubscriptionValidatorObject[model] = CUDValidator;
 }
 export var WebhookSubscriptionValidator = objectValidator(WebhookSubscriptionValidatorObject, { throwOnUnrecognizedField: true });
 export var sessionTypeValidator = exactMatchValidator(['user', 'enduser']);
 export var listOfDisplayNameInfo = listValidator(objectValidator({
-    fname: nameValidator(),
-    lname: nameValidator(),
-    id: listOfMongoIdStringValidator(),
-})());
+    fname: nameValidator,
+    lname: nameValidator,
+    id: listOfMongoIdStringValidator,
+}));
 export var attendeeInfoValidator = objectValidator({
-    AttendeeId: stringValidator(),
-    ExternalUserId: mongoIdStringValidator(),
-    JoinToken: stringValidator(),
+    AttendeeId: stringValidator,
+    ExternalUserId: mongoIdStringRequired,
+    JoinToken: stringValidator,
 });
 export var attendeeValidator = objectValidator({
-    type: sessionTypeValidator(),
-    id: mongoIdStringValidator(),
-    info: attendeeInfoValidator(),
+    type: sessionTypeValidator,
+    id: mongoIdStringRequired,
+    info: attendeeInfoValidator,
 });
-export var listOfAttendeesValidator = listValidator(attendeeValidator());
+export var listOfAttendeesValidator = listValidator(attendeeValidator);
 export var meetingInfoValidator = objectValidator({
-    Meeting: objectAnyFieldsAnyValuesValidator(),
+    Meeting: objectAnyFieldsAnyValuesValidator,
 });
 export var userIdentityValidator = objectValidator({
-    type: sessionTypeValidator(),
-    id: mongoIdStringValidator(),
+    type: sessionTypeValidator,
+    id: mongoIdStringRequired,
 });
-export var listOfUserIndentitiesValidator = listValidator(userIdentityValidator());
+export var listOfUserIndentitiesValidator = listValidator(userIdentityValidator);
 export var chatAttachmentValidator = objectValidator({
-    type: exactMatchValidator(['image', 'video', 'file'])(),
-    secureName: stringValidator250(),
+    type: exactMatchValidator(['image', 'video', 'file']),
+    secureName: stringValidator250,
 });
-export var listOfChatAttachmentsValidator = listValidatorEmptyOk(chatAttachmentValidator());
+export var listOfChatAttachmentsValidator = listValidatorEmptyOk(chatAttachmentValidator);
 export var meetingsListValidator = listValidator(objectValidator({
-    id: mongoIdStringValidator(),
-    updatedAt: stringValidator(),
-    status: meetingStatusValidator(),
-})());
+    id: mongoIdStringRequired,
+    updatedAt: stringValidator,
+    status: meetingStatusValidator,
+}));
 export var userDisplayInfoValidator = objectValidator({
-    id: mongoIdRequired,
-    createdAt: dateValidator(),
-    avatar: stringValidator(),
-    fname: nameValidator(),
-    lname: nameValidator(),
-    lastActive: dateValidator(),
-    lastLogout: dateValidator(),
-    email: emailValidator(),
+    id: mongoIdStringRequired,
+    createdAt: dateValidator,
+    avatar: stringValidator,
+    fname: nameValidator,
+    lname: nameValidator,
+    lastActive: dateValidator,
+    lastLogout: dateValidator,
+    email: emailValidator,
 });
-export var meetingDisplayInfoValidator = indexableValidator(mongoIdStringRequired, userDisplayInfoValidator());
+export var meetingDisplayInfoValidator = indexableValidator(mongoIdStringRequired, userDisplayInfoValidator);
 export var chatRoomUserInfoValidator = objectAnyFieldsValidator(objectValidator({
-    unreadCount: nonNegNumberValidator(),
-})());
+    unreadCount: nonNegNumberValidator,
+}));
 var _AUTOMATION_ENDUSER_STATUS = {
     active: '',
     finished: '',
@@ -1077,129 +1357,136 @@ var _MESSAGE_TEMPLATE_MODES = {
 export var MESSAGE_TEMPLATE_MODES = Object.keys(_MESSAGE_TEMPLATE_MODES);
 export var messageTemplateModeValidator = exactMatchValidator(MESSAGE_TEMPLATE_MODES);
 var sharedReminderValidators = {
-    msBeforeStartTime: nonNegNumberValidator(),
-    didRemind: booleanValidator({ isOptional: true }),
+    msBeforeStartTime: nonNegNumberValidator,
+    didRemind: booleanValidatorOptional,
 };
 export var calendarEventReminderValidator = orValidator({
-    webhook: objectValidator(__assign({ info: objectValidator({}, { emptyOk: true })({ isOptional: true }), type: exactMatchValidator(['webhook'])() }, sharedReminderValidators))(),
+    webhook: objectValidator(__assign({ info: objectValidator({}, { emptyOk: true, isOptional: true }), type: exactMatchValidator(['webhook']) }, sharedReminderValidators)),
     'add-to-journey': objectValidator(__assign({ info: objectValidator({
-            journeyId: mongoIdRequired,
-        })(), type: exactMatchValidator(['add-to-journey'])() }, sharedReminderValidators))(),
+            journeyId: mongoIdStringRequired,
+        }), type: exactMatchValidator(['add-to-journey']) }, sharedReminderValidators)),
     "enduser-notification": objectValidator(__assign({ info: objectValidator({
-            templateId: mongoIdOptional,
-        }, { emptyOk: true })(), type: exactMatchValidator(['enduser-notification'])() }, sharedReminderValidators))(),
+            templateId: mongoIdStringOptional,
+        }, { emptyOk: true }), type: exactMatchValidator(['enduser-notification']) }, sharedReminderValidators)),
     "user-notification": objectValidator(__assign({ info: objectValidator({
-            templateId: mongoIdOptional,
-        }, { emptyOk: true })(), type: exactMatchValidator(['user-notification'])() }, sharedReminderValidators))(),
+            templateId: mongoIdStringOptional,
+        }, { emptyOk: true }), type: exactMatchValidator(['user-notification']) }, sharedReminderValidators)),
 });
-export var listOfCalendarEventRemindersValidator = listValidatorEmptyOk(calendarEventReminderValidator());
+export var listOfCalendarEventRemindersValidator = listValidatorEmptyOk(calendarEventReminderValidator);
 export var cancelConditionsValidator = listOfObjectsValidator({
-    type: exactMatchValidator(['formResponse'])(),
+    type: exactMatchValidator(['formResponse']),
     info: objectValidator({
         automationStepId: mongoIdStringRequired,
-    }, { emptyOk: false })(),
+    }, { emptyOk: false }),
 });
+export var cancelConditionsValidatorOptional = listValidatorOptionalOrEmptyOk(objectValidator({
+    type: exactMatchValidator(['formResponse']),
+    info: objectValidator({
+        automationStepId: mongoIdStringRequired,
+    }, { emptyOk: false }),
+}));
 var delayValidation = {
     automationStepId: mongoIdStringRequired,
-    delayInMS: nonNegNumberValidator(),
-    delay: nonNegNumberValidator(),
-    unit: UnitOfTimeValidator(),
-    cancelConditions: cancelConditionsValidator({ isOptional: true, emptyListOk: true, })
+    delayInMS: nonNegNumberValidator,
+    delay: nonNegNumberValidator,
+    unit: UnitOfTimeValidator,
+    cancelConditions: cancelConditionsValidatorOptional,
 };
 export var automationEventValidator = orValidator({
     formResponse: objectValidator({
-        type: exactMatchValidator(['formResponse'])(),
+        type: exactMatchValidator(['formResponse']),
         info: objectValidator({
-            automationStepId: mongoIdStringValidator(),
-        }, { emptyOk: false })(),
-    })(),
+            automationStepId: mongoIdStringRequired,
+        }, { emptyOk: false }),
+    }),
     afterAction: objectValidator({
-        type: exactMatchValidator(['afterAction'])(),
-        info: objectValidator(delayValidation, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['afterAction']),
+        info: objectValidator(delayValidation, { emptyOk: false }),
+    }),
     formUnsubmitted: objectValidator({
-        type: exactMatchValidator(['formUnsubmitted'])(),
-        info: objectValidator(__assign(__assign({}, delayValidation), { automationStepId: mongoIdStringRequired }), { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['formUnsubmitted']),
+        info: objectValidator(__assign(__assign({}, delayValidation), { automationStepId: mongoIdStringRequired }), { emptyOk: false }),
+    }),
     onJourneyStart: objectValidator({
-        type: exactMatchValidator(['onJourneyStart'])(),
-        info: objectValidator({}, { emptyOk: true })(),
-    })(),
+        type: exactMatchValidator(['onJourneyStart']),
+        info: objectValidator({}, { emptyOk: true }),
+    }),
     ticketCompleted: objectValidator({
-        type: exactMatchValidator(['ticketCompleted'])(),
+        type: exactMatchValidator(['ticketCompleted']),
         info: objectValidator({
             automationStepId: mongoIdStringRequired,
-            closedForReason: stringValidator({ isOptional: true }),
-        }, { emptyOk: false })(),
-    })(),
+            closedForReason: stringValidatorOptional,
+        }, { emptyOk: false }),
+    }),
 });
-export var automationEventsValidator = listValidatorEmptyOk(automationEventValidator());
+export var automationEventsValidator = listValidatorEmptyOk(automationEventValidator);
 export var automationConditionValidator = orValidator({
     atJourneyState: objectValidator({
-        type: exactMatchValidator(['atJourneyState'])(),
-        info: objectValidator({ state: stringValidator100(), journeyId: mongoIdStringRequired }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['atJourneyState']),
+        info: objectValidator({ state: stringValidator100, journeyId: mongoIdStringRequired }, { emptyOk: false }),
+    }),
 });
-export var listOfAutomationConditionsValidator = listValidatorEmptyOk(automationConditionValidator());
+export var listOfAutomationConditionsValidator = listValidatorEmptyOk(automationConditionValidator);
 var _SEND_FORM_CHANNELS = {
     Email: '',
     SMS: '',
 };
 export var SEND_FORM_CHANNELS = Object.keys(_SEND_FORM_CHANNELS);
 export var sendFormChannelValidator = exactMatchValidator(SEND_FORM_CHANNELS);
+export var sendFormChannelValidatorOptional = exactMatchValidatorOptional(SEND_FORM_CHANNELS);
 export var automationActionValidator = orValidator({
     setEnduserStatus: objectValidator({
-        type: exactMatchValidator(['setEnduserStatus'])(),
-        info: objectValidator({ status: stringValidator250() }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['setEnduserStatus']),
+        info: objectValidator({ status: stringValidator250 }, { emptyOk: false }),
+    }),
     sendEmail: objectValidator({
-        type: exactMatchValidator(['sendEmail'])(),
-        info: objectValidator({ senderId: mongoIdStringValidator(), templateId: mongoIdStringValidator() }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['sendEmail']),
+        info: objectValidator({ senderId: mongoIdStringRequired, templateId: mongoIdStringRequired }, { emptyOk: false }),
+    }),
     sendSMS: objectValidator({
-        type: exactMatchValidator(['sendSMS'])(),
-        info: objectValidator({ senderId: mongoIdStringValidator(), templateId: mongoIdStringValidator() }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['sendSMS']),
+        info: objectValidator({ senderId: mongoIdStringRequired, templateId: mongoIdStringRequired }, { emptyOk: false }),
+    }),
     sendForm: objectValidator({
-        type: exactMatchValidator(['sendForm'])(),
+        type: exactMatchValidator(['sendForm']),
         info: objectValidator({
-            senderId: mongoIdStringValidator(),
-            formId: mongoIdStringValidator(),
-            channel: sendFormChannelValidator({ isOptional: true }),
-        }, { emptyOk: false })(),
-    })(),
+            senderId: mongoIdStringRequired,
+            formId: mongoIdStringRequired,
+            channel: sendFormChannelValidatorOptional,
+        }, { emptyOk: false }),
+    }),
     createTicket: objectValidator({
-        type: exactMatchValidator(['createTicket'])(),
+        type: exactMatchValidator(['createTicket']),
         info: objectValidator({
-            title: stringValidator({ isOptional: false }),
+            title: stringValidatorOptional,
             assignmentStrategy: orValidator({
                 'care-team-random': objectValidator({
-                    type: exactMatchValidator(['care-team-random'])(),
-                    info: objectValidator({}, { emptyOk: true })(),
-                })()
-            })(),
-            closeReasons: listOfStringsValidator({ isOptional: true, emptyListOk: true }),
+                    type: exactMatchValidator(['care-team-random']),
+                    info: objectValidator({}, { emptyOk: true }),
+                })
+            }),
+            closeReasons: listOfStringsValidatorOptionalOrEmptyOk,
             defaultAssignee: mongoIdStringRequired,
-        }, { emptyOk: false })(),
-    })(),
+        }, { emptyOk: false }),
+    }),
     sendWebhook: objectValidator({
-        type: exactMatchValidator(['sendWebhook'])(),
-        info: objectValidator({ message: stringValidator5000() }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['sendWebhook']),
+        info: objectValidator({ message: stringValidator5000 }, { emptyOk: false }),
+    }),
 });
 export var relatedRecordValidator = objectValidator({
-    type: stringValidator100(),
-    id: mongoIdStringValidator(),
+    type: stringValidator100,
+    id: mongoIdStringRequired,
     creator: mongoIdStringOptional,
 });
-export var listOfRelatedRecordsValidator = listValidatorEmptyOk(relatedRecordValidator());
+export var listOfRelatedRecordsValidator = listValidatorEmptyOk(relatedRecordValidator);
 export var searchOptionsValidator = objectValidator({
-    query: stringValidator100(),
+    query: stringValidator100,
 });
 export var notificationPreferenceValidator = objectValidator({
-    email: booleanValidator({ isOptional: true }),
+    email: booleanValidatorOptional,
 });
-export var notificationPreferencesValidator = objectAnyFieldsValidator(notificationPreferenceValidator());
+export var notificationPreferencesValidator = objectAnyFieldsValidator(notificationPreferenceValidator);
 export var FHIRObservationCategoryValidator = exactMatchValidator(['vital-signs']);
 var _FHIR_OBSERVATION_STATUS_CODES = {
     "entered-in-error": '',
@@ -1214,37 +1501,37 @@ var _FHIR_OBSERVATION_STATUS_CODES = {
 export var FHIR_OBSERVATION_STATUS_CODES = Object.keys(_FHIR_OBSERVATION_STATUS_CODES);
 export var FHIRObservationStatusCodeValidator = exactMatchValidator(FHIR_OBSERVATION_STATUS_CODES);
 export var FHIRObservationValueValidator = objectValidator({
-    unit: stringValidator(),
-    value: numberValidator(),
+    unit: stringValidator,
+    value: numberValidator,
 });
 export var previousFormFieldValidator = orValidator({
     root: objectValidator({
-        type: exactMatchValidator(['root'])(),
-        info: objectValidator({}, { emptyOk: true })(),
-    })(),
+        type: exactMatchValidator(['root']),
+        info: objectValidator({}, { emptyOk: true }),
+    }),
     "after": objectValidator({
-        type: exactMatchValidator(['after'])(),
-        info: objectValidator({ fieldId: mongoIdStringRequired }, { emptyOk: false })(),
-    })(),
+        type: exactMatchValidator(['after']),
+        info: objectValidator({ fieldId: mongoIdStringRequired }, { emptyOk: false }),
+    }),
     "previousEquals": objectValidator({
-        type: exactMatchValidator(['previousEquals'])(),
+        type: exactMatchValidator(['previousEquals']),
         info: objectValidator({
             fieldId: mongoIdStringRequired,
-            equals: stringValidator250(),
-        }, { emptyOk: false })(),
-    })(),
+            equals: stringValidator250,
+        }, { emptyOk: false }),
+    }),
 });
-export var previousFormFieldsValidator = listValidatorEmptyOk(previousFormFieldValidator());
+export var previousFormFieldsValidator = listValidatorEmptyOk(previousFormFieldValidator);
 export var portalSettingsValidator = objectValidator({});
 export var organizationThemeValidator = objectValidator({
-    logoURL: stringValidator250({ isOptional: true }),
-    themeColor: stringValidator250({ isOptional: true }),
-    name: stringValidator250(),
-    subdomain: stringValidator250(),
-    businessId: mongoIdRequired,
-    faviconURL: stringValidator250(),
-    customPortalURL: stringValidator250(),
-    portalSettings: portalSettingsValidator(),
+    logoURL: stringValidatorOptional,
+    themeColor: stringValidatorOptional,
+    name: stringValidator250,
+    subdomain: stringValidator250,
+    businessId: mongoIdStringRequired,
+    faviconURL: stringValidator250,
+    customPortalURL: stringValidator250,
+    portalSettings: portalSettingsValidator,
 });
 var _MANAGED_CONTENT_RECORD_TYPES = {
     Article: '',
@@ -1253,93 +1540,97 @@ var _MANAGED_CONTENT_RECORD_TYPES = {
 };
 export var MANAGED_CONTENT_RECORD_TYPES = Object.keys(_MANAGED_CONTENT_RECORD_TYPES);
 export var managedContentRecordTypeValidator = exactMatchValidator(MANAGED_CONTENT_RECORD_TYPES);
-export var passwordValidator = function (o) { return build_validator(function (password) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    if (typeof password !== 'string') {
-        throw new Error("Password must be a string");
-    }
-    if (password.length < 8) {
-        throw new Error("Password must be at least 8 characters long");
-    }
-    if (((_b = (_a = password.match(/[a-z]/g)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) < 1 // 1 lowercase
-        || (((_d = (_c = password.match(/[A-Z]/g)) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) < 1 // 1 uppercase
-            && ((_f = (_e = password.match(/[0-9]/g)) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0) < 1 // 1 number
-            && ((_h = (_g = password.match(/[^a-zA-Z0-9]/g)) === null || _g === void 0 ? void 0 : _g.length) !== null && _h !== void 0 ? _h : 0) < 1 // 1 special character
-        )) {
-        console.error('bad password regex');
-        throw new Error('Password must included 1 uppercase letter, 1 number, or 1 symbol');
-    }
-    return password;
-}, __assign(__assign({}, o), { listOf: false, emptyStringOk: false })); };
+export var passwordValidator = {
+    getExample: getExampleString,
+    getType: getTypeString,
+    validate: (function (o) { return build_validator(function (password) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        if (typeof password !== 'string') {
+            throw new Error("Password must be a string");
+        }
+        if (password.length < 8) {
+            throw new Error("Password must be at least 8 characters long");
+        }
+        if (((_b = (_a = password.match(/[a-z]/g)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) < 1 // 1 lowercase
+            || (((_d = (_c = password.match(/[A-Z]/g)) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) < 1 // 1 uppercase
+                && ((_f = (_e = password.match(/[0-9]/g)) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0) < 1 // 1 number
+                && ((_h = (_g = password.match(/[^a-zA-Z0-9]/g)) === null || _g === void 0 ? void 0 : _g.length) !== null && _h !== void 0 ? _h : 0) < 1 // 1 special character
+            )) {
+            console.error('bad password regex');
+            throw new Error('Password must included 1 uppercase letter, 1 number, or 1 symbol');
+        }
+        return password;
+    }, __assign(__assign({}, o), { listOf: false, emptyStringOk: false })); }),
+};
 export var flowchartUIValidator = objectValidator({
-    x: numberValidator(),
-    y: numberValidator(),
+    x: numberValidator,
+    y: numberValidator,
 }, { emptyOk: true });
 export var integrationAuthenticationsValidator = objectValidator({
-    type: exactMatchValidator(['oauth2'])(),
+    type: exactMatchValidator(['oauth2']),
     info: objectValidator({
-        access_token: stringValidator250(),
-        refresh_token: stringValidator250(),
-        scope: stringValidator5000(),
-        expiry_date: nonNegNumberValidator(),
-        token_type: exactMatchValidator(['Bearer'])(),
-        state: stringValidator250({ isOptional: true }),
-        email: emailValidator({ isOptional: true }),
-    })(),
+        access_token: stringValidator250,
+        refresh_token: stringValidator250,
+        scope: stringValidator5000,
+        expiry_date: nonNegNumberValidator,
+        token_type: exactMatchValidator(['Bearer']),
+        state: stringValidatorOptional,
+        email: emailValidatorOptional,
+    }),
 });
 export var formFieldOptionsValidator = objectValidator({
-    choices: listOfStringsValidator({ isOptional: true }),
-    from: numberValidator({ isOptional: true }),
-    to: numberValidator({ isOptional: true }),
-    other: stringValidator250({ isOptional: true }),
-    radio: booleanValidator({ isOptional: true }),
+    choices: listOfStringsValidatorOptionalOrEmptyOk,
+    from: numberValidatorOptional,
+    to: numberValidatorOptional,
+    other: stringValidatorOptional,
+    radio: booleanValidatorOptional,
 });
 export var blockValidator = orValidator({
     h1: objectValidator({
-        type: exactMatchValidator(['h1'])(),
+        type: exactMatchValidator(['h1']),
         info: objectValidator({
-            text: stringValidator5000({ emptyStringOk: true }),
-        })(),
-    })(),
+            text: stringValidator5000EmptyOkay,
+        }),
+    }),
     h2: objectValidator({
-        type: exactMatchValidator(['h2'])(),
+        type: exactMatchValidator(['h2']),
         info: objectValidator({
-            text: stringValidator5000({ emptyStringOk: true }),
-        })(),
-    })(),
+            text: stringValidator5000EmptyOkay,
+        }),
+    }),
     html: objectValidator({
-        type: exactMatchValidator(['html'])(),
+        type: exactMatchValidator(['html']),
         info: objectValidator({
-            html: stringValidator25000({ emptyStringOk: true }),
-        })(),
-    })(),
+            html: stringValidator25000EmptyOkay,
+        }),
+    }),
     image: objectValidator({
-        type: exactMatchValidator(['image'])(),
+        type: exactMatchValidator(['image']),
         info: objectValidator({
-            link: stringValidator5000({ emptyStringOk: true }),
-            name: stringValidator250({ isOptional: true, emptyStringOk: true }),
-            height: nonNegNumberValidator({ isOptional: true }),
-            width: nonNegNumberValidator({ isOptional: true }),
-        })(),
-    })(),
+            link: stringValidator5000EmptyOkay,
+            name: stringValidatorOptional,
+            height: numberValidatorOptional,
+            width: numberValidatorOptional,
+        }),
+    }),
     pdf: objectValidator({
-        type: exactMatchValidator(['pdf'])(),
+        type: exactMatchValidator(['pdf']),
         info: objectValidator({
-            link: stringValidator5000({ emptyStringOk: true }),
-            name: stringValidator250({ isOptional: true, emptyStringOk: true }),
-            height: nonNegNumberValidator({ isOptional: true }),
-            width: nonNegNumberValidator({ isOptional: true }),
-        })(),
-    })(),
+            link: stringValidator5000EmptyOkay,
+            name: stringValidatorOptional,
+            height: numberValidatorOptional,
+            width: numberValidatorOptional,
+        }),
+    }),
     youtube: objectValidator({
-        type: exactMatchValidator(['youtube'])(),
+        type: exactMatchValidator(['youtube']),
         info: objectValidator({
-            link: stringValidator5000({ emptyStringOk: true }),
-            name: stringValidator250({ isOptional: true, emptyStringOk: true }),
-            height: nonNegNumberValidator({ isOptional: true }),
-            width: nonNegNumberValidator({ isOptional: true }),
-        })(),
-    })(),
+            link: stringValidator5000EmptyOkay,
+            name: stringValidatorOptional,
+            height: numberValidatorOptional,
+            width: numberValidatorOptional,
+        }),
+    }),
 });
 var _BLOCK_TYPES = {
     h1: '',
@@ -1352,7 +1643,7 @@ var _BLOCK_TYPES = {
 export var BLOCK_TYPES = Object.keys(_BLOCK_TYPES);
 export var blockTypeValidator = exactMatchValidator(BLOCK_TYPES);
 export var is_block_type = function (type) { return BLOCK_TYPES.includes(type); };
-export var blocksValidator = listValidatorEmptyOk(blockValidator());
+export var blocksValidator = listValidatorEmptyOk(blockValidator);
 var _DATABASE_RECORD_FIELD_TYPES = {
     "string-long": '',
     number: '',
@@ -1378,30 +1669,30 @@ export var is_database_record_field_type = function (type) { return DATABASE_REC
 // })
 // structure as above instead if need unique label or additional config based on type
 export var databaseFieldValidator = objectValidator({
-    type: databaseRecordFieldTypeValidator(),
-    label: stringValidator250(),
+    type: databaseRecordFieldTypeValidator,
+    label: stringValidator250,
 });
-export var databaseFieldsValidator = listValidator(databaseFieldValidator());
+export var databaseFieldsValidator = listValidator(databaseFieldValidator);
 export var databaseRecordValueValidator = orValidator({
     string: objectValidator({
-        type: exactMatchValidator(['string'])(),
-        value: stringValidator1000(),
-    })(),
+        type: exactMatchValidator(['string']),
+        value: stringValidator1000,
+    }),
     'string-long': objectValidator({
-        type: exactMatchValidator(['string-long'])(),
-        value: stringValidator5000(),
-    })(),
+        type: exactMatchValidator(['string-long']),
+        value: stringValidator5000,
+    }),
     'number': objectValidator({
-        type: exactMatchValidator(['number'])(),
-        value: numberValidator(),
-    })(),
+        type: exactMatchValidator(['number']),
+        value: numberValidator,
+    }),
 });
-export var databaseRecordValuesValidator = listValidator(databaseRecordValueValidator());
+export var databaseRecordValuesValidator = listValidator(databaseRecordValueValidator);
 export var organizationAccessValidator = objectValidator({
-    create: booleanValidator({ isOptional: true }),
-    update: booleanValidator({ isOptional: true }),
-    read: booleanValidator({ isOptional: true }),
-    delete: booleanValidator({ isOptional: true }),
+    create: booleanValidatorOptional,
+    update: booleanValidatorOptional,
+    read: booleanValidatorOptional,
+    delete: booleanValidatorOptional,
 });
 var _PORTAL_PAGES = {
     "Care Plan": true,
@@ -1413,35 +1704,41 @@ var _PORTAL_PAGES = {
 };
 export var PORTAL_PAGES = Object.keys(_PORTAL_PAGES);
 export var portalPageValidator = exactMatchValidator(PORTAL_PAGES);
+var _FORM_TYPES = {
+    note: true,
+    enduserFacing: true,
+};
+export var FORM_TYPES = Object.keys(_FORM_TYPES);
+export var formTypeValidator = exactMatchValidator(FORM_TYPES);
 export var portalBlockValidator = orValidator({
     carePlan: objectValidator({
-        type: exactMatchValidator(['carePlan'])(),
-        info: objectValidator({}, { emptyOk: true })()
-    })(),
+        type: exactMatchValidator(['carePlan']),
+        info: objectValidator({}, { emptyOk: true })
+    }),
     education: objectValidator({
-        type: exactMatchValidator(['education'])(),
-        info: objectValidator({}, { emptyOk: true })()
-    })(),
+        type: exactMatchValidator(['education']),
+        info: objectValidator({}, { emptyOk: true })
+    }),
     careTeam: objectValidator({
-        type: exactMatchValidator(['careTeam'])(),
+        type: exactMatchValidator(['careTeam']),
         info: objectValidator({
-            title: stringValidator(),
+            title: stringValidator,
             // members: listValidatorEmptyOk(
             //   objectValidator<CareTeamMemberPortalCustomizationInfo>({
             //     title: stringValidator(),
             //     role: stringValidator({ isOptional: true }),
             //   })()
             // )()
-        })()
-    })(),
+        })
+    }),
     text: objectValidator({
-        type: exactMatchValidator(['text'])(),
+        type: exactMatchValidator(['text']),
         info: objectValidator({
-            text: stringValidator5000(),
-        })()
-    })(),
+            text: stringValidator5000,
+        })
+    }),
 });
-export var portalBlocksValidator = listValidatorEmptyOk(portalBlockValidator());
+export var portalBlocksValidator = listValidatorEmptyOk(portalBlockValidator);
 var _PORTAL_BLOCK_TYPES = {
     carePlan: '',
     careTeam: '',
@@ -1454,13 +1751,13 @@ export var enduserTaskForEventValidator = objectValidator({
     id: mongoIdStringRequired,
     enduserId: mongoIdStringRequired,
 });
-export var enduserTasksForEventValidator = listValidatorEmptyOk(enduserTaskForEventValidator());
+export var enduserTasksForEventValidator = listValidatorEmptyOk(enduserTaskForEventValidator);
 export var enduserFormResponseForEventValidator = objectValidator({
     enduserId: mongoIdStringRequired,
     formId: mongoIdStringRequired,
-    accessCode: stringValidator1000(),
+    accessCode: stringValidator1000,
 });
-export var enduserFormResponsesForEventValidator = listValidatorEmptyOk(enduserFormResponseForEventValidator());
+export var enduserFormResponsesForEventValidator = listValidatorEmptyOk(enduserFormResponseForEventValidator);
 export var VALID_STATES = [
     "AK",
     "AL",
@@ -1522,21 +1819,21 @@ export var VALID_STATES = [
 ];
 export var stateValidator = exactMatchValidator(VALID_STATES);
 export var stateCredentialValidator = objectValidator({
-    expiresAt: dateValidator({ isOptional: true }),
-    state: stateValidator(),
+    expiresAt: dateValidatorOptional,
+    state: stateValidator,
 });
-export var stateCredentialsValidator = listValidatorEmptyOk(stateCredentialValidator());
+export var stateCredentialsValidator = listValidatorEmptyOk(stateCredentialValidator);
 export var availabilityBlockValidator = objectValidator({
-    durationInMinutes: nonNegNumberValidator(),
-    startTimeInMS: nonNegNumberValidator(),
+    durationInMinutes: nonNegNumberValidator,
+    startTimeInMS: nonNegNumberValidator,
     userId: mongoIdStringRequired,
 });
-export var availabilityBlocksValidator = listValidatorEmptyOk(availabilityBlockValidator());
+export var availabilityBlocksValidator = listValidatorEmptyOk(availabilityBlockValidator);
 export var weeklyAvailabilityValidator = objectValidator({
-    dayOfWeekStartingSundayIndexedByZero: nonNegNumberValidator(),
-    endTimeInMinutes: nonNegNumberValidator(),
-    startTimeInMinutes: nonNegNumberValidator(),
+    dayOfWeekStartingSundayIndexedByZero: nonNegNumberValidator,
+    endTimeInMinutes: nonNegNumberValidator,
+    startTimeInMinutes: nonNegNumberValidator,
 });
-export var weeklyAvailabilitiesValidator = listValidatorEmptyOk(weeklyAvailabilityValidator());
+export var weeklyAvailabilitiesValidator = listValidatorEmptyOk(weeklyAvailabilityValidator);
 export var timezoneValidator = exactMatchValidator(Object.keys(TIMEZONES));
 //# sourceMappingURL=validation.js.map