Валідація API через Zod

const rawBody = await request.json();

const result = schema.safeParse(value);

if (!result.success) {
  // Дані не пройшли валідацію
  console.log(result.error.issues);
} else {
  // result.data має перевірений тип
  console.log(result.data);
}

import { z } from "zod";

const updateProductSchema = z.object({
  name: z.string().trim().min(2, "Назва має містити щонайменше 2 символи"),
  price: z.number().finite().positive("Ціна має бути більшою за нуль"),
  description: z.string().trim().max(500).optional(),
});

/api/products/42

const paramsSchema = z.object({
  id: z.coerce.number().int().positive("ID має бути додатним цілим числом"),
});

/api/products/42?page=2&includeDetails=true

const querySchema = z.object({
  page: z.coerce.number().int().min(1).default(1),
  includeDetails: z
    .enum(["true", "false"])
    .default("false")
    .transform((value) => value === "true"),
});

{
  page: 2,
  includeDetails: true
}

app/api/products/[id]/route.ts

import { NextRequest, NextResponse } from "next/server";
import { z } from "zod";

const paramsSchema = z.object({
  id: z.coerce.number().int().positive("ID має бути додатним цілим числом"),
});

const querySchema = z.object({
  page: z.coerce.number().int().min(1).default(1),
  includeDetails: z
    .enum(["true", "false"])
    .default("false")
    .transform((value) => value === "true"),
});

const updateProductSchema = z.object({
  name: z.string().trim().min(2, "Назва має містити щонайменше 2 символи"),
  price: z.number().finite().positive("Ціна має бути більшою за нуль"),
  description: z.string().trim().max(500).optional(),
});

function formatIssues(
  source: string,
  issues: z.ZodIssue[],
) {
  return issues.map((issue) => ({
    source,
    field: issue.path.length > 0 ? issue.path.join(".") : source,
    message: issue.message,
  }));
}

export async function POST(
  request: NextRequest,
  context: { params: Promise<{ id: string }> },
) {
  const rawParams = await context.params;

  const paramsResult = paramsSchema.safeParse(rawParams);

  if (!paramsResult.success) {
    return NextResponse.json(
      {
        error: "Помилка валідації параметрів маршруту",
        details: formatIssues("params", paramsResult.error.issues),
      },
      { status: 422 },
    );
  }

  const searchParams = Object.fromEntries(
    request.nextUrl.searchParams.entries(),
  );

  const queryResult = querySchema.safeParse(searchParams);

  if (!queryResult.success) {
    return NextResponse.json(
      {
        error: "Помилка валідації query-параметрів",
        details: formatIssues("query", queryResult.error.issues),
      },
      { status: 422 },
    );
  }

  let rawBody: unknown;

  try {
    rawBody = await request.json();
  } catch {
    return NextResponse.json(
      {
        error: "Тіло запиту має бути коректним JSON",
      },
      { status: 400 },
    );
  }

  const bodyResult = updateProductSchema.safeParse(rawBody);

  if (!bodyResult.success) {
    return NextResponse.json(
      {
        error: "Помилка валідації тіла запиту",
        details: formatIssues("body", bodyResult.error.issues),
      },
      { status: 422 },
    );
  }

  const { id } = paramsResult.data;
  const { page, includeDetails } = queryResult.data;
  const { name, price, description } = bodyResult.data;

  return NextResponse.json({
    message: "Дані пройшли валідацію",
    product: {
      id,
      name,
      price,
      description,
    },
    options: {
      page,
      includeDetails,
    },
  });
}

context: { params: Promise<{ id: string }> }

const rawParams = await context.params;

curl -X POST "http://localhost:3000/api/products/42?page=2&includeDetails=true" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Механічна клавіатура",
    "price": 3499,
    "description": "Клавіатура з механічними перемикачами"
  }'

{
  "message": "Дані пройшли валідацію",
  "product": {
    "id": 42,
    "name": "Механічна клавіатура",
    "price": 3499,
    "description": "Клавіатура з механічними перемикачами"
  },
  "options": {
    "page": 2,
    "includeDetails": true
  }
}

{
  "name": "A",
  "price": -10
}

{
  "error": "Помилка валідації тіла запиту",
  "details": [
    {
      "source": "body",
      "field": "name",
      "message": "Назва має містити щонайменше 2 символи"
    },
    {
      "source": "body",
      "field": "price",
      "message": "Ціна має бути більшою за нуль"
    }
  ]
}

type UpdateProductInput = z.infer<typeof updateProductSchema>;

type UpdateProductInput = {
  name: string;
  price: number;
  description?: string;
};

type QueryInput = z.input<typeof querySchema>;
type QueryOutput = z.output<typeof querySchema>;

const result = schema.safeParse(value);

if (!result.success) {
  // Обробка помилки
} else {
  // Використання result.data
}

const data = schema.parse(value);

const body = await request.json();
const productName = body.name.trim();

const result = updateProductSchema.safeParse(body);

const body = await request.json();
const result = updateProductSchema.safeParse(body);

if (!result.success) {
  // Повернення помилки
}

const productName = result.data.name;

?page=2

Boolean("false"); // true