feat: add min search length control

fix: #3241

Author: yajra

src/CollectionDataTable.php

@@ -143,6 +143,8 @@ public function paging(): void
     public function make(bool $mDataSupport = true): JsonResponse
     {
         try {
+            $this->validateMinLengthSearch();
+
             $this->totalRecords = $this->totalCount();
 
             if ($this->totalRecords) {

src/DataTableAbstract.php

@@ -122,6 +122,8 @@ abstract class DataTableAbstract implements DataTable
 
     protected bool $editOnlySelectedColumns = false;
 
+    protected int $minSearchLength = 0;
+
     /**
      * Can the DataTable engine be created with these parameters.
      *
@@ -989,4 +991,27 @@ protected function getPrimaryKeyName(): string
     {
         return 'id';
     }
+
+    public function minSearchLength(int $length): static
+    {
+        $this->minSearchLength = $length;
+
+        return $this;
+    }
+
+    protected function validateMinLengthSearch(): void
+    {
+        if ($this->request->isSearchable()
+            && $this->minSearchLength > 0
+            && Str::length($this->request->keyword()) < $this->minSearchLength
+        ) {
+            $this->totalRecords = 0;
+            $this->filteredRecords = 0;
+            throw new \Exception(
+                __('Please enter at least :length characters to search.', ['length' => $this->minSearchLength]),
+                400
+            );
+        }
+    }
+
 }

src/QueryDataTable.php

@@ -124,6 +124,8 @@ public static function canCreate($source): bool
     public function make(bool $mDataSupport = true): JsonResponse
     {
         try {
+            $this->validateMinLengthSearch();
+
             $results = $this->prepareQuery()->results();
             $processed = $this->processResults($results, $mDataSupport);
             $data = $this->transform($results, $processed);