Saltar al contenido principal
Volver al Changelog
v2.2.0 · Menor

Seguridad: el panel y el admin se autorizan en el servidor, y los pagos funcionan de verdad

Next.js 16.4.6, una capa de acceso a datos server-only para el panel y el admin, webhooks de Stripe y Polar que ya no se rechazan ni duplican créditos, y una subida prefirmada que acepta ficheros reales.

Es una versión de seguridad, pero sale como minor y no como patch: añade piezas nuevas y cambia algunas APIs internas que tu código puede estar usando. La estructura del proyecto no cambia. Lee «Si ya tienes un proyecto» antes de actualizar.

Next.js 16.4.6

next, @next/third-parties y eslint-config-next pasan de 16.4.3 a 16.4.6, fijados a la versión exacta. next build ya rechaza la 16.4.3 por vulnerable, así que un proyecto en la 2.1.4 deja de compilar hasta que actualice.

El panel y el admin solo estaban protegidos en el navegador

Los layouts de /dashboard y /admin redirigían en el cliente: el HTML del panel llegaba a cualquiera, y el acceso dependía de que cada endpoint comprobara la sesión por su cuenta. Ahora hay dos capas, como recomienda la guía de autenticación de Next.js:

  • Una comprobación optimista en el proxy. Sin cookie de sesión, /dashboard* y /admin* responden 307 al login con callbackUrl. Solo mira la cookie, nunca la base de datos.
  • La comprobación de verdad en una capa de acceso a datos (src/lib/auth/dal.ts, marcada server-only): getCurrentUser(), requireSession() y requireAdmin(). La sesión se lee una vez por render y quien la pide recibe un usuario reducido (id, nombre, email, rol, imagen), nunca la sesión con su token.
  • AuthGate y AdminGate dentro del Suspense de cada layout, requireAdmin() en cada página de admin y createAdminAction() para las Server Actions de administración.
  • Un test que lee todas las páginas de admin y falla si alguna consulta datos antes de comprobar el rol.

El login, además, vuelve a la página de la que venías (callbackUrl), validada contra redirecciones abiertas con el mismo criterio que Better Auth.

Pagos: lo que no funcionaba como estaba documentado

  • Los webhooks de Stripe y Polar recibían 403 en producción, porque llegan sin Origin y el proxy los rechazaba. Ahora están exentos por ruta exacta; su autenticidad la prueba la firma.
  • Polar leía todos los campos como undefined: el SDK los entrega en camelCase y el código los buscaba en snake_case. Las suscripciones no se guardaban y las compras no daban créditos.
  • subscription.canceled ya no quita el acceso. Polar lo envía cuando el cliente programa la baja; el acceso se mantiene hasta el final del periodo pagado y solo subscription.revoked lo retira.
  • Un webhook reintentado ya no duplica pagos ni créditos: compra, pago y créditos se escriben en una sola transacción, y un reembolso que llega antes que el pago ya no se pierde.
  • Con la versión de la API de Stripe que fija el boilerplate, ningún pago de suscripción se estaba registrando. Ahora se leen los campos nuevos de la factura.
  • El aviso de «pagos sin configurar» ya no sale con Polar configurado.

Subidas

La URL prefirmada llevaba el checksum de un cuerpo vacío y S3 rechazaba cualquier fichero real. Ahora además firma el tipo y el tamaño del fichero, y POST /api/upload/presigned-url valida el cuerpo con un límite de 5 MB.

Si ya tienes un proyecto

Seis cambios pueden romper código que hayas escrito encima del boilerplate:

  1. POST /api/upload/presigned-url exige size y un contentType de imagen.
  2. src/lib/actions/create-action.ts ya no es 'use server': tus acciones van en su propio fichero.
  3. requireAdmin se importa de @/lib/auth/dal y devuelve el usuario, no la sesión.
  4. Con Stripe, los créditos del chat necesitan STRIPE_SECRET_KEY, y isStripeConfigured e isPolarConfigured ya no se exportan de @/config/env.
  5. Cambia la firma de handleWebhookEvent y handlePolarWebhookEvent, si los llamas tú.
  6. El cliente de Prisma, auth/server y el resto de módulos de servidor son server-only: tus scripts fuera de Next.js necesitan su propio cliente de Prisma.

Empieza por subir Next a 16.4.6. La lista completa de ficheros a copiar, con el diff de cada cambio, está en «Upgrading from 2.1.4» del CHANGELOG.md del repositorio; copiada tal cual sobre una 2.1.4 sin tocar, pasa typecheck, lint y tests. Después, ejecuta bun run test: el test de las páginas de admin te dirá cuáles de las tuyas no comprueban el rol.

No hay migraciones ni variables de entorno nuevas.