add optional debug logging for search index operations

This commit introduces a configurable debug logging feature that helps
developers and operators monitor encrypted search index operations.

Changes:
- Added 'debug' configuration option in encrypted-search.php
- Implemented conditional logging in updateSearchIndex() method
- Implemented conditional logging in removeSearchIndex() method
- Logs include model class, model ID, token count, and backend type

The logging only activates when ENCRYPTED_SEARCH_DEBUG=true is set
in the environment configuration, preventing unnecessary log noise
in production environments.

Author: ginkelsoft-development

config/encrypted-search.php

@@ -82,4 +82,18 @@
         'host'    => env('ELASTICSEARCH_HOST', 'http://elasticsearch:9200'),
         'index'   => env('ELASTICSEARCH_INDEX', 'encrypted_search'),
     ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Debug Logging
+    |--------------------------------------------------------------------------
+    |
+    | Enable debug logging for encrypted search operations. When enabled,
+    | the package will log token generation, index updates, and deletions
+    | to help with debugging and monitoring.
+    |
+    | Warning: This can generate a lot of log entries in high-traffic applications.
+    |
+    */
+    'debug' => env('ENCRYPTED_SEARCH_DEBUG', false),
 ];

src/Traits/HasEncryptedSearchIndex.php

@@ -121,6 +121,16 @@ public function updateSearchIndex(): void
             return;
         }
 
+        // Debug logging
+        if (config('encrypted-search.debug', false)) {
+            logger()->debug('[EncryptedSearch] Updating search index', [
+                'model' => static::class,
+                'model_id' => $this->getKey(),
+                'token_count' => count($rows),
+                'backend' => $useElastic ? 'elasticsearch' : 'database',
+            ]);
+        }
+
         // Choose backend: Elasticsearch or Database
         if ($useElastic) {
             $this->syncToElasticsearch($rows);
@@ -145,6 +155,15 @@ public function removeSearchIndex(): void
     {
         $useElastic = config('encrypted-search.elasticsearch.enabled', false);
 
+        // Debug logging
+        if (config('encrypted-search.debug', false)) {
+            logger()->debug('[EncryptedSearch] Removing search index', [
+                'model' => static::class,
+                'model_id' => $this->getKey(),
+                'backend' => $useElastic ? 'elasticsearch' : 'database',
+            ]);
+        }
+
         if ($useElastic) {
             $this->removeFromElasticsearch();
         } else {