feat: misc — cooking mode, OpenAPI docs, email, storage, upload, homepage

Cooking mode step-by-step view. OpenAPI 3.1 spec auto-generated from Zod schemas.
Email lib (resend). Redis client. S3 storage helper. Photo upload endpoint.
Landing page. Short recipe URL redirect /r/[id]. API docs page.

apps/web/app/api/v1/feed/trending/route.ts

@@ -0,0 +1,42 @@
+import { NextRequest, NextResponse } from "next/server";
+import { db, recipes, users, favorites, eq, desc, sql, and, gte } from "@epicure/db";
+
+export async function GET(req: NextRequest) {
+  const { searchParams } = new URL(req.url);
+  const limit = Math.min(parseInt(searchParams.get("limit") ?? "20"), 50);
+
+  const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+
+  const trending = await db
+    .select({
+      id: recipes.id,
+      title: recipes.title,
+      description: recipes.description,
+      baseServings: recipes.baseServings,
+      prepMins: recipes.prepMins,
+      cookMins: recipes.cookMins,
+      difficulty: recipes.difficulty,
+      visibility: recipes.visibility,
+      aiGenerated: recipes.aiGenerated,
+      createdAt: recipes.createdAt,
+      authorId: recipes.authorId,
+      authorName: users.name,
+      authorUsername: users.username,
+      authorAvatarUrl: users.avatarUrl,
+      favoriteCount: sql<number>`cast(count(${favorites.recipeId}) as int)`,
+    })
+    .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})`), desc(recipes.createdAt))
+    .limit(limit);
+
+  return NextResponse.json({
+    data: trending.map((r) => ({ ...r, createdAt: r.createdAt.toISOString() })),
+  });
+}