OneOf и взаимоисключающие свойства

Принципы

• Утилита OneOf гарантирует, что объект содержит ровно один из указанных ключей (draftId или dbId).
• Полезно для моделирования состояний, где поля взаимоисключают друг друга.
• TypeScript подсказывает, какое свойство undefined, когда активировано другое.

Пример

import { OneOf } from 'ts-cookbook';

interface UnsavedRecord {
  name: string;
  age: number;
}

type DbRecord = UnsavedRecord &
  OneOf<{
    draftId: string;
    dbId: string;
  }>;

const record: DbRecord = {} as any;
if (record.dbId) {
  record.draftId; // тип: draftId?: undefined
}

Практика

• Используйте OneOf для форм, где запись может быть либо черновиком, либо сохранённой сущностью.
• Проверяйте наличие поля перед использованием: тип укажет, что второе поле будет undefined.
• При сериализации убедитесь, что объект действительно содержит только одно поле — утилита отвечает за тип, но не за runtime.