v10: per-request wifiOnly and key-scoped pause

[dmurphy5]

Summary

Two small additions that Diana needs, found by reading how Diana uses uploads today.

1. Wi-Fi only, per request

Diana has a "Wi-Fi only" setting. It applies to capture uploads (large video files). It does not apply to small requests like a comment or a field note edit; those go out on any connection.

Before this PR, the setting was one switch for the whole queue. With it on, a comment would wait for Wi-Fi. With it off, a capture would use cellular data.

Now a request can say wifiOnly: true or wifiOnly: false for itself. A request that says nothing follows the queue switch. Diana's captures say nothing, so the user's setting still controls them. Every other request says false.

2. Pause by kind

Diana's "pause uploads" setting pauses captures only. Comments and edits keep flowing.

Before this PR, pause() stopped the whole queue. Now pause({ keys: [...] }) pauses only the named kinds of request, and resume({ keys: [...] }) lets them go again. pause() with no keys still pauses everything.

How the library decides whether a request may run

flowchart TD
    A[Request is due] --> B{Whole queue paused?}
    B -- yes --> P[Wait]
    B -- no --> C{Its kind paused?}
    C -- yes --> P
    C -- no --> D{Wi-Fi only?<br/>request's own setting,<br/>else the queue setting}
    D -- yes, and no Wi-Fi --> P
    D -- no, or Wi-Fi present --> R[Send]

Loading

Both settings are stored on the device, so they survive a restart. Pausing never loses a request; it only waits.

What to look at

1. README, pause() and wifiOnly: are the two rules easy to follow?
2. The tests named scope in the JS, Android, and iOS suites.

Test Plan

yarn typecheck && yarn test && yarn lint:ci   # 189 tests
cd ios && swift test                          # 201 tests
cd example/RNBGUExample/android && ./gradlew :react-native-background-upload:testDebugUnitTest   # 307 tests

Both example apps build.

Compatibility

OS	Implemented
iOS	✅
Android	✅

Checklist

• I have tested this on a device and a simulator
• I added the documentation in README.md
• I updated the typed files (TS)
• I've added Detox End-to-End Test(s)
• I've created a snack to demonstrate the changes

🤖 Generated with Claude Code

[elliottkember]

Ah. Yes good calls.

Did we ship WiFi-only background upload for regular network requests already? We might want to ship this change fairly soon, I wouldn't want field note creations and such waiting for WiFi connections.

[dmurphy5]

Ah. Yes good calls.

Did we ship WiFi-only background upload for regular network requests already? We might want to ship this change fairly soon, I wouldn't want field note creations and such waiting for WiFi connections.

No, this is that annoying Claude behavior where it references a decision + revision it made some time earlier in the session despite never being committed.