typescript-operations does not support declarationKind

[benasher44]

Which packages are impacted by your issue?

@graphql-codegen/typescript-operations

Describe the bug

Set declarationKind: 'interface', and types generated by the typescript plugin switch to using interface, but typescript-operation types still use type, despite typescript-operations documenting that declarationKind is a supported option.

Your Example Website or App

n/a

Steps to Reproduce the Bug or Issue

1. Setup a project that uses typescript and typescript-operations
2. Set declarationKind to interface

Expected behavior

typescript-operation types switch to using interface

Screenshots or Videos

No response

Platform

• OS: macOS 13
• NodeJS: 18
• graphql: 16
• @graphql-codegen/* @graphql-codegen/typescript-operations: 2.5.7

Codegen Config File

schema: "../backend/src/graphql_server//*.graphql"
documents: "./src/graphql//*.graphql"
extensions:
codegen:
overwrite: true
config:
dedupeFragments: true
noNamespaces: true
strict: true
scalars:
Date: string
DateTime: string
useExplicitTyping: true
declarationKind: "interface"
generates:
src/generated/graphql/graphql.tsx:
plugins:
- "typescript"
- "typescript-operations"
- "fragment-matcher"
- "typed-document-node"

Additional context

No response

[TomSwift]

At the very least the documentation should be updated to reflect this reality - I spent a fair amount of time trying to make it work. https://the-guild.dev/graphql/codegen/plugins/typescript/typescript-operations#declarationkind

[ryanb93]

Still an issue, wasted a lot of time trying to get this to work before finding this issue.

[Harriebo]

We also need this. Its not very useful if you cant map it on an OO model without having to maintain the whole model your self.

[eddeee888]

Hi all 👋

Major version changes are under work: #10496
This will most likely be included in that. Will keep this issue updated with news

[eddeee888]

Hello 👋
declarationKind support is added to the next major version here.

Notes:

• Input: can only be type or interface
• Variables: no support. It must always be type because it's an alias e.g. Variables = Exact<{ something: type }>
• Result: can only be type or interface
  • Note: when extractAllFieldsToTypes:true or extractAllFieldsToTypesCompact:true, Results are used as type alias, so they are forced to be type. There is a console warning for users.

You can try it using these alpha versions:

@graphql-codegen/visitor-plugin-common@7.0.0-alpha-20260326135024-68a6e8709957a26f7d6283c9ab5e8e91c613b578
@graphql-codegen/typescript-operations@6.0.0-alpha-20260326135024-68a6e8709957a26f7d6283c9ab5e8e91c613b578

Note that this is for the next major version, so please follow the migration guide

Please let me know if it doesn't solve your issues!