Release v4.0.0 · Blaspsoft/blasp

Blasp v4.0.0

A ground-up rewrite with a driver-based architecture, severity scoring, and deep Laravel integration.

Driver-based architecture — regex (obfuscation/substitution detection), pattern (fast exact matching), phonetic (sound-alike evasion via metaphone + Levenshtein), and pipeline (chain multiple drivers together). Extend with custom drivers.
Severity scoring — Profanities categorised as mild/moderate/high/extreme with per-word weights and a 0–100 composite score. Filter by minimum severity threshold.
Multi-language support — English, Spanish, German, French with language-specific normalizers and severity maps. Check one, many, or all at once via fluent API.
Masking strategies — Character mask (*, #), grawlix (!@#$%), or a custom callback.
Eloquent integration — Blaspable trait auto-sanitizes or rejects profanity on model save, with withoutBlaspChecking() for bypassing.
Middleware — CheckProfanity middleware to reject or sanitize profane request fields with configurable severity and field filtering.
Validation rule — blasp_check rule with language support.
Blade directive — @clean($text) for output sanitization.
Str/Stringable macros — Str::isProfane(), Str::cleanProfanity(), and Stringable equivalents.
Result caching — Configurable cache driver, TTL, and key eviction.
Events — ProfanityDetected, ContentBlocked, ModelProfanityDetected.
Testing utilities — Blasp::fake() for test doubles with assertions.

Namespace flattened — Blaspsoft\Blasp\Laravel\ merged into Blaspsoft\Blasp\. Update any direct class references.
Service provider renamed — ServiceProvider → BlaspServiceProvider (auto-discovery handles this).
Config file renamed — config/config.php → config/blasp.php. Re-publish with php artisan vendor:publish --tag="blasp-config".
API changes — check() now returns a Result object with isOffensive(), clean(), score(), severity(), count(), words(), uniqueWords(). Previous methods like hasProfanity(), getCleanString(), getProfanitiesCount() are removed.