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 concallbackUrl. 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, marcadaserver-only):getCurrentUser(),requireSession()yrequireAdmin(). 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. AuthGateyAdminGatedentro del Suspense de cada layout,requireAdmin()en cada página de admin ycreateAdminAction()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
Originy 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.canceledya 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 solosubscription.revokedlo 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:
POST /api/upload/presigned-urlexigesizey uncontentTypede imagen.src/lib/actions/create-action.tsya no es'use server': tus acciones van en su propio fichero.requireAdminse importa de@/lib/auth/daly devuelve el usuario, no la sesión.- Con Stripe, los créditos del chat necesitan
STRIPE_SECRET_KEY, yisStripeConfiguredeisPolarConfiguredya no se exportan de@/config/env. - Cambia la firma de
handleWebhookEventyhandlePolarWebhookEvent, si los llamas tú. - El cliente de Prisma,
auth/servery el resto de módulos de servidor sonserver-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.