feat(search): full-text recipe search and explore page

Postgres full-text search with dietary/difficulty/time filters.
Search page with real-time results. Explore page with trending and recent recipes.
This commit is contained in:
Arnaud
2026-07-01 08:10:44 +02:00
parent 3636ab27ae
commit e179692adf
5 changed files with 647 additions and 0 deletions
+75
View File
@@ -0,0 +1,75 @@
import type { Metadata } from "next";
import {
db,
recipes,
users,
favorites,
eq,
desc,
sql,
and,
gte,
count,
} from "@epicure/db";
import { ExplorePageContent } from "@/components/search/explore-page-content";
export const metadata: Metadata = { title: "Explore — Epicure" };
export type RecipeResult = {
id: string;
title: string;
authorName: string | null;
difficulty: string | null;
prepMins: number | null;
cookMins: number | null;
};
export default async function ExplorePage() {
const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
// Trending: public recipes ordered by favorite count in last 7 days
const trendingRows = await db
.select({
id: recipes.id,
title: recipes.title,
authorName: users.name,
difficulty: recipes.difficulty,
prepMins: recipes.prepMins,
cookMins: recipes.cookMins,
favoriteCount: count(favorites.recipeId),
})
.from(recipes)
.innerJoin(users, eq(recipes.authorId, users.id))
.leftJoin(
favorites,
and(
eq(favorites.recipeId, recipes.id),
gte(favorites.createdAt, sevenDaysAgo)
)
)
.where(eq(recipes.visibility, "public"))
.groupBy(recipes.id, users.id)
.orderBy(desc(sql`count(${favorites.recipeId})`))
.limit(12);
// Recent: public recipes ordered by createdAt desc
const recentRows = await db
.select({
id: recipes.id,
title: recipes.title,
authorName: users.name,
difficulty: recipes.difficulty,
prepMins: recipes.prepMins,
cookMins: recipes.cookMins,
})
.from(recipes)
.innerJoin(users, eq(recipes.authorId, users.id))
.where(eq(recipes.visibility, "public"))
.orderBy(desc(recipes.createdAt))
.limit(12);
const trending: RecipeResult[] = trendingRows.map(({ favoriteCount: _fc, ...r }) => r);
const recent: RecipeResult[] = recentRows;
return <ExplorePageContent trending={trending} recent={recent} />;
}
+8
View File
@@ -0,0 +1,8 @@
import { SearchPageContent } from "@/components/search/search-page-content";
type Params = { searchParams: Promise<{ q?: string; difficulty?: string; dietary?: string }> };
export default async function SearchPage({ searchParams }: Params) {
const { q } = await searchParams;
return <SearchPageContent initialQuery={q ?? ""} />;
}
+124
View File
@@ -0,0 +1,124 @@
import { NextRequest, NextResponse } from "next/server";
import {
db,
recipes,
users,
eq,
and,
or,
ilike,
sql,
desc,
} from "@epicure/db";
const VALID_DIETARY = ["vegan", "vegetarian", "glutenFree", "dairyFree"] as const;
type DietaryTag = (typeof VALID_DIETARY)[number];
export async function GET(req: NextRequest) {
const { searchParams } = req.nextUrl;
// --- Parse & validate required param ---
const q = searchParams.get("q")?.trim() ?? "";
if (!q) {
return NextResponse.json(
{ error: "Query parameter 'q' is required and must not be empty." },
{ status: 400 }
);
}
// --- Optional params ---
const difficultyParam = searchParams.get("difficulty");
const difficulty =
difficultyParam === "easy" ||
difficultyParam === "medium" ||
difficultyParam === "hard"
? (difficultyParam as "easy" | "medium" | "hard")
: undefined;
const maxMinsRaw = searchParams.get("maxMins");
const maxMins =
maxMinsRaw !== null && !Number.isNaN(Number(maxMinsRaw))
? Number(maxMinsRaw)
: undefined;
const limitRaw = searchParams.get("limit");
const limit = Math.min(
limitRaw !== null && !Number.isNaN(Number(limitRaw))
? Math.max(1, Number(limitRaw))
: 20,
50
);
const offsetRaw = searchParams.get("offset");
const offset =
offsetRaw !== null && !Number.isNaN(Number(offsetRaw))
? Math.max(0, Number(offsetRaw))
: 0;
const dietaryRaw = searchParams.get("dietary");
const dietaryTags: DietaryTag[] = dietaryRaw
? (dietaryRaw
.split(",")
.map((s) => s.trim())
.filter((s): s is DietaryTag =>
(VALID_DIETARY as readonly string[]).includes(s)
))
: [];
// --- Build WHERE conditions ---
const conditions = [
eq(recipes.visibility, "public"),
or(
ilike(recipes.title, `%${q}%`),
ilike(recipes.description, `%${q}%`)
)!,
];
if (difficulty) {
conditions.push(eq(recipes.difficulty, difficulty));
}
if (maxMins !== undefined) {
conditions.push(
sql`(${recipes.prepMins} + ${recipes.cookMins}) <= ${maxMins}`
);
}
for (const tag of dietaryTags) {
conditions.push(sql`${recipes.dietaryTags}->>${tag} = 'true'`);
}
const where = and(...conditions);
// --- Main data query ---
const rows = await db
.select({
id: recipes.id,
title: recipes.title,
description: recipes.description,
difficulty: recipes.difficulty,
baseServings: recipes.baseServings,
prepMins: recipes.prepMins,
cookMins: recipes.cookMins,
authorId: recipes.authorId,
authorName: users.name,
createdAt: recipes.createdAt,
})
.from(recipes)
.innerJoin(users, eq(recipes.authorId, users.id))
.where(where)
.orderBy(desc(recipes.createdAt))
.limit(limit)
.offset(offset);
// --- Count query ---
const countResult = await db
.select({ total: sql<number>`count(*)::int` })
.from(recipes)
.innerJoin(users, eq(recipes.authorId, users.id))
.where(where);
const total = countResult[0]?.total ?? 0;
return NextResponse.json({ data: rows, total, limit, offset });
}
@@ -0,0 +1,135 @@
"use client";
import { useRef } from "react";
import { useRouter } from "next/navigation";
import Link from "next/link";
import { Input } from "@/components/ui/input";
import { Badge } from "@/components/ui/badge";
import { Flame, Clock, ChefHat, Search } from "lucide-react";
import type { RecipeResult } from "@/app/(app)/explore/page";
const DIFFICULTY_COLORS: Record<string, string> = {
easy: "bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200",
medium: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200",
hard: "bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200",
};
function RecipeCard({ recipe }: { recipe: RecipeResult }) {
const totalMins = (recipe.prepMins ?? 0) + (recipe.cookMins ?? 0);
return (
<Link
href={`/recipes/${recipe.id}`}
className="group block rounded-lg border bg-card p-4 shadow-sm transition-shadow hover:shadow-md min-w-[200px]"
>
<div className="flex items-start justify-between gap-2">
<h3 className="font-semibold text-card-foreground group-hover:text-primary line-clamp-2 flex-1">
{recipe.title}
</h3>
{recipe.difficulty && (
<Badge
variant="secondary"
className={`shrink-0 capitalize text-xs ${DIFFICULTY_COLORS[recipe.difficulty] ?? ""}`}
>
{recipe.difficulty}
</Badge>
)}
</div>
<div className="mt-3 flex items-center gap-3 text-xs text-muted-foreground">
{totalMins > 0 && (
<span className="flex items-center gap-1">
<Clock className="h-3.5 w-3.5" />
{totalMins}m
</span>
)}
{recipe.authorName && (
<span className="flex items-center gap-1">
<ChefHat className="h-3.5 w-3.5" />
{recipe.authorName}
</span>
)}
</div>
</Link>
);
}
function HorizontalScroll({ children }: { children: React.ReactNode }) {
return (
<div className="flex gap-4 overflow-x-auto pb-2 -mx-4 px-4 snap-x snap-mandatory">
{children}
</div>
);
}
type Props = {
trending: RecipeResult[];
recent: RecipeResult[];
};
export function ExplorePageContent({ trending, recent }: Props) {
const router = useRouter();
const inputRef = useRef<HTMLInputElement>(null);
const handleSearchSubmit = (e: React.FormEvent) => {
e.preventDefault();
const q = inputRef.current?.value.trim();
if (q) router.push(`/search?q=${encodeURIComponent(q)}`);
else router.push("/search");
};
return (
<div className="max-w-5xl mx-auto space-y-10">
{/* Search bar */}
<div>
<h1 className="text-3xl font-bold mb-6">Explore</h1>
<form onSubmit={handleSearchSubmit} className="relative">
<Search className="absolute left-3 top-1/2 -translate-y-1/2 h-5 w-5 text-muted-foreground pointer-events-none" />
<Input
ref={inputRef}
placeholder="Search recipes..."
className="pl-10 h-12 text-base"
/>
</form>
</div>
{/* Trending this week */}
<section>
<div className="flex items-center gap-2 mb-4">
<Flame className="h-5 w-5 text-orange-500" />
<h2 className="text-xl font-semibold">Trending this week</h2>
</div>
{trending.length === 0 ? (
<p className="text-muted-foreground text-sm py-8 text-center">
No trending recipes yet. Be the first to share one!
</p>
) : (
<HorizontalScroll>
{trending.map((recipe) => (
<div key={recipe.id} className="snap-start shrink-0 w-56">
<RecipeCard recipe={recipe} />
</div>
))}
</HorizontalScroll>
)}
</section>
{/* Recently added */}
<section>
<div className="flex items-center gap-2 mb-4">
<Clock className="h-5 w-5 text-blue-500" />
<h2 className="text-xl font-semibold">Recently added</h2>
</div>
{recent.length === 0 ? (
<p className="text-muted-foreground text-sm py-8 text-center">
No public recipes yet.
</p>
) : (
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4">
{recent.map((recipe) => (
<RecipeCard key={recipe.id} recipe={recipe} />
))}
</div>
)}
</section>
</div>
);
}
@@ -0,0 +1,305 @@
"use client";
import { useState, useEffect, useRef, useCallback } from "react";
import { useRouter, useSearchParams } from "next/navigation";
import Link from "next/link";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { Badge } from "@/components/ui/badge";
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@/components/ui/select";
import { Search, Clock, ChefHat } from "lucide-react";
type RecipeResult = {
id: string;
title: string;
description: string | null;
difficulty: string | null;
prepMins: number | null;
cookMins: number | null;
authorName: string | null;
};
type SearchResponse = {
data: RecipeResult[];
total: number;
limit: number;
offset: number;
};
const DIFFICULTY_COLORS: Record<string, string> = {
easy: "bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200",
medium: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200",
hard: "bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200",
};
function RecipeCard({ recipe }: { recipe: RecipeResult }) {
const totalMins = (recipe.prepMins ?? 0) + (recipe.cookMins ?? 0);
return (
<Link
href={`/recipes/${recipe.id}`}
className="group block rounded-lg border bg-card p-4 shadow-sm transition-shadow hover:shadow-md"
>
<div className="flex items-start justify-between gap-2">
<h3 className="font-semibold text-card-foreground group-hover:text-primary line-clamp-2">
{recipe.title}
</h3>
{recipe.difficulty && (
<Badge
variant="secondary"
className={`shrink-0 capitalize text-xs ${DIFFICULTY_COLORS[recipe.difficulty] ?? ""}`}
>
{recipe.difficulty}
</Badge>
)}
</div>
{recipe.description && (
<p className="mt-1 text-sm text-muted-foreground line-clamp-2">{recipe.description}</p>
)}
<div className="mt-3 flex items-center gap-3 text-xs text-muted-foreground">
{totalMins > 0 && (
<span className="flex items-center gap-1">
<Clock className="h-3.5 w-3.5" />
{totalMins}m
</span>
)}
{recipe.authorName && (
<span className="flex items-center gap-1">
<ChefHat className="h-3.5 w-3.5" />
{recipe.authorName}
</span>
)}
</div>
</Link>
);
}
export function SearchPageContent({ initialQuery }: { initialQuery: string }) {
const router = useRouter();
const searchParams = useSearchParams();
const [query, setQuery] = useState(initialQuery);
const [inputValue, setInputValue] = useState(initialQuery);
const [difficulty, setDifficulty] = useState<string>("any");
const [maxMins, setMaxMins] = useState<string>("");
const [results, setResults] = useState<RecipeResult[]>([]);
const [total, setTotal] = useState(0);
const [offset, setOffset] = useState(0);
const [loading, setLoading] = useState(false);
const [loadingMore, setLoadingMore] = useState(false);
const inputRef = useRef<HTMLInputElement>(null);
const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
const fetchResults = useCallback(
async (q: string, diff: string, maxM: string, off: number, append = false) => {
if (!q.trim()) {
setResults([]);
setTotal(0);
setOffset(0);
return;
}
if (off === 0) setLoading(true);
else setLoadingMore(true);
try {
const params = new URLSearchParams({ q, limit: "20", offset: String(off) });
if (diff && diff !== "any") params.set("difficulty", diff);
if (maxM) params.set("maxMins", maxM);
const res = await fetch(`/api/v1/search?${params}`);
if (!res.ok) return;
const json: SearchResponse = await res.json();
if (append) {
setResults((prev) => [...prev, ...json.data]);
} else {
setResults(json.data);
}
setTotal(json.total);
setOffset(off + json.data.length);
} finally {
setLoading(false);
setLoadingMore(false);
}
},
[]
);
// Auto-focus input on mount
useEffect(() => {
inputRef.current?.focus();
}, []);
// Fetch on mount if initialQuery provided
useEffect(() => {
if (initialQuery) {
fetchResults(initialQuery, "any", "", 0);
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, []);
// Sync query param into URL
const updateUrl = useCallback(
(q: string) => {
const params = new URLSearchParams(searchParams.toString());
if (q) params.set("q", q);
else params.delete("q");
router.replace(`/search?${params}`, { scroll: false });
},
[router, searchParams]
);
const handleInputChange = (value: string) => {
setInputValue(value);
if (debounceRef.current) clearTimeout(debounceRef.current);
debounceRef.current = setTimeout(() => {
setQuery(value);
updateUrl(value);
fetchResults(value, difficulty, maxMins, 0);
}, 300);
};
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault();
if (debounceRef.current) clearTimeout(debounceRef.current);
setQuery(inputValue);
updateUrl(inputValue);
fetchResults(inputValue, difficulty, maxMins, 0);
};
const handleFilterChange = (newDiff: string, newMaxMins: string) => {
fetchResults(query, newDiff, newMaxMins, 0);
};
const handleDifficultyChange = (value: string | null) => {
const v = value ?? "any";
setDifficulty(v);
handleFilterChange(v, maxMins);
};
const handleMaxMinsChange = (value: string) => {
setMaxMins(value);
if (debounceRef.current) clearTimeout(debounceRef.current);
debounceRef.current = setTimeout(() => {
handleFilterChange(difficulty, value);
}, 300);
};
const handleLoadMore = () => {
fetchResults(query, difficulty, maxMins, offset, true);
};
const hasMore = results.length < total;
const hasQuery = query.trim().length > 0;
return (
<div className="max-w-5xl mx-auto space-y-6">
<div>
<h1 className="text-3xl font-bold mb-6">Search Recipes</h1>
{/* Search input */}
<form onSubmit={handleSubmit} className="relative">
<Search className="absolute left-3 top-1/2 -translate-y-1/2 h-5 w-5 text-muted-foreground pointer-events-none" />
<Input
ref={inputRef}
value={inputValue}
onChange={(e) => handleInputChange(e.target.value)}
placeholder="Search for recipes..."
className="pl-10 h-12 text-base"
/>
</form>
{/* Filter bar */}
<div className="mt-3 flex flex-wrap items-center gap-3">
<Select value={difficulty} onValueChange={handleDifficultyChange}>
<SelectTrigger className="w-40">
<SelectValue placeholder="Difficulty" />
</SelectTrigger>
<SelectContent>
<SelectItem value="any">Any difficulty</SelectItem>
<SelectItem value="easy">Easy</SelectItem>
<SelectItem value="medium">Medium</SelectItem>
<SelectItem value="hard">Hard</SelectItem>
</SelectContent>
</Select>
<div className="flex items-center gap-2">
<Input
type="number"
min={1}
placeholder="Max minutes"
value={maxMins}
onChange={(e) => handleMaxMinsChange(e.target.value)}
className="w-36"
/>
</div>
{hasQuery && !loading && (
<span className="text-sm text-muted-foreground ml-auto">
{total} {total === 1 ? "recipe" : "recipes"} found
</span>
)}
</div>
</div>
{/* States */}
{!hasQuery && (
<div className="flex flex-col items-center justify-center py-24 text-muted-foreground">
<Search className="h-12 w-12 mb-4 opacity-30" />
<p className="text-lg">Search for recipes...</p>
<p className="text-sm mt-1">Try "pasta", "vegan dessert", or "quick dinner"</p>
</div>
)}
{hasQuery && loading && (
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4">
{Array.from({ length: 8 }).map((_, i) => (
<div key={i} className="rounded-lg border bg-card p-4 space-y-3">
<div className="h-5 bg-muted rounded animate-pulse" />
<div className="h-3 bg-muted rounded animate-pulse w-3/4" />
<div className="h-3 bg-muted rounded animate-pulse w-1/2" />
</div>
))}
</div>
)}
{hasQuery && !loading && results.length === 0 && (
<div className="flex flex-col items-center justify-center py-24 text-muted-foreground">
<ChefHat className="h-12 w-12 mb-4 opacity-30" />
<p className="text-lg font-medium">No recipes found for &ldquo;{query}&rdquo;</p>
<p className="text-sm mt-1">Try different keywords or remove filters</p>
</div>
)}
{!loading && results.length > 0 && (
<>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4">
{results.map((recipe) => (
<RecipeCard key={recipe.id} recipe={recipe} />
))}
</div>
{hasMore && (
<div className="flex justify-center pt-4">
<Button
variant="outline"
onClick={handleLoadMore}
disabled={loadingMore}
className="min-w-32"
>
{loadingMore ? "Loading..." : "Load more"}
</Button>
</div>
)}
</>
)}
</div>
);
}