Merge pull request #21 from ginkelsoft-development/feature/add-debug-logging

add optional debug logging for search index operations

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

@@ -126,6 +126,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);
@@ -152,6 +162,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 {