#11 - Add build from query method to builder class (#13)

readme.md

@@ -37,3 +37,12 @@ $data = [
 $heatmapBuilder = new LaravelHeatmapBuilder();
 $heatmap = $heatmapBuilder->buildFromArray($data, 'created_at');
 ```
+There is also option to build from query:
+```php
+use Blumilk\LaravelHeatmap\LaravelHeatmapBuilder;
+
+$query = YourModel::where('created_at', '>', '2022-11-01 00:00:00');
+
+$heatmapBuilder = new LaravelHeatmapBuilder();
+$heatmap = $heatmapBuilder->buildFromQuery($query, 'created_at');
+```

src/LaravelHeatmapBuilder.php

@@ -9,6 +9,7 @@
 use Blumilk\Heatmap\HeatmapBuilder;
 use Blumilk\Heatmap\PeriodInterval;
 use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Collection;
 use InvalidArgumentException;
@@ -30,6 +31,21 @@ public function buildFromArray(array $data, string $arrayAccessIndex = self::DEF
         return parent::build($collection);
     }
 
+    public function buildFromQuery(Builder $query, string $arrayAccessIndex = self::DEFAULT_ARRAY_ACCESS_INDEX): array
+    {
+        if (!is_a($query, Builder::class)) {
+            throw new InvalidArgumentException("The provided query is not a valid Eloquent Builder instance.");
+        }
+
+        $this->arrayAccessIndex = $arrayAccessIndex;
+
+        $results = $query->get();
+
+        $collection = $results instanceof Collection ? $results : collect($results);
+
+        return $this->buildFromCollection($collection, $arrayAccessIndex);
+    }
+
     /**
      * @param iterable<array|ArrayAccess|TimeGroupable|Model> $data
      */