sqlparser-rs 0.60.3-rc2 → 0.60.3-rc3

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-rc3` = upstream `0.60.0` + binding fix)
 
 | This package | sqlparser-rs |
 |--------------|--------------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlparser-rs",
-  "version": "0.60.3-rc2",
+  "version": "0.60.3-rc3",
   "type": "module",
   "description": "A SQL parser for JavaScript and TypeScript, powered by datafusion-sqlparser-rs via WASM",
   "main": "dist/index.cjs",
@@ -18,19 +18,6 @@
     "wasm",
     "README.md"
   ],
-  "scripts": {
-    "build": "npm run build:wasm && npm run build:ts",
-    "build:wasm": "cd .. && wasm-pack build --target nodejs --out-dir ts/wasm && rm -f ts/wasm/.gitignore",
-    "build:wasm:web": "cd .. && wasm-pack build --target web --out-dir ts/wasm-web",
-    "build:ts": "tsdown",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src tests",
-    "lint:fix": "eslint src tests --fix",
-    "prepublishOnly": "npm run build",
-    "local:pack": "npm run build:ts && npm pack",
-    "local:link": "npm run build:ts && npm link"
-  },
   "keywords": [
     "sql",
     "parser",
@@ -58,5 +45,17 @@
   },
   "engines": {
     "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "npm run build:wasm && npm run build:ts",
+    "build:wasm": "cd .. && wasm-pack build --target nodejs --out-dir ts/wasm && rm -f ts/wasm/.gitignore",
+    "build:wasm:web": "cd .. && wasm-pack build --target web --out-dir ts/wasm-web",
+    "build:ts": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "local:pack": "npm run build:ts && npm pack",
+    "local:link": "npm run build:ts && npm link"
   }
-}
+}

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-rc3` = 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-rc3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",