feat: add skipToken support for conditional query execution

[antomorel]

Summary

• Re-export skipToken from @tanstack/react-query for convenience
• All hooks (useEffectQuery, useInfiniteEffectQuery, useEffectQueries) now accept skipToken as queryFn
• toQueryOptions and effectQueryOptions support skipToken for use with useQuery directly
• When using skipToken, the runtime option is not required (typed as never)

This enables the idiomatic TanStack Query pattern for conditional queries:

const { data } = useEffectQuery({
  queryKey: ["user", userId],
  queryFn: userId ? () => Effect.succeed({ id: userId }) : skipToken,
});

Changes

• Updated type definitions to support discriminated unions for SkipToken vs Effect queryFn
• Added skipToken handling in all hook implementations
• Comprehensive test coverage for all skipToken scenarios

[Copilot]

Pull request overview

This PR adds first-class skipToken support to the Effect-based React Query hooks/utilities so callers can idiomatically skip conditional queries using TanStack Query’s skipToken, while also re-exporting skipToken from this package.

Changes:

• Re-export skipToken from @tanstack/react-query via the library entrypoint.
• Extend hook/option types and hook implementations to accept skipToken as a queryFn.
• Add tests covering skip/conditional-skip behavior and type-level constraints.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 13 comments.

Show a summary per file

File	Description
src/index.ts	Re-exports skipToken from TanStack Query.
src/types.ts	Updates public option/result types to allow skipToken as a queryFn.
src/useEffectQuery.ts	Adds runtime handling for skipToken when calling useQuery.
src/useInfiniteEffectQuery.ts	Adds runtime handling for skipToken when calling useInfiniteQuery (including getNextPageParam handling).
src/useEffectQueries.ts	Adds per-query skipToken handling when mapping to useQueries inputs.
src/toQueryOptions.ts	Adds skipToken support when converting Effect query options to React Query options.
test/useEffectQuery.test.ts	Adds skipToken behavior + type-level tests for useEffectQuery.
test/useInfiniteEffectQuery.test.ts	Adds skipToken behavior + type-level tests for useInfiniteEffectQuery.
test/useEffectQueries.test.ts	Adds skipToken behavior + type-level tests for useEffectQueries.
test/effectQueryOptions.test.ts	Adds skipToken tests for effectQueryOptions.
.changeset/add-skip-token.md	Declares a minor release and documents the new skipToken feature.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

[fondation451]

Nice :)