🚧 Add Timeline views

app/Actions/Photo/Timeline.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Actions\Photo;
+
+use App\Eloquent\FixedQueryBuilder;
+use App\Enum\ColumnSortingPhotoType;
+use App\Enum\OrderSortingType;
+use App\Models\Configs;
+use App\Models\Photo;
+use App\Policies\PhotoQueryPolicy;
+use Illuminate\Database\Eloquent\Builder;
+
+class Timeline
+{
+	protected PhotoQueryPolicy $photoQueryPolicy;
+
+	public function __construct(PhotoQueryPolicy $photoQueryPolicy)
+	{
+		$this->photoQueryPolicy = $photoQueryPolicy;
+	}
+
+	/**
+	 * Create the query manually.
+	 *
+	 * @return FixedQueryBuilder<Photo>
+	 */
+	public function do(): Builder
+	{
+		$order = Configs::getValueAsEnum('timeline_photos_order', ColumnSortingPhotoType::class);
+
+		// Safe default (should not be needed).
+		// @codeCoverageIgnoreStart
+		if (!in_array($order, [ColumnSortingPhotoType::CREATED_AT, ColumnSortingPhotoType::TAKEN_AT], true)) {
+			$order = ColumnSortingPhotoType::TAKEN_AT;
+		}
+		// @codeCoverageIgnoreEnd
+
+		return $this->photoQueryPolicy->applySearchabilityFilter(
+			query: Photo::query()->with(['album', 'size_variants', 'size_variants.sym_links']),
+			origin: null,
+			include_nsfw: !Configs::getValueAsBool('hide_nsfw_in_timeline')
+		)->orderBy($order->value, OrderSortingType::DESC->value);
+	}
+}

app/Http/Controllers/Gallery/TimelineController.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Controllers\Gallery;
+
+use App\Actions\Photo\Timeline;
+use App\Http\Requests\Photo\GetTimelineRequest;
+use App\Http\Resources\Timeline\InitResource;
+use App\Http\Resources\Timeline\TimelineResource;
+use App\Models\Configs;
+use App\Models\Photo;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Routing\Controller;
+use Spatie\LaravelData\Data;
+
+/**
+ * Controller responsible for the Timeline data.
+ */
+class TimelineController extends Controller
+{
+	public function __invoke(GetTimelineRequest $request, Timeline $timeline): Data
+	{
+		/** @var LengthAwarePaginator<Photo> $photoResults */
+		/** @disregard P1013 Undefined method withQueryString() (stupid intelephense) */
+		$photoResults = $timeline->do()->paginate(Configs::getValueAsInt('timeline_photos_pagination_limit'));
+
+		return TimelineResource::fromData($photoResults);
+	}
+
+	/**
+	 * Return init Search.
+	 *
+	 * @param GetTimelineRequest $request
+	 *
+	 * @return InitResource
+	 */
+	public function init(GetTimelineRequest $request): Data
+	{
+		return new InitResource();
+	}
+}

app/Http/Requests/Photo/GetTimelineRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests\Photo;
+
+use App\Http\Requests\AbstractEmptyRequest;
+use App\Models\Configs;
+use Illuminate\Support\Facades\Auth;
+
+class GetTimelineRequest extends AbstractEmptyRequest
+{
+	/**
+	 * {@inheritDoc}
+	 */
+	public function authorize(): bool
+	{
+		if (!Auth::check() && !Configs::getValueAsBool('timeline_photos_public')) {
+			return false;
+		}
+
+		return Configs::getValueAsBool('timeline_photos_enabled');
+	}
+}

app/Http/Resources/Timeline/InitResource.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Resources\Timeline;
+
+use App\Enum\PhotoLayoutType;
+use App\Models\Configs;
+use Spatie\LaravelData\Data;
+use Spatie\TypeScriptTransformer\Attributes\TypeScript;
+
+/**
+ * Initialization resource for the search.
+ */
+#[TypeScript()]
+class InitResource extends Data
+{
+	public PhotoLayoutType $photo_layout;
+
+	public function __construct()
+	{
+		$this->photo_layout = Configs::getValueAsEnum('timeline_photos_layout', PhotoLayoutType::class);
+	}
+}

app/Http/Resources/Timeline/TimelineResource.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Http\Resources\Timeline;
+
+use App\Enum\TimelinePhotoGranularity;
+use App\Http\Resources\Models\PhotoResource;
+use App\Http\Resources\Models\Utils\TimelineData;
+use App\Http\Resources\Traits\HasPrepPhotoCollection;
+use App\Models\Configs;
+use App\Models\Photo;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Contracts\Pagination\Paginator;
+use Illuminate\Support\Collection;
+use Spatie\LaravelData\Data;
+use Spatie\TypeScriptTransformer\Attributes\LiteralTypeScriptType;
+use Spatie\TypeScriptTransformer\Attributes\TypeScript;
+
+/**
+ * Result of a Search query.
+ */
+#[TypeScript()]
+class TimelineResource extends Data
+{
+	use HasPrepPhotoCollection;
+
+	/** @var Collection<int,PhotoResource> */
+	#[LiteralTypeScriptType('App.Http.Resources.Models.PhotoResource[]')]
+	public Collection $photos;
+
+	public int $current_page;
+	public int $from;
+	public int $last_page;
+	public int $per_page;
+	public int $to;
+	public int $total;
+
+	/**
+	 * @param LengthAwarePaginator<PhotoResource>&Paginator<PhotoResource> $photos
+	 *
+	 * @return void
+	 */
+	public function __construct(
+		LengthAwarePaginator $photos,
+	) {
+		$this->photos = collect($photos->items());
+		$this->current_page = $photos->currentPage();
+		$this->from = $photos->firstItem() ?? 0;
+		$this->last_page = $photos->lastPage();
+		$this->per_page = $photos->perPage();
+		$this->to = $photos->lastItem() ?? 0;
+		$this->total = $photos->total();
+
+		// We do it manually this time.
+		$previous_photo = null;
+		$this->photos->each(function (PhotoResource &$photo) use (&$previous_photo) {
+			if ($previous_photo !== null) {
+				$previous_photo->next_photo_id = $photo->id;
+			}
+			$photo->previous_photo_id = $previous_photo?->id;
+			$previous_photo = $photo;
+		});
+		$photo_granularity = Configs::getValueAsEnum('timeline_photos_granularity', TimelinePhotoGranularity::class);
+		$this->photos = TimelineData::setTimeLineDataForPhotos($this->photos, $photo_granularity);
+	}
+
+	/**
+	 * @param LengthAwarePaginator<Photo> $photos
+	 *
+	 * @return TimelineResource
+	 */
+	public static function fromData(LengthAwarePaginator $photos): self
+	{
+		return new self(
+			photos: PhotoResource::collect($photos), // @phpstan-ignore-line
+		);
+	}
+}

resources/js/layouts/PhotoLayout.ts

@@ -4,6 +4,7 @@ import { useJustify } from "./useJustify";
 import { useMasonry } from "./useMasonry";
 import { useGrid } from "./useGrid";
 import AlbumService from "@/services/album-service";
+import TimelineService from "@/services/timeline-service";
 
 export function useLayouts(
 	config: App.Http.Resources.GalleryConfigs.PhotoLayoutConfig,
@@ -63,9 +64,16 @@ export function useGetLayoutConfig() {
 		});
 	}
 
+	function loadLayoutTimeline() {
+		TimelineService.init().then((data) => {
+			layout.value = data.data.photo_layout;
+		});
+	}
+
 	return {
 		layout,
 		layoutConfig,
 		loadLayoutConfig,
+		loadLayoutTimeline,
 	};
 }

resources/js/lychee.d.ts

@@ -628,3 +628,17 @@ declare namespace App.Http.Resources.Statistics {
 		size: number;
 	};
 }
+declare namespace App.Http.Resources.Timeline {
+	export type InitResource = {
+		photo_layout: App.Enum.PhotoLayoutType;
+	};
+	export type TimelineResource = {
+		photos: App.Http.Resources.Models.PhotoResource[] | Array<any>;
+		current_page: number;
+		from: number;
+		last_page: number;
+		per_page: number;
+		to: number;
+		total: number;
+	};
+}

resources/js/router/routes.ts

@@ -3,6 +3,7 @@ import Albums from "@/views/gallery-panels/Albums.vue";
 import Photo from "@/views/gallery-panels/Photo.vue";
 
 const Landing = () => import("@/views/Landing.vue");
+const Timeline = () => import("@/views/gallery-panels/Timeline.vue");
 const Frame = () => import("@/views/gallery-panels/Frame.vue");
 const Search = () => import("@/views/gallery-panels/Search.vue");
 const MapView = () => import("@/views/gallery-panels/Map.vue");
@@ -45,6 +46,11 @@ const routes_ = [
 		component: Frame,
 		props: true,
 	},
+	{
+		name: "timeline",
+		path: "/timeline",
+		component: Timeline,
+	},
 	{
 		name: "frame",
 		path: "/frame",

resources/js/services/timeline-service.ts

@@ -0,0 +1,14 @@
+import axios, { type AxiosResponse } from "axios";
+import Constants from "./constants";
+
+const TimelineService = {
+	timeline(page: number = 1): Promise<AxiosResponse<App.Http.Resources.Timeline.TimelineResource>> {
+		return axios.get(`${Constants.getApiUrl()}Timeline`, { params: { page: page }, data: {} });
+	},
+
+	init(): Promise<AxiosResponse<App.Http.Resources.Timeline.InitResource>> {
+		return axios.get(`${Constants.getApiUrl()}Timeline::init`, { data: {} });
+	},
+};
+
+export default TimelineService;