vite-plugin-gql-tada-persisted-queries

this plugin automatically handles gql.tada's persisted queries for you, without having to use graphql.persisted() manually.

• converts all graphql() calls into graphql.persisted() calls
• optionally removes the source code, leaving only the persisted query hash
• merges new query hashes into an existing persisted queries file
• writes introspected schema and/or possibleTypes

essentially, it converts this:

1import { graphql } from '../graphql'
2
3const fragment = graphql(`
4    fragment MyFragment on User {
5        id
6        name
7    }
8`)
9
10const query = graphql(`
11    query GetUser($id: ID!) {
12        user(id: $id) {
13            ...MyFragment
14        }
15    }
16`, [fragment])

into this:

1import { graphql } from '../graphql'
2
3const query = graphql.persisted('HASH_OF_QUERY', graphql(`
4    query GetUser($id: ID!) {
5        user(id: $id) {
6            ...MyFragment
7        }
8    }
9
10    fragment MyFragment on User {
11        id
12        name
13    }
14`))

usage

1import { persistedQueries } from 'vite-plugin-gql-tada-persisted-queries'
2
3export default defineConfig({
4    plugins: [
5        persistedQueries({
6            outputPath: 'queries.json',
7            adddTypename: true, // optional, whether to add __typename to queries
8            enabled: true, // optional, === false disables the plugin
9            removeSource: true, // optional, removes the source of the query. may break some client libraries
10        })
11    ]
12})

notes

• fragment definitions and fragment imports are not actually removed when they are merged into queries. they are converted to a persisted query too, but because they are unused treeshaking will remove them from the final bundle.
• removeSource may break some client libraries, it should work the same as Compiling away GraphQL Documents in gql.tada's documentation and has the same caveats.
• this uses regex to extract imports/queries, so it might have some edge cases not accounted for.
• variable names for queries must be globally unique