NarixHine/uni-chem / .agents/skills/safe-action-client
safe-action-client
VerifiedUse when creating or configuring a next-safe-action client, defining actions with input/output validation, handling server errors, or setting up createSafeActionClient with Standard Schema (Zod, Yup, Valibot)
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.6 KB |
| client-setup.md | markdown | 4.2 KB |
| error-handling.md | markdown | 4.5 KB |
| input-output-validation.md | markdown | 3.1 KB |
input-output-validation.md
View on GitHub# Input & Output Validation
## Standard Schema v1
next-safe-action works with any validation library that implements the [Standard Schema](https://github.com/standard-schema/standard-schema) specification (v1). This includes Zod, Yup, Valibot, ArkType, and others — no adapters needed.
## Input Schema
### Basic usage
```ts
"use server";
import { z } from "zod";
import { actionClient } from "@/lib/safe-action";
export const createUser = actionClient
.inputSchema(
z.object({
name: z.string().min(2),
email: z.string().email(),
age: z.number().int().min(18).optional(),
})
)
.action(async ({ parsedInput }) => {
// parsedInput is fully typed: { name: string; email: string; age?: number }
const user = await db.user.create(parsedInput);
return { id: user.id };
});
```
### With Valibot
```ts
import * as v from "valibot";
export const createUser = actionClient
.inputSchema(
v.object({
name: v.pipe(v.string(), v.minLength(2)),
email: v.pipe(v.string(), v.email()),
})
)
.action(async ({ parsedInput }) => {
// Same typed parsedInput
});
```
### Async schema factory
Use an async function to dynamically extend schemas. The factory receives the previous schema (if chained) and the raw client input:
```ts
export const updateUser = actionClient
.inputSchema(z.object({ id: z.string().uuid() }))
.inputSchema(async (prevSchema, { clientInput }) => {
// prevSchema is the z.object({ id }) from above
// clientInput is the raw input from the client
const user = await db.user.findById((clientInput as any).id);
return prevSchema.extend({
name: z.string().min(2).default(user?.name ?? ""),
});
})
.action(async ({ parsedInput }) => {
// parsedInput: { id: string; name: string }
});
```
## Output Schema
Validates the return value of the action. If validation fails, `ActionOutputDataValidationError` is thrown.
```ts
export const getUser = actionClient
.inputSchema(z.object({ id: z.string().uuid() }))
.outputSchema(
z.object({
id: z.string(),
name: z.string(),
email: z.string().email(),
})
)
.action(async ({ parsedInput }) => {
const user = await db.user.findById(parsedInput.id);
if (!user) throw new Error("User not found");
// Return value is validated against outputSchema
return { id: user.id, name: user.name, email: user.email };
});
```
## Custom Validation Error Shape
Override the default validation error shape per-action:
```ts
import { flattenValidationErrors } from "next-safe-action";
export const myAction = actionClient
.inputSchema(
z.object({ email: z.string().email() }),
{
handleValidationErrorsShape: async (validationErrors) =>
flattenValidationErrors(validationErrors),
}
)
.action(async ({ parsedInput }) => {
// ...
});
// Result shape: { formErrors: string[], fieldErrors: { email?: string[] } }
```
## No Input Schema
Actions without `.inputSchema()` accept no input:
```ts
export const getCurrentTime = actionClient.action(async () => {
return { time: new Date().toISOString() };
});
// Client: execute() takes no arguments
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |