Ecosystem: zodql — Zod-schema-driven GraphQL queries

[mattiasahlsen]

Hi Colin 👋

I built zodql, a library for using Zod schemas as the source of truth for a GraphQL queries — it compiles the schema into the query string, infers the response type from it, and validates the response against that same schema at runtime. It targets Zod 4 (zod is a ^4.0.0 peer dependency).

📦 npm: https://www.npmjs.com/package/@mattiasahlsen/zodql
🛠️ GitHub: https://github.com/mattiasahlsen/zodql

What it does:

• One source of truth — the same schema defines the query, the inferred TS response type, and runtime validation. No separate query string to keep in sync, no codegen step.
• Dynamic queries — a query is a Zod schema, so you reshape it with ordinary Zod combinators (.pick, .omit, .extend, …) at runtime.
• Validation beyond GraphQL — enforce non-empty strings, emails, URLs, ranges, and any Zod refinement on the data you get back.
• Bring your own HTTP client — works with fetch, axios, or anything exposing .json().
• Supports queries/mutations, variables, arguments, aliases, nested selections, fragments, inline fragments, and unions/interfaces.

Suggested one-liner for the API Libraries section:

zodql — Compile a Zod schema into a GraphQL query and validate the response against it.