@warlock.js/seal 5.28.0 → 5.30.0

package/cjs/{required-methods-BOVNRtci.cjs → required-methods-DYsRO9aZ.cjs}

@@ -1,7 +1,7 @@
 let _mongez_reinforcements = require("@mongez/reinforcements");
 let _mongez_supportive_is = require("@mongez/supportive-is");
 
-//#region ../seal/src/standard-schema/json-schema.ts
+//#region ../../packages/seal/src/standard-schema/json-schema.ts
 /**
 * Apply nullable to a JSON Schema object based on the target dialect.
 *
@@ -80,7 +80,7 @@ function getRuleOptions(rules, ruleName) {
 }
 
 //#endregion
-//#region ../seal/src/config.ts
+//#region ../../packages/seal/src/config.ts
 /**
 * Global Seal configuration
 */
@@ -118,9 +118,12 @@ function resetSealConfig() {
 }
 
 //#endregion
-//#region ../seal/src/factory/validate.ts
+//#region ../../packages/seal/src/factory/validate.ts
 /**
-* Validate data against a schema
+* Validate data against a schema.
+*
+* The result narrows on `isValid`: on success `data` is the schema's
+* `Infer.Output`, on failure it is `undefined`.
 */
 const validate = async (schema, data, { context: extendedContext, ...configurations } = getSealConfig() || {}) => {
 	const context = {
@@ -141,14 +144,19 @@ const validate = async (schema, data, { context: extendedContext, ...configurati
 	};
 	const result = await schema.validate(data, context);
 	if (!result.isValid) return {
-		...result,
+		isValid: false,
+		errors: result.errors,
 		data: void 0
 	};
-	return result;
+	return {
+		isValid: true,
+		errors: result.errors,
+		data: result.data
+	};
 };
 
 //#endregion
-//#region ../seal/src/helpers/validation-helpers.ts
+//#region ../../packages/seal/src/helpers/validation-helpers.ts
 const VALID_RULE = { isValid: true };
 /**
 * Resolve a single attribute value through the full translation priority chain:
@@ -222,13 +230,13 @@ const invalidRule = (rule, context) => {
 };
 
 //#endregion
-//#region ../seal/src/helpers/is-empty-value.ts
+//#region ../../packages/seal/src/helpers/is-empty-value.ts
 function isEmptyValue(value) {
 	return (0, _mongez_supportive_is.isEmpty)(value) && !(0, _mongez_supportive_is.isObject)(value);
 }
 
 //#endregion
-//#region ../seal/src/helpers/date-helpers.ts
+//#region ../../packages/seal/src/helpers/date-helpers.ts
 /**
 * Detect if value is a date value or field name
 *
@@ -250,7 +258,7 @@ function isDateValue(value) {
 }
 
 //#endregion
-//#region ../seal/src/helpers/file.utils.ts
+//#region ../../packages/seal/src/helpers/file.utils.ts
 function resolveFileSize(size) {
 	if (typeof size === "number") return size;
 	switch (size.unit) {
@@ -281,7 +289,7 @@ function humanizeSize(sizeInBits) {
 }
 
 //#endregion
-//#region ../seal/src/helpers/get-field-value.ts
+//#region ../../packages/seal/src/helpers/get-field-value.ts
 /**
 * Get field value based on scope from rule options
 *
@@ -322,7 +330,7 @@ function getFieldValue(rule, context, fieldKey = "field") {
 }
 
 //#endregion
-//#region ../seal/src/helpers/path-helpers.ts
+//#region ../../packages/seal/src/helpers/path-helpers.ts
 /**
 * Set the key path for nested validation
 */
@@ -332,7 +340,7 @@ const setKeyPath = (path, key) => {
 };
 
 //#endregion
-//#region ../seal/src/rules/core/required.ts
+//#region ../../packages/seal/src/rules/core/required.ts
 /**
 * Required rule - value must be present and not empty
 */
@@ -362,7 +370,7 @@ const presentRule = {
 };
 
 //#endregion
-//#region ../seal/src/standard-schema/map-result.ts
+//#region ../../packages/seal/src/standard-schema/map-result.ts
 /**
 * Maps a Seal ValidationResult to a Standard Schema result shape.
 *
@@ -386,7 +394,7 @@ function mapToStandardResult(result) {
 }
 
 //#endregion
-//#region ../seal/src/validators/base-validator.ts
+//#region ../../packages/seal/src/validators/base-validator.ts
 /**
 * Base validator class - foundation for all validators
 */
@@ -797,6 +805,12 @@ var BaseValidator = class {
 	}
 	/**
 	* Define custom rule
+	*
+	* `value` is deliberately untyped: custom rules run in the rule pipeline,
+	* before a container validates its children (an object's fields are not yet
+	* validated or defaulted) and, when `firstErrorOnly` is `false` (the default
+	* is `true`), even after the type rule has failed. Typing it as the schema
+	* output would promise a shape the callback does not always receive.
 	*/
 	refine(callback) {
 		return this.addRule({
@@ -913,14 +927,27 @@ var BaseValidator = class {
 			errors: [],
 			data: null
 		};
-		const valueForRules = (isBlank ? void 0 : data) ?? this.getDefaultValue();
+		const input = isBlank ? void 0 : data;
+		let valueForRules = input ?? this.getDefaultValue();
+		const parentFilledDefault = context?.valueIsDefault === true;
+		if (parentFilledDefault) context.valueIsDefault = false;
+		const isUsableDefault = (value) => value !== void 0 && (value !== null || this.isNullable);
+		let blankMatchesDefault = false;
+		if (typeof input === "string" && input.trim() === "" && this.defaultValue !== void 0) {
+			const fallback = this.getDefaultValue();
+			if (typeof fallback === "string" && fallback.trim() === "") {
+				valueForRules = fallback;
+				blankMatchesDefault = true;
+			}
+		}
+		const usedDefault = blankMatchesDefault || input == null && isUsableDefault(valueForRules) || parentFilledDefault && isUsableDefault(input);
 		const mutatedData = this.isOptional && valueForRules === void 0 ? void 0 : await this.mutate(valueForRules, context);
 		const errors = [];
 		let isValid = true;
 		const isFirstErrorOnly = context.configurations?.firstErrorOnly ?? true;
 		const isEmpty = isEmptyValue(valueForRules);
-		const skipEmptyRules = this.isOptional ? valueForRules === void 0 : isEmpty;
-		const rulesToRun = this.requiredRule ? [this.requiredRule, ...this.rules] : this.rules;
+		const skipEmptyRules = usedDefault && isEmpty && valueForRules !== null && !this.matchesType(valueForRules) ? false : this.isOptional ? valueForRules === void 0 : isEmpty;
+		const rulesToRun = this.requiredRule && !usedDefault ? [this.requiredRule, ...this.rules] : this.rules;
 		for (const rule of rulesToRun) {
 			if ((rule.requiresValue ?? true) && skipEmptyRules) continue;
 			this.setRuleAttributesList(rule);
@@ -1043,7 +1070,7 @@ var BaseValidator = class {
 };
 
 //#endregion
-//#region ../seal/src/rules/core/equal.ts
+//#region ../../packages/seal/src/rules/core/equal.ts
 /**
 * Equal rule - value must be equal to a specific value
 */
@@ -1060,7 +1087,7 @@ const equalRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/core/forbidden.ts
+//#region ../../packages/seal/src/rules/core/forbidden.ts
 /**
 * Forbidden rule - value must not be present
 */
@@ -1074,14 +1101,16 @@ const forbiddenRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/core/union.ts
+//#region ../../packages/seal/src/rules/core/union.ts
 /**
 * Union rule - value must match at least one of the provided validators
 */
 const unionRule = {
 	name: "union",
+	requiresValue: false,
 	defaultErrorMessage: "Value must match one of the allowed types",
 	async validate(value, context) {
+		if (value === void 0) return VALID_RULE;
 		const validators = this.context.options.validators;
 		const firstErrorOnly = context.configurations?.firstErrorOnly ?? true;
 		const allErrors = [];
@@ -1099,7 +1128,7 @@ const unionRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/core/when.ts
+//#region ../../packages/seal/src/rules/core/when.ts
 /**
 * When rule - conditional validation based on another field value
 */
@@ -1129,7 +1158,7 @@ const whenRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/alpha.ts
+//#region ../../packages/seal/src/rules/string/alpha.ts
 /**
 * Alpha rule - allows only alphabetic characters
 */
@@ -1165,7 +1194,7 @@ const isNumericRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/credit-card.ts
+//#region ../../packages/seal/src/rules/string/credit-card.ts
 /**
 * Credit card rule - validates credit card number
 */
@@ -1192,7 +1221,7 @@ const isCreditCardRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/email.ts
+//#region ../../packages/seal/src/rules/string/email.ts
 /**
 * Email rule - validates email format
 */
@@ -1206,7 +1235,7 @@ const emailRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/id-formats.ts
+//#region ../../packages/seal/src/rules/string/id-formats.ts
 /**
 * Modern ID format validators — UUID, CUID, ULID, nanoid.
 *
@@ -1305,7 +1334,7 @@ const nanoidRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/ip.ts
+//#region ../../packages/seal/src/rules/string/ip.ts
 /**
 * Pure, dependency-free re-implementation of Node's `net.isIP`/`isIPv4`/`isIPv6`.
 * Mirrors the exact regex Node uses internally (lib/internal/net.js) so that
@@ -1366,7 +1395,7 @@ const ip6Rule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/matches.ts
+//#region ../../packages/seal/src/rules/string/matches.ts
 /**
 * Matches rule - value must match another field value
 */
@@ -1381,7 +1410,7 @@ const matchesRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/pattern.ts
+//#region ../../packages/seal/src/rules/string/pattern.ts
 /**
 * Pattern rule - validates against regex pattern
 */
@@ -1396,7 +1425,7 @@ const patternRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/string-comparison.ts
+//#region ../../packages/seal/src/rules/string/string-comparison.ts
 /**
 * Starts with rule
 */
@@ -1447,7 +1476,7 @@ const notContainsRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/strong-password-rule.ts
+//#region ../../packages/seal/src/rules/string/strong-password-rule.ts
 /**
 * Strong Password rule - validates password strength
 * Requirements:
@@ -1473,7 +1502,7 @@ const strongPasswordRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/url.ts
+//#region ../../packages/seal/src/rules/string/url.ts
 /**
 * URL rule - validates URL format
 */
@@ -1491,7 +1520,7 @@ const urlRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/string/without-whitespace.ts
+//#region ../../packages/seal/src/rules/string/without-whitespace.ts
 /**
 * Without whitespace rule - value must not contain whitespace
 */
@@ -1505,7 +1534,7 @@ const withoutWhitespaceRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/number/number-rules.ts
+//#region ../../packages/seal/src/rules/number/number-rules.ts
 /**
 * Min rule - value must be equal or greater than minimum
 * Supports field names with sibling scope
@@ -1695,7 +1724,7 @@ const betweenNumbersRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/length/length-rules.ts
+//#region ../../packages/seal/src/rules/length/length-rules.ts
 /**
 * Min length rule - validates minimum length
 * Works for any value with a length property (strings, arrays, etc.)
@@ -1788,7 +1817,7 @@ const wordsRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/array/array-rules.ts
+//#region ../../packages/seal/src/rules/array/array-rules.ts
 /**
 * Unique array rule - array must contain unique values
 */
@@ -1824,7 +1853,7 @@ const sortedArrayRule = {
 };
 
 //#endregion
-//#region ../seal/src/types/date-types.ts
+//#region ../../packages/seal/src/types/date-types.ts
 /**
 * Week day numbers mapping
 */
@@ -1839,7 +1868,7 @@ const WEEK_DAYS = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date.ts
+//#region ../../packages/seal/src/rules/date/date.ts
 /**
 * Date rule - validates date format
 */
@@ -2065,7 +2094,7 @@ const weekDayRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-comparison-rules.ts
+//#region ../../packages/seal/src/rules/date/date-comparison-rules.ts
 /**
 * Between dates rule - date must be between start and end dates
 */
@@ -2138,7 +2167,7 @@ const afterTodayRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-day-rules.ts
+//#region ../../packages/seal/src/rules/date/date-day-rules.ts
 /**
 * Weekend rule - date must be Saturday or Sunday
 */
@@ -2193,7 +2222,7 @@ const businessDayRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-field-comparison-rules.ts
+//#region ../../packages/seal/src/rules/date/date-field-comparison-rules.ts
 /**
 * Before field rule - date must be < given date or field
 * Smart detection: date value or field name
@@ -2267,7 +2296,7 @@ const sameAsFieldDateRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-period-rules.ts
+//#region ../../packages/seal/src/rules/date/date-period-rules.ts
 const MONTHS = {
 	1: "january",
 	2: "february",
@@ -2661,7 +2690,7 @@ const maxDayRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-relative-rules.ts
+//#region ../../packages/seal/src/rules/date/date-relative-rules.ts
 /**
 * Within days rule - date must be within X days from now (past or future)
 */
@@ -2711,7 +2740,7 @@ const withinFutureDaysRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/date/date-special-rules.ts
+//#region ../../packages/seal/src/rules/date/date-special-rules.ts
 /**
 * Birthday rule - valid birthday (not in future, reasonable age)
 */
@@ -2764,7 +2793,7 @@ const leapYearRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/file/dimensions.ts
+//#region ../../packages/seal/src/rules/file/dimensions.ts
 /**
 * Min width rule - image width validation
 */
@@ -2815,7 +2844,7 @@ const maxHeightRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/file/file-size.ts
+//#region ../../packages/seal/src/rules/file/file-size.ts
 /**
 * Max file size rule
 */
@@ -2842,7 +2871,7 @@ const minFileSizeRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/color/color-rules.ts
+//#region ../../packages/seal/src/rules/color/color-rules.ts
 /**
 * Color validation regex patterns
 */
@@ -2941,7 +2970,7 @@ const darkColorRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/required-if-rules.ts
+//#region ../../packages/seal/src/rules/conditional/required-if-rules.ts
 /**
 * Required if rule - field is required if another field equals a specific value
 * Supports both global and sibling scope
@@ -3136,7 +3165,7 @@ const requiredIfAnyNotEmptyRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/required-unless-rules.ts
+//#region ../../packages/seal/src/rules/conditional/required-unless-rules.ts
 /**
 * Required unless rule - field is required unless another field equals a specific value
 * Supports both global and sibling scope
@@ -3160,7 +3189,7 @@ const requiredUnlessRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/required-when-rule.ts
+//#region ../../packages/seal/src/rules/conditional/required-when-rule.ts
 /**
 * Required when callback returns true.
 *
@@ -3186,7 +3215,7 @@ const requiredWhenRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/required-with-rules.ts
+//#region ../../packages/seal/src/rules/conditional/required-with-rules.ts
 /**
 * Required with rule - field is required if another field is present
 * Supports both global and sibling scope
@@ -3244,7 +3273,7 @@ const requiredWithAnyRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/required-without-rules.ts
+//#region ../../packages/seal/src/rules/conditional/required-without-rules.ts
 /**
 * Required without rule - field is required if another field is missing
 * Supports both global and sibling scope
@@ -3302,7 +3331,7 @@ const requiredWithoutAnyRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/present-if-rules.ts
+//#region ../../packages/seal/src/rules/conditional/present-if-rules.ts
 /**
 * Present if rule - field must be present if another field equals a specific value
 * Supports both global and sibling scope
@@ -3392,7 +3421,7 @@ const presentIfNotInRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/present-unless-rules.ts
+//#region ../../packages/seal/src/rules/conditional/present-unless-rules.ts
 /**
 * Present unless rule - field must be present unless another field equals a specific value
 * Supports both global and sibling scope
@@ -3416,7 +3445,7 @@ const presentUnlessRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/present-with-rules.ts
+//#region ../../packages/seal/src/rules/conditional/present-with-rules.ts
 /**
 * Present with rule - field must be present if another field is present
 * Supports both global and sibling scope
@@ -3484,7 +3513,7 @@ const presentWithAnyRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/present-without-rules.ts
+//#region ../../packages/seal/src/rules/conditional/present-without-rules.ts
 /**
 * Present without rule - field must be present if another field is missing
 * Supports both global and sibling scope
@@ -3552,7 +3581,7 @@ const presentWithoutAnyRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/conditional/forbidden-if-rules.ts
+//#region ../../packages/seal/src/rules/conditional/forbidden-if-rules.ts
 /**
 * Forbidden if rule - field is forbidden if another field equals a specific value
 * Supports both global and sibling scope
@@ -3661,7 +3690,7 @@ const forbiddenIfNotInRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/enum.ts
+//#region ../../packages/seal/src/rules/common/enum.ts
 /**
 * Enum rule - value must be one of the enum values
 */
@@ -3733,7 +3762,7 @@ const notAllowedValuesRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/equals-field-rules.ts
+//#region ../../packages/seal/src/rules/common/equals-field-rules.ts
 /**
 * Equals field rule - value must equal another field's value
 * Supports both global and sibling scope
@@ -3769,7 +3798,7 @@ const notEqualsFieldRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/instanceof.ts
+//#region ../../packages/seal/src/rules/common/instanceof.ts
 /**
 * InstanceOf rule - value must be an instance of the given constructor.
 *
@@ -3787,7 +3816,7 @@ const instanceofRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/literal.ts
+//#region ../../packages/seal/src/rules/common/literal.ts
 /**
 * Literal rule - value must be strictly equal to one of the literal values.
 *
@@ -3813,7 +3842,7 @@ const literalRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/type-rules.ts
+//#region ../../packages/seal/src/rules/common/type-rules.ts
 /**
 * String rule - validates string type
 */
@@ -3919,7 +3948,7 @@ const arrayRule = {
 };
 
 //#endregion
-//#region ../seal/src/rules/common/unknown-key.ts
+//#region ../../packages/seal/src/rules/common/unknown-key.ts
 /**
 * Unknown key rule - validates that object doesn't have unknown keys
 */
@@ -3939,7 +3968,7 @@ const unknownKeyRule = {
 };
 
 //#endregion
-//#region ../seal/src/validators/methods/equality-conditional-methods.ts
+//#region ../../packages/seal/src/validators/methods/equality-conditional-methods.ts
 /**
 * Marker re-exported by the validators barrel so the dts bundler keeps this
 * module (and its `declare module` augmentation) in the bundled `.d.ts`.
@@ -4065,7 +4094,7 @@ BaseValidator.prototype.whenSibling = function(siblingField, options) {
 };
 
 //#endregion
-//#region ../seal/src/validators/methods/forbidden-methods.ts
+//#region ../../packages/seal/src/validators/methods/forbidden-methods.ts
 /**
 * Marker re-exported by the validators barrel so the dts bundler keeps this
 * module (and its `declare module` augmentation) in the bundled `.d.ts`.
@@ -4195,7 +4224,7 @@ BaseValidator.prototype.forbiddenIfNotInSibling = function(field, values, errorM
 };
 
 //#endregion
-//#region ../seal/src/validators/methods/present-methods.ts
+//#region ../../packages/seal/src/validators/methods/present-methods.ts
 /**
 * Marker re-exported by the validators barrel so the dts bundler keeps this
 * module (and its `declare module` augmentation) in the bundled `.d.ts`.
@@ -4427,7 +4456,7 @@ BaseValidator.prototype.presentWithoutAnySiblings = function(fields, errorMessag
 };
 
 //#endregion
-//#region ../seal/src/validators/methods/required-methods.ts
+//#region ../../packages/seal/src/validators/methods/required-methods.ts
 /**
 * Marker re-exported by the validators barrel so the dts bundler keeps this
 * module (and its `declare module` augmentation) in the bundled `.d.ts`.
@@ -5875,4 +5904,4 @@ Object.defineProperty(exports, 'yearRule', {
     return yearRule;
   }
 });
-//# sourceMappingURL=required-methods-BOVNRtci.cjs.map
+//# sourceMappingURL=required-methods-DYsRO9aZ.cjs.map