GenerateQL v0.1.0 — protoc, but for GraphQL

[oh-tarnished]

GenerateQL turns any GraphQL endpoint into a typed, idiomatic client library. Point it at a server that supports standard introspection — Hasura, Hasura DDN / Grafbase, Prisma-backed engines — and it emits a self-contained SDK: typed models, a fluent predicate DSL for filters, single-object create/update inputs, and one method per query, mutation, and subscription, organized into clean per-domain packages on a small transport runtime.

The idea is to make the schema the single source of truth. Hand-written query strings and client code drift from the schema; GenerateQL is a small compiler that closes that gap the way protoc does for .proto. It introspects, normalizes the result into a language-agnostic IR, runs analysis passes, and renders code. Mistakes fail at compile time instead of in production.

What you get:

• Typed end to end — every row is a struct, every root field a method.
• Natural call sites — svc.Query.Booking.Contacts.List(ctx, …) with native values. No raw input structs, no pointers.
• Predicate DSL — fluent, typed filters: Eq/In/Like/…, And/Or/Not, relation filters, ordering. No BoolExp leaking into your code.
• Full CRUD + live subscriptions — List / Get / Find / Aggregate, Create / Update / Delete, plus On* subscriptions.
• Escape hatch — QueryRaw / ExecuteRaw for anything the typed API doesn't cover.
• Convention-agnostic — CRUD families and filterable columns are derived from introspection, not hardcoded to one engine.
• Reproducible — deterministic, gofmt-clean output; --dump-schema ships the exact schema.json it was built from.

Today: Go is shipping (--lang go). Installing the CLI needs Go 1.26+; generated code needs Go 1.24+ (for encoding/json omitzero).

On the roadmap: the IR is already language-agnostic, so the generator is built to retarget. Python, TypeScript, and Rust client targets are coming in future releases, along with .proto output.

Get started: go install github.com/oh-tarnished/generateql/cmd/generateql@latest

Drop a generateql.yaml in your project, then generateql generate. A complete runnable example (config, generated library, and a main.go exercising full CRUD + a live subscription) lives in examples/freebusy.

Apache-2.0. Repo, docs, and the v0.1.0 release: https://github.com/oh-tarnished/generateql

This is an early release and I'm the author — feedback, issues, and stars genuinely help me prioritize the language targets. If Python, TypeScript, or Rust is the one you're waiting on, open an issue and say so.