feat: mutate filter

[huozhi]

Closes #1946.

Description

The global mutate API (imported directly from SWR or returned by useSWRConfig) can now accept a filter function, to match multiple keys for mutating:

await mutate(
  key => typeof key === 'string' && key.startsWith('/api/'),
  undefined, // newData | (data => newData)
  false,     // shouldRevalidate = true
)

Breaking Changes

• This deprecates the use case of accepting a function that returns a key.
• The Cache interface now requires a keys() method that returns all keys in the cache object, similar to the JavaScript Map instances.

Usage

(See #1946)

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit dcda636:

Sandbox	Source
SWR-Basic	Configuration
SWR-States	Configuration
SWR-Infinite	Configuration
SWR-SSR	Configuration

[huozhi]

Thank you shu for helping fixing the issues and those changes look good

[shuding]

(I think there’s still one last blocker which is to make useSWRInfinite work properly)

[shuding]

OK this is more like a general problem today, need to think deeper about it. Meanwhile this PR can be shipped!