@smartsoft001/utils
v2.211.0
Published
Framework-free static helpers for identifiers, Polish document validation, arrays, objects, slugs and in-memory specification checks.
Readme
📦 @smartsoft001/utils
🚀 Usage
npm i @smartsoft001/utils
🛠️ Services & Methods
ArrayService
Methods:
GuidService
Methods:
NipService
Methods:
ObjectService
Methods:
Password hashing
PasswordService hashes with an unsalted MD5 digest. That is the framework default and stays
so for compatibility with stored hashes, but MD5 is not a password hash: replace it for any
credentials that matter.
The framework never calls PasswordService directly. Login (@smartsoft001/auth-*) and the
password field of CRUD records (@smartsoft001/crud-*) use the IPasswordHasher registered
under the PASSWORD_HASHER token, and fall back to Md5PasswordHasher when there is none.
Register one provider anywhere in the Nest application to replace it everywhere:
{ provide: PASSWORD_HASHER, useClass: Pbkdf2PasswordHasher }Pbkdf2PasswordHasher is the ready-made replacement: PBKDF2-HMAC-SHA256 through Web Crypto,
600,000 iterations by default, a random 128-bit salt and a 256-bit key, compared in constant
time. Before switching:
- the stored value is 118 characters (
pbkdf2-sha256$600000$<salt>$<key>), so the password column must hold at least that; - it still verifies MD5 hashes, and
needsRehashreports them and hashes with fewer iterations than configured, so the built-in login upgrades them on the next successful login, with a conditional write; accounts that never log in keep the old hash, so set a reset deadline; - a rollback to a version, or a hasher, that only knows MD5 cannot verify upgraded hashes;
- hashing is deliberately slow: rate-limit the login endpoint and size capacity for it.
For bcrypt, argon2 or anything else, implement IPasswordHasher (hash, compare and the
optional needsRehash). The guide with executed examples:
https://framework.smartflow.biz.pl/docs/password-hashing/.
PeselService
Methods:
RemoveHtmlService
Methods:
SlugService
Methods:
SpecificationService
Methods:
ZipCodeService
Methods:
🔧 Functions
capitalize
🤝 Contributing
Contributions are welcome! 🎉
- Fork the repository.
- Create a feature branch: git checkout -b feature/my-new-feature.
- Commit your changes: git commit -m 'Add some feature'.
- Push to the branch: git push origin feature/my-new-feature. Submit a pull request.
For more details, see our Contributing Guidelines.
📝 Changelog
All notable changes to this project will be documented in the CHANGELOG.
📜 License
This project is licensed under the MIT License.
