Feature: lazy load reload

[santipalenque]

https://app.clickup.com/t/9014802374/86bb1gp6z

Summary by CodeRabbit

• New Features

  • Added automatic recovery for stale or unavailable application chunks by reloading the page.
  • Added safeguards to prevent repeated reload loops and improved reporting when recovery fails.
  • Added support for handling chunk-loading errors across lazy-loaded features and global application errors.

• Tests

  • Added comprehensive coverage for chunk detection, reload behavior, error handling, and recovery scenarios.

• Chores

  • Updated the package to version 5.0.45-beta.0.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ad6715e9-710b-4686-a0cc-487e879ccb96

📝 Walkthrough

Walkthrough

Adds a React/webpack chunk-load recovery utility with per-build reload protection, global error handling, Sentry filtering, Jest coverage, a Webpack entry, and a package version update.

Changes

Chunk Error Recovery

Layer / File(s)	Summary
Chunk error classification src/utils/lazy-with-reload.js, src/utils/__tests__/lazy-with-reload.test.js	Detects webpack chunk errors and HTML fallback SyntaxError values, including custom filename patterns, with matching tests.
Per-build reload state src/utils/lazy-with-reload.js, src/utils/__tests__/lazy-with-reload.test.js	Tracks build fingerprints in sessionStorage, reloads once per build, confirms recovery, and reports repeated failures through Sentry or the console.
Runtime recovery integration src/utils/lazy-with-reload.js, src/utils/__tests__/lazy-with-reload.test.js	Adds the React.lazy wrapper, global error listeners with cleanup, pending-reload confirmation, and Sentry event filtering.
Bundle and release wiring webpack.common.js, package.json	Adds the utility as a Webpack entry and updates the package version to 5.0.45-beta.0.

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

Sequence Diagram(s)

sequenceDiagram
  participant ReactLazy
  participant lazyWithReload
  participant sessionStorage
  participant Window
  participant Sentry
  ReactLazy->>lazyWithReload: import module
  lazyWithReload->>sessionStorage: check build reload state
  lazyWithReload->>Window: reload on matching chunk error
  Window->>lazyWithReload: repeated failure after reload
  lazyWithReload->>Sentry: report recovery failure

Loading

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title is concise and refers to the main change: adding lazy-load reload behavior.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/lazy-load-reload

---

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.}

[coderabbitai]

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/utils/lazy-with-reload.js`:
- Around line 40-55: Update isHtmlParsedAsScriptError to recognize Firefox’s
SyntaxError wording, “expected expression, got '<',” in addition to the existing
“Unexpected token '<'” check. Preserve the existing SyntaxError detection and
filename pattern guard, while allowing either characteristic message to trigger
the stale-chunk fallback.
- Around line 124-143: Update reloadOnChunkError to track, in memory, whether a
reload has already been triggered during the current page lifecycle or tick
before consulting persisted reload state. Have subsequent concurrent chunk
failures return without calling reportRecoveryFailed, while preserving the
existing persisted-state check for failures occurring after navigation and the
current write/sessionStorage/reload flow for the first failure.
- Around line 210-224: Update chunkErrorSentryBeforeSend to extract the relevant
filename from each Sentry exception’s stack frames and pass it with the
exception type and value to isChunkLoadError. Preserve the existing filtering
behavior for genuine chunk-load errors while ensuring the HTML-as-script
SyntaxError path requires a filename matching chunkFilenamePattern.
- Around line 61-82: Compute and cache the build fingerprint eagerly during
module evaluation, before any lazy chunks can load, instead of initializing
cachedBuildFingerprint inside getBuildFingerprint. Keep getBuildFingerprint as a
read-only accessor and preserve the existing document-scripts fingerprinting and
non-browser fallback behavior.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a5f6667e-34d6-40cb-a728-10d5b64ff9b6

📥 Commits

Reviewing files that changed from the base of the PR and between 24b90d8 and 400adfb.

📒 Files selected for processing (4)

• package.json
• src/utils/__tests__/lazy-with-reload.test.js
• src/utils/lazy-with-reload.js
• webpack.common.js

[Copilot]

Pull request overview

Adds a reusable chunk-load recovery utility to the UI core library so applications can automatically recover from stale/unavailable lazy-loaded webpack chunks by triggering a guarded page reload, with reporting for non-recoverable cases.

Changes:

• Added lazyWithReload, initChunkErrorRecovery, and Sentry filtering helpers to detect webpack chunk-load failures and recover via a one-time-per-build reload.
• Added Jest coverage for detection, reload-guard behavior, global error/unhandledrejection handling, and Sentry filtering behavior.
• Exposed the new utility via the webpack build entrypoints and bumped the package version to a beta release.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
webpack.common.js	Exposes the new utils/lazy-with-reload entry so consumers can import it from the built package.
src/utils/lazy-with-reload.js	Implements chunk-load error detection, guarded reload recovery, and Sentry beforeSend filtering helper.
src/utils/tests/lazy-with-reload.test.js	Adds unit tests covering detection and recovery behavior.
package.json	Updates package version to 5.0.45-beta.0.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[smarcet]

@santipalenque please review

[smarcet]

@santipalenque please review