@warlock.js/seal 4.14.0 → 4.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/esm/index.d.mts CHANGED
@@ -91,13 +91,13 @@ import { addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, dat
91
91
  import { absMutator, booleanMutator, ceilMutator, floorMutator, numberMutator, numericMutator, roundMutator, roundNumberMutator, toFixedMutator } from "./mutators/number-mutators.mjs";
92
92
  import { jsonMutator, objectTrimMutator, stripUnknownMutator } from "./mutators/object-mutators.mjs";
93
93
  import { stringMutator } from "./mutators/scalar-mutators.mjs";
94
- import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./mutators/string-mutators.mjs";
94
+ import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./mutators/string-mutators.mjs";
95
95
  import { SealConfig, TranslateAttributeCallback, TranslateRuleCallback, configureSeal, getSealConfig, resetSealConfig } from "./config.mjs";
96
96
  import { ValidateOptions, ValidatorV, v } from "./factory/validators.mjs";
97
97
  import { validate } from "./factory/validate.mjs";
98
98
  import { PluginContext, SealPlugin, getInstalledPlugins, hasPlugin, registerPlugin, unregisterPlugin } from "./plugins/plugin-system.mjs";
99
99
  import { mapToStandardResult } from "./standard-schema/map-result.mjs";
100
- export { AnyValidator, ArrayValidator, AttributeTranslation, BaseValidator, BooleanValidator, ComputedCallback, ComputedValidator, ContextualSchemaRule, ContextualizedMutator, ContextualizedTransformer, DateValidator, DiscriminatedUnionValidator, FileSizeOption, FloatValidator, Infer, InferInput, InferInputObjectShape, InferObjectShape, InferOutput, InferOutputObjectShape, InstanceOfValidator, IntValidator, IsInputOptionalKey, IsOptionalKey, IsOutputOptionalKey, JsonSchemaResult, JsonSchemaTarget, LazyValidator, LiteralValidator, ManagedCallback, ManagedValidator, Month, Mutator, MutatorContext, NumberValidator, NumericValidator, ObjectValidator, PluginContext, PrimitiveValidator, RecordValidator, RuleResult, RuleTranslation, ScalarValidator, Schema, SchemaContext, SchemaRule, SchemaRuleOptions, SealConfig, SealPlugin, SimpleTransformerCallback, StandardJSONSchemaV1, StandardSchemaV1, StringValidator, TransformerCallback, TranslateAttributeCallback, TranslateRuleCallback, TupleValidator, UUIDVersion, UnionValidator, VALID_RULE, ValidateOptions, ValidationAttributesList, ValidationResult, ValidatorV, WEEK_DAYS, WeekDay, WhenRuleOptions, absMutator, addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, afterFieldRule, afterTodayRule, ageRule, allowedValuesRule, alphaNumericRule, alphaOnlyMutator, alphaRule, alphanumericOnlyMutator, appendMutator, applyNullable, arrayRule, base64DecodeMutator, base64EncodeMutator, beforeFieldRule, beforeHourRule, beforeMinuteRule, beforeTodayRule, betweenAgeRule, betweenDatesRule, betweenDaysRule, betweenHoursRule, betweenLengthRule, betweenMinutesRule, betweenMonthsRule, betweenNumbersRule, betweenTimesRule, betweenYearsRule, birthdayRule, booleanMutator, booleanRule, businessDayRule, camelCaseMutator, capitalizeMutator, ceilMutator, colorRule, configureSeal, containsRule, cuidRule, darkColorRule, dateMutator, dateRule, emailRule, endsWithRule, enumRule, equalRule, equalityConditionalMethodsApplied, equalsFieldRule, evenRule, flipArrayMutator, floatRule, floorMutator, forbiddenIfEmptyRule, forbiddenIfInRule, forbiddenIfNotEmptyRule, forbiddenIfNotInRule, forbiddenIfNotRule, forbiddenIfRule, forbiddenMethodsApplied, forbiddenRule, fromHourRule, fromMinuteRule, fromTodayRule, futureRule, getFieldValue, getInstalledPlugins, getRuleOptions, getSealConfig, greaterThanRule, hasPlugin, hexColorRule, hslColorRule, htmlEscapeMutator, humanizeSize, inRule, instanceofRule, intRule, invalidRule, ip4Rule, ip6Rule, ipRule, isCreditCardRule, isDateValue, isNumericRule, jsonMutator, kebabCaseMutator, leapYearRule, lengthRule, lessThanRule, lightColorRule, literalRule, lowercaseMutator, ltrimMutator, mapToStandardResult, maskMutator, matchesRule, maxAgeRule, maxDateRule, maxDayRule, maxFileSizeRule, maxHeightRule, maxLengthRule, maxMonthRule, maxRule, maxWidthRule, maxWordsRule, maxYearRule, minAgeRule, minDateRule, minDayRule, minFileSizeRule, minHeightRule, minLengthRule, minMonthRule, minRule, minWidthRule, minWordsRule, minYearRule, moduloRule, monthRule, nanoidRule, negativeRule, notAllowedValuesRule, notContainsRule, notEqualsFieldRule, numberMutator, numberRule, numericMutator, objectRule, objectTrimMutator, oddRule, padEndMutator, padStartMutator, pascalCaseMutator, pastRule, patternRule, plainObjectRule, positiveRule, prependMutator, presentIfEmptyRule, presentIfInRule, presentIfNotEmptyRule, presentIfNotInRule, presentIfRule, presentMethodsApplied, presentRule, presentUnlessRule, presentWithAllRule, presentWithAnyRule, presentWithRule, presentWithoutAllRule, presentWithoutAnyRule, presentWithoutRule, quarterRule, registerPlugin, removeEmptyArrayElementsMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, requiredIfAllEmptyRule, requiredIfAllNotEmptyRule, requiredIfAnyEmptyRule, requiredIfAnyNotEmptyRule, requiredIfEmptyRule, requiredIfInRule, requiredIfNotEmptyRule, requiredIfNotInRule, requiredIfRule, requiredMethodsApplied, requiredRule, requiredUnlessRule, requiredWhenRule, requiredWithAllRule, requiredWithAnyRule, requiredWithRule, requiredWithoutAllRule, requiredWithoutAnyRule, requiredWithoutRule, resetSealConfig, resolveFileSize, resolveTranslation, reverseArrayMutator, reverseMutator, rgbColorRule, rgbaColorRule, roundMutator, roundNumberMutator, rtrimMutator, safeHtmlMutator, sameAsFieldDateRule, scalarRule, setKeyPath, slugMutator, snakeCaseMutator, sortArrayMutator, sortedArrayRule, startsWithRule, stringMutator, stringRule, stringifyMutator, stripUnknownMutator, strongPasswordRule, titleCaseMutator, toDateOnlyMutator, toEndOfDayMutator, toEndOfMonthMutator, toEndOfYearMutator, toFixedMutator, toFormatMutator, toISOStringMutator, toStartOfDayMutator, toStartOfMonthMutator, toStartOfYearMutator, toTimeOnlyMutator, toTimestampMutator, toUTCMutator, todayRule, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, ulidRule, unescapeHtmlMutator, unionRule, uniqueArrayMutator, uniqueArrayRule, unknownKeyRule, unregisterPlugin, uppercaseMutator, urlDecodeMutator, urlEncodeMutator, urlRule, uuidRule, v, validate, weekDayRule, weekdayRule, weekdaysRule, weekendRule, whenRule, withinDaysRule, withinFutureDaysRule, withinPastDaysRule, withoutWhitespaceRule, wordsRule, wrapNullableStrict, yearRule };
100
+ export { AnyValidator, ArrayValidator, AttributeTranslation, BaseValidator, BooleanValidator, ComputedCallback, ComputedValidator, ContextualSchemaRule, ContextualizedMutator, ContextualizedTransformer, DateValidator, DiscriminatedUnionValidator, FileSizeOption, FloatValidator, Infer, InferInput, InferInputObjectShape, InferObjectShape, InferOutput, InferOutputObjectShape, InstanceOfValidator, IntValidator, IsInputOptionalKey, IsOptionalKey, IsOutputOptionalKey, JsonSchemaResult, JsonSchemaTarget, LazyValidator, LiteralValidator, ManagedCallback, ManagedValidator, Month, Mutator, MutatorContext, NumberValidator, NumericValidator, ObjectValidator, PluginContext, PrimitiveValidator, RecordValidator, RuleResult, RuleTranslation, ScalarValidator, Schema, SchemaContext, SchemaRule, SchemaRuleOptions, SealConfig, SealPlugin, SimpleTransformerCallback, StandardJSONSchemaV1, StandardSchemaV1, StringValidator, TransformerCallback, TranslateAttributeCallback, TranslateRuleCallback, TupleValidator, UUIDVersion, UnionValidator, VALID_RULE, ValidateOptions, ValidationAttributesList, ValidationResult, ValidatorV, WEEK_DAYS, WeekDay, WhenRuleOptions, absMutator, addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, afterFieldRule, afterTodayRule, ageRule, allowedValuesRule, alphaNumericRule, alphaOnlyMutator, alphaRule, alphanumericOnlyMutator, appendMutator, applyNullable, arrayRule, base64DecodeMutator, base64EncodeMutator, beforeFieldRule, beforeHourRule, beforeMinuteRule, beforeTodayRule, betweenAgeRule, betweenDatesRule, betweenDaysRule, betweenHoursRule, betweenLengthRule, betweenMinutesRule, betweenMonthsRule, betweenNumbersRule, betweenTimesRule, betweenYearsRule, birthdayRule, booleanMutator, booleanRule, businessDayRule, camelCaseMutator, capitalizeMutator, ceilMutator, colorRule, configureSeal, containsRule, cuidRule, darkColorRule, dateMutator, dateRule, emailRule, endsWithRule, enumRule, equalRule, equalityConditionalMethodsApplied, equalsFieldRule, evenRule, flipArrayMutator, floatRule, floorMutator, forbiddenIfEmptyRule, forbiddenIfInRule, forbiddenIfNotEmptyRule, forbiddenIfNotInRule, forbiddenIfNotRule, forbiddenIfRule, forbiddenMethodsApplied, forbiddenRule, fromHourRule, fromMinuteRule, fromTodayRule, futureRule, getFieldValue, getInstalledPlugins, getRuleOptions, getSealConfig, greaterThanRule, hasPlugin, hexColorRule, hslColorRule, htmlEscapeMutator, humanizeSize, inRule, instanceofRule, intRule, invalidRule, ip4Rule, ip6Rule, ipRule, isCreditCardRule, isDateValue, isNumericRule, jsonMutator, kebabCaseMutator, leapYearRule, lengthRule, lessThanRule, lightColorRule, literalRule, lowercaseMutator, ltrimMutator, mapToStandardResult, maskMutator, matchesRule, maxAgeRule, maxDateRule, maxDayRule, maxFileSizeRule, maxHeightRule, maxLengthRule, maxMonthRule, maxRule, maxWidthRule, maxWordsRule, maxYearRule, minAgeRule, minDateRule, minDayRule, minFileSizeRule, minHeightRule, minLengthRule, minMonthRule, minRule, minWidthRule, minWordsRule, minYearRule, moduloRule, monthRule, nanoidRule, negativeRule, notAllowedValuesRule, notContainsRule, notEqualsFieldRule, numberMutator, numberRule, numericMutator, objectRule, objectTrimMutator, oddRule, padEndMutator, padStartMutator, pascalCaseMutator, pastRule, patternRule, plainObjectRule, positiveRule, prependMutator, presentIfEmptyRule, presentIfInRule, presentIfNotEmptyRule, presentIfNotInRule, presentIfRule, presentMethodsApplied, presentRule, presentUnlessRule, presentWithAllRule, presentWithAnyRule, presentWithRule, presentWithoutAllRule, presentWithoutAnyRule, presentWithoutRule, quarterRule, registerPlugin, removeEmptyArrayElementsMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, requiredIfAllEmptyRule, requiredIfAllNotEmptyRule, requiredIfAnyEmptyRule, requiredIfAnyNotEmptyRule, requiredIfEmptyRule, requiredIfInRule, requiredIfNotEmptyRule, requiredIfNotInRule, requiredIfRule, requiredMethodsApplied, requiredRule, requiredUnlessRule, requiredWhenRule, requiredWithAllRule, requiredWithAnyRule, requiredWithRule, requiredWithoutAllRule, requiredWithoutAnyRule, requiredWithoutRule, resetSealConfig, resolveFileSize, resolveTranslation, reverseArrayMutator, reverseMutator, rgbColorRule, rgbaColorRule, roundMutator, roundNumberMutator, rtrimMutator, safeHtmlMutator, sameAsFieldDateRule, scalarRule, setKeyPath, slugMutator, snakeCaseMutator, sortArrayMutator, sortedArrayRule, startsWithRule, stringMutator, stringRule, stringifyMutator, stripTagsMutator, stripUnknownMutator, strongPasswordRule, titleCaseMutator, toDateOnlyMutator, toEndOfDayMutator, toEndOfMonthMutator, toEndOfYearMutator, toFixedMutator, toFormatMutator, toISOStringMutator, toStartOfDayMutator, toStartOfMonthMutator, toStartOfYearMutator, toTimeOnlyMutator, toTimestampMutator, toUTCMutator, todayRule, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, ulidRule, unescapeHtmlMutator, unionRule, uniqueArrayMutator, uniqueArrayRule, unknownKeyRule, unregisterPlugin, uppercaseMutator, urlDecodeMutator, urlEncodeMutator, urlRule, uuidRule, v, validate, weekDayRule, weekdayRule, weekdaysRule, weekendRule, whenRule, withinDaysRule, withinFutureDaysRule, withinPastDaysRule, withoutWhitespaceRule, wordsRule, wrapNullableStrict, yearRule };
101
101
  import "./validators/methods/equality-conditional-methods.mjs";
102
102
  import "./validators/methods/forbidden-methods.mjs";
103
103
  import "./validators/methods/present-methods.mjs";
package/esm/index.mjs CHANGED
@@ -16,7 +16,7 @@ import { addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, dat
16
16
  import { absMutator, booleanMutator, ceilMutator, floorMutator, numberMutator, numericMutator, roundMutator, roundNumberMutator, toFixedMutator } from "./mutators/number-mutators.mjs";
17
17
  import { jsonMutator, objectTrimMutator, stripUnknownMutator } from "./mutators/object-mutators.mjs";
18
18
  import { stringMutator } from "./mutators/scalar-mutators.mjs";
19
- import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./mutators/string-mutators.mjs";
19
+ import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./mutators/string-mutators.mjs";
20
20
  import "./mutators/index.mjs";
21
21
  import { equalRule } from "./rules/core/equal.mjs";
22
22
  import { forbiddenRule } from "./rules/core/forbidden.mjs";
@@ -93,4 +93,4 @@ import { v } from "./factory/validators.mjs";
93
93
  import "./factory/index.mjs";
94
94
  import { getInstalledPlugins, hasPlugin, registerPlugin, unregisterPlugin } from "./plugins/plugin-system.mjs";
95
95
 
96
- export { AnyValidator, ArrayValidator, BaseValidator, BooleanValidator, ComputedValidator, DateValidator, DiscriminatedUnionValidator, FloatValidator, InstanceOfValidator, IntValidator, LazyValidator, LiteralValidator, ManagedValidator, NumberValidator, NumericValidator, ObjectValidator, PrimitiveValidator, RecordValidator, ScalarValidator, StringValidator, TupleValidator, UnionValidator, VALID_RULE, WEEK_DAYS, absMutator, addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, afterFieldRule, afterTodayRule, ageRule, allowedValuesRule, alphaNumericRule, alphaOnlyMutator, alphaRule, alphanumericOnlyMutator, appendMutator, applyNullable, arrayRule, base64DecodeMutator, base64EncodeMutator, beforeFieldRule, beforeHourRule, beforeMinuteRule, beforeTodayRule, betweenAgeRule, betweenDatesRule, betweenDaysRule, betweenHoursRule, betweenLengthRule, betweenMinutesRule, betweenMonthsRule, betweenNumbersRule, betweenTimesRule, betweenYearsRule, birthdayRule, booleanMutator, booleanRule, businessDayRule, camelCaseMutator, capitalizeMutator, ceilMutator, colorRule, configureSeal, containsRule, cuidRule, darkColorRule, dateMutator, dateRule, emailRule, endsWithRule, enumRule, equalRule, equalityConditionalMethodsApplied, equalsFieldRule, evenRule, flipArrayMutator, floatRule, floorMutator, forbiddenIfEmptyRule, forbiddenIfInRule, forbiddenIfNotEmptyRule, forbiddenIfNotInRule, forbiddenIfNotRule, forbiddenIfRule, forbiddenMethodsApplied, forbiddenRule, fromHourRule, fromMinuteRule, fromTodayRule, futureRule, getFieldValue, getInstalledPlugins, getRuleOptions, getSealConfig, greaterThanRule, hasPlugin, hexColorRule, hslColorRule, htmlEscapeMutator, humanizeSize, inRule, instanceofRule, intRule, invalidRule, ip4Rule, ip6Rule, ipRule, isCreditCardRule, isDateValue, isNumericRule, jsonMutator, kebabCaseMutator, leapYearRule, lengthRule, lessThanRule, lightColorRule, literalRule, lowercaseMutator, ltrimMutator, mapToStandardResult, maskMutator, matchesRule, maxAgeRule, maxDateRule, maxDayRule, maxFileSizeRule, maxHeightRule, maxLengthRule, maxMonthRule, maxRule, maxWidthRule, maxWordsRule, maxYearRule, minAgeRule, minDateRule, minDayRule, minFileSizeRule, minHeightRule, minLengthRule, minMonthRule, minRule, minWidthRule, minWordsRule, minYearRule, moduloRule, monthRule, nanoidRule, negativeRule, notAllowedValuesRule, notContainsRule, notEqualsFieldRule, numberMutator, numberRule, numericMutator, objectRule, objectTrimMutator, oddRule, padEndMutator, padStartMutator, pascalCaseMutator, pastRule, patternRule, plainObjectRule, positiveRule, prependMutator, presentIfEmptyRule, presentIfInRule, presentIfNotEmptyRule, presentIfNotInRule, presentIfRule, presentMethodsApplied, presentRule, presentUnlessRule, presentWithAllRule, presentWithAnyRule, presentWithRule, presentWithoutAllRule, presentWithoutAnyRule, presentWithoutRule, quarterRule, registerPlugin, removeEmptyArrayElementsMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, requiredIfAllEmptyRule, requiredIfAllNotEmptyRule, requiredIfAnyEmptyRule, requiredIfAnyNotEmptyRule, requiredIfEmptyRule, requiredIfInRule, requiredIfNotEmptyRule, requiredIfNotInRule, requiredIfRule, requiredMethodsApplied, requiredRule, requiredUnlessRule, requiredWhenRule, requiredWithAllRule, requiredWithAnyRule, requiredWithRule, requiredWithoutAllRule, requiredWithoutAnyRule, requiredWithoutRule, resetSealConfig, resolveFileSize, resolveTranslation, reverseArrayMutator, reverseMutator, rgbColorRule, rgbaColorRule, roundMutator, roundNumberMutator, rtrimMutator, safeHtmlMutator, sameAsFieldDateRule, scalarRule, setKeyPath, slugMutator, snakeCaseMutator, sortArrayMutator, sortedArrayRule, startsWithRule, stringMutator, stringRule, stringifyMutator, stripUnknownMutator, strongPasswordRule, titleCaseMutator, toDateOnlyMutator, toEndOfDayMutator, toEndOfMonthMutator, toEndOfYearMutator, toFixedMutator, toFormatMutator, toISOStringMutator, toStartOfDayMutator, toStartOfMonthMutator, toStartOfYearMutator, toTimeOnlyMutator, toTimestampMutator, toUTCMutator, todayRule, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, ulidRule, unescapeHtmlMutator, unionRule, uniqueArrayMutator, uniqueArrayRule, unknownKeyRule, unregisterPlugin, uppercaseMutator, urlDecodeMutator, urlEncodeMutator, urlRule, uuidRule, v, validate, weekDayRule, weekdayRule, weekdaysRule, weekendRule, whenRule, withinDaysRule, withinFutureDaysRule, withinPastDaysRule, withoutWhitespaceRule, wordsRule, wrapNullableStrict, yearRule };
96
+ export { AnyValidator, ArrayValidator, BaseValidator, BooleanValidator, ComputedValidator, DateValidator, DiscriminatedUnionValidator, FloatValidator, InstanceOfValidator, IntValidator, LazyValidator, LiteralValidator, ManagedValidator, NumberValidator, NumericValidator, ObjectValidator, PrimitiveValidator, RecordValidator, ScalarValidator, StringValidator, TupleValidator, UnionValidator, VALID_RULE, WEEK_DAYS, absMutator, addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, afterFieldRule, afterTodayRule, ageRule, allowedValuesRule, alphaNumericRule, alphaOnlyMutator, alphaRule, alphanumericOnlyMutator, appendMutator, applyNullable, arrayRule, base64DecodeMutator, base64EncodeMutator, beforeFieldRule, beforeHourRule, beforeMinuteRule, beforeTodayRule, betweenAgeRule, betweenDatesRule, betweenDaysRule, betweenHoursRule, betweenLengthRule, betweenMinutesRule, betweenMonthsRule, betweenNumbersRule, betweenTimesRule, betweenYearsRule, birthdayRule, booleanMutator, booleanRule, businessDayRule, camelCaseMutator, capitalizeMutator, ceilMutator, colorRule, configureSeal, containsRule, cuidRule, darkColorRule, dateMutator, dateRule, emailRule, endsWithRule, enumRule, equalRule, equalityConditionalMethodsApplied, equalsFieldRule, evenRule, flipArrayMutator, floatRule, floorMutator, forbiddenIfEmptyRule, forbiddenIfInRule, forbiddenIfNotEmptyRule, forbiddenIfNotInRule, forbiddenIfNotRule, forbiddenIfRule, forbiddenMethodsApplied, forbiddenRule, fromHourRule, fromMinuteRule, fromTodayRule, futureRule, getFieldValue, getInstalledPlugins, getRuleOptions, getSealConfig, greaterThanRule, hasPlugin, hexColorRule, hslColorRule, htmlEscapeMutator, humanizeSize, inRule, instanceofRule, intRule, invalidRule, ip4Rule, ip6Rule, ipRule, isCreditCardRule, isDateValue, isNumericRule, jsonMutator, kebabCaseMutator, leapYearRule, lengthRule, lessThanRule, lightColorRule, literalRule, lowercaseMutator, ltrimMutator, mapToStandardResult, maskMutator, matchesRule, maxAgeRule, maxDateRule, maxDayRule, maxFileSizeRule, maxHeightRule, maxLengthRule, maxMonthRule, maxRule, maxWidthRule, maxWordsRule, maxYearRule, minAgeRule, minDateRule, minDayRule, minFileSizeRule, minHeightRule, minLengthRule, minMonthRule, minRule, minWidthRule, minWordsRule, minYearRule, moduloRule, monthRule, nanoidRule, negativeRule, notAllowedValuesRule, notContainsRule, notEqualsFieldRule, numberMutator, numberRule, numericMutator, objectRule, objectTrimMutator, oddRule, padEndMutator, padStartMutator, pascalCaseMutator, pastRule, patternRule, plainObjectRule, positiveRule, prependMutator, presentIfEmptyRule, presentIfInRule, presentIfNotEmptyRule, presentIfNotInRule, presentIfRule, presentMethodsApplied, presentRule, presentUnlessRule, presentWithAllRule, presentWithAnyRule, presentWithRule, presentWithoutAllRule, presentWithoutAnyRule, presentWithoutRule, quarterRule, registerPlugin, removeEmptyArrayElementsMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, requiredIfAllEmptyRule, requiredIfAllNotEmptyRule, requiredIfAnyEmptyRule, requiredIfAnyNotEmptyRule, requiredIfEmptyRule, requiredIfInRule, requiredIfNotEmptyRule, requiredIfNotInRule, requiredIfRule, requiredMethodsApplied, requiredRule, requiredUnlessRule, requiredWhenRule, requiredWithAllRule, requiredWithAnyRule, requiredWithRule, requiredWithoutAllRule, requiredWithoutAnyRule, requiredWithoutRule, resetSealConfig, resolveFileSize, resolveTranslation, reverseArrayMutator, reverseMutator, rgbColorRule, rgbaColorRule, roundMutator, roundNumberMutator, rtrimMutator, safeHtmlMutator, sameAsFieldDateRule, scalarRule, setKeyPath, slugMutator, snakeCaseMutator, sortArrayMutator, sortedArrayRule, startsWithRule, stringMutator, stringRule, stringifyMutator, stripTagsMutator, stripUnknownMutator, strongPasswordRule, titleCaseMutator, toDateOnlyMutator, toEndOfDayMutator, toEndOfMonthMutator, toEndOfYearMutator, toFixedMutator, toFormatMutator, toISOStringMutator, toStartOfDayMutator, toStartOfMonthMutator, toStartOfYearMutator, toTimeOnlyMutator, toTimestampMutator, toUTCMutator, todayRule, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, ulidRule, unescapeHtmlMutator, unionRule, uniqueArrayMutator, uniqueArrayRule, unknownKeyRule, unregisterPlugin, uppercaseMutator, urlDecodeMutator, urlEncodeMutator, urlRule, uuidRule, v, validate, weekDayRule, weekdayRule, weekdaysRule, weekendRule, whenRule, withinDaysRule, withinFutureDaysRule, withinPastDaysRule, withoutWhitespaceRule, wordsRule, wrapNullableStrict, yearRule };
@@ -3,6 +3,6 @@ import { addDaysMutator, addHoursMutator, addMonthsMutator, addYearsMutator, dat
3
3
  import { absMutator, booleanMutator, ceilMutator, floorMutator, numberMutator, numericMutator, roundMutator, roundNumberMutator, toFixedMutator } from "./number-mutators.mjs";
4
4
  import { jsonMutator, objectTrimMutator, stripUnknownMutator } from "./object-mutators.mjs";
5
5
  import { stringMutator } from "./scalar-mutators.mjs";
6
- import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./string-mutators.mjs";
6
+ import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "./string-mutators.mjs";
7
7
 
8
8
  export { };
@@ -13,7 +13,21 @@ declare const titleCaseMutator: Mutator;
13
13
  declare const stringifyMutator: Mutator;
14
14
  /** Trim whitespace */
15
15
  declare const trimMutator: Mutator;
16
- /** Remove HTML tags (safe HTML) */
16
+ /**
17
+ * Strip HTML tags with a naive `<...>` regex.
18
+ *
19
+ * This is a **tag stripper, not an XSS sanitizer**: it is not a parser, so
20
+ * malformed/nested markup, attribute payloads, or content re-introduced
21
+ * later in a pipeline can defeat it. Do not rely on this alone to make
22
+ * untrusted rich text safe to render — use a real parser-based sanitizer
23
+ * (e.g. DOMPurify / sanitize-html) for that.
24
+ */
25
+ declare const stripTagsMutator: Mutator;
26
+ /**
27
+ * @deprecated Renamed to {@link stripTagsMutator} — the old name implied
28
+ * XSS safety this tag-stripping regex does not provide. Kept as an alias
29
+ * for backward compatibility; switch to `stripTagsMutator`.
30
+ */
17
31
  declare const safeHtmlMutator: Mutator;
18
32
  /** HTML escape */
19
33
  declare const htmlEscapeMutator: Mutator;
@@ -72,5 +86,5 @@ declare const alphanumericOnlyMutator: Mutator;
72
86
  /** Remove all numeric characters */
73
87
  declare const removeNumbersMutator: Mutator;
74
88
  //#endregion
75
- export { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator };
89
+ export { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator };
76
90
  //# sourceMappingURL=string-mutators.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"string-mutators.d.mts","names":[],"sources":["../../../../../../../seal/src/mutators/string-mutators.ts"],"mappings":";;;;cAca,gBAAA,EAAkB,OAE9B;AAFD;AAAA,cAKa,gBAAA,EAAkB,OAE9B;;cAGY,iBAAA,EAAmB,OAG/B;AAXA;AAAA,cAcY,gBAAA,EAAkB,OAE9B;;cAGY,gBAAA,EAAkB,OAW9B;;cAGY,WAAA,EAAa,OAEzB;AA3BD;AAAA,cA8Ba,eAAA,EAAiB,OAE7B;;cAGY,iBAAA,EAAmB,OAQ/B;AAxCA;AAAA,cA2CY,8BAAA,EAAgC,OAE5C;;cAGY,gBAAA,EAAkB,OAE9B;;cAGY,gBAAA,EAAkB,OAE9B;AA/CD;AAAA,cAkDa,gBAAA,EAAkB,OAE9B;;cAGY,iBAAA,EAAmB,OAE/B;AA9CA;AAAA,cAiDY,gBAAA,EAAkB,OAE9B;;cAGY,gBAAA,EAAkB,OAE9B;;cAGY,WAAA,EAAa,OASzB;AA5DD;AAAA,cA+Da,YAAA,EAAc,OAE1B;;cAGY,YAAA,EAAc,OAE1B;AApEA;AAAA,cAuEY,mBAAA,EAAqB,OAEjC;;cAGY,mBAAA,EAAqB,OAEjC;;cAGY,cAAA,EAAgB,OAI5B;AAvED;AAAA,cA0Ea,iBAAA,EAAmB,OAK/B;;cAGY,aAAA,EAAe,OAG3B;AAnFA;AAAA,cAsFY,cAAA,EAAgB,OAG5B;;cAGY,cAAA,EAAgB,OAE5B;;cAGY,eAAA,EAAiB,OAK7B;AA9FD;AAAA,cAiGa,6BAAA,EAA+B,OAE3C;;cAGY,eAAA,EAAiB,OAI7B;AAxGA;AAAA,cA2GY,aAAA,EAAe,OAI3B;;cAGY,aAAA,EAAe,OAG3B;;cAGY,WAAA,EAAa,OASzB;AAzHD;AAAA,cA4Ha,mBAAA,EAAqB,OAQjC;;cAGY,gBAAA,EAAkB,OAE9B;AAvIA;AAAA,cA0IY,uBAAA,EAAyB,OAErC;;cAGY,oBAAA,EAAsB,OAElC"}
1
+ {"version":3,"file":"string-mutators.d.mts","names":[],"sources":["../../../../../../../seal/src/mutators/string-mutators.ts"],"mappings":";;;;cAca,gBAAA,EAAkB,OAE9B;AAFD;AAAA,cAKa,gBAAA,EAAkB,OAE9B;;cAGY,iBAAA,EAAmB,OAG/B;AAXA;AAAA,cAcY,gBAAA,EAAkB,OAE9B;;cAGY,gBAAA,EAAkB,OAW9B;;cAGY,WAAA,EAAa,OAEzB;AA3BD;;;;AAGC;AAGD;;;;AANA,cAsCa,gBAAA,EAAkB,OAE9B;AA7BD;;;;AAWC;AAXD,cAoCa,eAAA,EAAiB,OAA0B;;cAG3C,iBAAA,EAAmB,OAQ/B;;cAGY,8BAAA,EAAgC,OAE5C;AAzBD;AAAA,cA4Ba,gBAAA,EAAkB,OAE9B;;cAGY,gBAAA,EAAkB,OAE9B;AAjCA;AAAA,cAoCY,gBAAA,EAAkB,OAE9B;;cAGY,iBAAA,EAAmB,OAE/B;;cAGY,gBAAA,EAAkB,OAE9B;AAtCD;AAAA,cAyCa,gBAAA,EAAkB,OAE9B;;cAGY,WAAA,EAAa,OASzB;AA/CA;AAAA,cAkDY,YAAA,EAAc,OAE1B;;cAGY,YAAA,EAAc,OAE1B;;cAGY,mBAAA,EAAqB,OAEjC;AAtDD;AAAA,cAyDa,mBAAA,EAAqB,OAEjC;;cAGY,cAAA,EAAgB,OAI5B;AAhEA;AAAA,cAmEY,iBAAA,EAAmB,OAK/B;;cAGY,aAAA,EAAe,OAG3B;;cAGY,cAAA,EAAgB,OAG5B;AA5ED;AAAA,cA+Ea,cAAA,EAAgB,OAE5B;;cAGY,eAAA,EAAiB,OAK7B;AAvFA;AAAA,cA0FY,6BAAA,EAA+B,OAE3C;;cAGY,eAAA,EAAiB,OAI7B;;cAGY,aAAA,EAAe,OAI3B;AAlGD;AAAA,cAqGa,aAAA,EAAe,OAG3B;;cAGY,WAAA,EAAa,OASzB;AAlHA;AAAA,cAqHY,mBAAA,EAAqB,OAQjC;;cAGY,gBAAA,EAAkB,OAE9B;;cAGY,uBAAA,EAAyB,OAErC;AA/HD;AAAA,cAkIa,oBAAA,EAAsB,OAElC"}
@@ -28,10 +28,24 @@ const stringifyMutator = async (value) => {
28
28
  const trimMutator = async (value, context) => {
29
29
  return trim(value?.toString(), context?.options?.needle ?? " ");
30
30
  };
31
- /** Remove HTML tags (safe HTML) */
32
- const safeHtmlMutator = async (value) => {
31
+ /**
32
+ * Strip HTML tags with a naive `<...>` regex.
33
+ *
34
+ * This is a **tag stripper, not an XSS sanitizer**: it is not a parser, so
35
+ * malformed/nested markup, attribute payloads, or content re-introduced
36
+ * later in a pipeline can defeat it. Do not rely on this alone to make
37
+ * untrusted rich text safe to render — use a real parser-based sanitizer
38
+ * (e.g. DOMPurify / sanitize-html) for that.
39
+ */
40
+ const stripTagsMutator = async (value) => {
33
41
  return value?.toString().replace(/<[^>]*>?/gm, "");
34
42
  };
43
+ /**
44
+ * @deprecated Renamed to {@link stripTagsMutator} — the old name implied
45
+ * XSS safety this tag-stripping regex does not provide. Kept as an alias
46
+ * for backward compatibility; switch to `stripTagsMutator`.
47
+ */
48
+ const safeHtmlMutator = stripTagsMutator;
35
49
  /** HTML escape */
36
50
  const htmlEscapeMutator = async (value) => {
37
51
  return value?.toString().replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
@@ -165,5 +179,5 @@ const removeNumbersMutator = async (value) => {
165
179
  };
166
180
 
167
181
  //#endregion
168
- export { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator };
182
+ export { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator };
169
183
  //# sourceMappingURL=string-mutators.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"string-mutators.mjs","names":[],"sources":["../../../../../../../seal/src/mutators/string-mutators.ts"],"sourcesContent":["import {\r\n capitalize,\r\n ltrim,\r\n readMoreChars,\r\n rtrim,\r\n toCamelCase,\r\n toKebabCase,\r\n toSnakeCase,\r\n toStudlyCase,\r\n trim,\r\n} from \"@mongez/reinforcements\";\r\nimport type { Mutator } from \"../types\";\r\n\r\n/** Convert string to lowercase */\r\nexport const lowercaseMutator: Mutator = async (value) => {\r\n return value?.toString().toLowerCase();\r\n};\r\n\r\n/** Convert string to uppercase */\r\nexport const uppercaseMutator: Mutator = async (value) => {\r\n return value?.toString().toUpperCase();\r\n};\r\n\r\n/** Capitalize only the first letter of the string */\r\nexport const capitalizeMutator: Mutator = async (value) => {\r\n const str = value?.toString();\r\n return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();\r\n};\r\n\r\n/** Capitalize the first letter of each word (Title Case) */\r\nexport const titleCaseMutator: Mutator = async (value) => {\r\n return capitalize(value?.toString());\r\n};\r\n\r\n/** Convert value to string */\r\nexport const stringifyMutator: Mutator = async (value) => {\r\n if (!value && value !== 0) return \"\";\r\n // only convert numbers, boolean and strings\r\n\r\n // Handle strings (pass through)\r\n if (typeof value === \"string\") return value;\r\n\r\n // Handle scalar types (number, boolean)\r\n if (typeof value === \"number\" || typeof value === \"boolean\") {\r\n return String(value);\r\n }\r\n};\r\n\r\n/** Trim whitespace */\r\nexport const trimMutator: Mutator = async (value, context) => {\r\n return trim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/** Remove HTML tags (safe HTML) */\r\nexport const safeHtmlMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/<[^>]*>?/gm, \"\");\r\n};\r\n\r\n/** HTML escape */\r\nexport const htmlEscapeMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .replace(/&/g, \"&amp;\")\r\n .replace(/</g, \"&lt;\")\r\n .replace(/>/g, \"&gt;\")\r\n .replace(/\"/g, \"&quot;\")\r\n .replace(/'/g, \"&#039;\");\r\n};\r\n\r\n/** Remove special characters */\r\nexport const removeSpecialCharactersMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/[^a-zA-Z0-9]/g, \"\");\r\n};\r\n\r\n/** URL decode */\r\nexport const urlDecodeMutator: Mutator = async (value) => {\r\n return decodeURIComponent(value);\r\n};\r\n\r\n/** URL encode */\r\nexport const urlEncodeMutator: Mutator = async (value) => {\r\n return encodeURIComponent(value);\r\n};\r\n\r\n/** Convert to camelCase */\r\nexport const camelCaseMutator: Mutator = async (value) => {\r\n return toCamelCase(value?.toString());\r\n};\r\n\r\n/** Convert to PascalCase */\r\nexport const pascalCaseMutator: Mutator = async (value) => {\r\n return toStudlyCase(value?.toString());\r\n};\r\n\r\n/** Convert to snake_case */\r\nexport const snakeCaseMutator: Mutator = async (value) => {\r\n return toSnakeCase(value?.toString());\r\n};\r\n\r\n/** Convert to kebab-case */\r\nexport const kebabCaseMutator: Mutator = async (value) => {\r\n return toKebabCase(value?.toString());\r\n};\r\n\r\n/** Convert to URL-friendly slug */\r\nexport const slugMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .toLowerCase()\r\n .trim()\r\n .replace(/[^\\w\\s-]/g, \"\")\r\n .replace(/[\\s_]+/g, \"-\")\r\n .replace(/--+/g, \"-\")\r\n .replace(/^-+|-+$/g, \"\");\r\n};\r\n\r\n/** Trim from the left/start */\r\nexport const ltrimMutator: Mutator = async (value, context) => {\r\n return ltrim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/** Trim from the right/end */\r\nexport const rtrimMutator: Mutator = async (value, context) => {\r\n return rtrim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/** Base64 encode */\r\nexport const base64EncodeMutator: Mutator = async (value) => {\r\n return Buffer.from(value?.toString()).toString(\"base64\");\r\n};\r\n\r\n/** Base64 decode */\r\nexport const base64DecodeMutator: Mutator = async (value) => {\r\n return Buffer.from(value?.toString(), \"base64\").toString(\"utf-8\");\r\n};\r\n\r\n/** Replace substring or pattern */\r\nexport const replaceMutator: Mutator = async (value, context) => {\r\n const { search, replace } = context?.options;\r\n if (!search) return value?.toString();\r\n return value?.toString().replace(search, replace ?? \"\");\r\n};\r\n\r\n/** Replace all occurrences of substring or pattern */\r\nexport const replaceAllMutator: Mutator = async (value, context) => {\r\n const { search, replace } = context?.options;\r\n if (!search) return value?.toString();\r\n const searchValue = typeof search === \"string\" ? new RegExp(search, \"g\") : search;\r\n return value?.toString().replace(searchValue, replace ?? \"\");\r\n};\r\n\r\n/** Append/suffix text to the end */\r\nexport const appendMutator: Mutator = async (value, context) => {\r\n const suffix = context?.options?.suffix ?? \"\";\r\n return value?.toString() + suffix;\r\n};\r\n\r\n/** Prepend/prefix text to the beginning */\r\nexport const prependMutator: Mutator = async (value, context) => {\r\n const prefix = context?.options?.prefix ?? \"\";\r\n return prefix + value?.toString();\r\n};\r\n\r\n/** Reverse the string */\r\nexport const reverseMutator: Mutator = async (value) => {\r\n return value?.toString().split(\"\").reverse().join(\"\");\r\n};\r\n\r\n/** Truncate to a maximum length */\r\nexport const truncateMutator: Mutator = async (value, context) => {\r\n const str = value?.toString();\r\n const maxLength = context?.options?.maxLength ?? 100;\r\n const suffix = context?.options?.suffix ?? \"...\";\r\n return readMoreChars(str, maxLength, suffix);\r\n};\r\n\r\n/** Trim multiple whitespace into single space */\r\nexport const trimMultipleWhitespaceMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/\\s+/g, \" \");\r\n};\r\n\r\n/** Pad string from the start to reach target length */\r\nexport const padStartMutator: Mutator = async (value, context) => {\r\n const length = context?.options?.length ?? 0;\r\n const char = context?.options?.char ?? \" \";\r\n return value?.toString().padStart(length, char);\r\n};\r\n\r\n/** Pad string from the end to reach target length */\r\nexport const padEndMutator: Mutator = async (value, context) => {\r\n const length = context?.options?.length ?? 0;\r\n const char = context?.options?.char ?? \" \";\r\n return value?.toString().padEnd(length, char);\r\n};\r\n\r\n/** Repeat string N times */\r\nexport const repeatMutator: Mutator = async (value, context) => {\r\n const count = context?.options?.count ?? 1;\r\n return value?.toString()?.repeat(count);\r\n};\r\n\r\n/** Mask part of string */\r\nexport const maskMutator: Mutator = async (value, context) => {\r\n const str = value?.toString();\r\n const maskChar = context?.options?.char ?? \"*\";\r\n const start = context?.options?.start ?? 0;\r\n const end = context?.options?.end ?? str?.length;\r\n const visibleStart = str?.substring(0, start);\r\n const visibleEnd = str?.substring(end);\r\n const maskedLength = end - start;\r\n return visibleStart + maskChar.repeat(maskedLength) + visibleEnd;\r\n};\r\n\r\n/** Unescape HTML entities */\r\nexport const unescapeHtmlMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .replace(/&amp;/g, \"&\")\r\n .replace(/&lt;/g, \"<\")\r\n .replace(/&gt;/g, \">\")\r\n .replace(/&quot;/g, '\"')\r\n .replace(/&#039;/g, \"'\");\r\n};\r\n\r\n/** Keep only alphabetic characters */\r\nexport const alphaOnlyMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[^a-zA-Z]/g, \"\");\r\n};\r\n\r\n/** Keep only alphanumeric characters */\r\nexport const alphanumericOnlyMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[^a-zA-Z0-9]/g, \"\");\r\n};\r\n\r\n/** Remove all numeric characters */\r\nexport const removeNumbersMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[0-9]/g, \"\");\r\n};\r\n"],"mappings":";;;;AAcA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,OAAO,SAAS,CAAC,CAAC,YAAY;AACvC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,OAAO,SAAS,CAAC,CAAC,YAAY;AACvC;;AAGA,MAAa,oBAA6B,OAAO,UAAU;CACzD,MAAM,MAAM,OAAO,SAAS;CAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY;AAChE;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,WAAW,OAAO,SAAS,CAAC;AACrC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,IAAI,CAAC,SAAS,UAAU,GAAG,OAAO;CAIlC,IAAI,OAAO,UAAU,UAAU,OAAO;CAGtC,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,WAChD,OAAO,OAAO,KAAK;AAEvB;;AAGA,MAAa,cAAuB,OAAO,OAAO,YAAY;CAC5D,OAAO,KAAK,OAAO,SAAS,GAAG,SAAS,SAAS,UAAU,GAAG;AAChE;;AAGA,MAAa,kBAA2B,OAAO,UAAU;CACvD,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,cAAc,EAAE;AACnD;;AAGA,MAAa,oBAA6B,OAAO,UAAU;CACzD,OAAO,OACH,SAAS,CAAC,CACX,QAAQ,MAAM,OAAO,CAAC,CACtB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,QAAQ,CAAC,CACvB,QAAQ,MAAM,QAAQ;AAC3B;;AAGA,MAAa,iCAA0C,OAAO,UAAU;CACtE,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,iBAAiB,EAAE;AACtD;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,mBAAmB,KAAK;AACjC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,mBAAmB,KAAK;AACjC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,YAAY,OAAO,SAAS,CAAC;AACtC;;AAGA,MAAa,oBAA6B,OAAO,UAAU;CACzD,OAAO,aAAa,OAAO,SAAS,CAAC;AACvC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,YAAY,OAAO,SAAS,CAAC;AACtC;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,YAAY,OAAO,SAAS,CAAC;AACtC;;AAGA,MAAa,cAAuB,OAAO,UAAU;CACnD,OAAO,OACH,SAAS,CAAC,CACX,YAAY,CAAC,CACb,KAAK,CAAC,CACN,QAAQ,aAAa,EAAE,CAAC,CACxB,QAAQ,WAAW,GAAG,CAAC,CACvB,QAAQ,QAAQ,GAAG,CAAC,CACpB,QAAQ,YAAY,EAAE;AAC3B;;AAGA,MAAa,eAAwB,OAAO,OAAO,YAAY;CAC7D,OAAO,MAAM,OAAO,SAAS,GAAG,SAAS,SAAS,UAAU,GAAG;AACjE;;AAGA,MAAa,eAAwB,OAAO,OAAO,YAAY;CAC7D,OAAO,MAAM,OAAO,SAAS,GAAG,SAAS,SAAS,UAAU,GAAG;AACjE;;AAGA,MAAa,sBAA+B,OAAO,UAAU;CAC3D,OAAO,OAAO,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,QAAQ;AACzD;;AAGA,MAAa,sBAA+B,OAAO,UAAU;CAC3D,OAAO,OAAO,KAAK,OAAO,SAAS,GAAG,QAAQ,CAAC,CAAC,SAAS,OAAO;AAClE;;AAGA,MAAa,iBAA0B,OAAO,OAAO,YAAY;CAC/D,MAAM,EAAE,QAAQ,YAAY,SAAS;CACrC,IAAI,CAAC,QAAQ,OAAO,OAAO,SAAS;CACpC,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,QAAQ,WAAW,EAAE;AACxD;;AAGA,MAAa,oBAA6B,OAAO,OAAO,YAAY;CAClE,MAAM,EAAE,QAAQ,YAAY,SAAS;CACrC,IAAI,CAAC,QAAQ,OAAO,OAAO,SAAS;CACpC,MAAM,cAAc,OAAO,WAAW,WAAW,IAAI,OAAO,QAAQ,GAAG,IAAI;CAC3E,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,aAAa,WAAW,EAAE;AAC7D;;AAGA,MAAa,gBAAyB,OAAO,OAAO,YAAY;CAC9D,MAAM,SAAS,SAAS,SAAS,UAAU;CAC3C,OAAO,OAAO,SAAS,IAAI;AAC7B;;AAGA,MAAa,iBAA0B,OAAO,OAAO,YAAY;CAE/D,QADe,SAAS,SAAS,UAAU,MAC3B,OAAO,SAAS;AAClC;;AAGA,MAAa,iBAA0B,OAAO,UAAU;CACtD,OAAO,OAAO,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE;AACtD;;AAGA,MAAa,kBAA2B,OAAO,OAAO,YAAY;CAChE,MAAM,MAAM,OAAO,SAAS;CAG5B,OAAO,cAAc,KAFH,SAAS,SAAS,aAAa,KAClC,SAAS,SAAS,UAAU,KACA;AAC7C;;AAGA,MAAa,gCAAyC,OAAO,UAAU;CACrE,OAAO,OAAO,SAAS,CAAC,CAAC,QAAQ,QAAQ,GAAG;AAC9C;;AAGA,MAAa,kBAA2B,OAAO,OAAO,YAAY;CAChE,MAAM,SAAS,SAAS,SAAS,UAAU;CAC3C,MAAM,OAAO,SAAS,SAAS,QAAQ;CACvC,OAAO,OAAO,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI;AAChD;;AAGA,MAAa,gBAAyB,OAAO,OAAO,YAAY;CAC9D,MAAM,SAAS,SAAS,SAAS,UAAU;CAC3C,MAAM,OAAO,SAAS,SAAS,QAAQ;CACvC,OAAO,OAAO,SAAS,CAAC,CAAC,OAAO,QAAQ,IAAI;AAC9C;;AAGA,MAAa,gBAAyB,OAAO,OAAO,YAAY;CAC9D,MAAM,QAAQ,SAAS,SAAS,SAAS;CACzC,OAAO,OAAO,SAAS,CAAC,EAAE,OAAO,KAAK;AACxC;;AAGA,MAAa,cAAuB,OAAO,OAAO,YAAY;CAC5D,MAAM,MAAM,OAAO,SAAS;CAC5B,MAAM,WAAW,SAAS,SAAS,QAAQ;CAC3C,MAAM,QAAQ,SAAS,SAAS,SAAS;CACzC,MAAM,MAAM,SAAS,SAAS,OAAO,KAAK;CAC1C,MAAM,eAAe,KAAK,UAAU,GAAG,KAAK;CAC5C,MAAM,aAAa,KAAK,UAAU,GAAG;CACrC,MAAM,eAAe,MAAM;CAC3B,OAAO,eAAe,SAAS,OAAO,YAAY,IAAI;AACxD;;AAGA,MAAa,sBAA+B,OAAO,UAAU;CAC3D,OAAO,OACH,SAAS,CAAC,CACX,QAAQ,UAAU,GAAG,CAAC,CACtB,QAAQ,SAAS,GAAG,CAAC,CACrB,QAAQ,SAAS,GAAG,CAAC,CACrB,QAAQ,WAAW,IAAG,CAAC,CACvB,QAAQ,WAAW,GAAG;AAC3B;;AAGA,MAAa,mBAA4B,OAAO,UAAU;CACxD,OAAO,MAAM,SAAS,CAAC,CAAC,QAAQ,cAAc,EAAE;AAClD;;AAGA,MAAa,0BAAmC,OAAO,UAAU;CAC/D,OAAO,MAAM,SAAS,CAAC,CAAC,QAAQ,iBAAiB,EAAE;AACrD;;AAGA,MAAa,uBAAgC,OAAO,UAAU;CAC5D,OAAO,MAAM,SAAS,CAAC,CAAC,QAAQ,UAAU,EAAE;AAC9C"}
1
+ {"version":3,"file":"string-mutators.mjs","names":[],"sources":["../../../../../../../seal/src/mutators/string-mutators.ts"],"sourcesContent":["import {\r\n capitalize,\r\n ltrim,\r\n readMoreChars,\r\n rtrim,\r\n toCamelCase,\r\n toKebabCase,\r\n toSnakeCase,\r\n toStudlyCase,\r\n trim,\r\n} from \"@mongez/reinforcements\";\r\nimport type { Mutator } from \"../types\";\r\n\r\n/** Convert string to lowercase */\r\nexport const lowercaseMutator: Mutator = async (value) => {\r\n return value?.toString().toLowerCase();\r\n};\r\n\r\n/** Convert string to uppercase */\r\nexport const uppercaseMutator: Mutator = async (value) => {\r\n return value?.toString().toUpperCase();\r\n};\r\n\r\n/** Capitalize only the first letter of the string */\r\nexport const capitalizeMutator: Mutator = async (value) => {\r\n const str = value?.toString();\r\n return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();\r\n};\r\n\r\n/** Capitalize the first letter of each word (Title Case) */\r\nexport const titleCaseMutator: Mutator = async (value) => {\r\n return capitalize(value?.toString());\r\n};\r\n\r\n/** Convert value to string */\r\nexport const stringifyMutator: Mutator = async (value) => {\r\n if (!value && value !== 0) return \"\";\r\n // only convert numbers, boolean and strings\r\n\r\n // Handle strings (pass through)\r\n if (typeof value === \"string\") return value;\r\n\r\n // Handle scalar types (number, boolean)\r\n if (typeof value === \"number\" || typeof value === \"boolean\") {\r\n return String(value);\r\n }\r\n};\r\n\r\n/** Trim whitespace */\r\nexport const trimMutator: Mutator = async (value, context) => {\r\n return trim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/**\r\n * Strip HTML tags with a naive `<...>` regex.\r\n *\r\n * This is a **tag stripper, not an XSS sanitizer**: it is not a parser, so\r\n * malformed/nested markup, attribute payloads, or content re-introduced\r\n * later in a pipeline can defeat it. Do not rely on this alone to make\r\n * untrusted rich text safe to render — use a real parser-based sanitizer\r\n * (e.g. DOMPurify / sanitize-html) for that.\r\n */\r\nexport const stripTagsMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/<[^>]*>?/gm, \"\");\r\n};\r\n\r\n/**\r\n * @deprecated Renamed to {@link stripTagsMutator} — the old name implied\r\n * XSS safety this tag-stripping regex does not provide. Kept as an alias\r\n * for backward compatibility; switch to `stripTagsMutator`.\r\n */\r\nexport const safeHtmlMutator: Mutator = stripTagsMutator;\r\n\r\n/** HTML escape */\r\nexport const htmlEscapeMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .replace(/&/g, \"&amp;\")\r\n .replace(/</g, \"&lt;\")\r\n .replace(/>/g, \"&gt;\")\r\n .replace(/\"/g, \"&quot;\")\r\n .replace(/'/g, \"&#039;\");\r\n};\r\n\r\n/** Remove special characters */\r\nexport const removeSpecialCharactersMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/[^a-zA-Z0-9]/g, \"\");\r\n};\r\n\r\n/** URL decode */\r\nexport const urlDecodeMutator: Mutator = async (value) => {\r\n return decodeURIComponent(value);\r\n};\r\n\r\n/** URL encode */\r\nexport const urlEncodeMutator: Mutator = async (value) => {\r\n return encodeURIComponent(value);\r\n};\r\n\r\n/** Convert to camelCase */\r\nexport const camelCaseMutator: Mutator = async (value) => {\r\n return toCamelCase(value?.toString());\r\n};\r\n\r\n/** Convert to PascalCase */\r\nexport const pascalCaseMutator: Mutator = async (value) => {\r\n return toStudlyCase(value?.toString());\r\n};\r\n\r\n/** Convert to snake_case */\r\nexport const snakeCaseMutator: Mutator = async (value) => {\r\n return toSnakeCase(value?.toString());\r\n};\r\n\r\n/** Convert to kebab-case */\r\nexport const kebabCaseMutator: Mutator = async (value) => {\r\n return toKebabCase(value?.toString());\r\n};\r\n\r\n/** Convert to URL-friendly slug */\r\nexport const slugMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .toLowerCase()\r\n .trim()\r\n .replace(/[^\\w\\s-]/g, \"\")\r\n .replace(/[\\s_]+/g, \"-\")\r\n .replace(/--+/g, \"-\")\r\n .replace(/^-+|-+$/g, \"\");\r\n};\r\n\r\n/** Trim from the left/start */\r\nexport const ltrimMutator: Mutator = async (value, context) => {\r\n return ltrim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/** Trim from the right/end */\r\nexport const rtrimMutator: Mutator = async (value, context) => {\r\n return rtrim(value?.toString(), context?.options?.needle ?? \" \");\r\n};\r\n\r\n/** Base64 encode */\r\nexport const base64EncodeMutator: Mutator = async (value) => {\r\n return Buffer.from(value?.toString()).toString(\"base64\");\r\n};\r\n\r\n/** Base64 decode */\r\nexport const base64DecodeMutator: Mutator = async (value) => {\r\n return Buffer.from(value?.toString(), \"base64\").toString(\"utf-8\");\r\n};\r\n\r\n/** Replace substring or pattern */\r\nexport const replaceMutator: Mutator = async (value, context) => {\r\n const { search, replace } = context?.options;\r\n if (!search) return value?.toString();\r\n return value?.toString().replace(search, replace ?? \"\");\r\n};\r\n\r\n/** Replace all occurrences of substring or pattern */\r\nexport const replaceAllMutator: Mutator = async (value, context) => {\r\n const { search, replace } = context?.options;\r\n if (!search) return value?.toString();\r\n const searchValue = typeof search === \"string\" ? new RegExp(search, \"g\") : search;\r\n return value?.toString().replace(searchValue, replace ?? \"\");\r\n};\r\n\r\n/** Append/suffix text to the end */\r\nexport const appendMutator: Mutator = async (value, context) => {\r\n const suffix = context?.options?.suffix ?? \"\";\r\n return value?.toString() + suffix;\r\n};\r\n\r\n/** Prepend/prefix text to the beginning */\r\nexport const prependMutator: Mutator = async (value, context) => {\r\n const prefix = context?.options?.prefix ?? \"\";\r\n return prefix + value?.toString();\r\n};\r\n\r\n/** Reverse the string */\r\nexport const reverseMutator: Mutator = async (value) => {\r\n return value?.toString().split(\"\").reverse().join(\"\");\r\n};\r\n\r\n/** Truncate to a maximum length */\r\nexport const truncateMutator: Mutator = async (value, context) => {\r\n const str = value?.toString();\r\n const maxLength = context?.options?.maxLength ?? 100;\r\n const suffix = context?.options?.suffix ?? \"...\";\r\n return readMoreChars(str, maxLength, suffix);\r\n};\r\n\r\n/** Trim multiple whitespace into single space */\r\nexport const trimMultipleWhitespaceMutator: Mutator = async (value) => {\r\n return value?.toString().replace(/\\s+/g, \" \");\r\n};\r\n\r\n/** Pad string from the start to reach target length */\r\nexport const padStartMutator: Mutator = async (value, context) => {\r\n const length = context?.options?.length ?? 0;\r\n const char = context?.options?.char ?? \" \";\r\n return value?.toString().padStart(length, char);\r\n};\r\n\r\n/** Pad string from the end to reach target length */\r\nexport const padEndMutator: Mutator = async (value, context) => {\r\n const length = context?.options?.length ?? 0;\r\n const char = context?.options?.char ?? \" \";\r\n return value?.toString().padEnd(length, char);\r\n};\r\n\r\n/** Repeat string N times */\r\nexport const repeatMutator: Mutator = async (value, context) => {\r\n const count = context?.options?.count ?? 1;\r\n return value?.toString()?.repeat(count);\r\n};\r\n\r\n/** Mask part of string */\r\nexport const maskMutator: Mutator = async (value, context) => {\r\n const str = value?.toString();\r\n const maskChar = context?.options?.char ?? \"*\";\r\n const start = context?.options?.start ?? 0;\r\n const end = context?.options?.end ?? str?.length;\r\n const visibleStart = str?.substring(0, start);\r\n const visibleEnd = str?.substring(end);\r\n const maskedLength = end - start;\r\n return visibleStart + maskChar.repeat(maskedLength) + visibleEnd;\r\n};\r\n\r\n/** Unescape HTML entities */\r\nexport const unescapeHtmlMutator: Mutator = async (value) => {\r\n return value\r\n ?.toString()\r\n .replace(/&amp;/g, \"&\")\r\n .replace(/&lt;/g, \"<\")\r\n .replace(/&gt;/g, \">\")\r\n .replace(/&quot;/g, '\"')\r\n .replace(/&#039;/g, \"'\");\r\n};\r\n\r\n/** Keep only alphabetic characters */\r\nexport const alphaOnlyMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[^a-zA-Z]/g, \"\");\r\n};\r\n\r\n/** Keep only alphanumeric characters */\r\nexport const alphanumericOnlyMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[^a-zA-Z0-9]/g, \"\");\r\n};\r\n\r\n/** Remove all numeric characters */\r\nexport const removeNumbersMutator: Mutator = async (value) => {\r\n return value.toString().replace(/[0-9]/g, \"\");\r\n};\r\n"],"mappings":"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"}
@@ -47,7 +47,21 @@ declare class StringValidator extends PrimitiveValidator {
47
47
  padStart(length: number, char?: string): this;
48
48
  /** Pad string from the end to reach target length */
49
49
  padEnd(length: number, char?: string): this;
50
- /** Remove HTML tags (safe HTML) */
50
+ /**
51
+ * Strip HTML tags with a naive `<...>` regex.
52
+ *
53
+ * This is a **tag stripper, not an XSS sanitizer**: it is not a parser,
54
+ * so malformed/nested markup or content re-introduced later in a
55
+ * pipeline can defeat it. Do not rely on this alone to make untrusted
56
+ * rich text safe to render — use a real parser-based sanitizer (e.g.
57
+ * DOMPurify / sanitize-html) for that.
58
+ */
59
+ stripTags(): this;
60
+ /**
61
+ * @deprecated Renamed to {@link StringValidator.stripTags} — the old
62
+ * name implied XSS safety this tag-stripping regex does not provide.
63
+ * Kept as an alias for backward compatibility; switch to `.stripTags()`.
64
+ */
51
65
  safeHtml(): this;
52
66
  /** HTML escape special characters */
53
67
  htmlEscape(): this;
@@ -1 +1 @@
1
- {"version":3,"file":"string-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"mappings":"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"}
1
+ {"version":3,"file":"string-validator.d.mts","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import { applyNullable, getRuleOptions } from "../standard-schema/json-schema.mjs";
2
- import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, safeHtmlMutator, slugMutator, snakeCaseMutator, stringifyMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "../mutators/string-mutators.mjs";
2
+ import { alphaOnlyMutator, alphanumericOnlyMutator, appendMutator, base64DecodeMutator, base64EncodeMutator, camelCaseMutator, capitalizeMutator, htmlEscapeMutator, kebabCaseMutator, lowercaseMutator, ltrimMutator, maskMutator, padEndMutator, padStartMutator, pascalCaseMutator, prependMutator, removeNumbersMutator, removeSpecialCharactersMutator, repeatMutator, replaceAllMutator, replaceMutator, reverseMutator, rtrimMutator, slugMutator, snakeCaseMutator, stringifyMutator, stripTagsMutator, titleCaseMutator, trimMultipleWhitespaceMutator, trimMutator, truncateMutator, unescapeHtmlMutator, uppercaseMutator, urlDecodeMutator, urlEncodeMutator } from "../mutators/string-mutators.mjs";
3
3
  import "../mutators/index.mjs";
4
4
  import { alphaNumericRule, alphaRule, isNumericRule } from "../rules/string/alpha.mjs";
5
5
  import { isCreditCardRule } from "../rules/string/credit-card.mjs";
@@ -103,9 +103,25 @@ var StringValidator = class extends PrimitiveValidator {
103
103
  char
104
104
  });
105
105
  }
106
- /** Remove HTML tags (safe HTML) */
106
+ /**
107
+ * Strip HTML tags with a naive `<...>` regex.
108
+ *
109
+ * This is a **tag stripper, not an XSS sanitizer**: it is not a parser,
110
+ * so malformed/nested markup or content re-introduced later in a
111
+ * pipeline can defeat it. Do not rely on this alone to make untrusted
112
+ * rich text safe to render — use a real parser-based sanitizer (e.g.
113
+ * DOMPurify / sanitize-html) for that.
114
+ */
115
+ stripTags() {
116
+ return this.addMutator(stripTagsMutator);
117
+ }
118
+ /**
119
+ * @deprecated Renamed to {@link StringValidator.stripTags} — the old
120
+ * name implied XSS safety this tag-stripping regex does not provide.
121
+ * Kept as an alias for backward compatibility; switch to `.stripTags()`.
122
+ */
107
123
  safeHtml() {
108
- return this.addMutator(safeHtmlMutator);
124
+ return this.stripTags();
109
125
  }
110
126
  /** HTML escape special characters */
111
127
  htmlEscape() {
@@ -1 +1 @@
1
- {"version":3,"file":"string-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"sourcesContent":["import {\r\n alphaOnlyMutator,\r\n alphanumericOnlyMutator,\r\n appendMutator,\r\n base64DecodeMutator,\r\n base64EncodeMutator,\r\n camelCaseMutator,\r\n capitalizeMutator,\r\n htmlEscapeMutator,\r\n kebabCaseMutator,\r\n lowercaseMutator,\r\n ltrimMutator,\r\n maskMutator,\r\n padEndMutator,\r\n padStartMutator,\r\n pascalCaseMutator,\r\n prependMutator,\r\n removeNumbersMutator,\r\n removeSpecialCharactersMutator,\r\n repeatMutator,\r\n replaceAllMutator,\r\n replaceMutator,\r\n reverseMutator,\r\n rtrimMutator,\r\n safeHtmlMutator,\r\n slugMutator,\r\n snakeCaseMutator,\r\n stringifyMutator,\r\n titleCaseMutator,\r\n trimMultipleWhitespaceMutator,\r\n trimMutator,\r\n truncateMutator,\r\n unescapeHtmlMutator,\r\n uppercaseMutator,\r\n urlDecodeMutator,\r\n urlEncodeMutator,\r\n} from \"../mutators\";\r\nimport {\r\n alphaNumericRule,\r\n alphaRule,\r\n betweenLengthRule,\r\n colorRule,\r\n containsRule,\r\n cuidRule,\r\n darkColorRule,\r\n emailRule,\r\n endsWithRule,\r\n hexColorRule,\r\n hslColorRule,\r\n ip4Rule,\r\n ip6Rule,\r\n ipRule,\r\n isCreditCardRule,\r\n isNumericRule,\r\n lengthRule,\r\n lightColorRule,\r\n maxLengthRule,\r\n maxWordsRule,\r\n minLengthRule,\r\n minWordsRule,\r\n nanoidRule,\r\n notContainsRule,\r\n patternRule,\r\n rgbColorRule,\r\n rgbaColorRule,\r\n startsWithRule,\r\n stringRule,\r\n strongPasswordRule,\r\n ulidRule,\r\n urlRule,\r\n uuidRule,\r\n withoutWhitespaceRule,\r\n wordsRule,\r\n type UUIDVersion,\r\n} from \"../rules\";\r\nimport { PrimitiveValidator } from \"./primitive-validator\";\r\nimport { applyNullable, getRuleOptions } from \"../standard-schema/json-schema\";\r\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\r\n\r\n/**\r\n * String validator class\r\n */\r\nexport class StringValidator extends PrimitiveValidator {\r\n public constructor(errorMessage?: string) {\r\n super();\r\n this.addMutableRule(stringRule, errorMessage);\r\n }\r\n\r\n /**\r\n * Check if value is a string type\r\n */\r\n public matchesType(value: any): boolean {\r\n return typeof value === \"string\";\r\n }\r\n\r\n // ==================== Mutators ====================\r\n\r\n /**\r\n * Stringify the value if not a string\r\n */\r\n public toString() {\r\n return this.addMutator(stringifyMutator);\r\n }\r\n\r\n /** Convert string to uppercase */\r\n public uppercase() {\r\n return this.addMutator(uppercaseMutator);\r\n }\r\n\r\n /** Convert string to lowercase */\r\n public lowercase() {\r\n return this.addMutator(lowercaseMutator);\r\n }\r\n\r\n /** Capitalize only the first letter of the string */\r\n public capitalize() {\r\n return this.addMutator(capitalizeMutator);\r\n }\r\n\r\n /** Capitalize the first letter of each word (Title Case) */\r\n public titleCase() {\r\n return this.addMutator(titleCaseMutator);\r\n }\r\n\r\n /** Convert to camelCase */\r\n public camelCase() {\r\n return this.addMutator(camelCaseMutator);\r\n }\r\n\r\n /** Convert to PascalCase */\r\n public pascalCase() {\r\n return this.addMutator(pascalCaseMutator);\r\n }\r\n\r\n /** Convert to snake_case */\r\n public snakeCase() {\r\n return this.addMutator(snakeCaseMutator);\r\n }\r\n\r\n /** Convert to kebab-case */\r\n public kebabCase() {\r\n return this.addMutator(kebabCaseMutator);\r\n }\r\n\r\n /**\r\n * Trim the given needle from the string\r\n * If no needle is provided, the default is a single space\r\n */\r\n public trim(needle?: string) {\r\n return this.addMutator(trimMutator, { needle });\r\n }\r\n\r\n /** Trim from the left/start */\r\n public ltrim(needle?: string) {\r\n return this.addMutator(ltrimMutator, { needle });\r\n }\r\n\r\n /** Trim from the right/end */\r\n public rtrim(needle?: string) {\r\n return this.addMutator(rtrimMutator, { needle });\r\n }\r\n\r\n /** Trim multiple whitespace into single space */\r\n public trimMultipleWhitespace() {\r\n return this.addMutator(trimMultipleWhitespaceMutator);\r\n }\r\n\r\n /** Pad string from the start to reach target length */\r\n public padStart(length: number, char = \" \") {\r\n return this.addMutator(padStartMutator, { length, char });\r\n }\r\n\r\n /** Pad string from the end to reach target length */\r\n public padEnd(length: number, char = \" \") {\r\n return this.addMutator(padEndMutator, { length, char });\r\n }\r\n\r\n /** Remove HTML tags (safe HTML) */\r\n public safeHtml() {\r\n return this.addMutator(safeHtmlMutator);\r\n }\r\n\r\n /** HTML escape special characters */\r\n public htmlEscape() {\r\n return this.addMutator(htmlEscapeMutator);\r\n }\r\n\r\n /** Unescape HTML entities */\r\n public unescapeHtml() {\r\n return this.addMutator(unescapeHtmlMutator);\r\n }\r\n\r\n /**\r\n * Remove special characters\r\n * This will remove all characters that are not alphanumeric or whitespace\r\n */\r\n public removeSpecialCharacters() {\r\n return this.addMutator(removeSpecialCharactersMutator);\r\n }\r\n\r\n /** Convert to only alphabetic characters */\r\n public toAlpha() {\r\n return this.addMutator(alphaOnlyMutator);\r\n }\r\n\r\n /** Convert to only alphanumeric characters */\r\n public toAlphanumeric() {\r\n return this.addMutator(alphanumericOnlyMutator);\r\n }\r\n\r\n /** Remove all numeric characters */\r\n public removeNumbers() {\r\n return this.addMutator(removeNumbersMutator);\r\n }\r\n\r\n /** URL decode */\r\n public urlDecode() {\r\n return this.addMutator(urlDecodeMutator);\r\n }\r\n\r\n /** URL encode */\r\n public urlEncode() {\r\n return this.addMutator(urlEncodeMutator);\r\n }\r\n\r\n /** Convert to URL-friendly slug */\r\n public slug() {\r\n return this.addMutator(slugMutator);\r\n }\r\n\r\n /** Base64 encode */\r\n public base64Encode() {\r\n return this.addMutator(base64EncodeMutator);\r\n }\r\n\r\n /** Base64 decode */\r\n public base64Decode() {\r\n return this.addMutator(base64DecodeMutator);\r\n }\r\n\r\n /** Replace substring or pattern */\r\n public replace(search: string | RegExp, replace: string) {\r\n return this.addMutator(replaceMutator, { search, replace });\r\n }\r\n\r\n /** Replace all occurrences of substring or pattern */\r\n public replaceAll(search: string | RegExp, replace: string) {\r\n return this.addMutator(replaceAllMutator, { search, replace });\r\n }\r\n\r\n /** Append/suffix text to the end */\r\n public append(suffix: string) {\r\n return this.addMutator(appendMutator, { suffix });\r\n }\r\n\r\n /** Prepend/prefix text to the beginning */\r\n public prepend(prefix: string) {\r\n return this.addMutator(prependMutator, { prefix });\r\n }\r\n\r\n /** Reverse the string */\r\n public reverse() {\r\n return this.addMutator(reverseMutator);\r\n }\r\n\r\n /** Truncate to a maximum length */\r\n public truncate(maxLength: number, suffix = \"...\") {\r\n return this.addMutator(truncateMutator, { maxLength, suffix });\r\n }\r\n\r\n /** Repeat string N times */\r\n public repeat(count: number) {\r\n return this.addMutator(repeatMutator, { count });\r\n }\r\n\r\n /** Mask part of string */\r\n public mask(start: number, end?: number, char = \"*\") {\r\n return this.addMutator(maskMutator, { start, end, char });\r\n }\r\n\r\n // ==================== Validation Rules ====================\r\n\r\n /** Value must be a valid email */\r\n public email(errorMessage?: string) {\r\n return this.addRule(emailRule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid URL */\r\n public url(errorMessage?: string) {\r\n return this.addRule(urlRule, errorMessage);\r\n }\r\n\r\n /** Value can not have whitespace */\r\n public withoutWhitespace(errorMessage?: string) {\r\n return this.addRule(withoutWhitespaceRule, errorMessage);\r\n }\r\n\r\n /** Value must match the given pattern */\r\n public pattern(pattern: RegExp, errorMessage?: string) {\r\n return this.addRule(patternRule, errorMessage, { pattern });\r\n }\r\n\r\n /**\r\n * Value must be a strong password\r\n * Requirements:\r\n * - At least 8 characters\r\n * - At least 1 uppercase letter\r\n * - At least 1 lowercase letter\r\n * - At least 1 number\r\n * - At least 1 special character\r\n */\r\n public strongPassword(minLength?: number, errorMessage?: string) {\r\n return this.addRule(strongPasswordRule, errorMessage, { minLength });\r\n }\r\n\r\n /** Value must be exactly the given number of words */\r\n public words(words: number, errorMessage?: string) {\r\n return this.addRule(wordsRule, errorMessage, { words });\r\n }\r\n\r\n /** Value must be at least the given number of words */\r\n public minWords(words: number, errorMessage?: string) {\r\n return this.addRule(minWordsRule, errorMessage, { minWords: words });\r\n }\r\n\r\n /** Value must be at most the given number of words */\r\n public maxWords(words: number, errorMessage?: string) {\r\n return this.addRule(maxWordsRule, errorMessage, { maxWords: words });\r\n }\r\n\r\n /** Value length must be greater than the given length */\r\n public minLength(length: number, errorMessage?: string) {\r\n return this.addRule(minLengthRule, errorMessage, { minLength: length });\r\n }\r\n\r\n /** @alias minLength */\r\n public min(min: number, errorMessage?: string) {\r\n return this.minLength(min, errorMessage);\r\n }\r\n\r\n /** Value length must be less than the given length */\r\n public maxLength(length: number, errorMessage?: string) {\r\n return this.addRule(maxLengthRule, errorMessage, { maxLength: length });\r\n }\r\n\r\n /** @alias maxLength */\r\n public max(max: number, errorMessage?: string) {\r\n return this.maxLength(max, errorMessage);\r\n }\r\n\r\n /** Value must be of the given length */\r\n public length(length: number, errorMessage?: string) {\r\n return this.addRule(lengthRule, errorMessage, { length });\r\n }\r\n\r\n /**\r\n * String length must be between min and max (inclusive)\r\n *\r\n * @param min - Minimum length (inclusive)\r\n * @param max - Maximum length (inclusive)\r\n *\r\n * @example\r\n * ```ts\r\n * v.string().between(5, 10) // Length: 5 to 10 characters\r\n * v.string().lengthBetween(8, 20) // Same using alias\r\n * ```\r\n *\r\n * @category Validation Rule\r\n */\r\n public lengthBetween(min: number, max: number, errorMessage?: string) {\r\n return this.addRule(betweenLengthRule, errorMessage, {\r\n minLength: min,\r\n maxLength: max,\r\n });\r\n }\r\n\r\n /** Allow only alphabetic characters */\r\n public alpha(errorMessage?: string) {\r\n return this.addRule(alphaRule, errorMessage);\r\n }\r\n\r\n /** Allow only alphanumeric characters */\r\n public alphanumeric(errorMessage?: string) {\r\n return this.addRule(alphaNumericRule, errorMessage);\r\n }\r\n\r\n /** Allow only numeric characters */\r\n public numeric(errorMessage?: string) {\r\n return this.addRule(isNumericRule, errorMessage);\r\n }\r\n\r\n /** Value must starts with the given string */\r\n public startsWith(value: string, errorMessage?: string) {\r\n return this.addRule(startsWithRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must ends with the given string */\r\n public endsWith(value: string, errorMessage?: string) {\r\n return this.addRule(endsWithRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must contain the given string */\r\n public contains(value: string, errorMessage?: string) {\r\n return this.addRule(containsRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must not contain the given string */\r\n public notContains(value: string, errorMessage?: string) {\r\n return this.addRule(notContainsRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must be a valid IP address */\r\n public ip(errorMessage?: string) {\r\n return this.addRule(ipRule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid IPv4 address */\r\n public ip4(errorMessage?: string) {\r\n return this.addRule(ip4Rule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid IPv6 address */\r\n public ip6(errorMessage?: string) {\r\n return this.addRule(ip6Rule, errorMessage);\r\n }\r\n\r\n /** Check if the string matches a credit card number */\r\n public creditCard(errorMessage?: string) {\r\n return this.addRule(isCreditCardRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid color */\r\n public color(errorMessage?: string) {\r\n return this.addRule(colorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid hex color */\r\n public hexColor(errorMessage?: string) {\r\n return this.addRule(hexColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid HSL color */\r\n public hslColor(errorMessage?: string) {\r\n return this.addRule(hslColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid RGB color */\r\n public rgbColor(errorMessage?: string) {\r\n return this.addRule(rgbColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid RGBA color */\r\n public rgbaColor(errorMessage?: string) {\r\n return this.addRule(rgbaColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid light color */\r\n public lightColor(errorMessage?: string) {\r\n return this.addRule(lightColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid dark color */\r\n public darkColor(errorMessage?: string) {\r\n return this.addRule(darkColorRule, errorMessage);\r\n }\r\n\r\n // ==================== ID Format Rules ====================\r\n\r\n /**\r\n * Value must be a valid UUID. Optionally restrict to a specific version.\r\n *\r\n * @example\r\n * v.string().uuid() // any RFC 4122 UUID\r\n * v.string().uuid(4) // only v4 (random)\r\n * v.string().uuid(7) // only v7 (timestamp-ordered)\r\n */\r\n public uuid(version?: UUIDVersion, errorMessage?: string) {\r\n return this.addRule(uuidRule, errorMessage, { version });\r\n }\r\n\r\n /**\r\n * Value must be a valid CUID. Defaults to CUID2; pass `{ version: 1 }` for legacy.\r\n *\r\n * @example\r\n * v.string().cuid() // CUID2\r\n * v.string().cuid({ version: 1 }) // legacy CUID1\r\n */\r\n public cuid(options?: { version?: 1 | 2; errorMessage?: string }) {\r\n const { errorMessage, version } = options ?? {};\r\n return this.addRule(cuidRule, errorMessage, { version });\r\n }\r\n\r\n /** Value must be a valid ULID (26 chars, Crockford base32). */\r\n public ulid(errorMessage?: string) {\r\n return this.addRule(ulidRule, errorMessage);\r\n }\r\n\r\n /**\r\n * Value must be a valid nanoid string. Default length is 21.\r\n *\r\n * @example\r\n * v.string().nanoid() // 21 chars (default)\r\n * v.string().nanoid(10) // 10 chars\r\n */\r\n public nanoid(length?: number, errorMessage?: string) {\r\n return this.addRule(nanoidRule, errorMessage, { length });\r\n }\r\n\r\n /**\r\n * @inheritdoc\r\n *\r\n * Maps String-specific rule options to JSON Schema keywords.\r\n * Non-representable rules (cross-field, refine, color rules, etc.) are silently omitted.\r\n *\r\n * @example\r\n * ```ts\r\n * v.string().min(2).max(100).email().toJsonSchema(\"draft-2020-12\")\r\n * // → { type: \"string\", minLength: 2, maxLength: 100, format: \"email\" }\r\n * ```\r\n */\r\n public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\r\n const schema: JsonSchemaResult = { type: \"string\" };\r\n\r\n // minLength / min\r\n const minOpts = getRuleOptions(this.rules, \"minLength\");\r\n if (minOpts?.minLength !== undefined) schema.minLength = minOpts.minLength;\r\n\r\n // maxLength / max\r\n const maxOpts = getRuleOptions(this.rules, \"maxLength\");\r\n if (maxOpts?.maxLength !== undefined) schema.maxLength = maxOpts.maxLength;\r\n\r\n // betweenLength covers both min and max in one rule\r\n const betweenOpts = getRuleOptions(this.rules, \"betweenLength\");\r\n if (betweenOpts) {\r\n if (betweenOpts.minLength !== undefined) schema.minLength = betweenOpts.minLength;\r\n if (betweenOpts.maxLength !== undefined) schema.maxLength = betweenOpts.maxLength;\r\n }\r\n\r\n // exact length\r\n const lengthOpts = getRuleOptions(this.rules, \"length\");\r\n if (lengthOpts?.length !== undefined) {\r\n schema.minLength = lengthOpts.length;\r\n schema.maxLength = lengthOpts.length;\r\n }\r\n\r\n // pattern (regex)\r\n const patternOpts = getRuleOptions(this.rules, \"pattern\");\r\n if (patternOpts?.pattern instanceof RegExp) {\r\n schema.pattern = patternOpts.pattern.source;\r\n }\r\n\r\n // format hints\r\n if (getRuleOptions(this.rules, \"email\") !== undefined ||\r\n this.rules.some(r => r.name === \"email\")) {\r\n schema.format = \"email\";\r\n } else if (this.rules.some(r => r.name === \"url\")) {\r\n schema.format = \"uri\";\r\n } else if (this.rules.some(r => r.name === \"ip\")) {\r\n schema.format = \"ipv4\";\r\n } else if (this.rules.some(r => r.name === \"ip4\")) {\r\n schema.format = \"ipv4\";\r\n } else if (this.rules.some(r => r.name === \"ip6\")) {\r\n schema.format = \"ipv6\";\r\n } else if (this.rules.some(r => r.name === \"uuid\")) {\r\n schema.format = \"uuid\";\r\n } else if (this.rules.some(r => r.name === \"hexColor\")) {\r\n schema.format = \"color\";\r\n }\r\n\r\n // CUID / ULID / nanoid don't have widely-supported format keywords —\r\n // fall back to pattern so JSON Schema validators still enforce shape.\r\n if (!schema.format) {\r\n const cuidOpts = getRuleOptions(this.rules, \"cuid\");\r\n if (cuidOpts) {\r\n schema.pattern = cuidOpts.version === 1 ? \"^c[a-z0-9]{24,}$\" : \"^[a-z][a-z0-9]{23}$\";\r\n }\r\n if (this.rules.some(r => r.name === \"ulid\")) {\r\n schema.pattern = \"^[0-9A-HJKMNP-TV-Z]{26}$\";\r\n }\r\n const nanoidOpts = getRuleOptions(this.rules, \"nanoid\");\r\n if (nanoidOpts) {\r\n const len = (nanoidOpts.length as number | undefined) ?? 21;\r\n schema.pattern = `^[A-Za-z0-9_-]{${len}}$`;\r\n }\r\n }\r\n\r\n // enum (from PrimitiveValidator.in / .enum)\r\n const inOpts = getRuleOptions(this.rules, \"in\");\r\n if (inOpts?.values && Array.isArray(inOpts.values)) {\r\n schema.enum = inOpts.values;\r\n }\r\n\r\n if (this.isNullable) applyNullable(schema, target);\r\n\r\n return schema;\r\n }\r\n}\r\n"],"mappings":"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"}
1
+ {"version":3,"file":"string-validator.mjs","names":[],"sources":["../../../../../../../seal/src/validators/string-validator.ts"],"sourcesContent":["import {\r\n alphaOnlyMutator,\r\n alphanumericOnlyMutator,\r\n appendMutator,\r\n base64DecodeMutator,\r\n base64EncodeMutator,\r\n camelCaseMutator,\r\n capitalizeMutator,\r\n htmlEscapeMutator,\r\n kebabCaseMutator,\r\n lowercaseMutator,\r\n ltrimMutator,\r\n maskMutator,\r\n padEndMutator,\r\n padStartMutator,\r\n pascalCaseMutator,\r\n prependMutator,\r\n removeNumbersMutator,\r\n removeSpecialCharactersMutator,\r\n repeatMutator,\r\n replaceAllMutator,\r\n replaceMutator,\r\n reverseMutator,\r\n rtrimMutator,\r\n slugMutator,\r\n snakeCaseMutator,\r\n stringifyMutator,\r\n stripTagsMutator,\r\n titleCaseMutator,\r\n trimMultipleWhitespaceMutator,\r\n trimMutator,\r\n truncateMutator,\r\n unescapeHtmlMutator,\r\n uppercaseMutator,\r\n urlDecodeMutator,\r\n urlEncodeMutator,\r\n} from \"../mutators\";\r\nimport {\r\n alphaNumericRule,\r\n alphaRule,\r\n betweenLengthRule,\r\n colorRule,\r\n containsRule,\r\n cuidRule,\r\n darkColorRule,\r\n emailRule,\r\n endsWithRule,\r\n hexColorRule,\r\n hslColorRule,\r\n ip4Rule,\r\n ip6Rule,\r\n ipRule,\r\n isCreditCardRule,\r\n isNumericRule,\r\n lengthRule,\r\n lightColorRule,\r\n maxLengthRule,\r\n maxWordsRule,\r\n minLengthRule,\r\n minWordsRule,\r\n nanoidRule,\r\n notContainsRule,\r\n patternRule,\r\n rgbColorRule,\r\n rgbaColorRule,\r\n startsWithRule,\r\n stringRule,\r\n strongPasswordRule,\r\n ulidRule,\r\n urlRule,\r\n uuidRule,\r\n withoutWhitespaceRule,\r\n wordsRule,\r\n type UUIDVersion,\r\n} from \"../rules\";\r\nimport { PrimitiveValidator } from \"./primitive-validator\";\r\nimport { applyNullable, getRuleOptions } from \"../standard-schema/json-schema\";\r\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\r\n\r\n/**\r\n * String validator class\r\n */\r\nexport class StringValidator extends PrimitiveValidator {\r\n public constructor(errorMessage?: string) {\r\n super();\r\n this.addMutableRule(stringRule, errorMessage);\r\n }\r\n\r\n /**\r\n * Check if value is a string type\r\n */\r\n public matchesType(value: any): boolean {\r\n return typeof value === \"string\";\r\n }\r\n\r\n // ==================== Mutators ====================\r\n\r\n /**\r\n * Stringify the value if not a string\r\n */\r\n public toString() {\r\n return this.addMutator(stringifyMutator);\r\n }\r\n\r\n /** Convert string to uppercase */\r\n public uppercase() {\r\n return this.addMutator(uppercaseMutator);\r\n }\r\n\r\n /** Convert string to lowercase */\r\n public lowercase() {\r\n return this.addMutator(lowercaseMutator);\r\n }\r\n\r\n /** Capitalize only the first letter of the string */\r\n public capitalize() {\r\n return this.addMutator(capitalizeMutator);\r\n }\r\n\r\n /** Capitalize the first letter of each word (Title Case) */\r\n public titleCase() {\r\n return this.addMutator(titleCaseMutator);\r\n }\r\n\r\n /** Convert to camelCase */\r\n public camelCase() {\r\n return this.addMutator(camelCaseMutator);\r\n }\r\n\r\n /** Convert to PascalCase */\r\n public pascalCase() {\r\n return this.addMutator(pascalCaseMutator);\r\n }\r\n\r\n /** Convert to snake_case */\r\n public snakeCase() {\r\n return this.addMutator(snakeCaseMutator);\r\n }\r\n\r\n /** Convert to kebab-case */\r\n public kebabCase() {\r\n return this.addMutator(kebabCaseMutator);\r\n }\r\n\r\n /**\r\n * Trim the given needle from the string\r\n * If no needle is provided, the default is a single space\r\n */\r\n public trim(needle?: string) {\r\n return this.addMutator(trimMutator, { needle });\r\n }\r\n\r\n /** Trim from the left/start */\r\n public ltrim(needle?: string) {\r\n return this.addMutator(ltrimMutator, { needle });\r\n }\r\n\r\n /** Trim from the right/end */\r\n public rtrim(needle?: string) {\r\n return this.addMutator(rtrimMutator, { needle });\r\n }\r\n\r\n /** Trim multiple whitespace into single space */\r\n public trimMultipleWhitespace() {\r\n return this.addMutator(trimMultipleWhitespaceMutator);\r\n }\r\n\r\n /** Pad string from the start to reach target length */\r\n public padStart(length: number, char = \" \") {\r\n return this.addMutator(padStartMutator, { length, char });\r\n }\r\n\r\n /** Pad string from the end to reach target length */\r\n public padEnd(length: number, char = \" \") {\r\n return this.addMutator(padEndMutator, { length, char });\r\n }\r\n\r\n /**\r\n * Strip HTML tags with a naive `<...>` regex.\r\n *\r\n * This is a **tag stripper, not an XSS sanitizer**: it is not a parser,\r\n * so malformed/nested markup or content re-introduced later in a\r\n * pipeline can defeat it. Do not rely on this alone to make untrusted\r\n * rich text safe to render — use a real parser-based sanitizer (e.g.\r\n * DOMPurify / sanitize-html) for that.\r\n */\r\n public stripTags() {\r\n return this.addMutator(stripTagsMutator);\r\n }\r\n\r\n /**\r\n * @deprecated Renamed to {@link StringValidator.stripTags} — the old\r\n * name implied XSS safety this tag-stripping regex does not provide.\r\n * Kept as an alias for backward compatibility; switch to `.stripTags()`.\r\n */\r\n public safeHtml() {\r\n return this.stripTags();\r\n }\r\n\r\n /** HTML escape special characters */\r\n public htmlEscape() {\r\n return this.addMutator(htmlEscapeMutator);\r\n }\r\n\r\n /** Unescape HTML entities */\r\n public unescapeHtml() {\r\n return this.addMutator(unescapeHtmlMutator);\r\n }\r\n\r\n /**\r\n * Remove special characters\r\n * This will remove all characters that are not alphanumeric or whitespace\r\n */\r\n public removeSpecialCharacters() {\r\n return this.addMutator(removeSpecialCharactersMutator);\r\n }\r\n\r\n /** Convert to only alphabetic characters */\r\n public toAlpha() {\r\n return this.addMutator(alphaOnlyMutator);\r\n }\r\n\r\n /** Convert to only alphanumeric characters */\r\n public toAlphanumeric() {\r\n return this.addMutator(alphanumericOnlyMutator);\r\n }\r\n\r\n /** Remove all numeric characters */\r\n public removeNumbers() {\r\n return this.addMutator(removeNumbersMutator);\r\n }\r\n\r\n /** URL decode */\r\n public urlDecode() {\r\n return this.addMutator(urlDecodeMutator);\r\n }\r\n\r\n /** URL encode */\r\n public urlEncode() {\r\n return this.addMutator(urlEncodeMutator);\r\n }\r\n\r\n /** Convert to URL-friendly slug */\r\n public slug() {\r\n return this.addMutator(slugMutator);\r\n }\r\n\r\n /** Base64 encode */\r\n public base64Encode() {\r\n return this.addMutator(base64EncodeMutator);\r\n }\r\n\r\n /** Base64 decode */\r\n public base64Decode() {\r\n return this.addMutator(base64DecodeMutator);\r\n }\r\n\r\n /** Replace substring or pattern */\r\n public replace(search: string | RegExp, replace: string) {\r\n return this.addMutator(replaceMutator, { search, replace });\r\n }\r\n\r\n /** Replace all occurrences of substring or pattern */\r\n public replaceAll(search: string | RegExp, replace: string) {\r\n return this.addMutator(replaceAllMutator, { search, replace });\r\n }\r\n\r\n /** Append/suffix text to the end */\r\n public append(suffix: string) {\r\n return this.addMutator(appendMutator, { suffix });\r\n }\r\n\r\n /** Prepend/prefix text to the beginning */\r\n public prepend(prefix: string) {\r\n return this.addMutator(prependMutator, { prefix });\r\n }\r\n\r\n /** Reverse the string */\r\n public reverse() {\r\n return this.addMutator(reverseMutator);\r\n }\r\n\r\n /** Truncate to a maximum length */\r\n public truncate(maxLength: number, suffix = \"...\") {\r\n return this.addMutator(truncateMutator, { maxLength, suffix });\r\n }\r\n\r\n /** Repeat string N times */\r\n public repeat(count: number) {\r\n return this.addMutator(repeatMutator, { count });\r\n }\r\n\r\n /** Mask part of string */\r\n public mask(start: number, end?: number, char = \"*\") {\r\n return this.addMutator(maskMutator, { start, end, char });\r\n }\r\n\r\n // ==================== Validation Rules ====================\r\n\r\n /** Value must be a valid email */\r\n public email(errorMessage?: string) {\r\n return this.addRule(emailRule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid URL */\r\n public url(errorMessage?: string) {\r\n return this.addRule(urlRule, errorMessage);\r\n }\r\n\r\n /** Value can not have whitespace */\r\n public withoutWhitespace(errorMessage?: string) {\r\n return this.addRule(withoutWhitespaceRule, errorMessage);\r\n }\r\n\r\n /** Value must match the given pattern */\r\n public pattern(pattern: RegExp, errorMessage?: string) {\r\n return this.addRule(patternRule, errorMessage, { pattern });\r\n }\r\n\r\n /**\r\n * Value must be a strong password\r\n * Requirements:\r\n * - At least 8 characters\r\n * - At least 1 uppercase letter\r\n * - At least 1 lowercase letter\r\n * - At least 1 number\r\n * - At least 1 special character\r\n */\r\n public strongPassword(minLength?: number, errorMessage?: string) {\r\n return this.addRule(strongPasswordRule, errorMessage, { minLength });\r\n }\r\n\r\n /** Value must be exactly the given number of words */\r\n public words(words: number, errorMessage?: string) {\r\n return this.addRule(wordsRule, errorMessage, { words });\r\n }\r\n\r\n /** Value must be at least the given number of words */\r\n public minWords(words: number, errorMessage?: string) {\r\n return this.addRule(minWordsRule, errorMessage, { minWords: words });\r\n }\r\n\r\n /** Value must be at most the given number of words */\r\n public maxWords(words: number, errorMessage?: string) {\r\n return this.addRule(maxWordsRule, errorMessage, { maxWords: words });\r\n }\r\n\r\n /** Value length must be greater than the given length */\r\n public minLength(length: number, errorMessage?: string) {\r\n return this.addRule(minLengthRule, errorMessage, { minLength: length });\r\n }\r\n\r\n /** @alias minLength */\r\n public min(min: number, errorMessage?: string) {\r\n return this.minLength(min, errorMessage);\r\n }\r\n\r\n /** Value length must be less than the given length */\r\n public maxLength(length: number, errorMessage?: string) {\r\n return this.addRule(maxLengthRule, errorMessage, { maxLength: length });\r\n }\r\n\r\n /** @alias maxLength */\r\n public max(max: number, errorMessage?: string) {\r\n return this.maxLength(max, errorMessage);\r\n }\r\n\r\n /** Value must be of the given length */\r\n public length(length: number, errorMessage?: string) {\r\n return this.addRule(lengthRule, errorMessage, { length });\r\n }\r\n\r\n /**\r\n * String length must be between min and max (inclusive)\r\n *\r\n * @param min - Minimum length (inclusive)\r\n * @param max - Maximum length (inclusive)\r\n *\r\n * @example\r\n * ```ts\r\n * v.string().between(5, 10) // Length: 5 to 10 characters\r\n * v.string().lengthBetween(8, 20) // Same using alias\r\n * ```\r\n *\r\n * @category Validation Rule\r\n */\r\n public lengthBetween(min: number, max: number, errorMessage?: string) {\r\n return this.addRule(betweenLengthRule, errorMessage, {\r\n minLength: min,\r\n maxLength: max,\r\n });\r\n }\r\n\r\n /** Allow only alphabetic characters */\r\n public alpha(errorMessage?: string) {\r\n return this.addRule(alphaRule, errorMessage);\r\n }\r\n\r\n /** Allow only alphanumeric characters */\r\n public alphanumeric(errorMessage?: string) {\r\n return this.addRule(alphaNumericRule, errorMessage);\r\n }\r\n\r\n /** Allow only numeric characters */\r\n public numeric(errorMessage?: string) {\r\n return this.addRule(isNumericRule, errorMessage);\r\n }\r\n\r\n /** Value must starts with the given string */\r\n public startsWith(value: string, errorMessage?: string) {\r\n return this.addRule(startsWithRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must ends with the given string */\r\n public endsWith(value: string, errorMessage?: string) {\r\n return this.addRule(endsWithRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must contain the given string */\r\n public contains(value: string, errorMessage?: string) {\r\n return this.addRule(containsRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must not contain the given string */\r\n public notContains(value: string, errorMessage?: string) {\r\n return this.addRule(notContainsRule, errorMessage, { value });\r\n }\r\n\r\n /** Value must be a valid IP address */\r\n public ip(errorMessage?: string) {\r\n return this.addRule(ipRule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid IPv4 address */\r\n public ip4(errorMessage?: string) {\r\n return this.addRule(ip4Rule, errorMessage);\r\n }\r\n\r\n /** Value must be a valid IPv6 address */\r\n public ip6(errorMessage?: string) {\r\n return this.addRule(ip6Rule, errorMessage);\r\n }\r\n\r\n /** Check if the string matches a credit card number */\r\n public creditCard(errorMessage?: string) {\r\n return this.addRule(isCreditCardRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid color */\r\n public color(errorMessage?: string) {\r\n return this.addRule(colorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid hex color */\r\n public hexColor(errorMessage?: string) {\r\n return this.addRule(hexColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid HSL color */\r\n public hslColor(errorMessage?: string) {\r\n return this.addRule(hslColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid RGB color */\r\n public rgbColor(errorMessage?: string) {\r\n return this.addRule(rgbColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid RGBA color */\r\n public rgbaColor(errorMessage?: string) {\r\n return this.addRule(rgbaColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid light color */\r\n public lightColor(errorMessage?: string) {\r\n return this.addRule(lightColorRule, errorMessage);\r\n }\r\n\r\n /** Determine if the value is a valid dark color */\r\n public darkColor(errorMessage?: string) {\r\n return this.addRule(darkColorRule, errorMessage);\r\n }\r\n\r\n // ==================== ID Format Rules ====================\r\n\r\n /**\r\n * Value must be a valid UUID. Optionally restrict to a specific version.\r\n *\r\n * @example\r\n * v.string().uuid() // any RFC 4122 UUID\r\n * v.string().uuid(4) // only v4 (random)\r\n * v.string().uuid(7) // only v7 (timestamp-ordered)\r\n */\r\n public uuid(version?: UUIDVersion, errorMessage?: string) {\r\n return this.addRule(uuidRule, errorMessage, { version });\r\n }\r\n\r\n /**\r\n * Value must be a valid CUID. Defaults to CUID2; pass `{ version: 1 }` for legacy.\r\n *\r\n * @example\r\n * v.string().cuid() // CUID2\r\n * v.string().cuid({ version: 1 }) // legacy CUID1\r\n */\r\n public cuid(options?: { version?: 1 | 2; errorMessage?: string }) {\r\n const { errorMessage, version } = options ?? {};\r\n return this.addRule(cuidRule, errorMessage, { version });\r\n }\r\n\r\n /** Value must be a valid ULID (26 chars, Crockford base32). */\r\n public ulid(errorMessage?: string) {\r\n return this.addRule(ulidRule, errorMessage);\r\n }\r\n\r\n /**\r\n * Value must be a valid nanoid string. Default length is 21.\r\n *\r\n * @example\r\n * v.string().nanoid() // 21 chars (default)\r\n * v.string().nanoid(10) // 10 chars\r\n */\r\n public nanoid(length?: number, errorMessage?: string) {\r\n return this.addRule(nanoidRule, errorMessage, { length });\r\n }\r\n\r\n /**\r\n * @inheritdoc\r\n *\r\n * Maps String-specific rule options to JSON Schema keywords.\r\n * Non-representable rules (cross-field, refine, color rules, etc.) are silently omitted.\r\n *\r\n * @example\r\n * ```ts\r\n * v.string().min(2).max(100).email().toJsonSchema(\"draft-2020-12\")\r\n * // → { type: \"string\", minLength: 2, maxLength: 100, format: \"email\" }\r\n * ```\r\n */\r\n public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\r\n const schema: JsonSchemaResult = { type: \"string\" };\r\n\r\n // minLength / min\r\n const minOpts = getRuleOptions(this.rules, \"minLength\");\r\n if (minOpts?.minLength !== undefined) schema.minLength = minOpts.minLength;\r\n\r\n // maxLength / max\r\n const maxOpts = getRuleOptions(this.rules, \"maxLength\");\r\n if (maxOpts?.maxLength !== undefined) schema.maxLength = maxOpts.maxLength;\r\n\r\n // betweenLength covers both min and max in one rule\r\n const betweenOpts = getRuleOptions(this.rules, \"betweenLength\");\r\n if (betweenOpts) {\r\n if (betweenOpts.minLength !== undefined) schema.minLength = betweenOpts.minLength;\r\n if (betweenOpts.maxLength !== undefined) schema.maxLength = betweenOpts.maxLength;\r\n }\r\n\r\n // exact length\r\n const lengthOpts = getRuleOptions(this.rules, \"length\");\r\n if (lengthOpts?.length !== undefined) {\r\n schema.minLength = lengthOpts.length;\r\n schema.maxLength = lengthOpts.length;\r\n }\r\n\r\n // pattern (regex)\r\n const patternOpts = getRuleOptions(this.rules, \"pattern\");\r\n if (patternOpts?.pattern instanceof RegExp) {\r\n schema.pattern = patternOpts.pattern.source;\r\n }\r\n\r\n // format hints\r\n if (getRuleOptions(this.rules, \"email\") !== undefined ||\r\n this.rules.some(r => r.name === \"email\")) {\r\n schema.format = \"email\";\r\n } else if (this.rules.some(r => r.name === \"url\")) {\r\n schema.format = \"uri\";\r\n } else if (this.rules.some(r => r.name === \"ip\")) {\r\n schema.format = \"ipv4\";\r\n } else if (this.rules.some(r => r.name === \"ip4\")) {\r\n schema.format = \"ipv4\";\r\n } else if (this.rules.some(r => r.name === \"ip6\")) {\r\n schema.format = \"ipv6\";\r\n } else if (this.rules.some(r => r.name === \"uuid\")) {\r\n schema.format = \"uuid\";\r\n } else if (this.rules.some(r => r.name === \"hexColor\")) {\r\n schema.format = \"color\";\r\n }\r\n\r\n // CUID / ULID / nanoid don't have widely-supported format keywords —\r\n // fall back to pattern so JSON Schema validators still enforce shape.\r\n if (!schema.format) {\r\n const cuidOpts = getRuleOptions(this.rules, \"cuid\");\r\n if (cuidOpts) {\r\n schema.pattern = cuidOpts.version === 1 ? \"^c[a-z0-9]{24,}$\" : \"^[a-z][a-z0-9]{23}$\";\r\n }\r\n if (this.rules.some(r => r.name === \"ulid\")) {\r\n schema.pattern = \"^[0-9A-HJKMNP-TV-Z]{26}$\";\r\n }\r\n const nanoidOpts = getRuleOptions(this.rules, \"nanoid\");\r\n if (nanoidOpts) {\r\n const len = (nanoidOpts.length as number | undefined) ?? 21;\r\n schema.pattern = `^[A-Za-z0-9_-]{${len}}$`;\r\n }\r\n }\r\n\r\n // enum (from PrimitiveValidator.in / .enum)\r\n const inOpts = getRuleOptions(this.rules, \"in\");\r\n if (inOpts?.values && Array.isArray(inOpts.values)) {\r\n schema.enum = inOpts.values;\r\n }\r\n\r\n if (this.isNullable) applyNullable(schema, target);\r\n\r\n return schema;\r\n }\r\n}\r\n"],"mappings":"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"}
package/llms-full.txt CHANGED
@@ -2055,7 +2055,7 @@ JSON Schema: `format: "color"` for `.hexColor()`; the others map to `format: "co
2055
2055
  | `.toAlphanumeric()` | strip non-alphanumerics |
2056
2056
  | `.removeSpecialCharacters()` | keep alphanumerics + whitespace |
2057
2057
  | `.removeNumbers()` | strip digits |
2058
- | `.safeHtml()` | strip HTML tags |
2058
+ | `.stripTags()` | strip HTML tags via a naive `<...>` regex — **not** an XSS sanitizer; `.safeHtml()` is a deprecated alias |
2059
2059
  | `.htmlEscape()` | `<` → `&lt;` etc |
2060
2060
  | `.unescapeHtml()` | reverse `htmlEscape()` |
2061
2061
 
@@ -2094,8 +2094,8 @@ v.string().strongPassword(12)
2094
2094
  // URL with strict format
2095
2095
  v.string().url().startsWith("https://")
2096
2096
 
2097
- // Sanitized HTML body
2098
- v.string().safeHtml().min(1)
2097
+ // Tag-stripped HTML body (not XSS-safe — sanitize with DOMPurify/sanitize-html before rendering untrusted rich text)
2098
+ v.string().stripTags().min(1)
2099
2099
 
2100
2100
  // Masked phone for response
2101
2101
  v.string().pattern(/^\+\d{8,}$/).mask(3, -2)
package/package.json CHANGED
@@ -1,6 +1,15 @@
1
1
  {
2
2
  "name": "@warlock.js/seal",
3
3
  "description": "Comprehensive Validation library",
4
+ "dependencies": {
5
+ "@mongez/supportive-is": "^2.1.4",
6
+ "@mongez/reinforcements": "^4.0.1",
7
+ "dayjs": "^1.11.9"
8
+ },
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "https://github.com/warlockjs/seal"
12
+ },
4
13
  "keywords": [
5
14
  "validation",
6
15
  "typescript",
@@ -10,16 +19,7 @@
10
19
  ],
11
20
  "author": "hassanzohdy",
12
21
  "license": "MIT",
13
- "repository": {
14
- "type": "git",
15
- "url": "https://github.com/warlockjs/seal"
16
- },
17
- "dependencies": {
18
- "@mongez/supportive-is": "^2.1.3",
19
- "@mongez/reinforcements": "^3.3.0",
20
- "dayjs": "^1.11.9"
21
- },
22
- "version": "4.14.0",
22
+ "version": "4.16.0",
23
23
  "main": "./cjs/index.cjs",
24
24
  "module": "./esm/index.mjs",
25
25
  "types": "./esm/index.d.mts",
@@ -119,7 +119,7 @@ JSON Schema: `format: "color"` for `.hexColor()`; the others map to `format: "co
119
119
  | `.toAlphanumeric()` | strip non-alphanumerics |
120
120
  | `.removeSpecialCharacters()` | keep alphanumerics + whitespace |
121
121
  | `.removeNumbers()` | strip digits |
122
- | `.safeHtml()` | strip HTML tags |
122
+ | `.stripTags()` | strip HTML tags via a naive `<...>` regex — **not** an XSS sanitizer; `.safeHtml()` is a deprecated alias |
123
123
  | `.htmlEscape()` | `<` → `&lt;` etc |
124
124
  | `.unescapeHtml()` | reverse `htmlEscape()` |
125
125
 
@@ -158,8 +158,8 @@ v.string().strongPassword(12)
158
158
  // URL with strict format
159
159
  v.string().url().startsWith("https://")
160
160
 
161
- // Sanitized HTML body
162
- v.string().safeHtml().min(1)
161
+ // Tag-stripped HTML body (not XSS-safe — sanitize with DOMPurify/sanitize-html before rendering untrusted rich text)
162
+ v.string().stripTags().min(1)
163
163
 
164
164
  // Masked phone for response
165
165
  v.string().pattern(/^\+\d{8,}$/).mask(3, -2)