Где хранить интерфейсы?

Question

[Алексей Ярков]

Сервер - RESTful API. Стек - typescript, typeorm, PostgreSQL.
Клиент - Web (Vue, typescript), Mobile (React Native).

Есть необходимость хранить интерфейсы в одном месте и шарить между проектами.
Думал сделать служебный API ресурс, где по имени отдавать схему, из которой генерировать интерфейс. Но это только копипаста для разработки.
Потом вспомнил про git submodule.
Кто-то сталкивался с подобным?

Comments

[Станислав Макаров]

Интерфейсы чего касаются? Только REST API и DTO-шек в нём или есть что-то ещё?

[Алексей Ярков]

Станислав Макаров, только рест апи. Надо затипизировать то, что может вернуть бэкенд.

[Владимир Проскурин]

Алексей Ярков, не успел в том вопросе ответить, про заполнение объектов датой. Может код пригодится

const data = [
    {"date":"2019-01-31","minTicketPrice":1000},
    {"date":"2019-02-05","minTicketPrice":1000},
    {"date":"2019-02-07","minTicketPrice":1000}
]
let offset = 1;
let objects = [];
// Начальный день, от которого идем
let dateStart = new Date(data[0].date);
// ... добавляем его сразу в список объектов
objects.push(data.shift());
// Следующий день из списка
let nextDate = new Date(data[0].date);

while(data.length) {
    // берем следующий день, относительно начального дня
    let nextDay = new Date(dateStart.getTime());
    nextDay.setDate(nextDay.getDate() + offset++);

    if (nextDay.getTime() === nextDate.getTime()) {
        objects.push(data.shift());
        if (data.length) {
            nextDate = new Date(data[0].date);
        }        
    } else {
        objects.push({date: nextDay.toISOString().slice(0, 10)});
    }
}

[Алексей Ярков]

Владимир Проскурин, спасибо )) Написал такую функцию уже

// differenceInDays и format импортированы из date-fns
function invertArray(array: DepartureDate[] = []): DepartureDate[]
{
    if (!array.length) {
        return [];
    }

    const first = array.slice().shift();
    const last = array.slice().pop();
    const days = differenceInDays(parse(last.date), parse(first.date));
    const dates = [{date: first.date, minTicketPrice: 0}];

    for (let i = 1; i < days; i++) {
        const date = format(addDays(parse(first.date), i), 'YYYY-MM-DD');
        dates.push({date, minTicketPrice: 0});
    }

    return (uniqBy([...array, ...dates], 'date') as DepartureDate[]).filter(date => !date.minTicketPrice);
}

Answer 1

[Станислав Макаров]

только рест апи. Надо затипизировать то, что может вернуть бэкенд.

Тогда почему бы не описать REST API с помощью OpenAPI-спеки и на её основе не сгенерить код?

Comments

[Алексей Ярков]

Так описываю. Не знал что есть такая возможность. Подскажите тулзу для этого.