one-linear-validator 🧪

🔍 A minimalist, dependency-free JavaScript validation library with one-liner functions for common input formats like Email, Phone, URL, Hex Color, Date, and Strong Passwords — returns clean structured results with error messages.

✨ Features

• ✅ Email validation
• 📱 Phone number validation
• 🌐 URL validation
• 🎨 Hex color code validation
• 📅 Date (YYYY-MM-DD) validation
• 🔒 Strong password checker (with custom rules)
• ⚡️ Lightweight & fast
• ❌ No external dependencies
• ✅ ESM support (Node.js & modern browsers)

📦 Installation

1npm install one-linear-validator
2or with yarn:
3
4yarn add one-linear-validator
5
6🚀 Usage
7
8import {
9  isEmail,
10  isPhoneNumber,
11  isURL,
12  isHexColor,
13  isDate,
14  isStrongPassword,
15} from 'one-linear-validator';
16
17console.log(isEmail('test@example.com'));
18// { valid: true }
19
20console.log(isPhoneNumber('+1234567890'));
21// { valid: true }
22
23console.log(isURL('https://example.com'));
24// { valid: true }
25
26console.log(isHexColor('#ffcc00'));
27// { valid: true }
28
29console.log(isDate('2024-05-06'));
30// { valid: true }
31
32console.log(isStrongPassword('Password@123'));
33// { valid: true }
34📚 API Reference
35Each validator returns an object:
36
37
38{ valid: true } 
39// or 
40{ valid: false, error: 'Reason here' }
41isEmail(str)
42Checks for a valid email format.
43
44isPhoneNumber(str)
45Accepts international formats, with or without +.
46
47isURL(str)
48Matches HTTP/HTTPS URLs, domains, optional port and path.
49
50isHexColor(str)
51Supports #RGB, #RRGGBB, or without #.
52
53isDate(str)
54Accepts date in YYYY-MM-DD format.
55
56isStrongPassword(str, options?)
57Checks password strength with default or custom rules.
58
59Options:
60
61{
62  minLength: 8,
63  uppercase: true,
64  number: true,
65  specialChar: true
66}
67
68✅ Example with Custom Password Rules
69
70isStrongPassword('abc123', {
71  minLength: 6,
72  uppercase: false,
73  number: true,
74  specialChar: false,
75});
76💡 Why one-linear-validator?
77✅ Clean return values
78✅ Simple integration
79✅ Great for forms, APIs, and input sanitization
80✅ Developer-friendly messages
81
82🛠️ Contributing
83Pull requests and suggestions are welcome!
84Open an issue or fork and create a PR.
85
86📄 License
87Licensed under the Apache-2.0 License.
88
89🌐 Links
90📦 NPM Page
91
92🛠 GitHub Repo
93
94Built with ❤️ by Muhammad Ahsan Raza
95
96---