Как стать автором
Обновить

Комментарии 3

Swagger и Swashbuckle – это прекрасно, трудно переоценить ту магию, которая предлагается в этих решениях. Однако есть ведь и «прямые» пути для генерации TypeScript (без промежуточной JSON Schema, а напрямую из сборок):
— http://type.litesolutions.net
— https://github.com/praeclarum/Netjs
Была ли попытка познакомиться с этими решениями? Сам ещё не пробовал в деле, но всё ищу подходящий повод.
Кроме TypeScript, есть metadata.js, реализующая на клиенте ссылочную типизацию полей документов, регистров и справочников, наподобие объектной модели 1С + автогенерация форм + offline-first.
Как уже было сказано в тексте статьи, мы получили пользу не только от конечного результата (типизации клиентских моделей), но и от промежуточного звена (документации API) в том числе.
Скажу больше. Вначале у нас был только Swagger для документации API. И уже потом пришла идея получить заодно и клиентские модели.
Отвечая на Ваш вопрос.
Попытки познакомиться не было, т.к. пришли мы к этому решению другим путём.

Что касается упомянутых решений.
1. Netjs вижу впервые. На мой взгляд не выглядит серьезным, если смотреть на метрики github.
Да и идея другая. Больше похоже на «пишем на C#, получаем TypeScript», а не на генерацию TS definitions.
Тут интереснее подумать о «пишем Back-End на TypeScript + Node.js, переиспользуем логику на Front-End», но это уже отдельная тема.

2. TypeLITE — согласен, делает как раз то, что нужно.
И он даже попадался мне на глаза ранее, но в тот момент не получилось его внедрить по каким-то другим причинам (время, ресурсы и т.п.), а не потому что не понравился.
Попробуйте его, если таки найдете подходящий повод. И поделитесь! :)

И наконец.
Вариант с промежуточной JSON Schema имеет неоспоримое преимущество.
Он не зависит от языка на котором написан API.
Это может быть Java, C#, PHP, Ruby и т.д. Всё, что душе угодно.
Хоть вручную описать Swagger документ, и сгенерировать клиентский код.
Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.