feat: TanStack Query React integration

[sanny-io]

This uses type inference rather than code generation. Final implementation will look something like this:

import { useHooks } from '@zenstackhq/tanstack-query';
import { schema } from '@/zenstack/schema';

// in component
...
const { user: userQuery } = useHooks(schema);
// signature of `useFindMany` is inferred from schema
const { data: users } = userQuery.useFindMany();

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[genu]

Do we need to distinguish between the flavor of hooks to use here? (React, vs vue, etc)

This may not necessarily work outside of a react context.

[sanny-io]

@genu this PR is focusing on React, but because it is the first target being developed for v3, there is going to be some groundwork laid for the others.

I think the common parts of the integration are going to be very similar to how it was in v2.

[ymc9]

Hey @sanny-io , I didn't know it was you on discord 🤣 . Thanks for the effort and can't wait to try it out!

[ymc9]

Just a heads up, I'm renaming "@zenstackhq/runtime" package to "@zenstackhq/orm".

[sanny-io]

Quick update regarding this PR: good progress has been made on the type inference for mutations and queries, but I've been dealing with the intellisense becoming unacceptably slow because the compiler is struggling with the types. The unfortunate thing is that a lot of the types in this PR build on top of one another, so fixing the bottleneck is proving to be quite difficult.

I'm closing this for now, but I'll keep experimenting to see if I can get it right. I know this is a much anticipated feature, so if anyone else wants to take a shot at it, I don't wanna be the holdup. My branch won't be deleted, and if anyone has any questions, I'm here to answer.

[ymc9]

Quick update regarding this PR: good progress has been made on the type inference for mutations and queries, but I've been dealing with the intellisense becoming unacceptably slow because the compiler is struggling with the types. The unfortunate thing is that a lot of the types in this PR build on top of one another, so fixing the bottleneck is proving to be quite difficult.

I'm closing this for now, but I'll keep experimenting to see if I can get it right. I know this is a much anticipated feature, so if anyone else wants to take a shot at it, I don't wanna be the holdup. My branch won't be deleted, and if anyone has any questions, I'm here to answer.

Thanks for the update @sanny-io . No worries, and I appreciate your effort put into this. I'm about to finish migrating server adapters to v3 and then will probably look into tanstack query code.