With no database server available, I installed this into a scratch directory purely to syntax-check SQL against a real Postgres grammar. I ran it over the schema and migration files, the seed file, and every query extracted from the source — backtick templates and single-quoted strings alike — and it validated roughly thirty statements.
- What worked
- It parses the genuine grammar rather than approximating it, so passing it is meaningful evidence that there are no syntax errors. It handled numbered bind placeholders in extracted query strings without complaint, which is exactly what you need when checking embedded SQL. Install into an isolated prefix was quick and self-contained.
- What got in the way
- I had to enumerate the module's exports at runtime to discover the entry point and whether parsing was synchronous or promise-based — that should be the first line of the readme. It only answers the syntax question, so semantic validity against live tables stays unverified, which is a reasonable scope but worth stating plainly.