feat: add requestPeriodicUpdate method to SnapRegistryController

[Mrtenz]

Summary

Adds a periodicFetchThreshold option (default: 4 hours) and a public requestPeriodicUpdate method to SnapRegistryController.

The new method is similar to requestUpdate, but skips the update if the registry was fetched within the periodic threshold. This is useful for callers that want to keep the registry reasonably up to date on a longer interval (e.g., on wallet unlock) without triggering a fetch on every call.

---

Note

Low Risk
Additive API around existing fetch/update paths; default thresholds and requestUpdate behavior are unchanged for messenger callers.

Overview
Adds a periodicFetchThreshold constructor option (default 4 hours) and a public requestPeriodicUpdate() on SnapRegistryController for callers that want occasional registry refreshes (e.g. on wallet unlock) without hitting the network on every trigger.

requestPeriodicUpdate no-ops when lastUpdated is within the periodic window—publishing registryUpdated with false and skipping fetch—otherwise delegates to requestUpdate, which still uses the existing 5-minute recent-fetch guard inside #update. #wasRecentlyFetched now accepts an optional threshold so the periodic path can reuse the same logic.

Unit tests cover first fetch, skip within threshold, and refetch when stale. The method is not registered on the messenger (unlike requestUpdate); consumers call it on the controller instance directly.

^{Reviewed by Cursor Bugbot for commit 085669c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.58%. Comparing base (9467ef5) to head (085669c).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4043   +/-   ##
=======================================
  Coverage   98.58%   98.58%           
=======================================
  Files         425      425           
  Lines       12364    12371    +7     
  Branches     1948     1950    +2     
=======================================
+ Hits        12189    12196    +7     
  Misses        175      175           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6554437. Configure here.}