@zdravkurort/quotas-contracts

Общие контракты (zod-схемы и производные от них TypeScript-типы) для backend и frontend виджета квот. Пакет публикуется публично в npm в scope организации zdravkurort: https://www.npmjs.com/package/@zdravkurort/quotas-contracts

• Исходники: commands/ (реэкспорт через index.ts)
• Сборка: build/ (генерируется tsc, в git не хранится осмысленно — пересобирается при публикации)
• Потребитель: frontend (зависимость @zdravkurort/quotas-contracts в frontend/package.json)

Разовая настройка (один раз на машину)

1. Ваш личный npm-аккаунт должен состоять в организации zdravkurort с правом публикации (участников добавляет владелец организации на странице Members).

2. Авторизоваться в npm под своим личным аккаунтом:

   npm login

   Проверить вход: npm whoami — должно вывести имя вашего аккаунта.

Флоу обновления контрактов

Все команды выполняются из каталога backend/contracts.

1. Внести изменения в схемы в commands/ (новые файлы не забыть реэкспортировать в commands/index.ts).

2. Проверить сборку:

   npm run build

3. Поднять версию по semver:

   npm version patch   # правка без изменения API (фикс схемы)
   npm version minor   # добавлены новые схемы/поля, обратная совместимость сохранена
   npm version major   # ломающее изменение (переименование/удаление полей, изменение типов)

4. Опубликовать:

   npm publish

   Перед публикацией автоматически выполняется prepublishOnly — чистая пересборка build/. Публикация публичная (publishConfig.access: "public"), флаг --access public указывать не нужно.

5. Обновить пакет во frontend (из каталога frontend):

   yarn upgrade @zdravkurort/quotas-contracts

   При minor/major-обновлении сначала поправить диапазон версии в frontend/package.json, затем выполнить yarn install.

6. Закоммитить изменения: исходники контрактов, backend/contracts/package.json (новая версия), frontend/package.json и frontend/yarn.lock.

Типичные проблемы

• npm publish → 403 Forbidden — вы залогинены не под тем пользователем (npm whoami), либо версия уже опубликована (поднимите версию), либо у пользователя нет прав на scope @zdravkurort.
• npm publish → 402 Payment Required — пакет пытается опубликоваться как приватный. Убедитесь, что в package.json осталась секция "publishConfig": { "access": "public" }.
• Frontend не видит новые типы — проверьте, что новая схема реэкспортируется из commands/index.ts, версия поднята и опубликована, а во frontend выполнен yarn upgrade.

История

До июля 2026 пакет назывался @yatolstoy/quotas-contracts и публиковался в GitHub Packages (npm.pkg.github.com, требовался .npmrc с токеном). Сейчас — публичный npm, .npmrc не нужен.