fix(content-uploader): localize upload error messages in modernized panel

[dealwith]

The modernized uploads panel surfaced the raw API error message, which is returned in the request locale rather than the user's Box language. Error codes now resolve against the message catalog first, falling back to the API message and then a generic failure.

Extracts the error-code-to-message mapping out of progressCellRenderer into a shared util so the legacy and modernized paths stay in sync, and adds a ModernizedUploadsManager wrapper that can read intl from context (ContentUploader renders above IntlProvider).

Summary by CodeRabbit

• New Features

  • Added a modernized uploads manager for displaying and managing uploads.
  • Added localized upload error messages with API and generic fallbacks, including upgrade guidance.
  • Improved support for folder uploads, cancellation, retries, sharing, and opening items.

• Bug Fixes

  • Improved handling of Safari ZIP errors and unknown or missing error codes.
  • Preserved API error messages when localized messaging is unavailable.

• Tests

  • Expanded coverage for upload management, folder handling, localization, retries, and fallback behavior.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

Walkthrough

The uploader now renders a typed ModernizedUploadsManager adapter. The adapter maps raw upload items with internationalization support. Shared utilities provide localized upload-error messages for mapped items and progress cells.

Changes

Uploader modernization

Layer / File(s)	Summary
Modernized manager integration src/elements/content-uploader/ContentUploader.tsx, src/elements/content-uploader/ModernizedUploadsManager.tsx, src/elements/content-uploader/__tests__/*	ContentUploader passes raw items to ModernizedUploadsManager. The adapter maps items and preserves manager callbacks, state, folder handling, retries, cancellation, and sharing behavior.
Localized upload-error handling src/elements/content-uploader/utils/getUploadErrorMessage.ts, src/elements/content-uploader/utils/mapToModernizedUploadItem.ts, src/elements/content-uploader/progressCellRenderer.tsx, src/elements/content-uploader/utils/__tests__/*, src/elements/content-uploader/__tests__/ModernizedUploadsManager.test.tsx	Shared utilities resolve known error codes, Safari ZIP digest errors, localized descriptors, item names, upgrade messages, and fallback API messages. Tests cover mapping, rendering, and fallback behavior.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant ContentUploader
  participant ModernizedUploadsManager
  participant mapToModernizedUploadItems
  participant UploadsManagerBP
  ContentUploader->>ModernizedUploadsManager: pass raw upload items and manager props
  ModernizedUploadsManager->>mapToModernizedUploadItems: map items with rootFolderId, ETA, and intl
  ModernizedUploadsManager->>UploadsManagerBP: render mapped items and remaining props

Loading

Possibly related PRs

• box/box-ui-elements#4571: Both changes integrate the modernized uploads manager into ContentUploader.
• box/box-ui-elements#4716: Both changes update upload-item mapping and manager support.
• box/box-ui-elements#4720: Both changes update ContentUploader, item mapping, and modernized manager handling.

Suggested reviewers: jpan-box, olehrybak

Poem

A rabbit checks each upload line,
Localized errors now align.
Raw items hop through the manager bright,
Retries and callbacks stay in sight.
The queue completes with messages right.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the primary change: localizing upload error messages in the modernized content uploader.
Description check	✅ Passed	The description explains the problem, fallback behavior, shared utility, and ModernizedUploadsManager changes.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch localize-modernized-upload-errors

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-08-05 12:47 UTC · Rule: Automatic strict merge · triggered by rule Automatic merge queue
• ✅ Checks passed · in-place
• ✅ Merged — 2026-08-05 12:59 UTC · at 0ccdd837141d8e9c5c01282f3de24168cbb346a2 · squash

This pull request spent 12 minutes 16 seconds in the queue, including 11 minutes 58 seconds running CI.

Required conditions to merge

• github-review-approved [🛡 GitHub branch protection]
  • fix(content-uploader): localize upload error messages in modernized panel #4739
• any of [🛡 GitHub branch protection]:
  • check-success = Summary
  • check-neutral = Summary
  • check-skipped = Summary
• any of [🛡 GitHub branch protection]:
  • check-success = lint_test_build
  • check-neutral = lint_test_build
  • check-skipped = lint_test_build
• any of [🛡 GitHub branch protection]:
  • check-success = license/cla
  • check-neutral = license/cla
  • check-skipped = license/cla
• any of [🛡 GitHub branch protection]:
  • check-success = lint_pull_request
  • check-neutral = lint_pull_request
  • check-skipped = lint_pull_request