wip

app/Http/Controllers/Api/V1/Banner/BannerController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Banner;
+
+use App\Http\Controllers\Api\V1\Banner\Requests\BannerIndexRequest;
+use App\Http\Controllers\Api\V1\Banner\Resources\BannerResource;
+use App\Http\Controllers\Controller;
+use App\Models\CMS\Media\Banner;
+use Illuminate\Http\JsonResponse;
+
+class BannerController extends Controller
+{
+    /**
+     * (Media) Banners (index)
+     */
+    public function index(BannerIndexRequest $request): JsonResponse
+    {
+        return response()->rest_paginate(
+            BannerResource::collection(
+                Banner::with('media')
+                    ->where('is_visible', true)
+                    ->when($request->place, fn ($query, $place) => $query->where('place', $place))
+                    ->when($request->app, fn ($query, $app) => $query->where('app', $app))
+                    ->ordered()
+                    ->simplePaginate(
+                        perPage: $request->perPage,
+                        columns: $request->fields,
+                    )
+            )
+        );
+    }
+}

app/Http/Controllers/Api/V1/Banner/Requests/BannerIndexRequest.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Banner\Requests;
+
+use App\Models\CMS\Media\Banner;
+use App\Models\System\Settings\OS;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class BannerIndexRequest extends FormRequest
+{
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'place' => ['nullable', 'string', Rule::in(array_keys(Banner::places()))],
+            'app' => ['nullable', 'string', Rule::in(array_keys(OS::apps()))],
+            'perPage' => ['nullable', 'integer'],
+            'fields' => ['nullable', 'string'],
+        ];
+    }
+
+    /**
+     * Handle a passed validation attempt.
+     */
+    protected function passedValidation(): void
+    {
+        $fields = [];
+        if ($this->fields) {
+            $sanitezedFields = validateCommaSeperated($this->fields, Banner::class);
+
+            $fields['fields'] = ! empty($sanitezedFields) ? $sanitezedFields : ['*'];
+        } else {
+            $fields['fields'] = ['*'];
+        }
+
+        $this->merge([
+            'perPage' => $this->perPage ?: 6,
+            ...$fields,
+        ]);
+    }
+
+    /**
+     * Get the error messages for the defined validation rules.
+     *
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'place.in' => sprintf('Valid sources: %s', implode(', ', array_keys(OS::apps()))),
+            'app.in' => sprintf('Valid sources: %s', implode(', ', array_keys(OS::apps()))),
+        ];
+    }
+}

app/Http/Controllers/Api/V1/Banner/Resources/BannerResource.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Banner\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class BannerResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->whenHas('id'),
+            'app' => $this->whenHas('app'),
+            'title' => $this->whenHas('title'),
+            'place' => $this->whenHas('place'),
+            'link' => $this->whenHas('link'),
+            'resource_type' => $this->whenHas('resource_type'),
+            'resource_id' => $this->whenHas('resource_id'),
+            'thumbnail' => $this->thumbnail('350x350'),
+            'related_resources' => $this->when(
+                condition: $this->shouldIncludeRelatedResources($request),
+                value: fn () => $this->relatedResources(),
+            ),
+        ];
+    }
+
+    /**
+     * Check if should include related resources
+     */
+    protected function shouldIncludeRelatedResources(Request $request): bool
+    {
+        if (! $request->fields) {
+            $request->merge(['fields' => ['*']]);
+        }
+
+        if ($request->fields[0] === '*') {
+            return true;
+        }
+
+        return in_array(['resource_type', 'resource_id', 'place'], $request->fields);
+    }
+}