Valibot: Модульная валидация, Tree-Shaking и конвейеры схем

z.string().min(5).max(100).email().trim();

+-------------------------------------------------------------------------+
|                  МОНОЛИТНЫЙ ГРАФ ZOD (Tree-Shaking невозможен)          |
+-------------------------------------------------------------------------+
|  import { z } from 'zod';                                               |
|  z.string().email();                                                    |
|                                                                         |
|  Сборщик видит класс ZodString:                                         |
|  class ZodString {                                                      |
|    min() { ... }     // <- Тянется в бандл, даже если не используется!   |
|    max() { ... }     // <- Тянется в бандл!                             |
|    uuid() { ... }    // <- Тянется в бандл!                             |
|    regex() { ... }   // <- Тянется в бандл!                             |
|    ip() { ... }      // <- Тянется в бандл!                             |
|  }                                                                      |
|  => Итоговый вес бандла: ~14 КБ (gzip)                                  |
+-------------------------------------------------------------------------+
|                                                                         |
|                  МОДУЛЬНЫЙ ГРАФ VALIBOT (Полный Tree-Shaking)           |
+-------------------------------------------------------------------------+
|  import { object, string, email, pipe } from 'valibot';                 |
|                                                                         |
|  Сборщик анализирует ES-экспорты:                                       |
|  - object()   => Включен в бандл (~350 байт)                            |
|  - string()   => Включен в бандл (~150 байт)                            |
|  - email()    => Включен в бандл (~200 байт)                            |
|  - pipe()     => Включен в бандл (~100 байт)                            |
|  * Все остальные 150+ функций библиотеки полностью удалены из сборки!  |
|  => Итоговый вес бандла: ~850 байт (gzip)!                              |
+-------------------------------------------------------------------------+

import * as v from 'valibot';

// Описание схемы через функциональный конвейер pipe()
export const UserProfileSchema = v.object({
  id: v.pipe(
    v.string(),
    v.uuid('Идентификатор должен быть валидным UUID v4')
  ),
  username: v.pipe(
    v.string(),
    v.trim(), // Трансформация: автоматическое удаление пробелов
    v.minLength(3, 'Минимальная длина имени — 3 символа'),
    v.maxLength(20, 'Максимальная длина имени — 20 символов')
  ),
  email: v.pipe(
    v.string(),
    v.trim(),
    v.toLowerCase(), // Трансформация: нормализация регистра
    v.email('Некорректный синтаксис email-адреса')
  ),
  age: v.pipe(
    v.number(),
    v.minValue(18, 'Сервис доступен только лицам старше 18 лет'),
    v.maxValue(100, 'Укажите корректный возраст')
  ),
  website: v.optional(
    v.pipe(
      v.string(),
      v.url('Некорректный формат URL адреса')
    )
  ),
});

// Статический инференс типа входных данных (до трансформаций)
export type UserProfileInput = v.InferInput<typeof UserProfileSchema>;

// Статический инференс типа выходных данных (после trim и toLowerCase)
export type UserProfileOutput = v.InferOutput<typeof UserProfileSchema>;

import * as v from 'valibot';

// Кастомное действие проверки надежности пароля
export function passwordStrength(requirementMessage = 'Пароль должен содержать минимум 1 цифру и 1 спецсимвол') {
  return v.check((input: string) => {
    const hasNumber = /\d/.test(input);
    const hasSpecialChar = /[!@#$%^&*(),.?":{}|<>]/.test(input);
    return hasNumber && hasSpecialChar;
  }, requirementMessage);
}

// Кастомное действие валидации ИНН (10 цифр с контрольной суммой)
export function isValidInn(errorMessage = 'Некорректный формат ИНН организации') {
  return v.check((input: string) => {
    if (!/^\d{10}$/.test(input)) return false;
    
    const coefficients = [2, 4, 10, 3, 5, 9, 4, 6, 8];
    const controlSum = coefficients.reduce(
      (sum, coeff, idx) => sum + coeff * Number(input[idx]),
      0
    );
    const controlDigit = (controlSum % 11) % 10;
    
    return Number(input[9]) === controlDigit;
  }, errorMessage);
}

// Использование кастомных действий в конвейере
export const SecurityFormSchema = v.object({
  inn: v.pipe(
    v.string(),
    v.trim(),
    isValidInn()
  ),
  password: v.pipe(
    v.string(),
    v.minLength(8, 'Длина пароля — не менее 8 символов'),
    passwordStrength()
  ),
});

import * as v from 'valibot';
import { UserProfileSchema, UserProfileOutput } from './profile-schema';

export interface FormSubmissionResult {
  isSuccess: boolean;
  data?: UserProfileOutput;
  fieldErrors?: Record<string, string>;
}

export function handleProfileSubmission(rawFormData: unknown): FormSubmissionResult {
  // safeParse не выбрасывает исключений и возвращает типизированный результат
  const result = v.safeParse(UserProfileSchema, rawFormData);

  if (!result.success) {
    // Преобразование плоского массива issues в мапу ошибок для полей формы
    const fieldErrors: Record<string, string> = {};

    for (const issue of result.issues) {
      // Извлечение имени первого сегмента пути ошибки (например, 'email' или 'username')
      const fieldName = issue.path?.[0]?.key;
      if (typeof fieldName === 'string' && !fieldErrors[fieldName]) {
        fieldErrors[fieldName] = issue.message;
      }
    }

    return {
      isSuccess: false,
      fieldErrors,
    };
  }

  // Данные гарантированно валидны и трансформированы
  return {
    isSuccess: true,
    data: result.output,
  };
}