Как типизировать объект с разным набором полей у сущностей?

На практике часто встречаются сущности, которые имеют общие поля, но различаются деталями.

Базовый подход

Самый распространённый способ — union-типы:

type User = Admin | Guest;

interface Admin {
  role: "admin";
  permissions: string[];
}

interface Guest {
  role: "guest";
  expiresAt: Date;
}

Здесь:

• User может быть разного вида

• набор полей зависит от роли

Сужение типов

TypeScript умеет автоматически определять конкретный вариант:

function processUser(user: User) {
  if (user.role === "admin") {
    user.permissions; // доступно
  }
}

Это называется type narrowing.

Общие поля

Часто выносят общие свойства:

interface BaseUser {
  id: number;
}

interface Admin extends BaseUser {
  role: "admin";
}

interface Guest extends BaseUser {
  role: "guest";
}

Альтернативы

В зависимости от задачи можно использовать:

• optional-поля (хуже для строгой типизации)

• дженерики

• mapped-типы

Вывод

Union-типы позволяют точно описывать объекты с разным набором полей. Это основной инструмент моделирования сложных доменных сущностей в TypeScript.