wip

app/Http/Controllers/Api/V1/Carousel/CarouselController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Carousel;
+
+use App\Http\Controllers\Api\V1\Carousel\Requests\CarouselIndexRequest;
+use App\Http\Controllers\Api\V1\Carousel\Resources\CarouselResource;
+use App\Http\Controllers\Controller;
+use App\Models\CMS\Media\Carousel;
+use Illuminate\Http\JsonResponse;
+
+class CarouselController extends Controller
+{
+    /**
+     * (Media) Carousels (index)
+     */
+    public function index(CarouselIndexRequest $request): JsonResponse
+    {
+        return response()->rest_paginate(
+            CarouselResource::collection(
+                Carousel::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/Carousel/Requests/CarouselIndexRequest.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Carousel\Requests;
+
+use App\Models\CMS\Media\Carousel;
+use App\Models\System\Settings\OS;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class CarouselIndexRequest 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(
+                Carousel::places()
+            ))],
+            'perPage' => ['nullable', 'integer'],
+            'fields' => ['nullable', 'string'],
+        ];
+    }
+
+    /**
+     * Handle a passed validation attempt.
+     */
+    protected function passedValidation(): void
+    {
+        $fields = [];
+        if ($this->fields) {
+            $sanitezedFields = validateCommaSeperated($this->fields, Carousel::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/Carousel/Resources/CarouselResource.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Carousel\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CarouselResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->whenHas('id'),
+            'title' => $this->whenHas('title'),
+            'place' => $this->whenHas('place'),
+            'app' => $this->whenHas('app'),
+            'link' => $this->whenHas('link'),
+            'resource_id' => $this->whenHas('resource_id'),
+            'resource_type' => $this->whenHas('resource_type'),
+            'thumbnail' => $this->thumbnail('650x650'),
+            'image' => $this->getFirstMediaUrl('main'),
+        ];
+    }
+}