[Bookings] Refactor caching strategy to handle stale data cleanup for all filters

[irfano]

Description

This PR addresses a data consistency issue where stale booking data could persist in the local cache when applying filters.

Previously, when fetching filtered bookings, we used a simple insertOrReplace strategy. This updated existing bookings but failed to remove bookings that were no longer present in the server response (e.g., deleted bookings or bookings that no longer matched the filter).

While we had previously addressed this issue specifically for Today and Upcoming tabs (#15022), this fix extends that same robust cleanup logic to all filter types. It uses a single optimized SQL query to:

1. Identify local bookings that match the current filter criteria.
2. Delete those that are missing from the fresh server response.
3. Insert/Update the new bookings.

Pagination & Data Sync Strategy
To ensure data integrity, we clear the entire cache for the active filter when refreshing the list (page 1).
Why clear pages 2, 3, etc.? Without backend support for deleted items, we can't reliably sync a shifting list client-side.

• The Risk: If a new booking is added, items shift from Page 1 to Page 2. If we only update Page 1, our logic would see the shifted item as "missing" from Page 1 and delete it, causing accidental data loss.
• The Solution: We prioritize data accuracy over retaining offline data for older pages.

Test Steps

1. Make sure you have some bookings in the Today and Upcoming tabs
2. Launch the app
3. Go to Today and load the bookings
4. Trash one of the booking from the Today tab via the web
5. Refresh the Today tab in the app
6. Verify the booking was removed
7. Repeat 3-6 for the All tab.

Images/gif

Before

before-bug.mov

After

after.mov

• I have considered if this change warrants release notes and have added them to RELEASE-NOTES.txt if necessary. Use the "[Internal]" label for non-user-facing changes.

[irfano]

This is the main change: cleanAndUpsertBookings() previously received only the date filters, but now it receives the entire filter object.

[wpmobilebot]

📲 You can test the changes from this Pull Request in WooCommerce-Wear Android by scanning the QR code below to install the corresponding build.

	App Name	WooCommerce-Wear Android
	Platform	⌚️ Wear OS
	Flavor	Jalapeno
	Build Type	Debug
	Commit	0acfc07
	Direct Download	woocommerce-wear-prototype-build-pr15061-0acfc07.apk

[wpmobilebot]

📲 You can test the changes from this Pull Request in WooCommerce Android by scanning the QR code below to install the corresponding build.

	App Name	WooCommerce Android
	Platform	📱 Mobile
	Flavor	Jalapeno
	Build Type	Debug
	Commit	0acfc07
	Direct Download	woocommerce-prototype-build-pr15061-0acfc07.apk

[codecov-commenter]

Codecov Report

❌ Patch coverage is 16.66667% with 25 lines in your changes missing coverage. Please review.
✅ Project coverage is 38.69%. Comparing base (8257c85) to head (0acfc07).

Files with missing lines	Patch %	Lines
...press/android/fluxc/persistence/dao/BookingsDao.kt	0.00%	21 Missing ⚠️
...xc/network/rest/wpcom/wc/bookings/BookingsStore.kt	55.55%	2 Missing and 2 partials ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##              trunk   #15061      +/-   ##
============================================
- Coverage     38.70%   38.69%   -0.02%     
+ Complexity    10326    10321       -5     
============================================
  Files          2162     2162              
  Lines        122532   122533       +1     
  Branches      16918    16917       -1     
============================================
- Hits          47424    47411      -13     
- Misses        70307    70319      +12     
- Partials       4801     4803       +2     

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