rawsql-ts 0.1.0-beta.8 → 0.1.1-beta.1

package/README.md

@@ -1,179 +1,262 @@
 # rawsql-ts
 
-rawsql-ts is a TypeScript SQL parser that performs Abstract Syntax Tree (AST) analysis for advanced SQL processing and transformation.
+![No external dependencies](https://img.shields.io/badge/dependencies-none-brightgreen)
+![Browser Support](https://img.shields.io/badge/browser-%F0%9F%9A%80-brightgreen)
+![npm version](https://img.shields.io/npm/v/rawsql-ts)
+![npm downloads](https://img.shields.io/npm/dm/rawsql-ts)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 
-> **Note:** This library is currently in beta. The API may change without notice until the v1.0 release.
+rawsql-ts is a high-performance SQL parser and AST transformer library written in TypeScript. It is designed for extensibility and advanced SQL analysis, with initial focus on PostgreSQL syntax but not limited to it. The library enables easy SQL parsing, transformation, and analysis for a wide range of SQL dialects.
 
-## Installation
+> **Note:** This library is currently in beta. The API may change until the v1.0 release.
 
-Install the package from npm as follows:
+---
 
-```bash
-npm install rawsql-ts
-```
+💡 **Key Advantages**
 
-## Usage
+With rawsql-ts, raw SQL can be represented as objects, enabling flexible manipulation of SQL statements directly within your program. Objectified SQL can be partially transformed, decomposed into manageable components, and recombined as needed. This approach dramatically improves the maintainability and reusability of complex SQL, making even large-scale queries easy to manage and refactor.
 
-Basic usage example:
+---
 
-```typescript
-import { SelectQueryParser } from 'rawsql-ts';
-import { Formatter } from 'rawsql-ts';
+## Features
 
-const sql = `SELECT id, name FROM users WHERE active = TRUE`;
-const query = SelectQueryParser.parseFromText(sql);
-const formatter = new Formatter();
-const formattedSql = formatter.visit(query);
-console.log(formattedSql);
-// => select "id", "name" from "users" where "active" = true
-```
+- Zero dependencies: fully self-contained and lightweight
+- High-speed SQL parsing and AST analysis
+- Rich utilities for SQL structure transformation and analysis
 
----
+## ✨ Browser & CDN Ready!
 
-## 🧩 Parsing Features
+You can use rawsql-ts directly in modern browsers via CDN (unpkg/jsdelivr)!
+No Node.js dependencies, no build tools required.
+Just import it like this:
 
-rawsql-ts provides the following main parser class for converting SQL text into an Abstract Syntax Tree (AST):
+```html
+<!-- Always get the latest version -->
+<script type="module">
+  import { parse } from "https://unpkg.com/rawsql-ts/dist/esm/index.js";
+</script>
+```
 
-- **SelectQueryParser**  
-  Parses complete SELECT and VALUES queries, including support for CTEs (WITH), UNION/INTERSECT/EXCEPT, subqueries, and all major SQL clauses. Handles PostgreSQL-specific syntax and advanced query structures.
-
- **Key methods:**
-  - `parseFromText(sql: string): SelectQuery`  
-    Parses a SQL string and returns the root AST node for the query. Throws an error if the SQL is invalid or contains extra tokens.
-  - `parse(lexemes: Lexeme[], index: number): { value: SelectQuery; newIndex: number }`  
-    Parses a tokenized SQL query from the given index and returns the AST node and the new index. Used internally for advanced parsing scenarios.
-
-  **Notes:**
-  - Only PostgreSQL syntax is supported at this time.
-  - Only SELECT and VALUES queries are supported (INSERT/UPDATE/DELETE are not yet implemented).
-  - All SQL comments are removed during parsing.
-
-  This class is designed to handle all practical SQL parsing needs for SELECT/VALUES queries in PostgreSQL, including:
-  - CTEs (WITH), including recursive and materialized options
-  - UNION, INTERSECT, EXCEPT, and subqueries
-  - Window functions and analytic clauses
-  - Complex expressions, functions, and operators
-  - Robust error handling with detailed messages
-  - Accurate tokenization, including comments and special literals
+```html
+<!-- Pin a specific version for stability -->
+<script type="module">
+  import { parse } from "https://unpkg.com/rawsql-ts@0.1.0-beta.12/dist/esm/index.js";
+</script>
+```
 
 ---
 
-## Core SQL Query Classes
+## Installation
 
-The following classes are the primary building blocks for representing and manipulating SQL queries in rawsql-ts:
+```bash
+npm install rawsql-ts
+```
 
-### SimpleSelectQuery
+## Quick Start
 
-Represents a single, standard SQL SELECT statement (not a UNION or VALUES). This class encapsulates all major clauses such as SELECT, FROM, WHERE, GROUP BY, HAVING, ORDER BY, and more.
+```typescript
+import { SelectQueryParser, Formatter } from 'rawsql-ts';
 
-**Key methods:**
-- `toUnion`, `toUnionAll`, `toIntersect`, `toExcept`, etc.
-  - Combine this query with another using UNION, INTERSECT, EXCEPT, etc., returning a BinarySelectQuery.
-- `appendWhere`, `appendWhereRaw`
-  - Add a new condition to the WHERE clause (as AST or raw SQL string).
-- `appendHaving`, `appendHavingRaw`
-  - Add a new condition to the HAVING clause.
-- `innerJoin`, `leftJoin`, `rightJoin`, `innerJoinRaw`, etc.
-  - Add JOIN clauses to the query, either as AST or from raw SQL.
-- `toSource`
-  - Wrap this query as a subquery (for use in FROM/JOIN, etc.).
-- `appendWith`, `appendWithRaw`
-  - Add CTEs (WITH clause) to the query.
+const sql = `SELECT user_id, name FROM users WHERE active = TRUE`;
+const query = SelectQueryParser.parse(sql);
+const formatter = new Formatter();
+const formattedSql = formatter.format(query);
 
-### BinarySelectQuery
+console.log(formattedSql);
+// => select "user_id", "name" from "users" where "active" = true
+```
 
-Represents a binary SQL query, such as `SELECT ... UNION SELECT ...`, `INTERSECT`, or `EXCEPT`. This class holds a left and right query and the operator between them.
+---
 
-**Key methods:**
-- `union`, `unionAll`, `intersect`, `intersectAll`, `except`, `exceptAll`
-  - Chain additional queries to the current binary query.
-- `appendSelectQuery`
-  - Add a new query with a custom operator.
-- `toSource`
-  - Wrap this binary query as a subquery (for use in FROM/JOIN, etc.).
-- `unionRaw`, `intersectRaw`, etc.
-  - Add a new query by parsing a raw SQL string and combining it.
+## Main Parser Features
 
-### ValuesQuery
+- **SelectQueryParser**  
+  The main class for converting SELECT and VALUES statements into AST. Fully supports CTEs (WITH), UNION/INTERSECT/EXCEPT, subqueries, and PostgreSQL-specific syntax.
+  - `parse(sql: string): SelectQuery`  
+    Converts a SQL string to an AST. Throws an exception on error.
+  - Supports only PostgreSQL syntax
+  - Only SELECT and VALUES are supported (INSERT/UPDATE/DELETE are not yet implemented)
+  - SQL comments are automatically removed
+  - Handles CTEs (WITH), UNION/INTERSECT/EXCEPT, subqueries, window functions, complex expressions, and functions
+  - Provides detailed error messages
+  - Highly accurate tokenization
 
-Represents a SQL `VALUES` clause, such as `VALUES (1, 'a'), (2, 'b')`, which is used for inline data tables.
+---
 
-**Key methods:**
-- (Primarily the constructor and tuple access)
-- This class can be used as a subquery source or wrapped with QueryNormalizer to convert it into a standard SELECT query.
+## Core SQL Query Classes
 
----
+- **SimpleSelectQuery**  
+  Represents a standard SELECT statement. Supports all major clauses such as WHERE, GROUP BY, JOIN, and CTE.
+  - `toUnion`, `toUnionAll`, ... for UNION operations
+  - `appendWhere`, `appendWhereRaw` to add WHERE conditions
+  - `innerJoin`, `leftJoin`, ... to add JOINs
+  - `toSource` to wrap as a subquery
+  - `appendWith`, `appendWithRaw` to add CTEs
 
-These classes are designed to be flexible and allow for robust construction, combination, and transformation of SQL queries. For further details, please refer to the source code.
+- **BinarySelectQuery**  
+  Represents binary SQL queries such as UNION, INTERSECT, and EXCEPT.
+  - `union`, `intersect`, ... to combine queries
+  - `toSource` to wrap as a subquery
+  - `unionRaw`, ... to combine with raw SQL
+
+- **ValuesQuery**  
+  For inline tables like `VALUES (1, 'a'), (2, 'b')`.
+  - Can be used as a subquery or converted to SELECT with QueryNormalizer
 
 ---
 
-## 🛠️ Transformer Features (AST Transformers)
+## AST Transformer Features
 
-rawsql-ts provides a suite of AST (Abstract Syntax Tree) transformers for advanced SQL analysis and manipulation. These utilities are intended for engineers who require programmatic extraction, analysis, or transformation of SQL query structures.
+A suite of utilities for transforming and analyzing SQL ASTs.
 
 ### Main Transformers
 
 - **Formatter**  
-  Converts SQL ASTs into standardized SQL text, handling identifier escaping and formatting for all SQL components.  
-  **Note:** Output formatting is currently limited to single-line (compact) style.
-
+  Converts ASTs to formatted SQL strings. Handles identifier escaping. Output is currently single-line (compact) style.
 - **SelectValueCollector**  
-  Extracts all columns, including aliases and expressions, from SELECT clauses. Supports wildcard expansion (e.g., `*`, `table.*`) when table structure information is provided.
-
+  Extracts all columns, aliases, and expressions from SELECT clauses. Supports wildcard expansion (e.g., `*`, `table.*`) with TableColumnResolver.
 - **SelectableColumnCollector**  
-  Collects all column references in a query that can be included in a SELECT clause. Gathers all columns available from root FROM/JOIN sources.
-
+  Collects all columns available from root FROM/JOIN sources.
+- **TableSourceCollector**  
+  Collects all table and subquery sources from FROM and JOIN clauses.
 - **CTECollector**  
-  Collects all Common Table Expressions (CTEs) from WITH clauses, subqueries, and UNION queries. Supports both nested and recursive CTEs.
-
+  Collects all CTEs from WITH clauses, subqueries, and UNION queries.
 - **UpstreamSelectQueryFinder**  
-  Identifies upstream SELECT queries that provide specific columns by traversing CTEs, subqueries, and UNION branches.
-
+  Finds upstream SELECT queries that provide specific columns by traversing CTEs, subqueries, and UNION branches.
 - **CTENormalizer**  
-  Consolidates all Common Table Expressions (CTEs) from any part of a query (including nested subqueries, JOINs, and UNIONs) into a single root-level WITH clause. If duplicate CTE names with different definitions are detected, an error is thrown to prevent ambiguity.
-
+  Consolidates all CTEs into a single root-level WITH clause. Throws an error if duplicate CTE names with different definitions are found.
 - **QueryNormalizer**  
-  Converts any SELECT query (including UNION, EXCEPT, or VALUES queries) into a standard SimpleSelectQuery format. For UNION or EXCEPT, the query is wrapped as a subquery with an alias (e.g., SELECT * FROM (...)). For VALUES, sequential column names (column1, column2, ...) are generated and the VALUES are wrapped in a subquery. This ensures a predictable query structure for downstream processing.
+  Converts any SELECT/UNION/VALUES query into a standard SimpleSelectQuery. Handles subquery wrapping and automatic column name generation.
+- **TableColumnResolver**  
+  A function type for resolving column names from a table name, mainly used for wildcard expansion (e.g., `table.*`). Used by analyzers like SelectValueCollector.
+  ```typescript
+  export type TableColumnResolver = (tableName: string) => string[];
+  ```
 
---- 
+---
 
-### Example Usage
+## Usage Example
 
 ```typescript
-import { SelectQueryParser } from 'rawsql-ts';
-import { SelectableColumnCollector } from 'rawsql-ts/transformers/SelectableColumnCollector';
+import { TableColumnResolver, SelectQueryParser, SelectableColumnCollector, SelectValueCollector, TableSourceCollector, Formatter } from 'rawsql-ts';
+
+// TableColumnResolver example
+const resolver: TableColumnResolver = (tableName) => {
+    if (tableName === 'users') return ['user_id', 'user_name', 'email'];
+    if (tableName === 'posts') return ['post_id', 'user_id', 'title', 'content'];
+    return [];
+};
 
-const sql = `SELECT u.id, u.name FROM users u JOIN posts p ON u.id = p.user_id`;
-const query = SelectQueryParser.parseFromText(sql);
+const sql = `SELECT u.*, p.title as post_title FROM users u INNER JOIN posts p ON u.user_id = p.user_id`;
+const query = SelectQueryParser.parse(sql);
+const formatter = new Formatter();
 
-const collector = new SelectableColumnCollector();
-const columns = collector.collect(query);
-console.log(columns.map(col => col.name)); // ["id", "name", "user_id", ...]
+// Collects information from the SELECT clause.
+// To expand wildcards, you must specify a TableColumnResolver.
+const selectValueCollector = new SelectValueCollector(resolver);
+const selectValues = selectValueCollector.collect(query);
+// Log the name and formatted value of each select value
+console.log('Select values:');
+selectValues.forEach(val => {
+    console.log(`  name: ${val.name}, value: ${formatter.format(val.value)}`);
+});
+/*
+Select values:
+  name: post_title, value: "p"."title"
+  name: user_id, value: "u"."user_id"
+  name: user_name, value: "u"."user_name"
+  name: email, value: "u"."email"
+*/
+
+// Collects selectable columns from the FROM/JOIN clauses.
+// You can get accurate information by specifying a TableColumnResolver.
+// If omitted, the information will be inferred from the query content.
+const selectableColumnCollector = new SelectableColumnCollector(resolver);
+const selectableColumns = selectableColumnCollector.collect(query);
+// Log detailed info for each selectable column
+console.log('Selectable columns:');
+selectableColumns.forEach(val => {
+    console.log(`  name: ${val.name}, value: ${formatter.format(val.value)}`);
+});
+/*
+Selectable columns:
+  name: post_title, value: "p"."title"
+  name: user_id, value: "u"."user_id"
+  name: user_name, value: "u"."user_name"
+  name: email, value: "u"."email"
+  name: post_id, value: "p"."post_id"
+  name: title, value: "p"."title"
+  name: content, value: "p"."content"
+*/
+
+// Retrieves physical table sources.
+const tableSourceCollector = new TableSourceCollector();
+const sources = tableSourceCollector.collect(query);
+// Log detailed info for each source
+console.log('Sources:');
+sources.forEach(src => {
+    console.log(`  name: ${src.getSourceName()}`);
+});
+/*
+TableSources:
+  name: users
+  name: posts
+*/
 ```
 
 ---
 
-By utilizing these transformer utilities, you can perform advanced SQL analysis and manipulation with reliability and consistency.
+## Advanced Example: Table Join
+
+This example demonstrates how to join two tables using rawsql-ts. You do not need to understand the internal structure or manage aliases manually. By specifying the join key(s), the ON clause is generated automatically.
+
+```typescript
+import { SelectQueryParser, Formatter, SimpleSelectQuery } from 'rawsql-ts';
+
+// Parse the base query
+const query = SelectQueryParser.parse('SELECT u.user_id, u.name FROM users u') as SimpleSelectQuery;
+
+// Add LEFT JOIN using the leftJoinRaw method (join on user_id)
+query.leftJoinRaw('orders', 'o', ['user_id']);
+
+// Add WHERE clause
+query.appendWhereRaw('o.order_id IS NULL');
+
+const formatter = new Formatter();
+const formattedSql = formatter.format(query);
+
+console.log(formattedSql);
+// => select "u"."user_id", "u"."name" from "users" as "u" left join "orders" as "o" on "u"."user_id" = "o"."user_id" where "o"."order_id" is null
+```
+
+**Key Points:**
+- No need to understand internal implementation or alias management
+- Specify only the join key(s) (e.g., `['user_id']`); the ON clause is generated automatically
+- Subqueries and aliases are handled automatically
+- You can join queries without detailed knowledge of SQL structure or AST internals
+
+---
 
 ## Benchmarks
 
-This project includes benchmarking functionality. To run benchmarks, execute:
+This project includes a comprehensive benchmark suite to evaluate the performance of `rawsql-ts` in comparison with other popular libraries such as `node-sql-parser` and `sql-formatter`.
+
+### How to Run
 
 ```bash
 npm run benchmark
 ```
 
-## Benchmark Details
+### Benchmark Details
 
-The benchmark suite evaluates the SQL parsing and formatting performance of `rawsql-ts` in comparison to popular libraries such as `sql-formatter` and `node-sql-parser`. Queries of varying complexity are tested:
+The benchmark suite measures SQL parsing and formatting speed across queries of varying complexity:
 
-- **Tokens20**: Simple `SELECT` query with a basic `WHERE` condition (~20 tokens)
-- **Tokens70**: Medium complexity query with `JOIN`s and multiple conditions (~70 tokens)
-- **Tokens140**: Complex query with `CTE`s and aggregations (~140 tokens)
-- **Tokens230**: Highly complex query with multiple `CTE`s, subqueries, and window functions (~230 tokens)
+- **Tokens20**: Simple SELECT with a basic WHERE clause (~20 tokens)
+- **Tokens70**: Medium complexity query with JOINs and multiple conditions (~70 tokens)
+- **Tokens140**: Complex query with CTEs and aggregations (~140 tokens)
+- **Tokens230**: Highly complex query with multiple CTEs, subqueries, and window functions (~230 tokens)
 
-## Benchmark Environment
+### Benchmark Environment
 
 ```
 benchmark.js v2.1.4  
@@ -182,71 +265,46 @@ AMD Ryzen 7 7800X3D (8C/16T)
 Node.js v22.14.0
 ```
 
-## Results
-
-### Tokens20
-| Method                            | Mean       | Error     | StdDev    |
-|---------------------------------- |-----------:|----------:|----------:|
-| rawsql-ts                  |    0.021 ms |  0.0044 ms |  0.0023 ms |
-| node-sql-parser                |    0.169 ms |  0.0695 ms |  0.0355 ms |
-| sql-formatter                  |    0.208 ms |  0.0556 ms |  0.0284 ms |
-
-### Tokens70
-| Method                            | Mean       | Error     | StdDev    |
-|---------------------------------- |-----------:|----------:|----------:|
-| rawsql-ts                  |    0.057 ms |  0.0143 ms |  0.0073 ms |
-| node-sql-parser                |    0.216 ms |  0.0780 ms |  0.0398 ms |
-| sql-formatter                  |    0.512 ms |  0.1251 ms |  0.0638 ms |
-
-### Tokens140
-| Method                            | Mean       | Error     | StdDev    |
-|---------------------------------- |-----------:|----------:|----------:|
-| rawsql-ts                  |    0.112 ms |  0.0236 ms |  0.0120 ms |
-| node-sql-parser                |    0.404 ms |  0.0926 ms |  0.0472 ms |
-| sql-formatter                  |    1.004 ms |  0.3027 ms |  0.1545 ms |
-
-### Tokens230
-| Method                            | Mean       | Error     | StdDev    |
-|---------------------------------- |-----------:|----------:|----------:|
-| rawsql-ts                  |    0.182 ms |  0.0371 ms |  0.0189 ms |
-| node-sql-parser                |    0.865 ms |  0.3325 ms |  0.1696 ms |
-| sql-formatter                  |    1.696 ms |  0.2754 ms |  0.1405 ms |
-
-## Performance Summary
+### Results
+
+#### Tokens20
+| Method           | Mean      | Error     | StdDev    |
+|------------------|----------:|----------:|----------:|
+| rawsql-ts        | 0.021 ms  | 0.0044 ms | 0.0023 ms |
+| node-sql-parser  | 0.169 ms  | 0.0695 ms | 0.0355 ms |
+| sql-formatter    | 0.208 ms  | 0.0556 ms | 0.0284 ms |
+
+#### Tokens70
+| Method           | Mean      | Error     | StdDev    |
+|------------------|----------:|----------:|----------:|
+| rawsql-ts        | 0.057 ms  | 0.0143 ms | 0.0073 ms |
+| node-sql-parser  | 0.216 ms  | 0.0780 ms | 0.0398 ms |
+| sql-formatter    | 0.512 ms  | 0.1251 ms | 0.0638 ms |
+
+#### Tokens140
+| Method           | Mean      | Error     | StdDev    |
+|------------------|----------:|----------:|----------:|
+| rawsql-ts        | 0.112 ms  | 0.0236 ms | 0.0120 ms |
+| node-sql-parser  | 0.404 ms  | 0.0926 ms | 0.0472 ms |
+| sql-formatter    | 1.004 ms  | 0.3027 ms | 0.1545 ms |
+
+#### Tokens230
+| Method           | Mean      | Error     | StdDev    |
+|------------------|----------:|----------:|----------:|
+| rawsql-ts        | 0.182 ms  | 0.0371 ms | 0.0189 ms |
+| node-sql-parser  | 0.865 ms  | 0.3325 ms | 0.1696 ms |
+| sql-formatter    | 1.696 ms  | 0.2754 ms | 0.1405 ms |
+
+### Performance Summary
 
 - `rawsql-ts` consistently outperforms both `node-sql-parser` and `sql-formatter` in all tested scenarios.
 - Approximately 4x faster than `node-sql-parser`.
-- Approximately 9-10x faster than `sql-formatter`.
-- Maintains comprehensive SQL parsing capabilities while delivering significant performance improvements.
-
-> **Note:** These benchmarks are based on a specific hardware and software environment. Actual performance may vary depending on system configuration and workload.
+- Approximately 9–10x faster than `sql-formatter`.
+- Maintains high performance even with complex SQL while providing comprehensive features.
 
-## Practical Example: Table Join
+> **Note:** These benchmarks are based on a specific hardware and software environment. Actual performance may vary depending on system configuration and query complexity.
 
-Let's see how easy it is to join two tables using rawsql-ts! You don't need to know the internal structure of SelectQuery or worry about alias names—just specify the join key(s) and the library will generate the ON clause for you automatically.
-
-```typescript
-import { SelectQueryParser } from 'rawsql-ts';
-import { Formatter } from 'rawsql-ts';
-
-// Parse two separate queries
-const userQuery = SelectQueryParser.parseFromText('SELECT user_id, user_name FROM users');
-const postQuery = SelectQueryParser.parseFromText('SELECT post_id, user_id, title FROM posts');
-
-// Join the two queries using innerJoin
-// Just pass the join key(s) as an array, and the ON clause will be generated automatically!
-const joinedQuery = userQuery.innerJoin(postQuery, ['user_id']);
+---
 
-// Format the joined query back to SQL
-const formatter = new Formatter();
-const sql = formatter.visit(joinedQuery);
-console.log(sql);
-// Output:
-// select "user_id", "user_name", "post_id", "title" from "users" inner join (select "post_id", "user_id", "title" from "posts") on "users"."user_id" = "posts"."user_id"
-```
+Feel free to try rawsql-ts! Questions, requests, and bug reports are always welcome.
 
-**Point:**
-- You do not need to understand the internal code of SelectQuery to perform joins.
-- You only need to specify the join key(s) (e.g., `['user_id']`). The ON clause is generated for you.
-- Alias names and subquery details are handled automatically by the library, so you never have to worry about them!
-- This makes it super easy to join queries, even if you don't know the full structure of the SQL or the internal AST.

package/dist/index.d.ts

@@ -6,8 +6,9 @@ export * from './models/ValuesQuery';
 export * from './transformers/CTECollector';
 export * from './transformers/CTENormalizer';
 export * from './transformers/Formatter';
-export * from './transformers/QueryNormalizer';
+export * from './transformers/QueryConverter';
 export * from './transformers/SelectValueCollector';
 export * from './transformers/SelectableColumnCollector';
+export * from './transformers/TableColumnResolver';
 export * from './transformers/TableSourceCollector';
 export * from './transformers/UpstreamSelectQueryFinder';

package/dist/index.js

@@ -23,9 +23,10 @@ __exportStar(require("./models/ValuesQuery"), exports);
 __exportStar(require("./transformers/CTECollector"), exports);
 __exportStar(require("./transformers/CTENormalizer"), exports);
 __exportStar(require("./transformers/Formatter"), exports);
-__exportStar(require("./transformers/QueryNormalizer"), exports);
+__exportStar(require("./transformers/QueryConverter"), exports);
 __exportStar(require("./transformers/SelectValueCollector"), exports);
 __exportStar(require("./transformers/SelectableColumnCollector"), exports);
+__exportStar(require("./transformers/TableColumnResolver"), exports);
 __exportStar(require("./transformers/TableSourceCollector"), exports);
 __exportStar(require("./transformers/UpstreamSelectQueryFinder"), exports);
 // Add more exports here if you want to expose additional public API

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AAErC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,iEAA+C;AAC/C,sEAAoD;AACpD,2EAAyD;AACzD,sEAAoD;AACpD,2EAAyD;AACzD,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AAErC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,gEAA8C;AAC9C,sEAAoD;AACpD,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,2EAAyD;AACzD,oEAAoE"}

package/dist/models/BinarySelectQuery.js

@@ -95,8 +95,9 @@ class BinarySelectQuery extends SqlComponent_1.SqlComponent {
         this.left = new BinarySelectQuery(this.left, this.operator.value, this.right);
         this.operator = new ValueComponent_1.RawString(operator);
         this.right = query;
-        const normalizer = new CTENormalizer_1.CTENormalizer();
-        normalizer.normalize(this);
+        // const normalizer = new CTENormalizer();
+        // normalizer.normalize(this);
+        CTENormalizer_1.CTENormalizer.normalize(this);
         return this;
     }
     /**
@@ -106,27 +107,27 @@ class BinarySelectQuery extends SqlComponent_1.SqlComponent {
      * @returns A new BinarySelectQuery representing "(this) UNION (parsed query)"
      */
     unionRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.union(parsedQuery);
     }
     unionAllRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.unionAll(parsedQuery);
     }
     intersectRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.intersect(parsedQuery);
     }
     intersectAllRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.intersectAll(parsedQuery);
     }
     exceptRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.except(parsedQuery);
     }
     exceptAllRaw(sql) {
-        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parseFromText(sql);
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
         return this.exceptAll(parsedQuery);
     }
     // Returns a SourceExpression wrapping this query as a subquery source.

package/dist/models/BinarySelectQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"BinarySelectQuery.js","sourceRoot":"","sources":["../../src/models/BinarySelectQuery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BinarySelectQuery.js","sourceRoot":"","sources":["../../src/models/BinarySelectQuery.ts"],"names":[],"mappings":"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"}

package/dist/models/SimpleSelectQuery.js

@@ -106,7 +106,7 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
      * @param rawCondition Raw SQL string representing the condition (e.g. "status = 'active'")
      */
     appendWhereRaw(rawCondition) {
-        const parsedCondition = ValueParser_1.ValueParser.parseFromText(rawCondition);
+        const parsedCondition = ValueParser_1.ValueParser.parse(rawCondition);
         this.appendWhere(parsedCondition);
     }
     /**
@@ -130,7 +130,7 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
      * @param rawCondition Raw SQL string representing the condition (e.g. "count(*) > 5")
      */
     appendHavingRaw(rawCondition) {
-        const parsedCondition = ValueParser_1.ValueParser.parseFromText(rawCondition);
+        const parsedCondition = ValueParser_1.ValueParser.parse(rawCondition);
         this.appendHaving(parsedCondition);
     }
     /**
@@ -208,7 +208,7 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
      * @param columns Array of column names to join on
      */
     joinSourceRaw(joinType, joinSourceRawText, alias, columns) {
-        const tableSource = SourceParser_1.SourceParser.parseFromText(joinSourceRawText);
+        const tableSource = SourceParser_1.SourceParser.parse(joinSourceRawText);
         const sourceExpr = new Clause_1.SourceExpression(tableSource, new Clause_1.SourceAliasExpression(alias, null));
         this.joinSource(joinType, sourceExpr, columns);
     }
@@ -249,8 +249,9 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
                 this.fromClause.joins = [joinClause];
             }
         }
-        const normalizer = new CTENormalizer_1.CTENormalizer();
-        normalizer.normalize(this);
+        // const normalizer = new CTENormalizer();
+        // normalizer.normalize(this);
+        CTENormalizer_1.CTENormalizer.normalize(this);
     }
     // Returns a SourceExpression wrapping this query as a subquery source.
     // Alias is required for correct SQL generation and join logic.
@@ -269,8 +270,9 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
         else {
             this.WithClause.tables.push(...tables);
         }
-        const normalizer = new CTENormalizer_1.CTENormalizer();
-        normalizer.normalize(this);
+        // const normalizer = new CTENormalizer();
+        // normalizer.normalize(this);
+        CTENormalizer_1.CTENormalizer.normalize(this);
     }
     /**
      * Appends a CommonTable (CTE) to the WITH clause from raw SQL text and alias.
@@ -280,7 +282,7 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
      * @param alias Optional alias for the CTE (e.g. 'cte_name')
      */
     appendWithRaw(rawText, alias) {
-        const query = SelectQueryParser_1.SelectQueryParser.parseFromText(rawText);
+        const query = SelectQueryParser_1.SelectQueryParser.parse(rawText);
         const commonTable = new Clause_1.CommonTable(query, alias, null);
         this.appendWith(commonTable);
     }