sqlparser-rs 0.60.3-rc2 → 0.60.3-rc4

package/README.md

@@ -127,9 +127,15 @@ const ast = parse('SELECT 1');
 
 ### Dialects
 
-All dialects from the upstream Rust crate are supported:
+All dialects from the upstream Rust crate are supported. You can use string names directly with `parse()`, `format()`, and `validate()`:
 
 ```typescript
+// String names (recommended)
+parse('SELECT 1', 'postgresql');
+parse('SELECT 1', 'mysql');
+parse('SELECT 1', 'bigquery');
+
+// Or import dialect classes for type safety
 import {
   GenericDialect,      // Permissive, accepts most SQL syntax
   AnsiDialect,         // ANSI SQL standard
@@ -144,9 +150,10 @@ import {
   DuckDbDialect,       // DuckDB
   DatabricksDialect,   // Databricks
   HiveDialect,         // Apache Hive
+  OracleDialect,       // Oracle
 } from 'sqlparser-rs';
 
-// Create dialect from string
+// Create dialect from string programmatically
 import { dialectFromString } from 'sqlparser-rs';
 const dialect = dialectFromString('postgresql'); // Returns PostgreSqlDialect instance
 ```
@@ -154,10 +161,10 @@ const dialect = dialectFromString('postgresql'); // Returns PostgreSqlDialect in
 ### Error Handling
 
 ```typescript
-import { Parser, GenericDialect, ParserError } from 'sqlparser-rs';
+import { parse, ParserError } from 'sqlparser-rs';
 
 try {
-  Parser.parse('SELEC * FROM users', new GenericDialect());
+  parse('SELEC * FROM users');
 } catch (error) {
   if (error instanceof ParserError) {
     console.log('Parse error:', error.message);
@@ -173,9 +180,10 @@ try {
 Full TypeScript types are provided for the AST:
 
 ```typescript
-import type { Statement, Query, Expr, Ident, ObjectName } from 'sqlparser-rs';
+import { parse } from 'sqlparser-rs';
+import type { Statement, Query } from 'sqlparser-rs';
 
-const statements: Statement[] = Parser.parse('SELECT 1', new GenericDialect());
+const statements: Statement[] = parse('SELECT 1');
 
 // Statement is a discriminated union type
 for (const stmt of statements) {
@@ -188,6 +196,23 @@ for (const stmt of statements) {
 }
 ```
 
+## Bundler Configuration
+
+### Vite
+
+Exclude `sqlparser-rs` from dependency optimization to ensure WASM files load correctly:
+
+```typescript
+// vite.config.ts
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ["sqlparser-rs"],
+  },
+});
+```
+
+This is required because Vite's pre-bundling breaks the WASM file path resolution.
+
 ## Development
 
 ### Prerequisites
@@ -224,7 +249,7 @@ npm test
 This package follows the upstream [sqlparser-rs](https://github.com/apache/datafusion-sqlparser-rs) version:
 
 - **Major.Minor** matches the upstream Rust crate version
-- **Patch** is for TypeScript binding fixes (e.g., `0.60.3-rc2` = upstream `0.60.0` + binding fix)
+- **Patch** is for TypeScript binding fixes (e.g., `0.60.3-rc4` = upstream `0.60.0` + binding fix)
 
 | This package | sqlparser-rs |
 |--------------|--------------|

package/dist/index.cjs

@@ -270,7 +270,7 @@ async function initWasm() {
 				/* @vite-ignore */
 				wasmJsUrl.href
 );
-			if (typeof wasm.default === "function") await wasm.default(wasmBinaryUrl);
+			if (typeof wasm.default === "function") await wasm.default({ module_or_path: wasmBinaryUrl });
 			wasmModule = wasm;
 		} catch (error) {
 			throw new WasmInitError(`Failed to load WASM module in browser: ${error instanceof Error ? error.message : String(error)}`);

package/dist/index.mjs

@@ -269,7 +269,7 @@ async function initWasm() {
 				/* @vite-ignore */
 				wasmJsUrl.href
 );
-			if (typeof wasm.default === "function") await wasm.default(wasmBinaryUrl);
+			if (typeof wasm.default === "function") await wasm.default({ module_or_path: wasmBinaryUrl });
 			wasmModule = wasm;
 		} catch (error) {
 			throw new WasmInitError(`Failed to load WASM module in browser: ${error instanceof Error ? error.message : String(error)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlparser-rs",
-  "version": "0.60.3-rc2",
+  "version": "0.60.3-rc4",
   "type": "module",
   "description": "A SQL parser for JavaScript and TypeScript, powered by datafusion-sqlparser-rs via WASM",
   "main": "dist/index.cjs",

package/wasm/README.md

@@ -127,9 +127,15 @@ const ast = parse('SELECT 1');
 
 ### Dialects
 
-All dialects from the upstream Rust crate are supported:
+All dialects from the upstream Rust crate are supported. You can use string names directly with `parse()`, `format()`, and `validate()`:
 
 ```typescript
+// String names (recommended)
+parse('SELECT 1', 'postgresql');
+parse('SELECT 1', 'mysql');
+parse('SELECT 1', 'bigquery');
+
+// Or import dialect classes for type safety
 import {
   GenericDialect,      // Permissive, accepts most SQL syntax
   AnsiDialect,         // ANSI SQL standard
@@ -144,9 +150,10 @@ import {
   DuckDbDialect,       // DuckDB
   DatabricksDialect,   // Databricks
   HiveDialect,         // Apache Hive
+  OracleDialect,       // Oracle
 } from 'sqlparser-rs';
 
-// Create dialect from string
+// Create dialect from string programmatically
 import { dialectFromString } from 'sqlparser-rs';
 const dialect = dialectFromString('postgresql'); // Returns PostgreSqlDialect instance
 ```
@@ -154,10 +161,10 @@ const dialect = dialectFromString('postgresql'); // Returns PostgreSqlDialect in
 ### Error Handling
 
 ```typescript
-import { Parser, GenericDialect, ParserError } from 'sqlparser-rs';
+import { parse, ParserError } from 'sqlparser-rs';
 
 try {
-  Parser.parse('SELEC * FROM users', new GenericDialect());
+  parse('SELEC * FROM users');
 } catch (error) {
   if (error instanceof ParserError) {
     console.log('Parse error:', error.message);
@@ -173,9 +180,10 @@ try {
 Full TypeScript types are provided for the AST:
 
 ```typescript
-import type { Statement, Query, Expr, Ident, ObjectName } from 'sqlparser-rs';
+import { parse } from 'sqlparser-rs';
+import type { Statement, Query } from 'sqlparser-rs';
 
-const statements: Statement[] = Parser.parse('SELECT 1', new GenericDialect());
+const statements: Statement[] = parse('SELECT 1');
 
 // Statement is a discriminated union type
 for (const stmt of statements) {
@@ -188,6 +196,23 @@ for (const stmt of statements) {
 }
 ```
 
+## Bundler Configuration
+
+### Vite
+
+Exclude `sqlparser-rs` from dependency optimization to ensure WASM files load correctly:
+
+```typescript
+// vite.config.ts
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ["sqlparser-rs"],
+  },
+});
+```
+
+This is required because Vite's pre-bundling breaks the WASM file path resolution.
+
 ## Development
 
 ### Prerequisites
@@ -224,7 +249,7 @@ npm test
 This package follows the upstream [sqlparser-rs](https://github.com/apache/datafusion-sqlparser-rs) version:
 
 - **Major.Minor** matches the upstream Rust crate version
-- **Patch** is for TypeScript binding fixes (e.g., `0.60.3-rc2` = upstream `0.60.0` + binding fix)
+- **Patch** is for TypeScript binding fixes (e.g., `0.60.3-rc4` = upstream `0.60.0` + binding fix)
 
 | This package | sqlparser-rs |
 |--------------|--------------|

package/wasm/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sqlparser-rs-wasm",
   "description": "WebAssembly bindings for sqlparser-rs SQL parser",
-  "version": "0.60.3-rc2",
+  "version": "0.60.3-rc4",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",