Skip to content

0.0.3

Choose a tag to compare

@zerobig zerobig released this 31 Oct 09:32
· 2 commits to main since this release

[0.0.3] - 31.10.2026

Первый публичный релиз библиотеки. Включает накопленный функционал
предыдущих итераций и новое семейство модификаторов для работы с null.

Добавлено

Базовые типы и фабрики

  • Фабрики примитивов: Zod.Строки, Zod.Числа, Zod.Булевы, Zod.Даты,
    Zod.Любое.
  • Фабрики объектов: Zod.Объект, Zod.СтрогийОбъект, Zod.СвободныйОбъект,
    Zod.Запись.
  • Фабрики коллекций: Zod.Массивы, Zod.Перечисление, Zod.Объединение.
  • Фабрики приведения: Zod.ПриведеннаяСтрока, Zod.ПриведенноеЧисло,
    Zod.ПриведенноеБулево, Zod.ПриведеннаяДата.
  • Строковые форматы: Email, URL, UUID, IPv4, IPv6, ДатаISO, ХешMD5, ХешSHA256,
    Телефон, ИНН, ИНН10, ИНН12, СНИЛС, ОГРН, ОГРНИП, КПП, БИК, РасчетныйСчет,
    ОКТМО, ОКПО, Луна, EAN13, EAN8, ISBN10, ISBN13.
  • Ссылочные типы 1С: Zod.Справочник, Zod.Документ,
    Zod.ПеречислениеСсылка, Zod.ПланВидовХарактеристик, Zod.ПланСчетов,
    Zod.ПланОбмена, Zod.БизнесПроцесс, Zod.Задача, Zod.ЛюбаяСсылка,
    Zod.СоставнаяСсылка.
  • Объекты 1С: Zod.ОбъектДокумента, Zod.ОбъектСправочника,
    Zod.ОбъектПланаВидовХарактеристик, Zod.ОбъектПланаСчетов,
    Zod.ОбъектПланаОбмена, Zod.ОбъектБизнесПроцесса, Zod.ОбъектЗадачи.

Модификаторы и утилиты схем

  • Модификаторы строк: .МинДлина, .МаксДлина, .Непустая, .Паттерн,
    а также все строковые форматы как методы.
  • Модификаторы чисел: .МинЗначение, .МаксЗначение, .Целое,
    .Положительное.
  • Модификаторы объектов и массивов: .Поле, .Элемент, .МинЭлементов,
    .МаксЭлементов.
  • Модификатор ссылок: .ТолькоСуществующая.
  • Модификатор объектов 1С: .ЗаполнятьПоУмолчанию, .ТабличнаяЧасть.
  • Генерация шаблонов: .СоздатьПустой, .СоздатьМинимальный.

Новое в этой версии: работа с null

  • Модификатор .ДопускаетNull(). Разрешает значение Неопределено (в JSON -
    null), но не разрешает отсутствие ключа в объекте. Используется для
    OpenAPI-свойств, которые в required и nullable: true.
  • Утилиты .ДопускаетОтсутствие() и .ДопускаетНеопределено() для
    программной проверки возможностей схемы.
  • Метод .ЭтоНеобязательное() сохранён как алиас .ДопускаетОтсутствие()
    для обратной совместимости.
  • ПроверитьВнутренний учитывает флаг ДопускаетNull: значение
    Неопределено проходит валидацию, если схема помечена .ДопускаетNull().
  • ПроверитьОбъект использует .ДопускаетОтсутствие() для различения
    «ключа нет» и «ключ есть, значение Неопределено».

Кастомные проверки и трансформеры

  • .Проверка(ОбъектПроверки) - добавление пользовательской проверки.
    Проверка - объект с методом Проверить(Значение). Проверки применяются
    только при успешной базовой валидации.
  • .Трансформировать(ОбъектТрансформера) - добавление трансформера.
    Трансформер - объект с методом Преобразовать(Значение), применяется
    до валидации.
  • Готовые трансформеры: Zod_Трансформер_Телефон (нормализация телефона РФ),
    Zod_Трансформер_ПустоеВНеопределено (пустая строка в Неопределено).
  • Фабрика Zod.НормализованныйТелефон для быстрого подключения трансформера
    телефона.

Утилиты и вспомогательные функции

  • Zod.СериализоватьСсылку - ссылка 1С в структуру {type, id}.
  • Zod.СериализоватьОбъект - объект 1С в структуру с реквизитами и
    табличными частями.
  • Zod.ЭтоСсылка1С - предикат для проверки, является ли значение ссылкой.
  • Zod.ПлоскиеОшибки - ошибки в формате {formErrors, fieldErrors}.
  • Zod.ДеревоОшибок - ошибки в виде вложенной структуры.
  • Zod.КрасивыйТекстОшибок - человекочитаемая строка ошибок.
  • Zod.ПроверитьПараметрыЗапроса(Запрос, Схема) - адаптер для валидации
    query-параметров HTTP-сервиса.

Изменено

  • Внутренняя логика Zod_Схема.ПроверитьВнутренний теперь учитывает
    флаг Состояние.ДопускаетNull.
  • Внутренняя логика Zod_Схема.ПроверитьОбъект использует метод
    .ДопускаетОтсутствие() вместо .ЭтоНеобязательное() для различения
    отсутствия ключа и значения Неопределено.

Ограничения

  • В общих модулях 1С нет переменных модуля, поэтому Zod_Схема - это
    обработка, и каждая схема является независимым объектом. Кэширование
    схем в общем модуле невозможно.
  • .Необязательное() ведёт себя как .nullish() в Zod (TypeScript):
    пропускает и отсутствие ключа, и Неопределено. Для строгой семантики
    .optional() используйте .ДопускаетNull() с явной проверкой.
  • .Паттерн() работает как RegExp.test(): ищет совпадение в любом месте
    строки. Для полного совпадения используйте явные анкоры ^...$.

Совместимость

Совместимость с swagger-1c 2.0.0 и выше:

  • Swag_ZodАдаптер в swagger-1c использует функции zod-1c для
    рантайм-валидации запросов и ответов HTTP-сервисов.
  • Zod.ДопускаетNull() используется для корректного преобразования поля
    nullable: true из OpenAPI-схем.
  • При отсутствии zod-1c в конфигурации swagger-1c работает без изменений
    (генерация спецификации не требует валидации).