Put your queries in .graphql files, and run megaera to generate TypeScript code from them.

Megaera will copy the query string to the generated TypeScript file, so you can
import it in your TypeScript code.

`ts
import { IssuesQuery } from './query.graphql.ts'
`

The IssuesQuery variable is a string with the GraphQL query. You can use it
directly in your code, or pass it to a function that accepts a query.

Also, IssuesQuery carries the type of the query, so you can use it to infer
the return type of the query, and the types of the input variables.

`ts
type Result = ReturnType
`

The type IssuesQuery can also be used independently:

`ts
import type { IssuesQuery } from './query.graphql.ts'
`

`ts
type UserQuery = (vars: { login?: string }) => {
user: {
login: string
avatarUrl: string
name: string
}
}
`

To get the return type of a query, use the ReturnType utility type:

`ts
type Result = ReturnType
`

You can use TypeScript's Parameters utility type to get the types of the variables:

`ts
type Variables = Parameters[0]
`

Or you can use the Variables utility type to get the types of the variables:

`ts
import { Variables } from 'megaera'

type Variables = Variables
`

`ts
import { Query, Variables } from 'megaera'
import { IssuesQuery } from './query.graphql.ts'

function query(query: T, variables?: Variables) {
return octokit.graphql>(query, variables)
}

// Return type, and types of variables are inferred from the query.
const { issues } = await query(IssuesQuery, { login: 'webpod' })
`

`graphql
query IssuesQuery($login: String) {
issues(login: $login) {
totalCount
nodes {
...Issue
}
}
}

fragment Issue on Issue {
number
author {
login
}
createdAt
closedAt
}
`

The generated TypeScript code will have a type Issue that can be used independently:

`ts
import { Issue, IssuesQuery } from './query.graphql.ts'

const firstIssue: Issue = query(IssuesQuery).issues.nodes[0]
`

No. To simplify development of Megaera, it is only possible to extract queries
from .graphql files.

But it should be possible to create plugins for webpack, rollup, or other
bundlers that can extract queries from .ts` files. If you are interested in
this, please open an issue.