:arrow_up: Update dependency @reduxjs/toolkit to v2

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
@reduxjs/toolkit (source)	`^1.9.7` -> `^2.4.0`

Release Notes

reduxjs/redux-toolkit (@reduxjs/toolkit)

### [`v2.4.0`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.4.0) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.3.0...v2.4.0) This **feature release** includes multiple tweaks and fixes to RTK Query functionality, additional exported TS types, and drops support for TS versions earlier than 5.0. #### Changelog ##### RTK Query Improvements Lazy query hooks can now be reset. `retry.fail` now accepts `meta` as a second argument. Tag invalidation arrays now ignore nullish values. We did some small internal refactoring around Maps and default values that shrank bundle size slightly. ##### RTK Query Bugfixes Passing `skipToken` to a query hook now bails out before running any other logic, which fixes cases where `serializeQueryArgs` previously threw an error because there were no args to process. The `autoBatchEnhancer` now reads `window.requestAnimationFrame` later, which it to work properly with Jest fake timers. We fixed cases where the hook result `isSuccess` flag would briefly flicker to `false` when switched to a different cache entry that was uninitialized, and would briefly flicker to `true` when refetching a query that previously errored. ##### Additional TS Types We now export `Typed[Query|Mutation]OnQueryStarted` helpers to let you define `onQueryStarted` callbacks outside of `createApi` if desired. We also now export a `CreateAsyncThunkFunction` type that can be used to type userland wrappers around `createAsyncThunk`. ##### TS Support Matrix Updates We've historically tried to maintain TS backwards compatibility as long as possible, and made occasional updates to our TS support matrix in minor versions over time. As of RTK 2.3.0, we officially supported back through TS 4.7. As of this release, we're tweaking that support policy to match [the policy used by DefinitelyTyped](https://redirect.github.com/DefinitelyTyped/DefinitelyTyped?tab=readme-ov-file#support-window): > Definitely Typed only tests packages on versions of TypeScript that are less than 2 years old > ![image](https://redirect.github.com/user-attachments/assets/30c8c1e6-db37-4ef1-a323-1c935fe4a12d) Given that, **we've dropped official support for TS versions earlier than 5.0**. (RTK *may* work with those versions, but we no longer test against them and won't try to fix issues with those versions.) We'll continue to update our TS support matrix over time based on that 2-year rolling window. #### What's Changed - add example to reproduce defect of serializeQueryArgs with skipToken by [@Themezv](https://redirect.github.com/Themezv) in [https://github.com/reduxjs/redux-toolkit/pull/4708](https://redirect.github.com/reduxjs/redux-toolkit/pull/4708) - Read `window.rAF` later to allow fake timers to work correctly by [@ensconced](https://redirect.github.com/ensconced) in [https://github.com/reduxjs/redux-toolkit/pull/4701](https://redirect.github.com/reduxjs/redux-toolkit/pull/4701) - Add type helpers for `OnQueryStarted` callbacks by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4713](https://redirect.github.com/reduxjs/redux-toolkit/pull/4713) - Add a type for `createAsyncThunk` without the `withTypes` method by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4667](https://redirect.github.com/reduxjs/redux-toolkit/pull/4667) - Add ability to reset lazy query hooks by [@alexmotoc](https://redirect.github.com/alexmotoc) in [https://github.com/reduxjs/redux-toolkit/pull/4689](https://redirect.github.com/reduxjs/redux-toolkit/pull/4689) - Ignore nullish values in tag invalidations by [@pierroberto](https://redirect.github.com/pierroberto) in [https://github.com/reduxjs/redux-toolkit/pull/4671](https://redirect.github.com/reduxjs/redux-toolkit/pull/4671) - Allow passing meta to retry.fail, and passing baseQuery to ensure types match by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4723](https://redirect.github.com/reduxjs/redux-toolkit/pull/4723) - Keep `isSuccess: true` when switching to an uninitialized cache entry by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4731](https://redirect.github.com/reduxjs/redux-toolkit/pull/4731) - Keep `isSuccess` consistent when refetching after an error by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4732](https://redirect.github.com/reduxjs/redux-toolkit/pull/4732) - Update to new version of upsert proposal, and fix listener equality checks by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4735](https://redirect.github.com/reduxjs/redux-toolkit/pull/4735) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.3.0...v2.4.0 ### [`v2.3.0`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.3.0) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.8...v2.3.0) This **feature release** adds a new RTK Query `upsertQueryEntries` util to batch-upsert cache entries more efficiently, passes through additional values for use in `prepareHeaders`, and exports additional TS types around query options and selectors. #### Changelog ##### `upsertQueryEntries` RTK Query already had an `upsertQueryData` thunk that would upsert a single cache entry. However, some users wanted to upsert *many* cache entries (potentially hundreds or thousands), and found that `upsertQueryData` had poor performance in those cases. This is because `upsertQueryData` runs the full async request handling sequence, including dispatching both `pending` and `fulfilled` actions, each of which run the main reducer and update store subscribers. That means there's `2N` store / UI updates per item, so upserting hundreds of items becomes extremely perf-intensive. RTK Query now includes an `api.util.upsertQueryEntries` action that is meant to handle the batched upsert use case more efficiently. It's a single synchronous action that accepts an array of many `{endpointName, arg, value}` entries to upsert. This results in a single store update, making this vastly better for performance vs many individual `upsertQueryData` calls. We see this as having two main use cases. The first is prefilling the cache with data retrieved from storage on app startup (and it's worth noting that `upsertQueryEntries` can accept entries for many different endpoints as part of the same array). The second is to act as a "pseudo-normalization" tool. [RTK Query is *not* a "normalized" cache](https://redux-toolkit.js.org/rtk-query/usage/cache-behavior#no-normalized-or-de-duplicated-cache). However, there are times when you may want to prefill other cache entries with the contents of another endpoint, such as taking the results of a `getPosts` list endpoint response and prefilling the individual `getPost(id)` endpoint cache entries, so that components that reference an individual item endpoint already have that data available. Currently, you can implement the "pseudo-normalization" approach by dispatching `upsertQueryEntries` in an endpoint lifecycle, like this: ```ts const api = createApi({ endpoints: (build) => ({ getPosts: build.query({ query: () => '/posts', async onQueryStarted(_, { dispatch, queryFulfilled }) { const res = await queryFulfilled const posts = res.data // Pre-fill the individual post entries with the results // from the list endpoint query dispatch( api.util.upsertQueryEntries( posts.map((post) => ({ endpointName: 'getPost', arg: { id: post.id }, value: post, })), ), ) }, }), getPost: build.query>({ query: (post) => `post/${post.id}`, }), }), }) ``` Down the road we may add a new option to query endpoints that would let you provide the mapping function and have it automatically update the corresponding entries. For additional comparisons between `upsertQueryData` and `upsertQueryEntries`, see [the `upsertQueryEntries` API reference](https://redux-toolkit.js.org/rtk-query/api/created-api/api-slice-utils#upsertqueryentries). ##### `prepareHeaders` Options The [`prepareHeaders` callback for `fetchBaseQuery`](https://redux-toolkit.js.org/rtk-query/api/fetchBaseQuery#prepareheaders) now receives two additional values in the `api` argument: - `arg`: the URL string or `FetchArgs` object that was passed in to `fetchBaseQuery` for this endpoint - `extraOptions`: any extra options that were provided to the base query ##### Additional TS Types We've added a `TypedQueryStateSelector` type that can be used to pre-type selectors for use with `selectFromResult`: ```ts const typedSelectFromResult: TypedQueryStateSelector< PostsApiResponse, QueryArgument, BaseQueryFunction, SelectedResult > = (state) => ({ posts: state.data?.posts ?? EMPTY_ARRAY }) function PostsList() { const { posts } = useGetPostsQuery(undefined, { selectFromResult: typedSelectFromResult, }) } ``` We've also exported several additional TS types around base queries and tag definitions. #### What's Changed - Fix serializeQueryArgs type by [@Reedgern](https://redirect.github.com/Reedgern) in [https://github.com/reduxjs/redux-toolkit/pull/4658](https://redirect.github.com/reduxjs/redux-toolkit/pull/4658) - Add the `TypedQueryStateSelector` helper type by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4656](https://redirect.github.com/reduxjs/redux-toolkit/pull/4656) - Pass query args to prepareHeaders function by [@kyletsang](https://redirect.github.com/kyletsang) in [https://github.com/reduxjs/redux-toolkit/pull/4638](https://redirect.github.com/reduxjs/redux-toolkit/pull/4638) - Implement a util function to batch-upsert cache entries by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4561](https://redirect.github.com/reduxjs/redux-toolkit/pull/4561) - fetchBaseQuery: expose extraOptions to prepareHeaders by [@phryneas](https://redirect.github.com/phryneas) in [https://github.com/reduxjs/redux-toolkit/pull/4291](https://redirect.github.com/reduxjs/redux-toolkit/pull/4291) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.8...v2.3.0 ### [`v2.2.8`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.8) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.7...v2.2.8) This **bugfix** release fixes a long-standing issue with RTK Query lazy query triggers returning stale data in some cases, fixes an error handling issue in RTK Query, and exports additional TS types. #### Changelog ##### Lazy Query Trigger Handling We'd had a couple long-standing issues reporting that `const result = await someLazyQueryTrigger()` sometimes returned stale data, especially if a mutation had just invalidated that query's tag. We finally got a good repro of this issue and identified it as a mis-written call inside of the middleware that skipped past the necessary handling to activate the correct query status tracking in that scenario. This should now be fixed. ##### Other Changes Timeout handling in RTKQ endpoints should now correctly throw a timeout-related error instead of an `AbortError`. Base queries now have access to the current `queryCacheKey` value so it can be used in deciding query logic. We've exported several more TS types related to query options, as some users have been depending on those even though they previously weren't part of the public API. #### What's Changed - Export `QueryExtraOptions` and `MutationExtraOptions` by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4556](https://redirect.github.com/reduxjs/redux-toolkit/pull/4556) - Fix `mangleErrors` not preserving different error types by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4586](https://redirect.github.com/reduxjs/redux-toolkit/pull/4586) - Add the `TypedUseQueryStateOptions` helper type by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4604](https://redirect.github.com/reduxjs/redux-toolkit/pull/4604) - feat(baseQuery): expose queryCacheKey in baseQuery by [@HaakonSvane](https://redirect.github.com/HaakonSvane) in [https://github.com/reduxjs/redux-toolkit/pull/4636](https://redirect.github.com/reduxjs/redux-toolkit/pull/4636) - Fix `AbortError` being triggered incorrectly on `createApi` endpoint timeout by [@andrejpavlovic](https://redirect.github.com/andrejpavlovic) in [https://github.com/reduxjs/redux-toolkit/pull/4628](https://redirect.github.com/reduxjs/redux-toolkit/pull/4628) - type: export QueryReturnValue by [@hornta](https://redirect.github.com/hornta) in [https://github.com/reduxjs/redux-toolkit/pull/4640](https://redirect.github.com/reduxjs/redux-toolkit/pull/4640) - call `initiate` to refetch queries from middleware by [@phryneas](https://redirect.github.com/phryneas) in [https://github.com/reduxjs/redux-toolkit/pull/4651](https://redirect.github.com/reduxjs/redux-toolkit/pull/4651) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.7...v2.2.8 ### [`v2.2.7`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.7) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.6...v2.2.7) This **bugfix release** fixes issues with "TS type portability" errors, improves build artifact tree shaking behavior, and exports some additional TS types. #### Changelog ##### TS Type Portability We've had a slew of issues reported around "TS type portability" errors, such as: - [#1806](https://redirect.github.com/reduxjs/redux-toolkit/issues/1806) - [#3962](https://redirect.github.com/reduxjs/redux-toolkit/issues/3962) - [#3983](https://redirect.github.com/reduxjs/redux-toolkit/issues/3983) The error messages are typically along the lines of: > Type error: The inferred type of `'configureStore'` cannot be named without a reference to `'@reduxjs/toolkit/node_modules/redux'`. This is likely not portable. A type annotation is necessary. [@aryaemami59](https://redirect.github.com/aryaemami59) did some deep investigation and concluded these were due to a mixture of using `interface` instead of `type` in most places, not pre-bundling our TS typedefs, and not exporting some of the unique symbols we use internally. Arya put together a highly detailed writeup and set of fixes in [ #4467: Fix: TypeScript Type Portability Issues](#4467), and that appears to resolve all of those issues we've seen. Thank you! ##### Other Changes Arya also did significant work to improve RTK's treeshaking, tweaking internal definitions to let bundlers better separate out unused code. We've exported additional types like `UpdateDefinitions` and `RetryOptions`, per request. `listenerMiddleware.withTypes()` methods now allow passing in an `ExtraArgument` generic. #### What's Changed - Fix: TypeScript Type Portability Issues by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4467](https://redirect.github.com/reduxjs/redux-toolkit/pull/4467) - Export UpdateDefinitions from toolkit/query by [@joekrill](https://redirect.github.com/joekrill) in [https://github.com/reduxjs/redux-toolkit/pull/4519](https://redirect.github.com/reduxjs/redux-toolkit/pull/4519) - feat: Adds ExtraArgument to withTypes for listenerMiddleware. by [@antondalgren](https://redirect.github.com/antondalgren) in [https://github.com/reduxjs/redux-toolkit/pull/4517](https://redirect.github.com/reduxjs/redux-toolkit/pull/4517) - Improve treeshakeability of build artifacts by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4435](https://redirect.github.com/reduxjs/redux-toolkit/pull/4435) - Export RetryOptions by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4529](https://redirect.github.com/reduxjs/redux-toolkit/pull/4529) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.6...v2.2.7 ### [`v2.2.6`](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.5...a9362fbcec6cb66bdb3e6dc52bbf3d69ea6f2b22) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.5...v2.2.6) ### [`v2.2.5`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.5) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.4...v2.2.5) This **bugfix release** fixes an issue in the recent `createEntityAdapter` sorting perf improvements that could (in specific cases) cause Immer to throw an error when trying to read a plain JS value instead of a proxy-wrapped value. #### What's Changed - Fix missed spot where use of `current` may fail if the value is not a draft by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4412](https://redirect.github.com/reduxjs/redux-toolkit/pull/4412) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.4...v2.2.5 ### [`v2.2.4`](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.3...72b3ac65a2adc510280f19ec6689aebbf2bf1df4) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.3...v2.2.4) ### [`v2.2.3`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.3) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.2...v2.2.3) This minor release fixes the types for functions that accept a React Context instance to match the [changes in React Redux v9](https://redux-toolkit.js.org/usage/migrating-rtk-2#custom-context-typing). #### What's Changed - Update React Redux dependency to v9, and update docs to use `.withTypes` by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4308](https://redirect.github.com/reduxjs/redux-toolkit/pull/4308) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.2...v2.2.3 ### [`v2.2.2`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.2) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.1...v2.2.2) This patch release fixes an incorrect build setting for the `legacy-esm` artifacts, and fixes an issue with RTKQ query hooks didn't always remove the cache entries if arguments were changed rapidly. #### Changes ##### `legacy-esm` Artifact Transpilation The `legacy-esm` build artifacts are intended for use by Webpack 4. Those were *supposed* to be transpiled to target `"es2017"`, but were in fact still set to target `"esnext"` - an oversight during the 2.0 development cycle. This release fixes that setting, so those artifacts are now correctly transpiled. ##### Other Fixes RTKQ query hooks now handle additional actions around argument changes that should result in cache entries being removed. Additionally, 2.2.1 contained a fix to an incorrectly named type: `TypedUseMutationTrigger` is now `TypedMutationTrigger`. #### What's Changed - rename TypedUseMutationTrigger to TypedMutationTrigger, and add deprecated alias by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4204](https://redirect.github.com/reduxjs/redux-toolkit/pull/4204) - Fixed memory leak in rapid hook arg changing by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4268](https://redirect.github.com/reduxjs/redux-toolkit/pull/4268) - Fix incorrect legacy-esm target by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/4284](https://redirect.github.com/reduxjs/redux-toolkit/pull/4284) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.2.0...v2.2.2 ### [`v2.2.1`](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.0...v2.2.1) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.2.0...v2.2.1) ### [`v2.2.0`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.2.0) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.1.0...v2.2.0) This *minor release*: - Adds a second parameter to `entityAdapter.getInitialState(additionalProps, entities)` to allow prefilling state - Equivalent to `entityAdapter.setAll(entityAdapter.getInitialState(additionalProps), entities)` - First parameter can be `undefined` if no additional properties are desired - Allows initialising `combineSlices` with no static reducers - Previously `const combinedReducer = combineSlices().withLazyLoadedSlices()` would have thrown an error - Now returns a "no-op" reducer that just returns an empty object until first reducer injected - Allows a new `'throw'` value for `overrideExisting` in `injectEndpoints`, which throws an error if a definition is injected with a name which is already used - Exports more type helpers for RTKQ hook and trigger types - Exports types related to overriding result types in `enhanceEndpoints` - Fixes state inference for injected slices when undeclared (i.e. not in `LazyLoadedSlices`) - Adds a `action.meta.arg.isPrefetch` value to query thunk actions when prefetched #### What's Changed - Revamp type tests setup by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4095](https://redirect.github.com/reduxjs/redux-toolkit/pull/4095) - Bump Prettier and Prettier related packages by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4126](https://redirect.github.com/reduxjs/redux-toolkit/pull/4126) - Fix codemods to work with TypeScript 4.7+ by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4081](https://redirect.github.com/reduxjs/redux-toolkit/pull/4081) - Export types related to overriding the result types by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4134](https://redirect.github.com/reduxjs/redux-toolkit/pull/4134) - Migrate type tests to Vitest by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4127](https://redirect.github.com/reduxjs/redux-toolkit/pull/4127) - Fix RetryOptions type test by flipping order by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4136](https://redirect.github.com/reduxjs/redux-toolkit/pull/4136) - Format all files by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4135](https://redirect.github.com/reduxjs/redux-toolkit/pull/4135) - \[Docs/Website] skipPollingIfUnfocused added to polling overview and query options by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4131](https://redirect.github.com/reduxjs/redux-toolkit/pull/4131) - \[Docs] Changed create.asyncThunk setup admonition to caution by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4150](https://redirect.github.com/reduxjs/redux-toolkit/pull/4150) - Temporarily revert node-fetch bump until ESM issues are sorted by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4151](https://redirect.github.com/reduxjs/redux-toolkit/pull/4151) - Contributing Markdown Refresh by [@itz-Me-Pj](https://redirect.github.com/itz-Me-Pj) in [https://github.com/reduxjs/redux-toolkit/pull/4139](https://redirect.github.com/reduxjs/redux-toolkit/pull/4139) - investigate re-adding size limit action by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4083](https://redirect.github.com/reduxjs/redux-toolkit/pull/4083) - Add size limit imports for more commonly used RTK exports by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4155](https://redirect.github.com/reduxjs/redux-toolkit/pull/4155) - pure some things by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4157](https://redirect.github.com/reduxjs/redux-toolkit/pull/4157) - cut back on suffixes tested for size by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4160](https://redirect.github.com/reduxjs/redux-toolkit/pull/4160) - Incorrect builder method referenced by [@kantbtrue](https://redirect.github.com/kantbtrue) in [https://github.com/reduxjs/redux-toolkit/pull/4161](https://redirect.github.com/reduxjs/redux-toolkit/pull/4161) - Rename `cli.js` to `cli.mjs` by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4169](https://redirect.github.com/reduxjs/redux-toolkit/pull/4169) - Migrate Codegen OpenAPI's unit tests to Vitest by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4137](https://redirect.github.com/reduxjs/redux-toolkit/pull/4137) - Fix wrong state for injected slices when not declared via `withLazyLoadedSlices` by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4172](https://redirect.github.com/reduxjs/redux-toolkit/pull/4172) - \[Docs, createEntityAdapter API]: add missing setOne and setMany signature by [@kyselberg](https://redirect.github.com/kyselberg) in [https://github.com/reduxjs/redux-toolkit/pull/4173](https://redirect.github.com/reduxjs/redux-toolkit/pull/4173) - Corrected the "Observing cache behaviour" example point no.4 by [@721-atikshaikh](https://redirect.github.com/721-atikshaikh) in [https://github.com/reduxjs/redux-toolkit/pull/4174](https://redirect.github.com/reduxjs/redux-toolkit/pull/4174) - feat: add isPrefetch property in query action by [@juliengbt](https://redirect.github.com/juliengbt) in [https://github.com/reduxjs/redux-toolkit/pull/4177](https://redirect.github.com/reduxjs/redux-toolkit/pull/4177) - allow initialising combined slice reducer with no static slices by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4184](https://redirect.github.com/reduxjs/redux-toolkit/pull/4184) - Create more Typed wrappers for RTKQ hook types by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4147](https://redirect.github.com/reduxjs/redux-toolkit/pull/4147) - proposal fix for axios base query types by [@smff](https://redirect.github.com/smff) in [https://github.com/reduxjs/redux-toolkit/pull/4186](https://redirect.github.com/reduxjs/redux-toolkit/pull/4186) - Provide 'throw' option for `overrideExisting` by [@ffluk3](https://redirect.github.com/ffluk3) in [https://github.com/reduxjs/redux-toolkit/pull/4189](https://redirect.github.com/reduxjs/redux-toolkit/pull/4189) - Use vite-tsconfig-paths to make path aliasing easier by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4175](https://redirect.github.com/reduxjs/redux-toolkit/pull/4175) - Remove trailing commas in `tsconfig.json` files of all CodesandBox examples by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4190](https://redirect.github.com/reduxjs/redux-toolkit/pull/4190) - \[Docs] Added withTypes documentation in createDraftSafeSelector by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4143](https://redirect.github.com/reduxjs/redux-toolkit/pull/4143) - Add second parameter to getInitialState to prefill entities by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4183](https://redirect.github.com/reduxjs/redux-toolkit/pull/4183) #### New Contributors - [@itz-Me-Pj](https://redirect.github.com/itz-Me-Pj) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4139](https://redirect.github.com/reduxjs/redux-toolkit/pull/4139) - [@kantbtrue](https://redirect.github.com/kantbtrue) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4161](https://redirect.github.com/reduxjs/redux-toolkit/pull/4161) - [@kyselberg](https://redirect.github.com/kyselberg) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4173](https://redirect.github.com/reduxjs/redux-toolkit/pull/4173) - [@721-atikshaikh](https://redirect.github.com/721-atikshaikh) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4174](https://redirect.github.com/reduxjs/redux-toolkit/pull/4174) - [@smff](https://redirect.github.com/smff) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4186](https://redirect.github.com/reduxjs/redux-toolkit/pull/4186) - [@ffluk3](https://redirect.github.com/ffluk3) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4189](https://redirect.github.com/reduxjs/redux-toolkit/pull/4189) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.1.0...v2.2.0 ### [`v2.1.0`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.1.0) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.0.1...v2.1.0) This *minor release*: - adds withTypes methods to `listenerMiddleware` and `createDraftSafeSelector` - adds a `skipPollingIfUnfocused` option to RTK Query - adds the ability to customise the `createSelector` instance used by RTK Query - reworks slice selector logic to avoid depending on `this` value - fixes the order and inference of `create.asyncThunk` type parameters - fixes requirements for meta fields returned from `queryFn`s - marks promises that will never reject as safe, in preparation for [https://github.com/typescript-eslint/typescript-eslint/issues/7008](https://redirect.github.com/typescript-eslint/typescript-eslint/issues/7008) #### What's Changed - Update docs to avoid circular type by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/3948](https://redirect.github.com/reduxjs/redux-toolkit/pull/3948) - Copy "Migrating to Modern Redux" and "RTK is Redux" docs from core site by [@markerikson](https://redirect.github.com/markerikson) in [https://github.com/reduxjs/redux-toolkit/pull/3956](https://redirect.github.com/reduxjs/redux-toolkit/pull/3956) - Fix store path rtk-query pokemon api tutorial by [@suspiciousRaccoon](https://redirect.github.com/suspiciousRaccoon) in [https://github.com/reduxjs/redux-toolkit/pull/3611](https://redirect.github.com/reduxjs/redux-toolkit/pull/3611) - tweak RTKQ without hooks section, and add note regarding memoization by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/3963](https://redirect.github.com/reduxjs/redux-toolkit/pull/3963) - Add section regarding overriding deps by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/3968](https://redirect.github.com/reduxjs/redux-toolkit/pull/3968) - Add section re: RR custom context typing change by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/3995](https://redirect.github.com/reduxjs/redux-toolkit/pull/3995) - Add Expo demo app to CI workflow by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/3985](https://redirect.github.com/reduxjs/redux-toolkit/pull/3985) - docs: fix a typo in queries markdown file by [@fatihgnc](https://redirect.github.com/fatihgnc) in [https://github.com/reduxjs/redux-toolkit/pull/4013](https://redirect.github.com/reduxjs/redux-toolkit/pull/4013) - Preserve nullable store state type by avoiding intersection with {} by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4011](https://redirect.github.com/reduxjs/redux-toolkit/pull/4011) - Upgrade version of "graphql-request" by [@phryneas](https://redirect.github.com/phryneas) in [https://github.com/reduxjs/redux-toolkit/pull/4026](https://redirect.github.com/reduxjs/redux-toolkit/pull/4026) - \[graphql-request-base-query] update RTK peerDependency by [@phryneas](https://redirect.github.com/phryneas) in [https://github.com/reduxjs/redux-toolkit/pull/4027](https://redirect.github.com/reduxjs/redux-toolkit/pull/4027) - fix: improve selectFromResult memoization by [@thisjeremiah](https://redirect.github.com/thisjeremiah) in [https://github.com/reduxjs/redux-toolkit/pull/4029](https://redirect.github.com/reduxjs/redux-toolkit/pull/4029) - Rename "createSliceWithThunks" and "createThunkSlice" to "createAppSlice" by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4035](https://redirect.github.com/reduxjs/redux-toolkit/pull/4035) - Bump Vitest to latest version by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4047](https://redirect.github.com/reduxjs/redux-toolkit/pull/4047) - fix inference and order of async thunk generics by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4061](https://redirect.github.com/reduxjs/redux-toolkit/pull/4061) - Fix markdown links on Next.js page by [@DmitryScaletta](https://redirect.github.com/DmitryScaletta) in [https://github.com/reduxjs/redux-toolkit/pull/4069](https://redirect.github.com/reduxjs/redux-toolkit/pull/4069) - Introduce pre-typed listener middleware via `listenerMiddleware.withTypes()` method by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4049](https://redirect.github.com/reduxjs/redux-toolkit/pull/4049) - Add `.withTypes` to `createDraftSafeSelector` by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4080](https://redirect.github.com/reduxjs/redux-toolkit/pull/4080) - Task/remove all settled by [@bever1337](https://redirect.github.com/bever1337) in [https://github.com/reduxjs/redux-toolkit/pull/3917](https://redirect.github.com/reduxjs/redux-toolkit/pull/3917) - Allow customising createSelector instance used by RTKQ by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4048](https://redirect.github.com/reduxjs/redux-toolkit/pull/4048) - cacheLifecycle fix for fixedCacheKey in mutationThunk by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4082](https://redirect.github.com/reduxjs/redux-toolkit/pull/4082) - avoid relying on `this` in createSlice by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4071](https://redirect.github.com/reduxjs/redux-toolkit/pull/4071) - documentation: fix grammar in redux and redux toolkit comparison by [@untilhamza](https://redirect.github.com/untilhamza) in [https://github.com/reduxjs/redux-toolkit/pull/4086](https://redirect.github.com/reduxjs/redux-toolkit/pull/4086) - Update `tsconfig.typetests.json` to include all TS files by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4091](https://redirect.github.com/reduxjs/redux-toolkit/pull/4091) - Remove abort event listner for AbortController by [@Fonger](https://redirect.github.com/Fonger) in [https://github.com/reduxjs/redux-toolkit/pull/3951](https://redirect.github.com/reduxjs/redux-toolkit/pull/3951) - Docs: unused value 'isRejected' in code snippet by [@alphonsotran](https://redirect.github.com/alphonsotran) in [https://github.com/reduxjs/redux-toolkit/pull/3301](https://redirect.github.com/reduxjs/redux-toolkit/pull/3301) - fix/kitchen-sink-isAuthenticated: fixed isAuthenticated state change on login fullfilled by [@shrijan00003](https://redirect.github.com/shrijan00003) in [https://github.com/reduxjs/redux-toolkit/pull/3588](https://redirect.github.com/reduxjs/redux-toolkit/pull/3588) - Fix `composeWithDevTools` spy by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4093](https://redirect.github.com/reduxjs/redux-toolkit/pull/4093) - require queryFn meta to match base query by [@EskiMojo14](https://redirect.github.com/EskiMojo14) in [https://github.com/reduxjs/redux-toolkit/pull/4098](https://redirect.github.com/reduxjs/redux-toolkit/pull/4098) - Added 'SafePromise' branded Promises for createAsyncThunk by [@JoshuaKGoldberg](https://redirect.github.com/JoshuaKGoldberg) in [https://github.com/reduxjs/redux-toolkit/pull/4102](https://redirect.github.com/reduxjs/redux-toolkit/pull/4102) - Add React Native demo app to CI workflow by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/3984](https://redirect.github.com/reduxjs/redux-toolkit/pull/3984) - Modernize unit test setup by [@aryaemami59](https://redirect.github.com/aryaemami59) in [https://github.com/reduxjs/redux-toolkit/pull/4114](https://redirect.github.com/reduxjs/redux-toolkit/pull/4114) - Add missing reducer field to ConfigureStoreOptions docs by [@nickgirardo](https://redirect.github.com/nickgirardo) in [https://github.com/reduxjs/redux-toolkit/pull/4116](https://redirect.github.com/reduxjs/redux-toolkit/pull/4116) - Option for queries to pause polling when unfocused by [@riqts](https://redirect.github.com/riqts) in [https://github.com/reduxjs/redux-toolkit/pull/4055](https://redirect.github.com/reduxjs/redux-toolkit/pull/4055) #### New Contributors - [@suspiciousRaccoon](https://redirect.github.com/suspiciousRaccoon) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/3611](https://redirect.github.com/reduxjs/redux-toolkit/pull/3611) - [@fatihgnc](https://redirect.github.com/fatihgnc) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4013](https://redirect.github.com/reduxjs/redux-toolkit/pull/4013) - [@thisjeremiah](https://redirect.github.com/thisjeremiah) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4029](https://redirect.github.com/reduxjs/redux-toolkit/pull/4029) - [@riqts](https://redirect.github.com/riqts) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4082](https://redirect.github.com/reduxjs/redux-toolkit/pull/4082) - [@untilhamza](https://redirect.github.com/untilhamza) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4086](https://redirect.github.com/reduxjs/redux-toolkit/pull/4086) - [@Fonger](https://redirect.github.com/Fonger) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/3951](https://redirect.github.com/reduxjs/redux-toolkit/pull/3951) - [@alphonsotran](https://redirect.github.com/alphonsotran) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/3301](https://redirect.github.com/reduxjs/redux-toolkit/pull/3301) - [@shrijan00003](https://redirect.github.com/shrijan00003) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/3588](https://redirect.github.com/reduxjs/redux-toolkit/pull/3588) - [@JoshuaKGoldberg](https://redirect.github.com/JoshuaKGoldberg) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4102](https://redirect.github.com/reduxjs/redux-toolkit/pull/4102) - [@nickgirardo](https://redirect.github.com/nickgirardo) made their first contribution in [https://github.com/reduxjs/redux-toolkit/pull/4116](https://redirect.github.com/reduxjs/redux-toolkit/pull/4116) **Full Changelog**: https://github.com/reduxjs/redux-toolkit/compare/v2.0.1...v2.1.0 ### [`v2.0.1`](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.0.0...v2.0.1) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v2.0.0...v2.0.1) ### [`v2.0.0`](https://redirect.github.com/reduxjs/redux-toolkit/releases/tag/v2.0.0) [Compare Source](https://redirect.github.com/reduxjs/redux-toolkit/compare/v1.9.7...v2.0.0) This **major release** : - Removes the deprecated object syntax from `createSlice` and `createReducer` - Removes other deprecated options - Updates the `middleware` and `enhancers` options of `configureStore` to require callbacks - Updates the packaging for better ESM/CJS compatibility and modernizes the build output - Includes all changes to [Redux core 5.0](https://redirect.github.com/reduxjs/redux/releases/tag/v5.0.0), [Reselect 5.0](https://redirect.github.com/reduxjs/reselect/releases/tag/v5.0.0), and [Redux Thunk 3.0](https://redirect.github.com/reduxjs/redux-thunk/releases/tag/v3.0.0) - Updates RTKQ default subscription behavior - Adds a new `combineSlices` method with support for lazy-loading slice reducers - Adds a new "dynamic middleware" middleware with support for adding middleware at runtime - Adds a new callback syntax to `createSlice.reducers`, with optional support for defining thunks inside of `createSlice` - Adds the `autoBatchEnhancer` to `configureStore` by default - Has many additional TS tweaks and improvements This release has **breaking changes**. (Note: v2.0.1 was released with a couple hotfixes for Reselect and Redux Thunk right as this was being finalized.) This release is part of a wave of major versions of all the Redux packages: **Redux Toolkit 2.0, Redux core 5.0, React-Redux 9.0, Reselect 5.0, and Redux Thunk 3.0**. For full details on all of the breaking changes and other significant changes to all of those packages, see the **["Migrating to RTK 2.0 and Redux 5.0" migration guide](https://redux.js.org/usage/migrations/migrating-rtk-2)** in the Redux docs. > \[!NOTE] > The Redux core, Reselect, and Redux Thunk packages are included as part of Redux Toolkit, and RTK users do not need to manually upgrade them - you'll get them as part of the upgrade to RTK 2.0. (If you're not using Redux Toolkit yet, [**please start migrating your existing legacy Redux code to use Redux Toolkit today!**](https://redux.js.org/usage/migrating-to-modern-redux)) ```bash ##### RTK npm install @reduxjs/toolkit yarn add @reduxjs/toolkit ``` ##### Changelog ##### Object syntax for `createSlice.extraReducers` and `createReducer` removed RTK's `createReducer` API was originally designed to accept a lookup table of action type strings to case reducers, like `{ "ADD_TODO": (state, action) => {} }`. We later added the "builder callback" form to allow more flexibility in adding "matchers" and a default handler, and did the same for `createSlice.extraReducers`. We have removed the "object" form for both `createReducer` and `createSlice.extraReducers` in RTK 2.0, as the builder callback form is effectively the same number of lines of code, and works much better with TypeScript. As an example, this: ```ts const todoAdded = createAction('todos/todoAdded') createReducer(initialState, { [todoAdded]: (state, action) => {}, }) createSlice({ name, initialState, reducers: { /* case reducers here */ }, extraReducers: { [todoAdded]: (state, action) => {}, }, }) ``` should be migrated to: ```ts createReducer(initialState, (builder) => { builder.addCase(todoAdded, (state, action) => {}) }) createSlice({ name, initialState, reducers: { /* case reducers here */ }, extraReducers: (builder) => { builder.addCase(todoAdded, (state, action) => {}) }, }) ``` ##### Codemods To simplify upgrading codebases, we've published a set of codemods that will automatically transform the deprecated "object" syntax into the equivalent "builder" syntax. The codemods package is available on NPM as [`@reduxjs/rtk-codemods`](https://www.npmjs.com/package/@reduxjs/rtk-codemods). More details are available [here](../api/codemods). To run the codemods against your codebase, run `npx @reduxjs/rtk-codemods path/of/files/ or/some**/*glob.js.` Examples: ```sh npx @reduxjs/rtk-codemods createReducerBuilder ./src npx @reduxjs/rtk-codemods createSliceBuilder ./packages/my-app/**/*.ts ``` We also recommend re-running Prettier on the codebase before committing the changes. These codemods should work, but we would greatly appreciate feedback from more real-world codebases! ##### `configureStore` Options Changes ##### `configureStore.middleware` must be a callback Since the beginning, `configureStore` has accepted a direct array value as the `middleware` option. However, providing an array directly prevents `configureStore` from calling `getDefaultMiddleware()`. So, `middleware: [myMiddleware]` means there is no thunk middleware added (or any of the dev-mode checks). This is a footgun, and we've had numerous users accidentally do this and cause their apps to fail because the default middleware never got configured. As a result, we've now made the `middleware` only accept the callback form. *If* for some reason you still want to replace *all* of the built-in middleware, do so by returning an array from the callback: ```ts const store = configureStore({ reducer, middleware: (getDefaultMiddleware) => { // WARNING: this means that _none_ of the default middleware are added! return [myMiddleware] // or for TS users, use: // return new Tuple(myMiddleware) }, }) ``` But note that **we consistently recommend not replacing the default middleware entirely**, and that you should use `return getDefaultMiddleware().concat(myMiddleware)`. ##### `configureStore.enhancers` must be a callback Similarly to `configureStore.middleware`, the `enhancers` field must also be a callback, for the same reasons. The callback will receive a `getDefaultEnhancers` function that can be used to customise the batching enhancer [that's now included by default](#configurestore-adds-autobatchenhancer-by-default). For example: ```ts const store = configureStore({ reducer, enhancers: (getDefaultEnhancers) => { return getDefaultEnhancers({ autoBatch: { type: 'tick' }, }).concat(myEnhancer) }, }) ``` It's important to note that the result of `getDefaultEnhancers` will **also** contain the middleware enhancer created with any configured/default middleware. To help prevent mistakes, `configureStore` will log an error to console if middleware was provided and the middleware enhancer wasn't included in the callback result. ```ts const store = configureStore({ reducer, enhancers: (getDefaultEnhancers) => { return [myEnhancer] // we've lost the middleware here // instead: return getDefaultEnhancers().concat(myEnhancer) }, }) ``` Also, note that **if you supply the `enhancers` field, it *must* come *after* the `middleware` field in order for TS inference to work properly**. ##### Standalone `getDefaultMiddleware` and `getType` removed The standalone version of `getDefaultMiddleware` has been deprecated since v1.6.1, and has now been removed. Use the function passed to the `middleware` callback instead, which has the correct types. We have also removed the `getType` export, which was used to extract a type string from action creators made with `createAction`. Instead, use the static property `actionCreator.type`. ##### RTK Query behaviour changes We've had a number of reports where RTK Query had issues around usage of `dispatch(endpoint.initiate(arg, {subscription: false}))`. There were also reports that multiple triggered lazy queries were resolving the promises at the wrong time. Both of these had the same underlying issue, which was that RTKQ wasn't tracking cache entries in these cases (intentionally). We've reworked the logic to always track cache entries (and remove them as needed), which should resolve those behavior issues. We also have had issues raised about trying to run multiple mutations in a row and how tag invalidation behaves. RTKQ now has internal logic to delay tag invalidation briefly, to allow multiple invalidations to get handled together. This is controlled by a new `invalidationBehavior: 'immediate' | 'delayed'` flag on `createApi`. The new default behavior is `'delayed'`. Set it to `'immediate'` to revert to the behavior in RTK 1.9. In RTK 1.9, we reworked RTK Query's internals to keep most of the subscription status inside the RTKQ middleware. The values are still synced to the Redux store state, but this is primarily for display by the Redux DevTools "RTK Query" panel. Related to the cache entry changes above, we've optimized how often those values get synced to the Redux state for perf. ##### ESM/CJS Package Compatibility The biggest theme of the Redux v5 and RTK 2.0 releases is trying to get "true" ESM package publishing compatibility in place, while still supporting CJS in the published package. **The primary build artifact is now an ESM file, `dist/redux-toolkit.modern.mjs`**. Most build tools should pick this up. There's also a CJS artifact, and a second copy of the ESM file named `redux-toolkit.legacy-esm.js` to support Webpack 4 (which does not recognize the `exports` field in `package.json`). Additionally, all of the build artifacts now live under `./dist/` in the published package. ##### Modernized Build Output We now publish modern JS syntax targeting ES2020, including optional chaining, object spread, and other modern syntax. If you need to ##### Build Tooling We're now building the package using https://github.com/egoist/tsup. We also now include sourcemaps for the ESM and CJS artifacts. ##### Dropping UMD Builds Redux has always shipped with UMD build artifacts. These are primarily meant for direct import as script tags, such as in a CodePen or a no-bundler build environment. We've dropped those build artifacts from the published package, on the grounds that the use cases seem pretty rare today. There's now a `redux-toolkit.browser.mjs` file in the package that can be loaded from a CDN like Unpkg. If you have strong use cases for us continuing to include UMD build artifacts, please let us know! ##### Dependency Updates ##### Redux Libraries RTK now depends on **[Redux core 5.0](https://redirect.github.com/reduxjs/redux/releases/tag/v5.0.0), [Reselect 5.0](https://redirect.github.com/reduxjs/reselect/releases/tag/v5.0.0), and [Redux Thunk 3.0](https://redirect.github.com/reduxjs/redux-thunk/releases/tag/v3.0.0)**. See the linked release notes for those libraries, as **each of them has additional breaking changes**. The ["Migrating to RTK 2.0 and Redux 5.0" docs page](https://redux.js.org/usage/migrations/migrating-rtk-2) also covers the combined changes in one page ##### Immer 10 RTK now also depends on [Immer 10.0](https://redirect.github.com/immerjs/immer/releases/tag/v10.0.0), which has several major improvements and updates: - Much faster update perf - Much smaller bundle size - Better ESM/CJS package formatting - No default export - No ES5 fallback We've also removed the prior call to automatically enable the Immer ES5 fallback mode any time RTK was loaded. ##### Other Changes ##### Bundle Size Optimizations Redux 4.1.0 optimized its bundle size by [extracting error message strings out of production builds](https://redirect.github.com/reduxjs/redux/releases/tag/v4.1.0), based on React's approach. We've applied the same technique to RTK. This saves about 1000 bytes from prod bundles (actual benefits will depend on which imports are being used). We also noted that [ESBuild does not deduplicate imports when it bundles source files](https://redirect.github.com/evanw/esbuild/issues/475), and this was causing RTK Query's bundle to contain a dozen references to `import { } from "@reduxjs/toolkit"`, including some of the same methods. Manually deduplicating those saves about 600 bytes off the production RTKQ artifact. ##### `reactHooksModule` custom hook configuration Previously, custom versions of React Redux's hooks (`useSelector`, `useDispatch`, and `useStore`) could be passed separately to `reactHooksModule`, usually to enable using a different context to the default `ReactReduxContext`. In practicality, the react hooks module needs all three of these hooks to be provided, and it became an easy mistake to only pass `useSelector` and `useDispatch`, without `useStore`. The module has now moved all three of these under the same configuration key, and will check that all three are provided if the key is present. ```ts // previously const customCreateApi = buildCreateApi( coreModule(), reactHooksModule({ useDispatch: createDispatchHook(MyContext), useSelector: createSelectorHook(MyContext), useStore: createStoreHook(MyContext), }) ) // now const customCreateApi = buildCreateApi( coreModule(), reactHooksModule({ hooks: { useDispatch: createDispatchHook(MyContext), useSelector: createSelectorHook(MyContext), useStore: createStoreHook(MyContext), }, }) ) ``` ##### Deprecated Options Removed Several other options were previously marked as deprecated, and have been removed. We've also removed polyfills like the `AbortController` polyfill. ##### TypeScript Changes ##### `configureStore` field order for `middleware` matters If you are passing *both* the `middleware` and `enhancers` fields to `configureStore`, the `middleware` field *must* come first in order for internal TS inference to work properly. ##### Non-default middleware/enhancers must use `Tuple` We've seen many cases where users passing the `middleware` parameter to configureStore have tried spreading the array returned by `getDefaultMiddleware()`, or passed an alternate plain array. This unfortunately loses the exact TS types from the individual middleware, and often causes TS problems down the road (such as `dispatch` being typed as `Dispatch` and not knowing about thunks). `getDefaultMiddleware()` already used an internal `MiddlewareArray` class, an `Array` subclass that had strongly typed `.concat/prepend()` methods to correctly capture and retain the middleware types. We've renamed that type to `Tuple`, and `configureStore`'s TS types now require that you *must* use `Tuple` if you want to pass your own array of middleware: ```ts import { configureStore, Tuple } from '@reduxjs/toolkit' configureStore({ reducer: rootReducer, middleware: (getDefaultMiddleware) => new Tuple(additionalMiddleware, logger), }) ``` (Note that this has no effect if you're using RTK with plain JS, and you could still pass a plain array here.) This same restriction applies to the `enhancers` field. ##### Entity adapter type updates `createEntityAdapter` now has an `Id` generic argument, which will be used to strongly type the item IDs anywhere those are exposed. Previously, the ID field type was always `string | number`. TS will now try to infer the exact type from either the `.id` field of your entity type, or the `selectId` return type. You could also fall back to passing that generic type directly. **If you use the `EntityState` type directly, you *must* supply both generic arguments!** The `.entities` lookup table is now defined to use a standard TS `Record`, which assumes that each item lookup exists by default. Previously, it used a `Dictionary` type, which assumed the result was `MyEntityType | undefined`. The `Dictionary` type has been removed. If you prefer to assume that the lookups *might* be undefined, use TypeScript's `noUncheckedIndexedAccess` configuration option to control that. ##### New Features These features are new in Redux Toolkit 2.0, and help cover additional use cases that we've seen users ask for in the ecosystem. ##### `combineSlices` API with slice reducer injection for code-splitting The Redux core has always included `combineReducers`, which takes an object full of "slice reducer" functions and generates a reducer that calls those slice reducers. RTK's `createSlice` generates slice reducers + associated action creators, and we've taught the pattern of exporting individual action creators as named exports and the slice reducer as a default export. Meanwhile, we've never had official support for lazy-loading reducers, a

Configuration

📅 Schedule: Branch creation - "before 4am on Monday" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

[ ] If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

Name	Link
Latest commit	914162b4b6531354a06c806e69c9e5aab232c8b0
Latest deploy log	https://app.netlify.com/sites/nonebot-bison/deploys/6748e551d3d6750008f4f3cc
Deploy Preview	https://deploy-preview-592--nonebot-bison.netlify.app
Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

MountainDash / nonebot-bison