vendor and env first commit

vendor/spatie/laravel-query-builder/src/Concerns/AddsIncludesToQuery.php

@@ -0,0 +1,103 @@
+<?php
+
+namespace Spatie\QueryBuilder\Concerns;
+
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+use Spatie\QueryBuilder\AllowedInclude;
+use Spatie\QueryBuilder\Exceptions\InvalidIncludeQuery;
+use Spatie\QueryBuilder\Includes\IncludeInterface;
+
+trait AddsIncludesToQuery
+{
+    protected ?Collection $allowedIncludes = null;
+
+    public function allowedIncludes($includes): static
+    {
+        $includes = is_array($includes) ? $includes : func_get_args();
+
+        $this->allowedIncludes = collect($includes)
+            ->reject(function ($include) {
+                return empty($include);
+            })
+            ->flatMap(function ($include): Collection {
+                if ($include instanceof Collection) {
+                    return $include;
+                }
+
+                if ($include instanceof IncludeInterface) {
+                    return collect([$include]);
+                }
+
+                if (Str::endsWith($include, config('query-builder.count_suffix', 'Count'))) {
+                    return AllowedInclude::count($include);
+                }
+
+                if (Str::endsWith($include, config('query-builder.exists_suffix', 'Exists'))) {
+                    return AllowedInclude::exists($include);
+                }
+
+                return AllowedInclude::relationship($include);
+            })
+            ->unique(function (AllowedInclude $allowedInclude) {
+                return $allowedInclude->getName();
+            });
+
+        $this->ensureAllIncludesExist();
+
+        $includes = $this->filterNonExistingIncludes($this->request->includes());
+
+        $this->addIncludesToQuery($includes);
+
+        return $this;
+    }
+
+    protected function addIncludesToQuery(Collection $includes)
+    {
+        $includes->each(function ($include) {
+            $include = $this->findInclude($include);
+
+            $include->include($this);
+        });
+    }
+
+    protected function findInclude(string $include): ?AllowedInclude
+    {
+        return $this->allowedIncludes
+            ->first(function (AllowedInclude $included) use ($include) {
+                return $included->isForInclude($include);
+            });
+    }
+
+    protected function ensureAllIncludesExist()
+    {
+        if (config('query-builder.disable_invalid_includes_query_exception', false)) {
+            return;
+        }
+
+        $includes = $this->request->includes();
+
+        $allowedIncludeNames = $this->allowedIncludes->map(function (AllowedInclude $allowedInclude) {
+            return $allowedInclude->getName();
+        });
+
+        $diff = $includes->diff($allowedIncludeNames);
+
+        if ($diff->count()) {
+            throw InvalidIncludeQuery::includesNotAllowed($diff, $allowedIncludeNames);
+        }
+
+        // TODO: Check for non-existing relationships?
+    }
+
+    protected function filterNonExistingIncludes(Collection $includes): Collection
+    {
+        if (config('query-builder.disable_invalid_includes_query_exception', false) == false) {
+            return $includes;
+        }
+
+        return $includes->filter(function ($include) {
+            return $this->findInclude($include);
+        });
+    }
+}