V2.2.1

README.md

@@ -35,19 +35,16 @@ import {
     ComposedValSan
 } from 'valsan';
 
-class UsernameValSan extends ComposedValSan<string, string> {
-    public constructor() {
-        super([
-            new TrimSanitizer(),
-            new LengthValidator({ minLength: 5, maxLength: 10 }),
-            new LowercaseSanitizer(),
-        ]);
-    }
-}
+const usernameValSan = new ComposedValSan<string, string>([
+    new TrimSanitizer(),
+    new LengthValidator({ minLength: 5, maxLength: 10 }),
+    new LowercaseSanitizer(),
+]);
 
 // Create an object sanitizer
 const sanitizer = new ObjectSanitizer({
-  username: new UsernameValSan(),
+  username: usernameValSan,
+  optionalUsername: usernameValSan.copy({ isOptional: true }),
   email: new EmailValidator(),
 });
 

docs/using-options.md

@@ -14,3 +14,25 @@ You can use options to:
 - Pass dependencies (e.g. database)
 
 All options are optional and have sensible defaults. See validator docs for details.
+
+## Copying
+
+You can copy an existing validator or sanitizer and override its options or rules using the `.copy()` method. This is handy when you want a slightly different behavior (for example making a validator optional) without recreating the instance.
+
+Example:
+
+```typescript
+import { ComposedValSan, MinLengthValidator } from 'valsan';
+
+const minLen = new ComposedValSan([
+    MinLengthValidator({ minLength: 5 })
+]);
+
+// Copy to make optional
+const optionalMinLen = minLen.copy({ isOptional: true });
+
+await minLen.run('hi');              // fails
+await optionalMinLen.run(undefined); // passes because it's now optional
+```
+
+`.copy()` returns a new instance with the provided overrides merged into the original options; the original instance is unchanged.

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "valsan",
-	"version": "2.2.0",
+	"version": "2.2.1",
 	"description": "Validation and sanitization library for TypeScript",
 	"private": "true",
 	"typescript-template": {

src/primitives/index.ts

@@ -7,11 +7,16 @@ export * from './bool';
 // Date-time primitives
 export * from './date-time';
 
+export * from './network';
+
+// Number primitives
+export * from './number';
+
 // Person primitives
 export * from './person';
 
 // String primitives
 export * from './string';
 
-// Number primitives
-export * from './number';
+// Utility primitives
+export * from './utility';

test/spec/primitives/network/ip-address-valsan.spec.ts

@@ -1,5 +1,5 @@
 // eslint-disable-next-line max-len
-import { IpAddressValSan } from '../../../../src/primitives/network/ip-address-valsan';
+import { IpAddressValSan } from '../../../../src/primitives';
 
 describe('IpAddressValSan', () => {
 	const valSan = new IpAddressValSan();

test/spec/primitives/utility/enum-validator.spec.ts

@@ -1,5 +1,5 @@
 // eslint-disable-next-line max-len
-import { EnumValidator } from '../../../../src/primitives/utility/enum-validator';
+import { EnumValidator } from '../../../../src/primitives/utility';
 
 describe('EnumValidator', () => {
 	it('should pass for allowed values', async () => {