Roadmap v2

[stijnvanhulle]

Note

PR: #549
Installation: https://beta.kubb.dev//installation
Docs: https://beta.kubb.dev/

Why

Summary

Discord

Hi all, I created a roadmap on Github for v2: #556.
Why?

I have been working on some changes related to the architecture of Kubb which will make it faster and easier but it's taking more time to get it ready. So v2 will not be a breaking change but with the changes that will be added it can cause weird behaviours(don't want to do this with a major bump).

v2 will also include a rewrite of how react-query is getting generated so that all issues related to using useQuery and useMutation will be resolved(v4 and v5).

All of this will be added to the alpha tag on NPM and with the playground you can also select the alpha build: https://www.kubb.dev/playground.

Features/fixes

• Deprecate skipBy and replace with include and exclude  #542
• Deprecate client and replace by clientImportPath #621
• Use of PluginKey instead of the plugin.name

type PluginKey = [pluginName: string, identifier: number]

• 📔 Multiple(array of) KubbConfig when calling defineConfig
• sort imports/exports based on type => import type will be last
• PluginManager.write without the queue
• 📔 Better support for namespace Kubb in TypeScript(with help of declare const)
• Fast build times with a change in the printer in @kubb/parser
• 📔 Name for logging
• Use of logger instead of throwing Errors(PluginError, ...)
• 📔 Support for mswjs/msw v2 #527
• Use of --moduleResolution bundler #528
• Fix/tanstack query v5 #550
• Tanstack-query v5: TS error on return queryOptions() #530
• Tanstack-query v5: TS error on return queryOptions() #530 (comment)
• improve query keys in tanstack query plugin #513
• More strict type for swagger-client, swagger-swr #582
• Better resolveName and resolvePath system
• Test cases for all PlugingManagers hooks
• Templates #648
• Better support for OpenAPI v3.1
• Add useSuspenseQuery for @tanstack/query
• Templates for schema creations
• Use of queryOptions for @tanstack/query v5
• Refactor of FunctionParams
• Disable barrel files @kubb/swagger-ts: grouping by tag can result in ambiguous import paths in barrel files #552
• tsconfigPaths esbuild plugin instead of alias for vitest
• tsup update
• disable barrel exports
• Mutate(tanstack and SWR) with props/params for the URL

Explore

• RTK Query https://redux-toolkit.js.org/rtk-query/overview Cancelled see https://redux-toolkit.js.org/rtk-query/usage/code-generation
• Http-wizard https://github.com/flodlc/http-wizard
• Better changelog generation with
• https://github.com/intuit/auto
• https://github.com/mikepenz/release-changelog-builder-action
• [Question] support for monorepos? mikepenz/release-changelog-builder-action#986
• https://github.com/colinhacks/zod/blob/master/.github/workflows/release.yml
• https://github.com/TanStack/table/blob/main/scripts/publish.ts
• https://github.com/orhun/git-cliff
• https://github.com/tinylibs/tinypool

• 📔 = docs added

[stijnvanhulle]

@la55u I added your issue for the mutation to the list(#530 (comment)). I will have a look later this week to fix it :)

[b6pzeusbc54tvhw5jgpyw8pwz2x6gs]

How about if deleting the deprecated client option is also added in v2?

[la55u]

React-query is further complicating things.. In v5 there is a separate hook now for queries if you want to make use of Suspense: useSuspenseQuery. AFAIK useQuery and useSuspenseQuery are for different use-cases: you have to use the first one if you explicitly don't want to use Suspense and the second one if you do, there is no option anymore to disable it on a per-query basis. Since most IRL projects will have edge cases where it's desired to be able to disable suspense behavior I suppose both useQuery and useSuspenseQuery custom hooks should be generated with kubb? Please someone correct me if I'm wrong I'm just getting started with react-query v5.

[kalagin]

Is RTK Query implementation planned?

[b6pzeusbc54tvhw5jgpyw8pwz2x6gs]

When do you expect the v2 release?

[stijnvanhulle]

@b6pzeusbc54tvhw5jgpyw8pwz2x6gs Probably in a couple of weeks, it will depend on how much time I will have in the coming weeks :)

[stijnvanhulle]

@kalagin I would suggest using https://redux-toolkit.js.org/rtk-query/usage/code-generation with that it's maintained by the creators of Redux.