Inferred type references an inaccessible unique symbol type after updating from 5.61.5 to 5.62.0

[antoine-delahaye]

Describe the bug

After updating TanStack from version 5.61.5 to 5.62.0 (not solved with 5.69.0), I encountered the following TypeScript error on every function that returns queryOptions or infiniteQueryOptions:

TS2527: The inferred type of 'queryPlan' references an inaccessible 'unique symbol' type. A type annotation is necessary.

Your minimal, reproducible example

https://www.typescriptlang.org/play/?ts=5.7.3#code/JYWwDg9gTgLgBAbwLACg5wI4FcCmUCeA8mDMBAHYDOANKusOQGYPAw4CKuBxpFlqAXziMoEEHADkAARgBDKnIDGAawD08gOZYANrKgBabHnz6cADzB5QOcnO0SA3KlSLdlSnACiZ2eG04AZTwAN2BFHEQ6ODAsACNtMMwuInIcAApzXzB-AEkAEwAuOHIsEFi8AEpItHQ4KBwYLChyJOMeMio05Bra1oIAaRx8IoBtCQkAXVoe2qMCADFyIrSKouCIYDy4AF4APkQBad70G1l4nEK4AEIrzL8cfKPagQqnFAFnFBj4xLn8AFl5PgVtVevVGs04AxmORWBxku0+F0or0-oNhnAxpMnqjkotlmBZBocAAFPS+VZwdabHb7BCHFG1FikWTaMnEslQXxFACMONqxJgJPqoQgWEo7NJ5JAyyqezgfMZ6EFADlzEKiVKuTK4CD5TzGS83h93kA

Steps to reproduce

Inside a Angular's service :

public queryOne(exampleId: number) {
    return queryOptions({
      queryKey: [this.getFetchPath(...)],
      queryFn: (): Promise<ExampleDTO[]> => this.getOne(...),
      enabled: !!exampleId,
    });
}

public queryMany(paramsData) {
    return infiniteQueryOptions({
      queryKey: [...],
      queryFn: (pageParam): Promise<ExampleDTO[]> => this.getMany(...),
      ...,
    });
}

Expected behavior

The code should compile without any TypeScript errors without any type annotation.

How often does this bug happen?

Every time

Screenshots or Videos

No response

Platform

• OS: Windows
• Framework: Angular v19.2.2

Tanstack Query adapter

angular-query

TanStack Query version

v5.62.0

TypeScript version

v5.7.3

Additional context

I managed to get rid of this error by annotating queryOptions and function return type :

public queryMany(...): CreateQueryOptions<ExampleDTO[]> {
    return queryOptions<ExampleDTO[]>(...);
}

However, unable to annotate properly infiniteQueryOptions because I got another type error :

public queryManyWithPagination(...): CreateInfiniteQueryOptions<ExampleDTO[]> {
    return infiniteQueryOptions<ExampleDTO[]>(...);
  }

TS2322: Type CreateInfiniteQueryOptions<StopPointResponseDTO[], Error, InfiniteData<StopPointResponseDTO[], unknown>, StopPointResponseDTO[], readonly unknown[], unknown> & { ...; } & { ...; } is not assignable to type CreateInfiniteQueryOptions<StopPointResponseDTO[], Error, StopPointResponseDTO[], StopPointResponseDTO[], readonly unknown[], unknown>

[jeroenpg]

Doesn't seem to be an angular-query specific issue. Same issue occurs for @tanstack/solid-query

[arnoud-dv]

This may be the same problem as #8453 which isn't fully solved

@TkDodo FYI

[arnoud-dv]

@antoine-delahaye Could you re-check your TypeScript playground reproduction if there's still any problem? I currently do not see a type error there.

[vbifonixor]

It's still being reproduced with solid-query when I'm trying to generate type declarations for my api client package that generates queries with @hey-api/openapi-ts. TypeError starts to appear if you have delcaration: true in your tsconfig

[dannylin108]

It's still being reproduced with solid-query: TypeError starts to appear if you have delcaration: true in your tsconfig

Confirm for solid-query 5.81.5

[Hookyns]

Same issue with"@tanstack/solid-query": "^5.83.0".

When declaration: true is set in tsconfig, every exported const that returns a queryOptions factory causes the mentioned error. However, if the export keyword is removed or declarations are disabled, the error no longer occurs.

export const someQueryOptions = (param: string) =>
	queryOptions({
		queryFn: async () => {
			return [];
		},
		queryKey: ["some", "key", param],
	});

TS2527: The inferred type of someQueryOptions references an inaccessible unique symbol type. A type annotation is necessary.

---

EDIT: Downgrade to v5.61.5 removes this issue.