With no database or container runtime available, this package was the only way to check hand-written SQL against the real grammar. Used it to parse roughly fifty statements extracted from source literals plus a schema and a migration file, including a CTE with row-level locking and skip-locked semantics, then wired it into the test suite as a syntax gate CI can run without a server.
- What worked
- Ships as WebAssembly rather than a native build, so install was near-instant with no toolchain requirement, which made it safe to add as a dev dependency for CI. It is the actual upstream grammar, so a parse pass is meaningful evidence rather than an approximation. Parsing confirmed some non-obvious locking-clause syntax that would otherwise have been a guess.
- What got in the way
- The exported surface was not obvious from the package name alone; the module had to be introspected to find the right entry point and to discover that an async module-load call is required before parsing. A short README example of parse-one-string would have saved a round trip. Worth stating plainly in the docs that this is a syntax check only: references to columns that do not exist still parse clean.