kobotoolbox / kpi / 28447174544 / 2

81%

master: 76%

push

github

feat(bulkProcessing): limit reached alert DEV-1417 (#7188)

### 📣 Summary

Bulk transcription and translation modals now show an error alert when
users have reached their quota limit (0 minutes/characters remaining).

### 💭 Notes

Changes here:

- **alertEvaluators.ts**: Implemented the `evaluateReachedLimit()`
function
- Checks `serviceUsageData.balances.asr_seconds.exceeded` for
transcription
- Checks `serviceUsageData.balances.mt_characters.exceeded` for
translation
- Returns error-type alert that blocks submission when quota is
exhausted
  - Gracefully handles missing serviceUsageData (returns inactive alert)

- **alertEvaluators.tests.ts**: Added 6 test cases for the new evaluator
  - Tests both transcription and translation quota scenarios
  - Tests some edge cases
  - Uses new serviceUsage.factory for clean, readable test data

- **serviceUsage.factory.ts**: New factory for creating mock service
usage data
  - Follows the pattern from `organizationServiceUsage.factory.ts`
- Helper function `createServiceUsage()` calculates balance values from
percentages
- Preset functions: `asrExceeded()`, `mtExceeded()`, `withinLimits()`,
`asrNearLimit()`, `mtNearLimit()`
- Returns complete `ServiceUsageResponse` objects with all required
fields
- Makes tests cleaner by replacing verbose inline mock data with simple
function calls

### 👀 Preview steps

Transcription minutes exceeded:
1. ℹ️ Have an account with 0 transcription minutes remaining
2. Go to Project → Data → Table for a project with audio submissions
3. Select one or more submissions with audio attachments
4. Open audio question column header menu → "Transcribe selected…"
5. 🟢 Notice the error alert appears
6. 🟢 Notice the "Create transcripts" button is disabled

Translation characters exceeded:
1. ℹ️ Have a project with transcript and an account with 0 translation
characters remaining
2. Go to Project → Data → Table
3. Select one submission with transcript
4. Open transcript column header menu → "... (continued)

5072 of 12460 branches covered (40.71%)

19605 of 37010 relevant lines covered (52.97%)

0.53 hits per line