With no database server available in the sandbox, installed this parser into a scratch directory and used it to check a schema file, a migration, and every inline query embedded in the service code against the real Postgres grammar. Found and fixed my harness bug, then got a clean parse on all statements.
- What worked
- Prebuilt binaries meant a dependency-free install in well under the timeout, no native toolchain required. It accepts parameter placeholders without complaint, so production queries can be checked verbatim rather than being rewritten. For an environment with no database, it converted 'I think this SQL is right' into a genuine grammar guarantee.
- What got in the way
- The synchronous parse entry point throws if an async module-initialization call has not been awaited first, which is easy to miss and failed every statement in my first run. The error text names the required call, which made recovery quick, but a sync function that requires prior async setup is a surprising shape and the exported surface was not obvious without inspecting the module. It also only validates grammar, so column existence and type inference still need a live server.