Files
silo-server/web/src/pages/Home.tsx
T

328 lines
11 KiB
TypeScript

/* eslint-disable react-hooks/set-state-in-effect */
import { useEffect, useMemo, useRef, useState } from "react";
import { useQuery, useQueryClient } from "@tanstack/react-query";
import { Link } from "react-router";
import { LayoutDashboard } from "lucide-react";
import HeroBanner from "@/components/HeroBanner";
import SectionRow from "@/components/SectionRow";
import TasteSeedBanner from "@/components/TasteSeedBanner";
import { Skeleton } from "@/components/ui/skeleton";
import type { HomeSectionItemsResponse, ResolvedSection } from "@/api/types";
import { useDocumentTitle } from "@/hooks/useDocumentTitle";
import { HERO_BANNER_SIZE } from "@/lib/design-system";
import { sectionKeys } from "@/hooks/queries/keys";
import { fetchHomeSectionItems, useHomeLayout } from "@/hooks/queries/sections";
import { planNextHomeSectionBatch } from "./homeSectionQueue";
import { buildHomeSectionViewModel, type HomeSectionSlot } from "./homeSectionState";
import { collectCachedHomeSections } from "./homeSectionCache";
const SECTION_STALE_TIME = 5 * 60 * 1000;
const MAX_CONCURRENT_SECTION_REQUESTS = 5;
const SKELETON_CARD_COUNT = 7;
function useHomeRefreshSignal() {
return useQuery({
queryKey: sectionKeys.homeRefreshSignal(),
queryFn: () => 0,
initialData: 0,
staleTime: Number.POSITIVE_INFINITY,
gcTime: Number.POSITIVE_INFINITY,
});
}
export default function Home() {
const queryClient = useQueryClient();
const { data, isLoading, isError, refetch } = useHomeLayout();
const { data: homeRefreshSignal = 0 } = useHomeRefreshSignal();
const [loadedSections, setLoadedSections] = useState<Map<string, ResolvedSection>>(new Map());
const [failedIds, setFailedIds] = useState<Set<string>>(new Set());
const [inFlightIds, setInFlightIds] = useState<Set<string>>(new Set());
const [completedIds, setCompletedIds] = useState<Set<string>>(new Set());
const activeSectionIdsRef = useRef<Set<string>>(new Set());
useDocumentTitle("Home");
const layout = useMemo(() => data?.sections ?? [], [data?.sections]);
const layoutResetKey = layout
.map(
(section) =>
`${section.id}:${section.section_type}:${section.title}:${section.featured ? "featured" : "row"}:${section.item_limit}:${section.is_custom ? "custom" : "default"}:${section.customized ? "customized" : "clean"}`,
)
.join("|");
useEffect(() => {
const activeIds = layout.map((section) => section.id);
activeSectionIdsRef.current = new Set(activeIds);
setLoadedSections(
collectCachedHomeSections(layout, (sectionId) =>
queryClient.getQueryData<HomeSectionItemsResponse>(sectionKeys.homeItems(sectionId)),
),
);
setFailedIds(new Set());
setInFlightIds(new Set());
setCompletedIds(new Set());
return () => {
activeSectionIdsRef.current = new Set();
activeIds.forEach((sectionId) => {
void queryClient.cancelQueries({ queryKey: sectionKeys.homeItems(sectionId) });
});
};
}, [homeRefreshSignal, layout, layoutResetKey, queryClient]);
useEffect(() => {
if (layout.length === 0) return;
const nextIds = planNextHomeSectionBatch({
layout,
loadedIds: completedIds,
inFlightIds,
maxConcurrentRequests: MAX_CONCURRENT_SECTION_REQUESTS,
});
if (nextIds.length === 0) return;
setInFlightIds((prev) => {
const next = new Set(prev);
nextIds.forEach((id) => next.add(id));
return next;
});
nextIds.forEach((sectionId) => {
void queryClient
.fetchQuery<HomeSectionItemsResponse>({
queryKey: sectionKeys.homeItems(sectionId),
queryFn: ({ signal }) => fetchHomeSectionItems(sectionId, { signal }),
staleTime: SECTION_STALE_TIME,
})
.then((response) => {
if (!activeSectionIdsRef.current.has(sectionId)) return;
setLoadedSections((prev) => {
const next = new Map(prev);
next.set(sectionId, response.section);
return next;
});
setFailedIds((prev) => {
if (!prev.has(sectionId)) return prev;
const next = new Set(prev);
next.delete(sectionId);
return next;
});
setCompletedIds((prev) => {
const next = new Set(prev);
next.add(sectionId);
return next;
});
})
.catch(() => {
if (!activeSectionIdsRef.current.has(sectionId)) return;
setFailedIds((prev) => {
const next = new Set(prev);
next.add(sectionId);
return next;
});
setCompletedIds((prev) => {
const next = new Set(prev);
next.add(sectionId);
return next;
});
})
.finally(() => {
if (!activeSectionIdsRef.current.has(sectionId)) return;
setInFlightIds((prev) => {
if (!prev.has(sectionId)) return prev;
const next = new Set(prev);
next.delete(sectionId);
return next;
});
});
});
}, [completedIds, inFlightIds, layout, queryClient]);
const viewModel = buildHomeSectionViewModel({
layout,
loadedSections,
failedIds,
});
const retrySection = (sectionId: string) => {
queryClient.removeQueries({ queryKey: sectionKeys.homeItems(sectionId) });
setFailedIds((prev) => {
if (!prev.has(sectionId)) return prev;
const next = new Set(prev);
next.delete(sectionId);
return next;
});
setCompletedIds((prev) => {
if (!prev.has(sectionId)) return prev;
const next = new Set(prev);
next.delete(sectionId);
return next;
});
};
const heroSlot = renderHeroSlot(viewModel.hero, retrySection);
const hasHeroSlot = heroSlot !== null;
if (isLoading && !data) {
return <HomePageSkeleton />;
}
if (isError && !data) {
return (
<div className="page-shell flex min-h-[50vh] items-center justify-center py-12">
<div className="surface-panel max-w-md rounded-[1.8rem] border-0 p-6 text-center shadow-none">
<p className="text-lg font-semibold">Unable to load the homepage</p>
<p className="text-muted-foreground mt-2 text-sm">
We couldn&apos;t load your section layout right now.
</p>
<button
type="button"
onClick={() => void refetch()}
className="border-border hover:bg-muted/40 mt-4 rounded-lg border px-4 py-2 text-sm font-medium"
>
Retry
</button>
</div>
</div>
);
}
return (
<>
<h1 className="sr-only">Home</h1>
<div className={`space-y-10 ${hasHeroSlot ? "pb-2" : "pt-6 pb-2"}`}>
{heroSlot}
<TasteSeedBanner />
{viewModel.rows.map((slot) => {
if (slot.state === "empty") {
return null;
}
if (slot.state === "ready" && slot.section) {
return <SectionRow key={slot.layout.id} section={slot.section} />;
}
if (slot.state === "error") {
return (
<SectionErrorRow
key={slot.layout.id}
title={slot.layout.title}
onRetry={() => retrySection(slot.layout.id)}
/>
);
}
return <SectionLoadingRow key={slot.layout.id} title={slot.layout.title} />;
})}
{layout.length === 0 && !isLoading && (
<div className="surface-panel flex h-64 flex-col items-center justify-center gap-3 rounded-[1.8rem] border-0 px-6 text-center">
<LayoutDashboard className="text-muted-foreground h-10 w-10" />
<p className="text-muted-foreground text-sm">
Your home screen is empty. Customize it by adding sections to display your media.
</p>
<Link to="/settings/home" className="text-primary text-sm font-medium hover:underline">
Customize Home Screen
</Link>
</div>
)}
</div>
</>
);
}
function renderHeroSlot(hero: HomeSectionSlot | null, retrySection: (sectionId: string) => void) {
if (!hero) return null;
if (hero.state === "ready" && hero.section) {
return <HeroBanner items={hero.section.items} maxSlides={hero.layout.item_limit} />;
}
if (hero.state === "error") {
return (
<div
className={`bg-muted relative ${HERO_BANNER_SIZE} w-full overflow-hidden rounded-[1.8rem]`}
>
<div className="from-background via-background/70 absolute inset-0 bg-gradient-to-t to-transparent" />
<div className="relative flex h-full items-end px-4 pb-10 sm:px-6 sm:pb-12 lg:px-12 lg:pb-16">
<div className="max-w-xl space-y-3">
<p className="text-3xl font-bold">{hero.layout.title}</p>
<p className="text-muted-foreground text-sm">
This featured section could not be loaded right now.
</p>
<button
type="button"
onClick={() => retrySection(hero.layout.id)}
className="border-border hover:bg-muted/40 rounded-lg border px-4 py-2 text-sm font-medium"
>
Retry section
</button>
</div>
</div>
</div>
);
}
if (hero.state === "empty") {
return null;
}
return <Skeleton className={`${HERO_BANNER_SIZE} w-full rounded-[1.8rem]`} />;
}
function HomePageSkeleton() {
return (
<div className="space-y-8 py-4">
<Skeleton className={`${HERO_BANNER_SIZE} w-full rounded-[1.8rem]`} />
{Array.from({ length: 3 }).map((_, i) => (
<div key={i} className="space-y-3 px-4 sm:px-6 lg:px-12">
<Skeleton className="h-6 w-48" />
<div className="flex gap-4">
{Array.from({ length: SKELETON_CARD_COUNT }).map((_, j) => (
<Skeleton
key={j}
className="aspect-[2/3] w-[130px] shrink-0 rounded-lg sm:w-[150px] lg:w-[178px]"
/>
))}
</div>
</div>
))}
</div>
);
}
function SectionLoadingRow({ title }: { title: string }) {
return (
<section className="space-y-3 px-4 sm:px-6 lg:px-12">
<h2 className="text-foreground h-6 text-sm font-semibold">{title}</h2>
<div className="flex gap-4 overflow-hidden">
{Array.from({ length: SKELETON_CARD_COUNT }).map((_, index) => (
<Skeleton
key={index}
className="aspect-[2/3] w-[130px] shrink-0 rounded-lg sm:w-[150px] lg:w-[178px]"
/>
))}
</div>
</section>
);
}
function SectionErrorRow({ title, onRetry }: { title: string; onRetry: () => void }) {
return (
<section className="space-y-3 px-4 sm:px-6 lg:px-12">
<h2 className="text-foreground h-6 text-sm font-semibold">{title}</h2>
<div className="surface-panel flex items-center justify-between rounded-[1.4rem] border-0 px-5 py-4">
<p className="text-muted-foreground text-sm">This section could not be loaded right now.</p>
<button
type="button"
onClick={onRetry}
className="border-border hover:bg-muted/40 rounded-lg border px-4 py-2 text-sm font-medium"
>
Retry
</button>
</div>
</section>
);
}