feat(postgrest-typegen): formatter hook, oxfmt default, concurrent introspection

[spydon]

Summary

Adds an optional format callback to GenerateTypescriptOptions for the TypeScript generator, and switches the default formatter itself from prettier to oxfmt.

This unblocks supabase/postgres-meta#1084, whose description flags that @supabase/postgrest-typegen formats inline with prettier and exposed no formatting hook yet, which that PR states should land here first. Tracked in Linear as SDK-1649.

The review comment on that PR (supabase/postgres-meta#1084 (comment)) measured prettier at roughly 73-92% of generateTypescript's time and made two asks against this package:

1. "A formatter-choice option... worth raising against postgrest-typegen — it already uses oxfmt/oxlint on its own source, so the dependency is familiar there." Addressed by the format option.
2. "~90% of type generation is prettier... oxfmt is roughly an order of magnitude faster on this kind of workload." Addressed by switching the default itself, not just making it overridable.

Neither of these fully eliminates main-thread blocking on its own; that review's own benchmark achieved its largest win (~1000ms -> ~21ms main-thread block) by additionally wrapping the entire generateTypescript() call in a worker, which is an architecture choice for the consumer (postgres-meta) to make, not something needed here.

Changes

• introspect() now issues its ten introspection queries under Promise.all instead of awaiting them one at a time. The same review flagged that postgres-meta's CLI path (supabase gen types) went from parallel to sequential in the migration, adding one round trip per query on remote databases; this restores the old parallelism for every consumer. A pooled Queryable runs the queries in parallel, a single-connection one pipelines them.

• GenerateTypescriptOptions.format?: (code: string) => Promise<string> — optional, defaults to a new oxfmt-backed formatter (semi: false, printWidth: 80 to match prettier's default and minimize output churn).

• prettier dropped as a dependency; oxfmt moves from a devDependency to a runtime dependency.

• The nightly parity job against real postgres-meta (still prettier-formatted) now canonicalizes postgres-meta's TypeScript output through this package's own oxfmt formatter before diffing, so it keeps catching real content drift without flagging the formatter swap itself every night.

• test/parity/expected/typescript.txt and the inline snapshots in test/generation/typescript.test.ts regenerated for the new formatter's output. Verified the only remaining differences from the previous prettier-formatted goldens are formatter style choices (confirmed by reformatting the old prettier golden through the new oxfmt formatter and diffing against a fresh regeneration; the only residual difference is oxfmt adding parentheses around a conditional type in a couple of generic-default positions, which is semantically inert).

Test plan

• bun run check-types
• bun run format-and-lint
• bun run knip
• bun run build
• bun run test (93 pass, including a regression test asserting a custom format callback is invoked and its output is used verbatim)

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 10fbe7cc-dad9-4dc7-8106-03598552d9c2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[avallete]

❤️