# @v2/player-compensation-service

Player compensation system for `TODOS.phase-72.72.12.2.12`.

The package can grant items and currency to affected players after bugs or
outages. Campaigns are incident-scoped, evidence-backed, approval-gated, and
server-authoritative.

Primary exports:

- `buildV2PlayerCompensationSurface`
- `planV2PlayerCompensationGrants`
- `applyV2PlayerCompensationGrant`

Service endpoints:

- `GET /v2/live-ops/compensation/campaigns`
- `POST /v2/live-ops/compensation/campaigns/{campaignId}/grants/plan`
- `POST /v2/live-ops/compensation/campaigns/{campaignId}/grants/apply`

The service validates campaign uniqueness, bug and outage reason coverage,
affected-player evidence, approval records, currency grants, item grants,
idempotent grant keys, and per-account grant application before issuing
compensation.

Verification:

```sh
pnpm --filter @v2/player-compensation-service test
pnpm --filter @v2/player-compensation-service typecheck
pnpm --filter @v2/player-compensation-service lint
pnpm --filter @v2/player-compensation-service build
python3 V2/ue/Tools/check-v2-player-compensation.py
```