Que fait next-safe-action ?
Présentation
next-safe-action ajoute la sécurité de type, la validation des entrées et un middleware aux Server Actions de Next.js. Au lieu d'analyser manuellement FormData et de gérer les erreurs, définissez un schéma Zod et obtenez des entrées validées et typées avec une gestion automatique des erreurs.
Instructions
Étape 1 : Configuration
npm install next-safe-action zod
// lib/safe-action.ts — Client d'action avec middleware d'authentification
import { createSafeActionClient } from 'next-safe-action'
import { auth } from '@/auth'
// Actions publiques (aucune authentification requise)
export const publicAction = createSafeActionClient()
// Actions authentifiées
export const authAction = createSafeActionClient({
async middleware() {
const session = await auth()
if (!session?.user) throw new Error('Non authentifié')
return { user: session.user }
},
})
Étape 2 : Définir les actions
// actions/projects.ts — Actions serveur typées en toute sécurité
'use server'
import { authAction } from '@/lib/safe-action'
import { z } from 'zod'
import { prisma } from '@/lib/db'
import { revalidatePath } from 'next/cache'
const createProjectSchema = z.object({
name: z.string().min(1).max(100),
description: z.string().max(500).optional(),
})
export const createProject = authAction
.schema(createProjectSchema)
.action(async ({ parsedInput, ctx }) => {
const project = await prisma.project.create({
data: {
...parsedInput,
ownerId: ctx.user.id,
},
})
revalidatePath('/dashboard')
return { project }
})
const updateProjectSchema = z.object({
id: z.string().uuid(),
name: z.string().min(1).max(100).optional(),
description: z.string().max(500).optional(),
status: z.enum(['active', 'archived']).optional(),
})
export const updateProject = authAction
.schema(updateProjectSchema)
.action(async ({ parsedInput, ctx }) => {
const { id, ...data } = parsedInput
// Vérifier la propriété
const project = await prisma.project.findFirst({
where: { id, ownerId: ctx.user.id },
})
if (!project) throw new Error('Projet non trouvé')
const updated = await prisma.project.update({
where: { id },
data,
})
revalidatePath(`/projects/${id}`)
return { project: updated }
})
Étape 3 : Utilisation dans les composants
// components/CreateProjectForm.tsx — Formulaire avec action sécurisée
'use client'
import { useAction } from 'next-safe-action/hooks'
import { createProject } from '@/actions/projects'
export function CreateProjectForm() {
const { execute, result, isExecuting } = useAction(createProject)
return (
<form action={execute}>
<input name="name" placeholder="Nom du projet" required />
<textarea name="description" placeholder="Description (optionnelle)" />
{result.validationErrors && (
<div className="errors">
{Object.entries(result.validationErrors).map(([field, errors]) => (
<p key={field}>{field} : {errors?.join(', ')}</p>
))}
</div>
)}
{result.serverError && (
<p className="error">{result.serverError}</p>
)}
<button disabled={isExecuting}>
{isExecuting ? 'Création...' : 'Créer le projet'}
</button>
</form>
)
}
Bonnes pratiques
- Utilisez toujours des schémas Zod pour la validation des entrées — ne faites jamais confiance aux données soumises par le client.
- Utilisez le middleware pour l'authentification — il s'exécute avant chaque action dans la chaîne.
- Le hook
useActionfournitisExecuting,result, et une gestion automatique des erreurs. - Combinez avec
useOptimisticActionpour un retour utilisateur instantané. - Révalidez les chemins/tags après les mutations pour maintenir l'interface utilisateur synchronisée avec la base de données.