Consolidate metadata into single DTO

Author: pdphilip

src/Data/MetaDTO.php

@@ -8,6 +8,15 @@
 use Illuminate\Support\Arr;
 use PDPhilip\Elasticsearch\Traits\Makeable;
 
+/**
+ * Raw ES response transfer object.
+ *
+ * Created by the Processor from ES response arrays. Carries response data
+ * to QueryMeta (collection-level) and ModelMeta (per-model) via their setters.
+ *
+ * The set() method allows the Processor to add computed values (query, dsl, total, after_key)
+ * after construction.
+ */
 class MetaDTO implements Arrayable
 {
     use Makeable;

src/Data/ModelMeta.php

@@ -4,6 +4,15 @@
 
 use Illuminate\Support\Arr;
 
+/**
+ * Per-model metadata.
+ *
+ * Manages two concerns:
+ * - Document metadata from ES responses (score, highlights, sort, cursor, index, docCount, bucket)
+ * - Table/index identity (table name, prefix, suffix for dynamic indices)
+ *
+ * Data flow: ES response → Processor → MetaDTO → ModelMeta (via setMeta)
+ */
 final class ModelMeta
 {
     protected string $recordIndex = '';
@@ -26,8 +35,6 @@ final class ModelMeta
 
     protected ?int $docCount = null;
 
-    //    public array $_query = []; //TBD
-
     public function __construct($table, $tablePrefix)
     {
         $this->table = $table;
@@ -121,10 +128,6 @@ public function toArray(): array
     // ----------------------------------------------------------------------
     // Setters
     // ----------------------------------------------------------------------
-    //    public function setId($id): void
-    //    {
-    //        $this->_id = $id;
-    //    }
 
     public function setTable($table): void
     {