TanStack
diff --git a/‎.github/workflows/test-and-publish.yml‎
Lines changed: 2 additions & 1 deletion b/‎.github/workflows/test-and-publish.yml‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎createAsyncStoragePersister/package.json‎
Lines changed: 6 additions & 0 deletions b/‎createAsyncStoragePersister/package.json‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎createAsyncStoragePersistor-experimental/package.json‎
Lines changed: 0 additions & 6 deletions b/‎createAsyncStoragePersistor-experimental/package.json‎
Lines changed: 0 additions & 6 deletions
diff --git a/‎createWebStoragePersister/package.json‎
Lines changed: 6 additions & 0 deletions b/‎createWebStoragePersister/package.json‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎createWebStoragePersistor-experimental/package.json‎
Lines changed: 0 additions & 6 deletions b/‎createWebStoragePersistor-experimental/package.json‎
Lines changed: 0 additions & 6 deletions
diff --git a/‎docs/src/manifests/manifest.json‎
Lines changed: 18 additions & 8 deletions b/‎docs/src/manifests/manifest.json‎
Lines changed: 18 additions & 8 deletions
diff --git a/‎docs/src/pages/comparison.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/src/pages/comparison.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/src/pages/guides/caching.md‎
Lines changed: 7 additions & 7 deletions b/‎docs/src/pages/guides/caching.md‎
Lines changed: 7 additions & 7 deletions
diff --git a/‎docs/src/pages/guides/default-query-function.md‎
Lines changed: 2 additions & 3 deletions b/‎docs/src/pages/guides/default-query-function.md‎
Lines changed: 2 additions & 3 deletions
diff --git a/‎docs/src/pages/guides/disabling-queries.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/src/pages/guides/disabling-queries.md‎
Lines changed: 1 addition & 1 deletion
@@ -5,6 +5,7 @@ on:
     branches:
       - 'master'
       - 'next'
+      - 'alpha'
       - 'beta'
       - '1.x'
       - '2.x'
@@ -36,7 +37,7 @@ jobs:
     name: 'Publish Module to NPM'
     needs: test
     # publish only when merged in master on original repo, not on PR
-    if: github.repository == 'tannerlinsley/react-query' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/next' || github.ref == 'refs/heads/beta' || github.ref == 'refs/heads/1.x' || github.ref == 'refs/heads/2.x')
+    if: github.repository == 'tannerlinsley/react-query' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/next' || github.ref == 'refs/heads/alpha' || github.ref == 'refs/heads/beta' || github.ref == 'refs/heads/1.x' || github.ref == 'refs/heads/2.x')
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
 
@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../lib/createAsyncStoragePersister/index.js",
+  "module": "../es/createAsyncStoragePersister/index.js",
+  "types": "../types/createAsyncStoragePersister/index.d.ts"
+}
@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../lib/createWebStoragePersister/index.js",
+  "module": "../es/createWebStoragePersister/index.js",
+  "types": "../types/createWebStoragePersister/index.d.ts"
+}
@@ -75,6 +75,11 @@
           "path": "/guides/query-functions",
           "editUrl": "/guides/query-functions.md"
         },
+        {
+          "title": "Network Mode",
+          "path": "/guides/network-mode",
+          "editUrl": "/guides/network-mode.md"
+        },
         {
           "title": "Parallel Queries",
           "path": "/guides/parallel-queries",
@@ -204,6 +209,11 @@
           "title": "Migrating to React Query 3",
           "path": "/guides/migrating-to-react-query-3",
           "editUrl": "/guides/migrating-to-react-query-3.md"
+        },
+        {
+          "title": "Migrating to React Query 4",
+          "path": "/guides/migrating-to-react-query-4",
+          "editUrl": "/guides/migrating-to-react-query-4.md"
         }
       ]
     },
@@ -314,19 +324,19 @@
       "heading": true,
       "routes": [
         {
-          "title": "persistQueryClient (Experimental)",
+          "title": "persistQueryClient",
           "path": "/plugins/persistQueryClient",
           "editUrl": "/plugins/persistQueryClient.md"
         },
         {
-          "title": "createWebStoragePersistor (Experimental)",
-          "path": "/plugins/createWebStoragePersistor",
-          "editUrl": "/plugins/createWebStoragePersistor.md"
+          "title": "createWebStoragePersister",
+          "path": "/plugins/createWebStoragePersister",
+          "editUrl": "/plugins/createWebStoragePersister.md"
         },
         {
-          "title": "createAsyncStoragePersistor (Experimental)",
-          "path": "/plugins/createAsyncStoragePersistor",
-          "editUrl": "/plugins/createAsyncStoragePersistor.md"
+          "title": "createAsyncStoragePersister",
+          "path": "/plugins/createAsyncStoragePersister",
+          "editUrl": "/plugins/createAsyncStoragePersister.md"
         },
         {
           "title": "broadcastQueryClient (Experimental)",
@@ -442,4 +452,4 @@
       ]
     }
   ]
-}
+}
@@ -64,7 +64,7 @@ Feature/Capability Key:
 
 > **<sup>1</sup> Lagged Query Data** - React Query provides a way to continue to see an existing query's data while the next query loads (similar to the same UX that suspense will soon provide natively). This is extremely important when writing pagination UIs or infinite loading UIs where you do not want to show a hard loading state whenever a new query is requested. Other libraries do not have this capability and render a hard loading state for the new query (unless it has been prefetched), while the new query loads.
 
-> **<sup>2</sup> Render Optimization** - React Query has excellent rendering performance. It will only re-render your components when a query is updated. For example because it has new data, or to indicate it is fetching. React Query also batches updates together to make sure your application only re-renders once when multiple components are using the same query. If you are only interested in the `data` or `error` properties, you can reduce the number of renders even more by setting `notifyOnChangeProps` to `['data', 'error']`. Set `notifyOnChangeProps: 'tracked'` to automatically track which fields are accessed and only re-render if one of them changes.
+> **<sup>2</sup> Render Optimization** - React Query has excellent rendering performance. By default, it will automatically track which fields are accessed and only re-render if one of them changes. If you would like to opt-out of this optimization, setting `notifyOnChangeProps` to `'all'` will re-render your components whenever the query is updated. For example because it has new data, or to indicate it is fetching. React Query also batches updates together to make sure your application only re-renders once when multiple components are using the same query. If you are only interested in the `data` or `error` properties, you can reduce the number of renders even more by setting `notifyOnChangeProps` to `['data', 'error']`. 
 
 > **<sup>3</sup> Partial query matching** - Because React Query uses deterministic query key serialization, this allows you to manipulate variable groups of queries without having to know each individual query-key that you want to match, eg. you can refetch every query that starts with `todos` in its key, regardless of variables, or you can target specific queries with (or without) variables or nested properties, and even use a filter function to only match queries that pass your specific conditions.
 
 
@@ -16,17 +16,17 @@ This caching example illustrates the story and lifecycle of:
 
 Let's assume we are using the default `cacheTime` of **5 minutes** and the default `staleTime` of `0`.
 
-- A new instance of `useQuery('todos', fetchTodos)` mounts.
+- A new instance of `useQuery(['todos'], fetchTodos)` mounts.
   - Since no other queries have been made with this query + variable combination, this query will show a hard loading state and make a network request to fetch the data.
-  - It will then cache the data using `'todos'` and `fetchTodos` as the unique identifiers for that cache.
+  - It will then cache the data using `['todos']` as the unique identifiers for that cache.
   - The hook will mark itself as stale after the configured `staleTime` (defaults to `0`, or immediately).
-- A second instance of `useQuery('todos', fetchTodos)` mounts elsewhere.
+- A second instance of `useQuery(['todos'], fetchTodos)` mounts elsewhere.
   - Because this exact data exists in the cache from the first instance of this query, that data is immediately returned from the cache.
 - A background refetch is triggered for both queries (but only one request), since a new instance appeared on screen.
   - Both instances are updated with the new data if the fetch is successful
-- Both instances of the `useQuery('todos', fetchTodos)` query are unmounted and no longer in use.
+- Both instances of the `useQuery(['todos'], fetchTodos)` query are unmounted and no longer in use.
   - Since there are no more active instances of this query, a cache timeout is set using `cacheTime` to delete and garbage collect the query (defaults to **5 minutes**).
-- Before the cache timeout has completed another instance of `useQuery('todos', fetchTodos)` mounts. The query immediately returns the available cached value while the `fetchTodos` function is being run in the background to populate the query with a fresh value.
-- The final instance of `useQuery('todos', fetchTodos)` unmounts.
-- No more instances of `useQuery('todos', fetchTodos)` appear within **5 minutes**.
+- Before the cache timeout has completed another instance of `useQuery(['todos'], fetchTodos)` mounts. The query immediately returns the available cached value while the `fetchTodos` function is being run in the background to populate the query with a fresh value.
+- The final instance of `useQuery(['todos'], fetchTodos)` unmounts.
+- No more instances of `useQuery(['todos'], fetchTodos)` appear within **5 minutes**.
   - This query and its data are deleted and garbage collected.
@@ -7,7 +7,6 @@ If you find yourself wishing for whatever reason that you could just share the s
 
 ```js
 // Define a default query function that will receive the query key
-// the queryKey is guaranteed to be an Array here
 const defaultQueryFn = async ({ queryKey }) => {
   const { data } = await axios.get(`https://jsonplaceholder.typicode.com${queryKey[0]}`);
   return data;
@@ -32,14 +31,14 @@ function App() {
 
 // All you have to do now is pass a key!
 function Posts() {
-  const { status, data, error, isFetching } = useQuery('/posts')
+  const { status, data, error, isFetching } = useQuery(['/posts'])
 
   // ...
 }
 
 // You can even leave out the queryFn and just go straight into options
 function Post({ postId }) {
-  const { status, data, error, isFetching } = useQuery(`/posts/${postId}`, {
+  const { status, data, error, isFetching } = useQuery([`/posts/${postId}`], {
     enabled: !!postId,
   })
 
 
@@ -26,7 +26,7 @@ function Todos() {
     error,
     refetch,
     isFetching,
-  } = useQuery('todos', fetchTodoList, {
+  } = useQuery(['todos'], fetchTodoList, {
     enabled: false,
   })
Original file line number	Diff line number	Diff line change
`@@ -75,6 +75,11 @@`
`75`	`75`	`"path": "/guides/query-functions",`
`76`	`76`	`"editUrl": "/guides/query-functions.md"`
`77`	`77`	`},`
	`78`	`+ {`
	`79`	`+ "title": "Network Mode",`
	`80`	`+ "path": "/guides/network-mode",`
	`81`	`+ "editUrl": "/guides/network-mode.md"`
	`82`	`+ },`
`78`	`83`	`{`
`79`	`84`	`"title": "Parallel Queries",`
`80`	`85`	`"path": "/guides/parallel-queries",`
`@@ -204,6 +209,11 @@`
`204`	`209`	`"title": "Migrating to React Query 3",`
`205`	`210`	`"path": "/guides/migrating-to-react-query-3",`
`206`	`211`	`"editUrl": "/guides/migrating-to-react-query-3.md"`
	`212`	`+ },`
	`213`	`+ {`
	`214`	`+ "title": "Migrating to React Query 4",`
	`215`	`+ "path": "/guides/migrating-to-react-query-4",`
	`216`	`+ "editUrl": "/guides/migrating-to-react-query-4.md"`
`207`	`217`	`}`
`208`	`218`	`]`
`209`	`219`	`},`
`@@ -314,19 +324,19 @@`
`314`	`324`	`"heading": true,`
`315`	`325`	`"routes": [`
`316`	`326`	`{`
`317`		`- "title": "persistQueryClient (Experimental)",`
	`327`	`+ "title": "persistQueryClient",`
`318`	`328`	`"path": "/plugins/persistQueryClient",`
`319`	`329`	`"editUrl": "/plugins/persistQueryClient.md"`
`320`	`330`	`},`
`321`	`331`	`{`
`322`		`- "title": "createWebStoragePersistor (Experimental)",`
`323`		`- "path": "/plugins/createWebStoragePersistor",`
`324`		`- "editUrl": "/plugins/createWebStoragePersistor.md"`
	`332`	`+ "title": "createWebStoragePersister",`
	`333`	`+ "path": "/plugins/createWebStoragePersister",`
	`334`	`+ "editUrl": "/plugins/createWebStoragePersister.md"`
`325`	`335`	`},`
`326`	`336`	`{`
`327`		`- "title": "createAsyncStoragePersistor (Experimental)",`
`328`		`- "path": "/plugins/createAsyncStoragePersistor",`
`329`		`- "editUrl": "/plugins/createAsyncStoragePersistor.md"`
	`337`	`+ "title": "createAsyncStoragePersister",`
	`338`	`+ "path": "/plugins/createAsyncStoragePersister",`
	`339`	`+ "editUrl": "/plugins/createAsyncStoragePersister.md"`
`330`	`340`	`},`
`331`	`341`	`{`
`332`	`342`	`"title": "broadcastQueryClient (Experimental)",`
`@@ -442,4 +452,4 @@`
`442`	`452`	`]`
`443`	`453`	`}`
`444`	`454`	`]`
`445`		`-}`
	`455`	`+}`