Add isReady function to check WASM module initialization

- Add isReady() function to wasm/index.js and wasm/index.cjs
- Export isReady from main index.js with TypeScript definition
- Document isReady in README with clear usage examples
- Helps users avoid 'WASM module not initialized' errors with sync methods
- All 32 tests passing, no breaking changes

Co-Authored-By: Dan Lynch <[email protected]>

Author: devin-ai-integration[bot]

README.md

@@ -183,6 +183,30 @@ const result = parseQueryDetailedSync('SELECT * FROM users WHERE active = true')
 // Returns: DetailedParseResult with enhanced error information if parsing fails
 ```
 
+### `isReady(): boolean`
+
+Checks if the WebAssembly module is initialized and ready for synchronous operations. This is useful when using sync methods to avoid "WASM module not initialized" errors.
+
+```typescript
+import { isReady, parseQuerySync, parseQuery } from 'libpg-query';
+
+// Check if module is ready before using sync methods
+if (isReady()) {
+  const result = parseQuerySync('SELECT * FROM users');
+} else {
+  // Initialize by calling any async method first
+  await parseQuery('SELECT 1');
+  // Now sync methods will work
+  const result = parseQuerySync('SELECT * FROM users');
+}
+
+// Alternative pattern - always safe
+if (!isReady()) {
+  await parseQuery('SELECT 1'); // Initialize module
+}
+const result = parseQuerySync('SELECT * FROM users');
+```
+
 ### Type Definitions
 
 ```typescript

index.d.ts

@@ -12,4 +12,5 @@ export function normalize(sql: string): Promise<string>;
 export function normalizeSync(sql: string): string;
 export function parseQueryDetailed(sql: string): Promise<ParseResult>;
 export function parseQueryDetailedSync(sql: string): ParseResult;
+export function isReady(): boolean;
 export * from '@pgsql/types';

index.js

@@ -25,6 +25,10 @@ function parseQueryDetailedSync(query) {
   return wasmModule.parseQueryDetailedSync(query);
 }
 
+function isReady() {
+  return wasmModule.isReady();
+}
+
 module.exports = {
   parseQuery: wasmModule.parseQuery,
   deparse: wasmModule.deparse,
@@ -38,5 +42,6 @@ module.exports = {
   parsePlPgSQLSync,
   fingerprintSync,
   normalizeSync,
-  parseQueryDetailedSync
+  parseQueryDetailedSync,
+  isReady
 };

wasm/index.cjs

@@ -398,6 +398,10 @@ function parseQueryDetailedSync(query) {
 
 
 
+function isReady() {
+  return !!wasmModule;
+}
+
 module.exports = {
   parseQuery,
   deparse,
@@ -411,5 +415,6 @@ module.exports = {
   fingerprintSync,
   normalizeSync,
   parseQueryDetailedSync,
+  isReady,
   initPromise
 };

wasm/index.js

@@ -394,3 +394,7 @@ export function parseQueryDetailedSync(query) {
     wasmModule._free(queryPtr);
   }
 }
+
+export function isReady() {
+  return !!wasmModule;
+}