Merge pull request #24 from devaction-labs/feat/new-filter

Feat/new filter

Author: alexnogueirasilva

CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to `filterable-package` will be documented in this file.
 
+## 1.1.0 - 2025-09-14
+
+### Added
+- **New Filter Types**: Added 7 new commonly used filter types
+  - `ilike()` - Case-insensitive LIKE with database-specific handling (PostgreSQL ILIKE, SQLite LIKE, MySQL LOWER())
+  - `notEquals()` - NOT EQUALS (!=) filter for excluding specific values
+  - `notIn()` - NOT IN filter for excluding multiple values from a list
+  - `notLike()` - NOT LIKE filter for excluding text patterns
+  - `isNull()` - IS NULL filter for checking null values
+  - `isNotNull()` - IS NOT NULL filter for checking non-null values
+  - `startsWith()` - STARTS WITH filter using LIKE with % suffix
+  - `endsWith()` - ENDS WITH filter using LIKE with % prefix
+
+### Enhanced
+- **Database Compatibility**: Improved database-specific handling for different SQL dialects
+  - PostgreSQL: Uses native ILIKE for case-insensitive searches
+  - SQLite: Falls back to LIKE for case-insensitive searches  
+  - MySQL: Uses LOWER() function for case-insensitive comparisons
+- **Filter Value Processing**: Enhanced `prepareValue()` method to handle new filter types
+  - Automatic pattern generation for STARTS_WITH and ENDS_WITH
+  - Support for comma-separated values in NOT_IN filters
+  - Pattern application for NOT_LIKE filters
+
+### Testing
+- **Comprehensive Test Coverage**: Added complete test suite for all new filter types
+  - Unit tests for each new filter type
+  - Database driver detection tests
+  - Operator validation tests
+  - Integration tests with Filterable trait
+
+### Performance
+- **Optimized Query Building**: Enhanced `applyFilterToBuilder()` method
+  - Direct method calls for null checks (whereNull/whereNotNull)
+  - Efficient handling of negation filters (whereNotIn)
+  - Streamlined LIKE pattern processing
+
 ## 1.0.22 - 2025-04-04
 
 ### Added

README.md

@@ -12,7 +12,8 @@ A Laravel package for filterable traits and classes. This package provides power
 ## Features
 
 - **Easy Integration:** Apply the `Filterable` trait to your Eloquent models.
-- **Flexible Filters:** Exact, like, in, between, greater than (gte, gt), less than (lte, lt), JSON, and relationship filters.
+- **Comprehensive Filters:** Support for 15+ filter types including exact, like, ilike, in, between, greater/less than, negation filters (notEquals, notIn, notLike), null checks (isNull, isNotNull), and text pattern filters (startsWith, endsWith).
+- **Database Compatibility:** Database-specific optimizations for PostgreSQL, MySQL, and SQLite.
 - **Dynamic Sorting:** Customize sorting behavior directly from requests.
 - **Relationship Filters:** Use advanced conditional logic like `whereAny`, `whereAll`, and `whereNone` for relational queries.
 - **JSON Support:** Directly filter JSON columns with dot-notation.
@@ -84,13 +85,44 @@ class ExpenseController extends Controller
 ## Available Filters
 
 ### Direct Filters
+
+#### Basic Comparison Filters
 - **Exact Match:** `Filter::exact('status', 'status')`
-- **LIKE Match:** `Filter::like('description', 'search')`
-- **IN Clause:** `Filter::in('category_id', 'categories')`
+- **Not Equals:** `Filter::notEquals('status', 'exclude_status')`
+- **Greater Than:** `Filter::gt('amount', 'min_amount')`
 - **Greater Than or Equal:** `Filter::gte('amount', 'min_amount')`
+- **Less Than:** `Filter::lt('amount', 'max_amount')`
 - **Less Than or Equal:** `Filter::lte('amount', 'max_amount')`
 - **Between:** `Filter::between('created_at', 'date_range')`
 
+#### Text Search Filters
+- **LIKE Match:** `Filter::like('description', 'search')`
+- **Case-Insensitive LIKE:** `Filter::ilike('description', 'search')` **(Database-specific)**
+- **NOT LIKE:** `Filter::notLike('description', 'exclude_text')`
+- **Starts With:** `Filter::startsWith('name', 'name_prefix')`
+- **Ends With:** `Filter::endsWith('email', 'email_suffix')`
+
+#### List and Array Filters  
+- **IN Clause:** `Filter::in('category_id', 'categories')`
+- **NOT IN Clause:** `Filter::notIn('status', 'exclude_statuses')`
+
+#### Null Value Filters
+- **Is Null:** `Filter::isNull('deleted_at', 'show_deleted')`
+- **Is Not Null:** `Filter::isNotNull('email_verified_at', 'verified_only')`
+
+#### Database-Specific Behavior
+The `ilike()` filter automatically adapts to your database:
+- **PostgreSQL:** Uses native `ILIKE` operator
+- **SQLite:** Falls back to `LIKE` (case-sensitive)  
+- **MySQL:** Uses `LOWER()` function for case-insensitive comparison
+
+```php
+// Example usage for case-insensitive search
+$filters = [
+    Filter::ilike('name', 'search'), // Works across all databases
+];
+```
+
 ### JSON Filters
 - **Exact Match:** `Filter::json('data', 'user.name', '=', 'user_name')`
 - **LIKE Match:** `Filter::json('data', 'user.name', 'LIKE', 'user_name')`

composer.json

@@ -9,7 +9,7 @@
             "email": "alex@devaction.com.br"
         }
     ],
-    "version": "1.0.23",
+    "version": "1.0.24",
     "require": {
         "php": "^8.2|^8.3|^8.4",
         "illuminate/cache": "^11|^12",