feat(useQuery): add meta field

[zaguiini]

Closes #2772.

Usage example (parts of the code omitted for brevity):

persistQueryClient({
  queryClient,
  persistor: localStoragePersistor,
  dehydrateOptions: {
    shouldDehydrateQuery: (query: Query) => {
      const shouldPersist = query.meta.persist ?? true;

      return shouldPersist;
    },
  },
});

const FetchData = () => {
  const queryKey = ["repoData", 123];

  useQuery(queryKey, {
    meta: {
      persist: false,
    },
  });

  return null;
};

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/tanstack/react-query/6DGpHYWBTprMYnqWwdxRd7dg7UEY
✅ Preview: https://react-query-git-fork-zaguiini-feature-meta-fiel-ff32b5-tanstack.vercel.app

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

[TkDodo]

• please also add some tests that use meta
• we've also discussed that the meta should be part of the queryFnContext,e.g.:
  https://github.com/tannerlinsley/react-query/blob/e6da990703482cff8ea99f5a254975cb57463ed5/src/core/query.ts#L387-L391

so that you can access it from within the queryFn, and generally everywhere where the context is available. This should also be documented then please

[zaguiini]

Thanks for the feedback, @TkDodo! Please take a second look.

[TkDodo]

looking good, please have a look at one more finding

[zaguiini]

Thanks for the thorough review, @TkDodo. On to the next -- and hopefully, last -- round of feedback!

[TkDodo]

looks awesome 🚀

[tannerlinsley]

🎉 This PR is included in version 3.29.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀