feat(toolkit-lib): network detector

[kaizencc]

this PR implements a connectivity detector that performs a HEAD request to the notices endpoint, with a timeout of 1 hour. before making any subsequent network calls, (including GET notices and PUT telemetry) we check to see if we have already determined the network to be disconnected. in those cases, we skip subsequent calls.

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[mrgrain]

Is throwing the right thing here? Is that error caught elsewhere? Asking because Notices should just silently fail. A comment might help.

[kaizencc]

this is the right thing to do here. we are throwing errors in web-data-source on failures and expecting to swallow them elsewhere (which we do)

[otaviomacedo]

[non-blocking] Since this pattern will be very common (get the result, check whether it's true and throw an error if not), we could also have a method that takes a callback and does this for you:

return NetworkDetector.ifConnected(async() => {...});

[kaizencc]

this is a good thought and i have considered this. im not entirely against it, but i feel like my more (naive) approach works more intuitively even if it reuses the same pattern. we can always refactor in the future if it turns out that ifConnected is a cleaner API

[kaizencc]

this is the true result: we do not ping the telemetry endpoint in environments without internet access

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.60%. Comparing base (8758f3c) to head (1dc3a75).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #926      +/-   ##
==========================================
- Coverage   84.17%   83.60%   -0.57%     
==========================================
  Files          71       71              
  Lines       10437    10445       +8     
  Branches     1334     1324      -10     
==========================================
- Hits         8785     8733      -52     
- Misses       1611     1673      +62     
+ Partials       41       39       -2     

Flag	Coverage Δ
suite.unit	83.60% <100.00%> (-0.57%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 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.