React Server Components en producción: patrones y errores frecuentes

import { ProductDetails } from './ProductDetails'
import { AddToCartButton } from './AddToCartButton'

export default async function ProductPage({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params
  const product = await getProduct(id)

  return (
    <div>
      {/* Server Component: acceso directo a la BD */}
      <ProductDetails product={product} />
      {/* Client Component: interactividad aislada */}
      <AddToCartButton productId={product.id} price={product.price} />
    </div>
  )
}

'use client'

import { useState } from 'react'

export function AddToCartButton({ productId, price }: { productId: string; price: number }) {
  const [adding, setAdding] = useState(false)

  async function handleAdd() {
    setAdding(true)
    await fetch('/api/cart', {
      method: 'POST',
      body: JSON.stringify({ productId, quantity: 1 }),
    })
    setAdding(false)
  }

  return (
    <button onClick={handleAdd} disabled={adding}>
      {adding ? 'Añadiendo...' : `Añadir al carrito — $${price}`}
    </button>
  )
}

'use client'

import { useState } from 'react'

// Todo el contenido hijo pasa al lado cliente
export function PageWrapper({ children }: { children: React.ReactNode }) {
  const [theme, setTheme] = useState('light')
  return (
    <div className={theme}>
      <button onClick={() => setTheme(t => t === 'light' ? 'dark' : 'light')}>
        Cambiar tema
      </button>
      {children}
    </div>
  )
}

import { PageWrapper } from './PageWrapper'
import { HeavyServerContent } from './HeavyServerContent'

export default function Layout() {
  return (
    <PageWrapper>
      {/* Sigue siendo Server Component a pesar del wrapper cliente */}
      <HeavyServerContent />
    </PageWrapper>
  )
}

import { cache } from 'react'

// Deduplica llamadas idénticas dentro del mismo render
const getUser = cache(async (userId: string) => {
  const res = await fetch(`https://api.example.com/users/${userId}`, {
    next: { revalidate: 3600 }, // Cache durante 1 hora
  })
  if (!res.ok) throw new Error('User not found')
  return res.json()
})

export default async function UserProfile({ userId }: { userId: string }) {
  const user = await getUser(userId)

  return (
    <section>
      <h2>{user.name}</h2>
      <p>{user.email}</p>
      <p>Miembro desde {new Date(user.createdAt).toLocaleDateString('es-ES')}</p>
    </section>
  )
}

// TRAMPA: pasar tipos no serializables
// Función — no funciona
<ClientComp onSubmit={async (data) => { /* server action */ }} />
// Usar una Server Action importada en su lugar
import { submitForm } from '@/lib/actions/form'
<ClientComp onSubmit={submitForm} />

// Objeto Date — no funciona
<ClientComp createdAt={new Date()} />
// Cadena ISO — funciona
<ClientComp createdAt={new Date().toISOString()} />

// Map, Set, RegExp — no funciona
<ClientComp data={new Map([['key', 'value']])} />
// Objeto plano o array — funciona
<ClientComp data={{ key: 'value' }} />

import { Suspense } from 'react'
import { RevenueChart } from './RevenueChart'
import { RecentOrders } from './RecentOrders'
import { UserStats } from './UserStats'

export default function DashboardPage() {
  return (
    <div className="grid grid-cols-2 gap-6">
      <Suspense fallback={<ChartSkeleton />}>
        <RevenueChart />
      </Suspense>

      <Suspense fallback={<StatsSkeleton />}>
        <UserStats />
      </Suspense>

      <Suspense fallback={<TableSkeleton />}>
        <RecentOrders />
      </Suspense>
    </div>
  )
}

'use client'

import { useEffect, useState } from 'react'

export function HydrationDebug() {
  const [isClient, setIsClient] = useState(false)

  useEffect(() => {
    setIsClient(true)
  }, [])

  if (process.env.NODE_ENV !== 'development') return null

  return (
    <div style={{ position: 'fixed', bottom: 0, right: 0, padding: '4px 8px', fontSize: 12 }}>
      {isClient ? 'Client' : 'Server'}
    </div>
  )
}

const nextConfig = {
  logging: {
    fetches: {
      fullUrl: true, // Muestra las URLs completas de los fetch
    },
  },
}

export default nextConfig

import { getTodos } from '@/lib/services/todo'
import { TodoForm } from './TodoForm'
import { deleteTodo } from '@/lib/actions/todo'

export default async function TodoList() {
  const todos = await getTodos()

  return (
    <div>
      <TodoForm />
      <ul>
        {todos.map(todo => (
          <li key={todo.id}>
            {todo.title}
            <form action={deleteTodo}>
              <input type="hidden" name="id" value={todo.id} />
              <button type="submit">Eliminar</button>
            </form>
          </li>
        ))}
      </ul>
    </div>
  )
}

'use server'

import { revalidatePath } from 'next/cache'
import { TodoService } from '@/lib/services/todo'

export async function deleteTodo(formData: FormData) {
  const id = formData.get('id') as string
  await TodoService.delete(id)
  revalidatePath('/todos')
}