Add advanced aggregation, filter, and DSL output tests

Introduces comprehensive test coverage for advanced aggregations, filter context queries, and DSL output inspection. Adds new test files for aggregation (AggregationAdvancedTest), filter context (FilterWhereTest), and DSL output (DslOutputTest). Implements a trait (TestsWithIdStrategies) for conditional ID generation in tests. Updates Eloquent and Query builders to support time-based where clauses and new query methods. Removes legacy test models and test cases related to ID strategies, consolidating model usage.

Author: pdphilip

.gitignore

@@ -1,5 +1,6 @@
 .env
 .env.*
+.cl*
 
 #composer
 vendor

_ide_helper.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * IDE Helper for Laravel version compatibility traits.
+ *
+ * This file helps IDEs understand the runtime trait switching.
+ * Points to v12 implementations as the canonical reference.
+ *
+ * @see /src/Laravel/Compatibility/
+ */
+
+namespace PDPhilip\Elasticsearch\Laravel\Compatibility\Schema {
+
+    use PDPhilip\Elasticsearch\Laravel\v12\Schema\BlueprintCompatibility as BlueprintCompat12;
+    use PDPhilip\Elasticsearch\Laravel\v12\Schema\BuilderCompatibility as BuilderCompat12;
+    use PDPhilip\Elasticsearch\Laravel\v12\Schema\GrammarCompatibility as GrammarCompat12;
+
+    trait BlueprintCompatibility
+    {
+        use BlueprintCompat12;
+    }
+
+    trait BuilderCompatibility
+    {
+        use BuilderCompat12;
+    }
+
+    trait GrammarCompatibility
+    {
+        use GrammarCompat12;
+    }
+}
+
+namespace PDPhilip\Elasticsearch\Laravel\Compatibility\Connection {
+
+    use PDPhilip\Elasticsearch\Laravel\v12\Connection\ConnectionCompatibility as ConnectionCompat12;
+
+    trait ConnectionCompatibility
+    {
+        use ConnectionCompat12;
+    }
+}

src/Eloquent/Builder.php

@@ -66,6 +66,7 @@ class Builder extends BaseEloquentBuilder
         'rawvalue',
         'tosql',
         'torawsql',
+        'tocompiledquery',
 
         // ES
         'todsl',

src/Eloquent/Docs/ModelDocs.php

@@ -179,6 +179,7 @@
  * @method static $this orderByNestedDesc($column, $direction = 'asc', $mode = null)
  *-----------------------------------
  * @method static $this withSort($column, $key, $value)
+ * @method static $this withRefresh($type)
  *===========================================
  * Executors
  *===========================================
@@ -189,8 +190,9 @@
  * @method static array getModels($columns = ['*'])
  * @method static ElasticCollection get($columns = ['*'])
  * @method static ElasticCollection insert($values, $returnData = null)
- * @method static self createOnly()
- * @method static self createOrFail(array $attributes)
+ * @method static $this create(array $attributes)
+ * @method static $this createOnly()
+ * @method static $this createOrFail(array $attributes)
  *-----------------------------------
  * @method static array toDsl($columns = ['*'])
  * @method static array toSql($columns = ['*'])

src/Query/Builder.php

@@ -448,6 +448,11 @@ public function orWhereDate($column, $operator, $value = null, array $options =
      */
     protected function addDateBasedWhere($type, $column, $operator, $value, $boolean = 'and', array $options = [])
     {
+        // Handle Time type specially since it compares multiple components
+        if ($type === 'Time') {
+            return $this->addTimeBasedWhere($column, $operator, $value, $boolean, $options);
+        }
+
         switch ($type) {
             case 'Year':
                 $dateType = 'year';
@@ -480,6 +485,63 @@ protected function addDateBasedWhere($type, $column, $operator, $value, $boolean
         return $this;
     }
 
+    /**
+     * Add a time-based where clause (whereTime) to the query.
+     *
+     * Handles time comparisons with various formats: HH:mm:ss, HH:mm, or HH
+     *
+     * @param  string  $column
+     * @param  string  $operator
+     * @param  string  $value
+     * @param  string  $boolean
+     * @param  array  $options
+     * @return $this
+     */
+    protected function addTimeBasedWhere($column, $operator, $value, $boolean = 'and', array $options = [])
+    {
+        $type = 'Script';
+
+        $operator = $operator == '=' ? '==' : $operator;
+        $operator = $operator == '<>' ? '!=' : $operator;
+
+        // Parse time value - can be HH:mm:ss, HH:mm, or just HH
+        $timeParts = explode(':', $value);
+        $hour = (int) ($timeParts[0] ?? 0);
+        $minute = isset($timeParts[1]) ? (int) $timeParts[1] : null;
+        $second = isset($timeParts[2]) ? (int) $timeParts[2] : null;
+
+        // Build time comparison - convert to seconds since midnight for easier comparison
+        $docTimeExpr = "doc.{$column}.value.hour * 3600 + doc.{$column}.value.minute * 60 + doc.{$column}.value.second";
+
+        // Build the target time value in seconds since midnight
+        $targetSeconds = $hour * 3600;
+        if ($minute !== null) {
+            $targetSeconds += $minute * 60;
+            if ($second !== null) {
+                $targetSeconds += $second;
+            }
+        }
+
+        // For partial time matches (HH:mm or just HH), adjust the comparison
+        if ($second === null && $minute === null) {
+            // Just hour specified - compare only the hour part
+            $docTimeExpr = "doc.{$column}.value.hour";
+            $targetSeconds = $hour;
+        } elseif ($second === null) {
+            // Hour and minute specified - compare hour*60+minute
+            $docTimeExpr = "doc.{$column}.value.hour * 60 + doc.{$column}.value.minute";
+            $targetSeconds = $hour * 60 + $minute;
+        }
+
+        $script = "doc.{$column}.size() > 0 && doc.{$column}.value != null && {$docTimeExpr} {$operator} params.value";
+
+        $options['params'] = ['value' => $targetSeconds];
+
+        $this->wheres[] = compact('script', 'options', 'type', 'boolean');
+
+        return $this;
+    }
+
     /**
      * {@inheritdoc}
      */