Omit

export type User = {
  name: string;
  email: string;
  age: number;
};

export type PublicUser = Omit<User, "email">;

export const publicUser: PublicUser = {
  name: "Макс",
  age: 25,
  // @ts-expect-error в публичном профиле не должно быть email
  email: "max@maxroslow.ru",
};

Omit<User, "email"> даёт { name: string; age: number }. Поля email в типе нет, поэтому попытка положить его в объектный литерал становится ошибкой, и директива оказывается на месте.

Pick или Omit

Результат один и тот же, отличается только то, что перечисляется:

type PublicUser = Omit<User, "email">;          // всё, кроме почты
type PublicUser = Pick<User, "name"

Разница проявляется, когда в User добавят новое поле, например phone. Вариант с Omit подхватит его автоматически (и телефон окажется публичным), вариант с Pick продолжит отдавать только имя и возраст.

Отсюда практическое правило: для белого списка (что можно отдавать наружу) надёжнее Pick, для чёрного (что нужно спрятать) удобнее Omit. В коде, который отвечает за приватность, безопаснее по умолчанию скрывать всё новое, то есть Pick.

Одна особенность Omit

Ключи в Omit не проверяются на принадлежность типу:

type X = Omit<User, "phone">; // ошибки нет, просто ничего не убрано

Pick в такой ситуации ругается. Это делает опечатку в Omit тихой: тип соберётся, но поле останется. Ещё один аргумент в пользу Pick там, где цена ошибки высока.

Несколько ключей сразу

type Minimal = Omit<User, "email" | "age">; // { name: string }

Ключи перечисляются через |, как и в Pick.