Пакеты client-SDK

9 пакетов, сгруппированных по слоям (ADR-0042). Для каждого — нарративный гайд (эта секция) и API-референс из кода (секция «API-референс»).

Пакет	Слой	Назначение	Гайд	API из кода
@mineflow/api-client	L0	TS-типы REST (codegen)	гайд	REST ↗
@mineflow/api-zod	L0	Zod-схемы форм (codegen)	гайд	REST ↗
@mineflow/api-schemas	L0	FSM-машины + энумы	гайд	↗
@mineflow/client-core	L1	ядро: fetch/ошибки/саги/SSE/JWT	гайд	↗
@mineflow/client-react	L2	провайдер + хуки	гайд	↗
@mineflow/auth-web	L3	Keycloak adapter (web)	гайд	↗
@mineflow/auth-native	L3	token provider (RN)	гайд	↗
@mineflow/contracts	—	типы доменных событий	гайд	↗
@mineflow/shared-validation	—	ИИН/БИН/IBAN-проверки	гайд	↗

Установка извне монорепо

Пакеты публикуются в приватный registry (GitHub Packages). В frontend-репозитории:

# .npmrc
@mineflow:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

export GITHUB_TOKEN=ghp_xxx   # PAT classic, scope read:packages
pnpm add @mineflow/client-react @mineflow/auth-web @mineflow/api-zod

Версия SDK должна совпадать с tag'ом backend-образа (X.Y.Z). Детали — docs/frontend-sdk-packages.md.