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 isValidTaxId(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({
  taxId: v.pipe(
    v.string(),
    v.trim(),
    isValidTaxId()
  ),
  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,
  };
}