sqlparser-rs 0.60.0-rc1

package/dist/types/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * sqlparser-rs - SQL Parser for JavaScript/TypeScript
+ *
+ * This package wraps the Rust sqlparser crate via WebAssembly, providing
+ * a fast and accurate SQL parser for JavaScript and TypeScript.
+ *
+ * @example
+ * ```typescript
+ * import { Parser, GenericDialect, PostgreSqlDialect } from 'sqlparser-rs';
+ *
+ * // Simple parsing
+ * const statements = await Parser.parse('SELECT * FROM users', new GenericDialect());
+ *
+ * // With specific dialect
+ * const pgStatements = await Parser.parse(
+ *   'SELECT * FROM users WHERE id = $1',
+ *   new PostgreSqlDialect()
+ * );
+ *
+ * // Builder pattern with options
+ * const parser = new Parser(new PostgreSqlDialect())
+ *   .withRecursionLimit(50)
+ *   .withOptions({ trailingCommas: true });
+ *
+ * const ast = await parser.parseAsync('SELECT * FROM users');
+ *
+ * // Format SQL
+ * const formatted = await Parser.format('select * from users', new GenericDialect());
+ * // Returns: "SELECT * FROM users"
+ *
+ * // Validate SQL
+ * try {
+ *   await Parser.validate('SELECT * FRO users', new GenericDialect());
+ * } catch (e) {
+ *   console.log('Invalid SQL:', e.message);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Parser, initWasm } from './parser';
+export type { ParserOptions } from './parser';
+export { GenericDialect, AnsiDialect, MySqlDialect, PostgreSqlDialect, SQLiteDialect, SnowflakeDialect, RedshiftDialect, MsSqlDialect, ClickHouseDialect, BigQueryDialect, DuckDbDialect, DatabricksDialect, HiveDialect, dialectFromString, SUPPORTED_DIALECTS, } from './dialects';
+export type { Dialect, DialectName } from './dialects';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGvD,cAAc,SAAS,CAAC"}

package/dist/types/parser.d.ts

@@ -0,0 +1,130 @@
+import type { Dialect } from './dialects';
+import type { Statement } from './types/ast';
+/**
+ * Parser options
+ */
+export interface ParserOptions {
+    /**
+     * Allow trailing commas in SELECT lists
+     */
+    trailingCommas?: boolean;
+    /**
+     * Maximum recursion depth for parsing nested expressions
+     */
+    recursionLimit?: number;
+}
+/**
+ * Initialize the WASM module
+ * This is called automatically when needed, but can be called manually for eager loading
+ */
+export declare function initWasm(): Promise<void>;
+/**
+ * SQL Parser
+ *
+ * Parses SQL statements into an Abstract Syntax Tree (AST).
+ *
+ * @example
+ * ```typescript
+ * import { Parser, PostgreSqlDialect } from 'sqlparser-rs';
+ *
+ * // Simple parsing
+ * const statements = await Parser.parse('SELECT * FROM users', new PostgreSqlDialect());
+ *
+ * // With builder pattern
+ * const parser = new Parser(new PostgreSqlDialect())
+ *   .withRecursionLimit(50)
+ *   .withOptions({ trailingCommas: true });
+ *
+ * const ast = await parser.parseAsync('SELECT * FROM users');
+ * ```
+ */
+export declare class Parser {
+    private dialect;
+    private options;
+    /**
+     * Create a new parser instance
+     *
+     * @param dialect - The SQL dialect to use (defaults to GenericDialect)
+     */
+    constructor(dialect?: Dialect);
+    /**
+     * Set the recursion limit for parsing nested expressions
+     *
+     * @param limit - Maximum recursion depth
+     * @returns This parser instance for chaining
+     */
+    withRecursionLimit(limit: number): Parser;
+    /**
+     * Set parser options
+     *
+     * @param options - Parser options
+     * @returns This parser instance for chaining
+     */
+    withOptions(options: ParserOptions): Parser;
+    /**
+     * Parse SQL statements asynchronously
+     *
+     * @param sql - SQL string to parse
+     * @returns Array of parsed statements
+     */
+    parseAsync(sql: string): Promise<Statement[]>;
+    /**
+     * Parse SQL statements synchronously
+     * Requires WASM module to be initialized first via initWasm()
+     *
+     * @param sql - SQL string to parse
+     * @returns Array of parsed statements
+     */
+    parseSync(sql: string): Statement[];
+    private parseWithWasm;
+    /**
+     * Parse SQL statements (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns Array of parsed statements
+     *
+     * @example
+     * ```typescript
+     * const statements = await Parser.parse('SELECT 1', new GenericDialect());
+     * ```
+     */
+    static parse(sql: string, dialect?: Dialect): Promise<Statement[]>;
+    /**
+     * Parse SQL and return the AST as a JSON string (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns JSON string representation of the AST
+     */
+    static parseToJson(sql: string, dialect?: Dialect): Promise<string>;
+    /**
+     * Parse SQL and return a formatted string representation (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns String representation of the parsed SQL
+     */
+    static parseToString(sql: string, dialect?: Dialect): Promise<string>;
+    /**
+     * Format SQL by parsing and regenerating it (round-trip)
+     *
+     * @param sql - SQL string to format
+     * @param dialect - SQL dialect to use
+     * @returns Formatted SQL string
+     */
+    static format(sql: string, dialect?: Dialect): Promise<string>;
+    /**
+     * Validate SQL syntax without returning the full AST
+     *
+     * @param sql - SQL string to validate
+     * @param dialect - SQL dialect to use
+     * @returns true if valid, throws ParserError if invalid
+     */
+    static validate(sql: string, dialect?: Dialect): Promise<boolean>;
+    /**
+     * Get the list of supported dialect names
+     */
+    static getSupportedDialects(): Promise<string[]>;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiBD;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C;AA6CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;;OAIG;gBACS,OAAO,GAAE,OAA8B;IAKnD;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKzC;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAK3C;;;;;OAKG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKnD;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;IAKnC,OAAO,CAAC,aAAa;IAwBrB;;;;;;;;;;;OAWG;WACU,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAA8B,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAK9F;;;;;;OAMG;WACU,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAA8B,GAAG,OAAO,CAAC,MAAM,CAAC;IAS/F;;;;;;OAMG;WACU,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAA8B,GAAG,OAAO,CAAC,MAAM,CAAC;IASjG;;;;;;OAMG;WACU,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAA8B,GAAG,OAAO,CAAC,MAAM,CAAC;IAS1F;;;;;;OAMG;WACU,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAA8B,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7F;;OAEG;WACU,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAIvD"}